Besondere Hinweise zum Generieren von EGL- oder SOAP-Services für z/OS CICS
Zum Generieren eines EGL- oder eines Web-Service in einer z/OS CICS-Umgebung sind die folgenden Voraussetzungen erforderlich:
- Zum Generieren von Services in CICS ist CICS TS für z/OS 3.1 mit APARS PK15904 und PK23547 erforderlich.
- Zum Generieren von Services ist der Zugriff auf das hierarchische Dateisystem
unter z/OS erforderlich:
- Die Builddeskriptoroption destDirectory gibt das Basisverzeichnis im hierarchischen Dateisystem an, das für die Implementierung eines CICS-Web-Service und für die Implementierung von Anforderern verwendet werden soll.
- Bei der Implementierung eines Web-Service wird ein Unterverzeichnis zu dem in der Builddeskriptoroption destDirectory genannten Verzeichnis hinzugefügt. In dieses Unterverzeichnis mit dem Namen "Provider" werden bei der Vorbereitungszeit eine WSDL- und eine WSBIND-Datei hochgeladen. CICS muss über Lese- und Schreibzugriff für dieses Verzeichnis verfügen.
- Bei der Implementierung eines Web-Service-Clients wird ein Unterverzeichnis zu dem in der Builddeskriptoroption destDirectory genannten Verzeichnis hinzugefügt. In dieses Unterverzeichnis mit dem Namen "Anforderer" werden bei der Vorbereitungszeit eine WSDL- und eine WSBIND-Datei hochgeladen.
Die für die CICS-Web-Services bereitgestellte Standardtransaktion ist CPIH. Sie benötigt einen Transaktionsarbeitsbereich (TWA - Transaction Work Area) von 0 Bytes. Für EGL-Anwendungen ist ein TWA mit einer Mindestgröße von 1024 Bytes erforderlich. Zum Implementieren Ihrer mit EGL erstellten Anwendungen müssen Sie Ihre CPIH-Transaktion kopieren und die TWA-Größe in 1024 Bytes ändern. Anschließend müssen Sie die neu kopierte Transaktion im Attribut Transaction des für die Kommunikation unter CICS verwendeten Protokolls angeben.
http://www.example.com/banking/BankService
Der
URI-Pfad bezieht sich auf /banking/BankService. Der Pfad wird standardmäßig
auf /services/web-servicename gesetzt.
Dabei steht web-servicename für den Namen des Service
im EGL-Implementierungsdeskriptor. Wenn keine Anmerkung vorhanden ist, kann web-servicename aber auch
für den Namen des Serviceabschnitts stehen. Sie können den URI-Pfad im
Web-Serviceeintrag über das Feld "URI" im EGL-Implementierungsdeskriptor festlegen.Einschränkungen
- WSDL-Dateien anderer Anbieter, die SOAP-Bindings mit der Angabe "use=encoded" enthalten, werden nicht unterstützt und können nicht zum Erstellen von CICS-Web-Service-Clients verwendet werden.
- Parameter vom Typ "dbchar" werden in CICS-Web-Service nicht unterstützt.
- Die Funktionsüberladung wird in CICS-Web-Service nicht unterstützt.
Weitere Informationen
Weitere Details finden Sie im Abschnitt “Web-Service unter CICS generieren und implementieren”.