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.