Fujitsu Siemens Computers GmbH S E S A M - D B A c c e s s (JDBC) Version 5.0A Juli 2006 F r e i g a b e m i t t e i l u n g Copyright Fujitsu Siemens Computers GmbH All rights reserved - 1 - Inhalt 1 1.1 1.2 1.3 Allgemeines Bestellung Auslieferung Dokumentation 3 3 3 4 2 2.1 2.2 2.3 2.3.1 2.3.2 2.4 2.4.1 2.4.2 2.5 2.6 2.7 2.8 Technische Hinweise Ressourcenbedarf SW-Konfiguration Produktinstallation Installation des SESAM-DBAccess (JDBC) Servers Installation des SESAM-DBAccess (JDBC) Clients Produkt-Einsatz Einsatz des SESAM-DBAccess (JDBC) Servers Einsatz des SESAM-DBAccess (JDBC) Clients Entfallene Funktionen (entfaellt) Inkompatibilitaeten Einschraenkungen Verhalten im Fehlerfall 5 5 5 5 5 5 5 6 6 6 6 6 6 3 3.1 3.2 Software-Erweiterungen Erweiterungen Server Erweiterungen Client 7 7 7 - 2 - 1 Allgemeines SESAM-DBAccess (JDBC) V5.0A BS2000/OSD Datenbank-Service Diese Freigabemitteilung enthaelt in gedraengter Form die wesentlichen Erweiterungen, Abhaengigkeiten und Betriebshinweise zu SESAM-DBAccess (JDBC) V5.0A unter dem Betriebssystem BS2000/OSD. Die Freigabemitteilung kann mit /PRINT-FILE FILE-NAME=SYSFGM.SESDBA.050.D,LAYOUT-CONTR=PAR(CONTR-CHAR=EBCDIC) auf Drucker ausgegeben werden. Der Datenbankzugriffsservice SESAM-DBAccess (JDBC) ermoeglicht seinen Benutzern den Zugriff auf SESAM/SQL-Datenbanken des BS2000/OSD. Er bietet seine Leistungen ueber die JDBC-Schnittstelle des SESAM-DBAccess (JDBC) Clients unter Windows, UNIX oder BS2000/OSD von einer Java-Anwendung oder einem Java-Applet aus an. Der SESAM-DBAccess (JDBC) Server hat aus Anwendersicht die Aufgabe, die durch den Client gestellten DB-Requests auf die realen Schnittstellen des Datenbanksystems SESAM/SQL abzubilden. Der SESAM-DBAccess (JDBC) Server bearbeitet Auftraege von mehreren, voneinander unabhaengigen Client-Benutzern, die auf einem oder mehreren Rechnern arbeiten. Mit der Version 5.0A wird das Datenbanksystem SESAM/SQL ab V5.0A unterstuetzt. Die Wiedergabe von Namen, Warenbezeichnungen und dgl. in dieser Information berechtigt nicht zu der Annahme, dass diese Namen/Bezeichnungen ohne weiteres von jedermann benutzt werden duerfen; oft handelt es sich um gesetzlich oder vertraglich geschuetzte Namen/Bezeichnungen, auch wenn sie nicht als solche gekennzeichnet sind. 1.1 Bestellung SESAM-DBAccess (JDBC) ist Bestandteil des Datenbanksystems SESAM/ SQL und kann nur zusammen mit diesem ueber die zustaendige Vertriebsgesellschaft bezogen werden. Sollte ein Interessent bereits eine aeltere Version von SESAM/SQL im Einsatz haben, so genuegt der Bezug einer aktuellen Korrekturversion dieses Produkts, in dem der SESAM-DBAccess (JDBC) enthalten ist. 1.2 Auslieferung Die Lieferung der Dateien zu SESAM-DBAccess (JDBC) V4.0A erfolgt zusammen mit dem Datenbanksystem SESAM/SQL ueber das Lieferverfahren SOLIS. Folgende Dateien sind Bestandteil dieser Lieferung: Dateiname Bedeutung ------------------------------------------------------------------SYSDAT.SESDBA.050.EBCASC Tabelle fuer Umsetzung EBCDIC nach ASCII SYSDAT.SESDBA.050.INIT Initialisierungsdatei SYSFGM.SESDBA.050.D Freigabemitteilung - 3 - SYSFGM.SESDBA.050.E SYSLIB.SESDBA.050.PROCLIB SYSMES.SESDBA.050 SYSOML.SESDBA.050 SYSPRC.SESDBA.050.USER Freigabemitteilung (englisch) Bibliothek mit Prozeduren und Masken Meldungsdatei Modulbibliothek Prozedur zum Erstellen der Benutzerdatei Der SESAM-DBAccess (JDBC) Client befindet sich auf der beiliegenden CD "SES/SQL-SE V5.0A" "Tools and Drivers for Windows" im Verzeichnis: \DBACCESS\JDBC_050\CLIENT\LIB. Die Readme-Datei zu SESAM-DBAccess (JDBC) Client (readme.html) und das Handbuch zu SESAM-DBAccess (JDBC) Server (jdbc_sv.pdf) befinden sich ebenfalls auf der beiliegenden CD im Verzeichnis: \DBACCESS\JDBC_050\CLIENT\DOC bzw. \DBACCESS\JDBC_050\SERVER\DOC. 1.3 Dokumentation Die fuer die Arbeit mit SESAM-DBAccess (JDBC) notwendigen Handbuecher fuer den Client und den Server sind auf der beiliegenden CD enthalten (siehe oben). Die Handbuecher sind PDF-Dateien. Um diese anschauen oder ausdrukken zu koennen, ist der Adobe Acrobat Reader erforderlich. Er befindet sich auf der beiliegenden CD im Verzeichnis: \AcrobatReader5 Die Datei ar500deu.exe ist eine selbstextrahierende EXE-Datei. Durch Aufruf der Datei werden in dem anschliessend angeforderten Verzeichnis die zur Installation notwendigen Dateien erzeugt. Der Speicherplatzbedarf nach der Installation betraegt ca. 7,4 MB. Neben diesen Benutzerhandbuechern koennen auch die Manuale des verwendeten Datenbanksystems SESAM/SQL sowie des BS2000-Grundausbaus hilfreich sein. - 4 - 2 Technische Hinweise 2.1 Ressourcenbedarf Der Einsatz von SESAM-DBAccess (JDBC) V5.0A ist auf allen von BS2000/OSD ab V5.0 unterstuetzen Zentraleinheiten mit einem virtuellen Adressraum von mindestens 16 MB moeglich. Der Speicherbedarf auf der Platte betraegt ca. 3000 PAM-Seiten fuer die Installationsdateien. 2.2 SW-Konfiguration An der BS2000-Anlage setzt: Betriebssystem: werden folgende Softwareprodukte vorausge- BS2000/OSD ab Version mit POSIX-BC ab Version Datenbanksystem: SESAM/SQL ab Version Common Run-Time Environment: CRTE ab Version Editor: EDT ab Version SESAM-DBAccess (JDBC) setzt clientseitig voraus: Java Interpreter Java ab Version JDK ab Version JDBC ab Version 5.0 3.0A15 5.0A 2.1A 16.5 1.2 1.2 2.0 2.3 Produktinstallation 2.3.1 Installation des SESAM-DBAccess (JDBC) Servers Der Inhalt des Kundenbandes wird ins System uebernommen. Alle fuer die Installation des Servers notwendigen Informationen sind im Handbuch "SESAM-DBAccess (JDBC) V4.0A Server-Installation, Administration" beschrieben, das auf der, der Lieferung beiliegenden CD als PDF-Datei enthalten ist. Der Betrieb des SESAM-DBAccess (JDBC) Servers wird durch Startparameter gesteuert. Diese Startparameter sind in einer Initialisierungsdatei mit dem Namen SYSDAT.SESDBA.050.INIT abgelegt. Sie sind im oben genannten Handbuch beschrieben. Der SESAM-DBAccess (JDBC) Server kann wahlweise mit oder ohne Benutzerpruefung eingesetzt werden. Dies wird in der Initialisierungsdatei eingestellt. Die Benutzerverwaltung ist im oben genannten Handbuch beschrieben. 2.3.2 Installation des SESAM-DBAccess (JDBC) Clients Alle fuer die Installation des Clients notwendigen Informationen sind in der Readme-Datei beschrieben, die auf der, der Lieferung beiliegenden CD als HTML-Datei enthalten ist. Die jeweils neuesten Versionen des SESAM-DBAccess (JDBC) Clients stehen auch im Internet zur Verfuegung: http://www.fujitsu-siemens.com/products/software/... ...transaction_processing/database_systems/sesamsqljdbc.html 2.4 Produkt-Einsatz - 5 - 2.4.1 Einsatz des SESAM-DBAccess (JDBC) Servers Alle fuer den Betrieb des Servers notwendigen Informationen sind im Handbuch "SESAM-DBAccess (JDBC) V5.0A Server-Installation, Administration" beschrieben. 2.4.2 Einsatz des SESAM-DBAccess (JDBC) Clients Alle fuer den Betrieb des Clients notwendigen Informationen sind in der Readme-Datei beschrieben. 2.5 Entfallene Funktionen (entfaellt) --2.6 Inkompatibilitaeten Der Client V4.0A kann nur mit dem Server V5.0A zusammenarbeiten, bzw aeltere Client-Versionen koennen nicht mit dem Server V5.0A zusammenarbeiten. 2.7 Einschraenkungen Siehe Handbuch "SESAM-DBAccess (JDBC) V5.0A Server-Installation, Administration" und Readme-Datei zu SESAM-DBAccess (JDBC) Client, die auf der, der Lieferung beiliegenden CD enthalten sind. 2.8 Verhalten im Fehlerfall Fehlermeldungen zu DBAccess sind neben einer genauen Beschreibung des Fehlers die nachfolgend aufgefuehrten Unterlagen beizulegen: - DBAccess (BS2000/OSD) Benutzerprotokolldatei (Trace-Datei) - SYSOUT-Protokolle - Traceprotokoll des Treibermanagers (Client) - 6 - 3 Software-Erweiterungen 3.1 Erweiterungen Server In der Server-Komponenten wurde die Unterstuetzung von UNICODE fuer SESAM, d.h. die neuen Datentypen NCHAR und NVARCHAR implementiert. 3.2 Erweiterungen Client Der JDBC-Treiber 5.0A unterstuetzt den Zugriff auf Columns der Datentypen NCHAR und NVARCHAR. Die Java-Applikation kann fuer den Zugriff die gleichen Funktionen verwenden wie fuer Columns des Typs CHAR bzw. VARCHAR. - 7 - Information on this document On April 1, 2009, Fujitsu became the sole owner of Fujitsu Siemens Computers. This new subsidiary of Fujitsu has been renamed Fujitsu Technology Solutions. This document from the document archive refers to a product version which was released a considerable time ago or which is no longer marketed. Please note that all company references and copyrights in this document have been legally transferred to Fujitsu Technology Solutions. Contact and support addresses will now be offered by Fujitsu Technology Solutions and have the format …@ts.fujitsu.com. The Internet pages of Fujitsu Technology Solutions are available at http://ts.fujitsu.com/... and the user documentation at http://manuals.ts.fujitsu.com. Copyright Fujitsu Technology Solutions, 2009 Hinweise zum vorliegenden Dokument Zum 1. April 2009 ist Fujitsu Siemens Computers in den alleinigen Besitz von Fujitsu übergegangen. Diese neue Tochtergesellschaft von Fujitsu trägt seitdem den Namen Fujitsu Technology Solutions. Das vorliegende Dokument aus dem Dokumentenarchiv bezieht sich auf eine bereits vor längerer Zeit freigegebene oder nicht mehr im Vertrieb befindliche Produktversion. Bitte beachten Sie, dass alle Firmenbezüge und Copyrights im vorliegenden Dokument rechtlich auf Fujitsu Technology Solutions übergegangen sind. Kontakt- und Supportadressen werden nun von Fujitsu Technology Solutions angeboten und haben die Form …@ts.fujitsu.com. Die Internetseiten von Fujitsu Technology Solutions finden Sie unter http://de.ts.fujitsu.com/..., und unter http://manuals.ts.fujitsu.com finden Sie die Benutzerdokumentation. Copyright Fujitsu Technology Solutions, 2009