++ Im folgenden Abschnitt werden die Protokolloptionen aufgelistet, die zur Verfügung stehen,
wenn Sie eine EGL-Servicebindung oder eine native Servicebindung codieren oder
wenn Sie einen Web-Service in CICS oder IBM® i implementieren. Bei einer Implementierung
geben Sie Details für den Zugriff auf ein COBOL-Programm über den Web-Service an.
++ Die folgenden Protokolle werden für eine EGL-Servicebindung unterstützt:
- Local
- ++ Für einen Anforderer, der auf einen Service in derselben Ausführungseinheit zugreift.
- CICSECI
- ++ Für einen Java™-Anforderer, der
auf einen COBOL-Service über die ECI-Schnittstelle von CICS Transaction
Gateway (CTG) zugreift.
- CICSJ2C
- ++ Für einen Java-Anforderer, der
auf einen COBOL-Service über einen J2C-Connector für CICS Transaction Gateway zugreift.
- CICSSSL
- ++ Für einen Java-Anforderer, der
auf einen COBOL-Service über die SSL-Funktionen (SSL - Secure Socket Layer) von CICS Transaction Gateway (CTG) zugreift.
- JAVA400
- ++ Für einen Java-Anforderer, der
auf einen COBOL-Service unter IBM i zugreift.
++ In diesem Fall werden die Verbindungsdetails vom Java-Anforderer verwaltet.
- JAVA400J2C
- ++ Für einen Java-Anforderer, der
auf einen COBOL-Service unter IBM i zugreift.
++ Diese Option ist nur verfügbar, wenn der Java-Anforderer
auf einem Anwendungsserver ausgeführt wird, der vollständig mit Java EE kompatibel ist, wie beispielsweise IBM WebSphere Application
Server anstelle von Apache Tomcat. ++ Bei Verwendung von JAVA400J2C werden die Verbindungsdetails,
wie beispielsweise die Sicherheitsberechtigungsnachweise, durch den Anwendungsserver verwaltet. ++ EGL-generierte Anwendungen und nicht mit EGL generierte Anwendungen dürfen J2C-Connector nicht gemeinsam
nutzen.
++ JAVA400J2C unterstützt keine Verbindung mit Zustandsüberwachung (STATEFUL).
Der Benutzer kann jedoch die auf dem Host verwendete aktuelle Bibliothek und die Bibliotheksliste
steuern.
- TCPIP
- ++ Für einen Java-Anforderer, der auf einen
Java-Service über das TCP/IP-Protokoll zugreift.
++ Die folgenden Protokolle werden für eine native Servicebindung unterstützt:
- SYSTEM-I LOCAL
- ++ Für einen COBOL-Anforderer, der auf einen COBOL-Service auf derselben
IBM i-Maschine zugreift. ++ In diesem
Fall ist der Service-Code im EGL-generierten Code enthalten. ++ Sie
die Binding-Details nicht zur Ausführungszeit ändern.
- JAVA400
- ++ Für einen Java-Anforderer, der
auf einen COBOL-Service unter IBM i zugreift.
++ In diesem Fall werden die Verbindungsdetails vom Java-Anforderer verwaltet.
- JAVA400J2C
- ++ Für einen Java-Anforderer, der
auf einen COBOL-Service unter IBM i zugreift.
++ Diese Option steht nur zur Verfügung, wenn der Java-Anforderer
auf einem Anwendungsserver ausgeführt wird, der vollständig mit Java EE kompatibel ist, wie beispielsweise WebSphere Application Server anstelle von Apache Tomcat. ++ Bei Verwendung von JAVA400J2C werden die Verbindungsdetails,
wie beispielsweise die Sicherheitsberechtigungsnachweise, durch den Anwendungsserver verwaltet. ++ EGL-generierte Anwendungen und nicht mit EGL generierte Anwendungen dürfen J2C-Connector nicht gemeinsam
nutzen.
++ JAVA400J2C unterstützt keinen Aufruf mit Zustandsüberwachung (STATEFUL).
Der Benutzer kann jedoch die auf dem Host verwendete aktuelle Bibliothek und die Bibliotheksliste
steuern.
++ Je nach Protokoll geben Sie Attribute aus der folgenden
Liste an:
- location
- ++ Der Server und Pfad, die die Position des Service angeben, wie beispielsweise myServer.myCompany.com/myService
- password
- ++ Das Kennwort für das IBM i-System. ++ Geben Sie die Benutzer-ID mit der Option userID an.
- userID
- ++ Die Benutzer-ID für das IBM i-System. ++ Wenn der Verbindungstyp JAVA400J2C ist, werden die Sicherheitsberechtigungsnachweise
in der Regel vom Anwendungsserver verarbeitet. Wenn
Sie die Benutzer-ID und das Kennwort bei der Verbindung angeben, werden die angegebenen Werte
verwendet.
- bindDir
- ++ Bei einer SYSTEM-I.LOCAL-Verbindung wird ein vollständig qualifiziertes Bindingverzeichnis,
wie beispielsweise, LIBNAME/BIND_DIR_NAME, für den Zugriff auf das Serviceprogramm verwendet.
- conversionTable
- ++ Der Name der Konvertierungstabelle, die Daten bei einem Aufruf an
den Service konvertiert. ++ Die Konvertierung ist erforderlich, wenn sich die Codepage,
mit der der Text im Service verschlüsselt wird, von der vom Anforderer verwendeten Verschlüsselung
unterscheidet. ++ Weitere Informationen zu Konvertierungstabellen finden
Sie unter "Datenkonvertierung".
- currentLibrary
- ++ Bei einer JAVA400J2C-Verbindung steht dieser Parameter für den Namen, mit dem die Bibliothek
auf dem Host-Job festgelegt wird. Beispiel: *USRPRF. oder *CRTDFT.
- ctgKeyStore
- ++ Der des Keystores, der mit dem CICS Transaction Gateway-Tool IKEYMAN erstellt wird.
- ctgKeyStorePassword
- ++ Das Kennwort, das beim Erstellen des Keystores verwendet wird
- ctgLocation
- ++ Die URL für den Zugriff auf den Service über einen CTG-Server (CTG - CICS Transaction Gateway). ++ Geben Sie den
zugehörigen Port mit der Option ctgPort an.
- ctgPort
- ++ Der Port, über den der Zugriff auf einen Service über einen CTG-Server (CTG - CICS Transaction Gateway) erfolgt.
- libraries
- ++ Bei einer JAVA400J2C-Verbindung
ist dies eine Liste der Bibliotheken. In dieser Liste stellt jeder Eintrag einen Bibliotheksnamen dar,
gefolgt von einem Wert für die Position, für den der Standardwert *LAST festgelegt ist (auf diese Weise wird
sichergestellt, dass der Eintrag nach den Einträgen angeordnet wird, die einen anderen Wert für die
Position aufweisen, nämlich *FIRST).
++ Im Folgenden finden Sie einen Beispielwert für
libraries:
MYMQLIB,MYFILLIB,MYDBLIB *FIRST
- library
- ++ Bei einer JAVA400- oder SYSTEM-I.LOCAL-Verbindung ist dies der Name der Bibliothek,
in der sich der Service auf dem IBM i-System befindet.
- location
- ++ Bei
einer TCPIP-Verbindung ist dies der TCPIP-Hostname oder die -Hostadresse. ++ Bei einer JAVA400-Verbindung
steht dieser Parameter für den Server und Pfad, die die Position für den Service angeben, wie beispielsweise
myServer.myCompany.com/myService. ++ Bei JAVA400J2C
wird der JNDI-Name im Anwendungsserver angegeben. ++ Bei einer CICSECI- oder
CICSSSL-Verbindung wird die CICS-System-ID angegeben. ++ Bei einer CICSJ2C-Verbindung wird der JNDI-Name des Objekts ConnectionFactory
angegeben, das Sie für die durch den Aufruf gestartete CICS-Transaktion erstellen.
- password
- ++ Das Kennwort für das IBM i-System. ++ Geben Sie die Benutzer-ID mit der Option userID an.
++ Die Benutzer-ID für das IBM i-System.
++ Wenn der Verbindungstyp JAVA400J2C ist, werden die Sicherheitsberechtigungsnachweise
in der Regel vom Anwendungsserver verarbeitet. ++ Wenn Sie die Benutzer-ID und das Kennwort für die Verbindung angeben,
werden die angegeben Werte anstelle von anderen Werten verwendet.
- serverID
- ++ Bei einer TCPIP-Verbindung ist dies die Portnummer des Listeners für den
Service. ++ Bei einer CICSJ2C-, CICSSSL- oder CICSECI-Verbindung handelt es sich um die ID einer aufgerufenen
CICS-Transaktion.
++ Standardmäßig ist dies die Spiegeltransaktion für das CICS-Serversystem (CPMI).
- transaction
- ++ Der Name der Transaktion, die Sie als Kopie der CPIH-Transaktion
mit einem größeren Wert für die Größe des Transaktionsarbeitsbereichs (wie im Abschnitt “Besondere Hinweise zum Erstellen von EGL- oder SOAP-Services für z/OS CICS” erläutert).
- userID
- ++ Die Benutzer-ID für das System
- ++ Wenn es sich bei dem Verbindungstyp unter IBM i
um JAVA400J2C handelt, werden die Sicherheitsberechtigungsnachweise in der Regel vom
Anwendungsserver verarbeitet. ++ Wenn Sie die Benutzer-ID und das Kennwort für die Verbindung angeben,
werden die angegeben Werte anstelle von anderen Werten verwendet.
- ++ Geben Sie unter CICS diesen Wert an,
wenn Sie die Transaktionen als Benutzer eines bestimmten Typs ausführen möchten.