Optionen für gemeinsam nutzbare Protokolle

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.