Mit z/OS Connect können Sie Anforderungs- und Antwortnutzdaten, die für den Aufruf eines Geschäftsassets
unter z/OS-Betriebssystemen verwendet werden, optional transformieren. z/OS Connect stellt zwei neue Dienstprogramme bereit:
BBGLS2JS und BBGJS2LS.
Vorbereitende Schritte
Bevor Sie Ihre Bindungs- und Schemadateien erstellen, müssen Sie sicherstellen, dass Ihr Setup die folgenden
Bedingungen erfüllt:
- Ihre Datenstrukturen höherer Programmiersprachen müssen den folgenden Kriterien entsprechen:
- Die Datenstrukturen müssen gesondert vom Quellenprogramm definiert werden, z. B. in einem COBOL-Copybook.
- Wenn Ihr PL/I- oder COBOL-Anwendungsprogramm unterschiedliche Datenstrukturen für die Eingabe und die Ausgabe verwendet,
müssen die Datenstrukturen in zwei verschiedenen Membern in einer partitionierten Datei definiert werden. Wenn dieselbe
Struktur für die Eingabe und die Ausgabe verwendet wird, muss die Struktur in einem einzigen Member definiert werden.
- Für C und C++ können sich Ihre Datenstrukturen im demselben Member einer partitionierten Datei befinden.
- Die Sprachstrukturen müssen in einer partitionierten Datei verfügbar sein.
- Sie müssen die Benutzer-ID, die BBGLS2JS bzw. BBGJS2LS
für die Ausführung verwendet, in Open Multiple Virtual Storage (OMVS) definieren.
- Der Benutzer muss Leseberechtigung für die z/OS®-UNIX- und -PDS-Bibliotheken
und Schreibberechtigung für die Verzeichnisse besitzen, die in den Ausgabeparametern
LOGFILE, WSBIND, JSON-SCHEMA-REQUEST und JSON-SCHEMA-RESPONSE
angegeben sind.
- Der Benutzer-ID muss ausreichend Speicher zugeordnet sein, damit Java™ ausgeführt werden kann.
Sie können jede unterstützte Java-Version verwenden. Die Dienstprogramme BBGLS2JS und BBGJS2LS
verwenden die Java-Version, die standardmäßig mit JAVA_HOME in der USS-Umgebung angegeben ist. Andernfalls verwendet die ID
die in der PATH-Anweisung angegebene Java-Version.
Informationen zu diesem Vorgang
Das Dienstprogramm BBGLS2JS liest eine COBOL-Copybook-, PL/I- oder C-Strukturdatei ein und generiert eine Bindungsdatei
und JSON-Schemadateien.
Das Dienstprogramm BBGJS2LS liest ein JSON-Schema ein und generiert die entsprechende Bindungsdatei
und Sprachstrukturdatei (COBOL-Copybook-, PL/I- oder C-Strukturheaderdatei). Die Dienstprogramme gleichen den vorhandenen Tools
DFHLS2JS und DFHJS2LS, die zum Feature-Pack "CICS Transaction
Server Mobile Extensions" gehören. Die Eingabeparameter sind zwar dieselben, aber die symbolischen Parameter sind verschieden.
Vorgehensweise
- Rufen Sie die BBGLS2JS-JCL-Prozedur ab. Die BBGLS2JS- und BBGJS2LS-JCL-Prozeduren sind im GitHub verfügbar. Informationen zur
Verwendung der JCL finden Sie in der Readme-Datei zu GitHub. Sie müssen die JCL-Prozedur von dieser Position
in ein Member mit dem Namen BBGLS2JS einer JCL-Prozedurbibliothek auf Ihrem z/OS-System kopieren.
- Verwenden Sie die BBGLS2JS-Prozedur, um aus einer Sprachstruktur eine z/OS Connect-Servicebindungsdatei zu generieren. Sie müssen die JCL bereitstellen, um die BBGLS2JS-Prozedur mit den Eingabeparametern aufzurufen. Informationen zu den Eingabeparametern
und einen Beispieljob für die Verwendung der Prozedur finden Sie in der Referenzdokumentation zu BBGLS2JS. Wenn Sie die BBGLS2JS-Prozedur
übergeben, generiert das Dienstprogramm die Servicebindungsdatei an der Position, die Sie mit dem Parameter WSBIND angegeben haben.
Die generierten JSON-Schemas werden an die Position kopiert, die Sie mit den Parametern JSON-SCHEMA-REQUEST und JSON-SCHEMA-RESPONSE
angegeben haben.
- Sehen Sie sich das generierte JSON-Schema an. Diese Schemas werden verwendet, um die Eingabe- und Ausgabedatenformaten für die Interaktion
mit dem z/OS Connect-Service zu definieren. Der Anwendungsentwickler muss diese Schemas bei der Verwendung
einer Anwendung verwenden, um den Service aufzurufen und die JSON-Anforderungsnutzdaten zu übergeben.
Anmerkung: Durch die Änderung des generierten Schemas wird die generierte Bindungsdatei bei WSBIND ungültig gemacht.
Wenn Sie das Schema ändern möchten, z. B., um die Felder im Schema umzubenennen, müssen Sie mit BBGJS2LS
eine neue Bindungsdatei und einen neuen Satz von Sprachstrukturen generieren. Das Anwendungsprogramm muss erneut
kompiliert werden, damit die neuen Sprachstrukturen verwendet werden.