Mit IBM® 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. Sie können Transformatoren für Nachrichtennutzdaten erstellen, um
bestimmte Anforderungen durch Implementierung der Service-Provider-Schnittstelle (SPI) com.ibm.wsspi.zos.connect.DataXform, die im Lieferumfang von z/OS Connect enthalten ist, zu erfüllen.
Informationen zu diesem Vorgang
z/OS Connect stellt eine Implementierung bereit, die JSON als
Format für Anforderungs- und Antwortnachrichten voraussetzt. Dieses Feature unterstützt
die Konvertierung der Anforderung in ein Byte-Array, das
mit einer Cobol-, PL/I- oder C-Struktur einer nativen Sprache zugeordnet werden kann.
Diese Sprachstruktur des Zielprogramms bzw. dieses Copybook, das eine Beschreibung der Parameter
in und out enthält, wird verwendet, um eine Bindungsdatei
und JSON-Schemadateien für Anforderungen und Antworten mit einem von
z/OS Connect bereitgestellten Dienstprogramm zu generieren. Die von diesem Dienstprogramm
generierte Bindungsdatei wird von z/OS Connect verwendet, um die Datenkonvertierung in und aus
JSON- und native Datenformaten durchzuführen, wenn Anforderungen eingehen und Antworten zurückgegeben werden.
Sie können die JSON-Schemas für die Anforderungs- und Antwortnachrichten mit einem von z/OS Connect unterstützten REST-API-Aufruf abrufen.
Mit dem
von z/OS Connect bereitgestellten Konfigurationselement zosConnectService kann der Administrator
einen Satz von Attributen für einen bestimmten Service konfigurieren. Eines dieser Attribute ist "dataXformRef", das auf eine Datentransformationskonfiguration verweist, die für einen bestimmten Service verwendet werden soll.
In dieser Task wird beschrieben, wie Sie die Verwendung eines von
z/OS Connect bereitgestellten Datentransformators anfordern.
- Aktualisieren Sie das Element zosConnectService für jeden Service in der
Konfigurationsdatei server.xml, für den Sie die von z/OS Connect bereitgestellte Datentransformation
aktivieren möchten.
<!-- Definition des z/OS Connect-Service -->
<zosConnectService id="zcs1"
serviceName="recordOpsCreate"
serviceRef="wolaOpsCreateService"
dataXformRef="xformJSON2btye"/>
- Erstellen Sie das zugehörige Element zosConnectDataXform.
<!-- z/OS Connect-Datentransformationsprovider -->
<zosConnectDataXform id="xformJSON2Byte"
bindFileLoc="/u/bindfiles" bindFileSuffix=".bnd"
requestSchemaLoc="/u/json" responseSchemaLoc="/u/json"
requestSchemaSuffix=".json" responseSchemaSuffix=".json"/>
Weitere Informationen zu den konfigurierbaren
Attributdefinitionen, die dem zosConnectDataXform zugeordnet sind,
finden Sie in der Dokumentation zum Feature
z/OS Connect.
- Optional: Konfigurieren Sie einen Datentransformator, der für alle Services gilt. Setzen Sie das Attribut globaDataXformRef des Elements
zosConnectManager auf die konfigurierte ID des Datentransformators, die für die globale Verwendung
bestimmt ist.
Wenn globale und servicespezifische Datentransformatoren definiert sind und Anforderungen für einen Service mit einem
konfigurierten Datentransformator eingehen, verwendet z/OS Connect den Datentransformator, der speziell für den Service konfiguriert wurde.
<zosConnectManager id="zosConnectGlobals" globalDataXformRef="globalDataXform"/>
<!-- z/OS Connect-Datentransformationsprovider -->
<zosConnectDataXform id="globalDataXform"
bindFileLoc="/u/bindfiles" bindFileSuffix=".bnd"
requestSchemaLoc="/u/json" responseSchemaLoc="/u/json"
requestSchemaSuffix=".json" responseSchemaSuffix=".json"/>
- Optional: Konfigurieren Sie Einstellungen, wie z. B. pollingRate und updateTrigger, um die Überwachungsaktionen zu optimieren. Standardmäßig werden Verzeichnisse, die einer Datentransformationsdefinition zugeordnet sind, auf neue Dateien und Dateiaktualisierungen überwacht. Weitere Informationen zu diesen Konfigurationsattributen finden Sie im Abschnitt zum Element "zosConnectDataXform" unter zosConnect-1.0 und zosConnect
1.2.
<zosConnectDataXform id="ibmDataXform2"
bindFileLoc="/zosConnect/banking/bind/" bindFileSuffix=".bnd"
requestSchemaLoc="/zosConnect/banking/reqSchema" requestSchemaSuffix=".json"
responseSchemaLoc="/zosConnect/banking/respSchema" responseSchemaSuffix=".json" pollingRate="500ms">
</zosConnectDataXform>
Im Beispiel werden für die Verzeichnisse /zosConnect/banking/bind,/zosConnect/banking/reqSchema und
/zosConnect/banking/respSchema alle 500 Millisekunden Dateiaktualisierungen abgefragt. Wenn die Konfigurationsattribute pollingRate und updateTrigger nicht konfiguriert wurden, werden die Standardwerte polled bzw. 2 seconds verwendet. Wenn die Dateiüberwachung nicht erforderlich ist, können Sie sie inaktivieren, indem Sie das Attribut updateTrigger auf disabled setzen. Wenn Sie die Aktualisierung bestimmter Dateien manuell auslösen möchten, setzen Sie das
Attribut updateTrigger auf mbean und verwenden Sie die MBean für Dateibenachrichtigung com.ibm.ws.kernel.filemonitor.FileNotificationMBean, um die Aktualisierung auszulösen. Beispiel:
String[] MBEAN_METHOD_SIGNATURE = new String[] {Collection.class.getName(),Collection.class.getName(),Collection.class.getName() };
JMXConnector jmxConnector = ...;
MBeanServerConnection mbsc = jmxConnector.getMBeanServerConnection();
ObjectName fileMonitorMBeanName = new ObjectName("WebSphere:service=com.ibm.ws.kernel.filemonitor.FileNotificationMBean");
List<String> paths = new ArrayList<String>();
paths.add("/zosConnect/banking/bind/customer.bnd");
paths.add("/zosConnect/banking/reqSchema/customer_request.json");
paths.add("/zosConnect/banking/respSchema/customer_response.json");
Object[] params = new Object[] { null, paths, null };
mbsc.invoke(fileMonitorMBeanName, "notifyFileChanges", params, MBEAN_METHOD_SIGNATURE);
Im Beispiel wird das Feature restConnector-1.0 verwendet, um die Aktualisierung der Dateien
customer.bnd, customer_request.json und customer_response.json auszulösen. Weitere Informationen zum erstellen einer sicheren JMX-Verbindung finden Sie in der Dokumentation zu Sichere JMX-Verbindung zu Liberty konfigurieren.