z/OS® Connect-Servicedefinitionen stellen den Mechanismus für das Erreichen von z/OS-Anwendungsassets über REST-Aufrufe bereit.
Zum Aktivieren von z/OS Connect-Services müssen Sie der Libertydatei server.xml eine z/OS Connect-Servicedefinition mit dem
Elementnamen zosConnectService und einem Namen sowie einem Service-Provider-Referenzelementnamen hinzufügen.
Informationen zu diesem Vorgang
z/OS Connect-Services werden vom Konfigurationselement zosConnectService
definiert. Dieses Element enthält Attributdefinitionen, die global definierte Entsprechungen haben können.
Attribute können global mit dem Element zosConnectManager definiert werden. Diese Attribute
gelten (sofern angegeben) für alle Services. Wenn die globalen Attribute und die Attribute auf Serviceebene konfiguriert sind,
werden die auf der Ebene zosConnectService verwendeten
Werte verwendet.
z/OS Connect stellt eine Serviceimplementierung bereit, die ermöglicht, dass
z/OS Connect-Anforderungen über
WebSphere Optimized Local Adapters (WOLA) mit z/OS-Assets interagieren. Der Service wird automatisch aktiviert, wenn
die Features zosConnect-1.0 und zosLocalAdapters-1.0
konfiguriert werden.
Instanzen dieses Service können über das Konfigurationselement
localAdaptersConnectService definiert werden.
z/OS Connect stellt auch eine Serviceimplementierung bereit, die ermöglicht, dass z/OS Connect-Anforderungen ferne REST-Endpunkte kontaktieren. Der Service ist verfügbar, wenn das Feature zosConnect-1.2 konfiguriert ist. Instanzen dieses Service können über das Konfigurationselement zosConnectServiceRestClient definiert werden. Weitere Informationen finden Sie in der Dokumentation unter z/OS Connect-REST-Client-Service.
- Fügen Sie für jeden Service in Ihrer Konfigurationsdatei server.xml ein Konfigurationselement zosConnectService
hinzu. Sie müssen mindestens die Attribute "serviceRef" und "serviceName"
konfigurieren. Das Element "serviceRef" verweist auf das Konfigurationselement des Service-Providers.
Das Attribut "serviceName" beschreibt, wie der Service-Provider sich selbst
bei z/OS Connect angibt, und ist außerdem der Name,
der als Teil der URL für z/OS Connect-Anforderungen verwendet werden soll, die auf einen bestimmten Service
abzielen. Der Servicename muss eindeutig sein. Im Folgenden sehen Sie eine Beispieldatei vom Typ
server.xml, die zeigt, welche Elemente einem
z/OS Connect-Service mit dem Namen "recordOpsCreate" hinzugefügt werden müssen:
<!-- z/OS Connect-Servicedefinitionen -->
<zosConnectService id="zcs1"
serviceName="recordOpsCreate"
serviceRef="wolaCreateService"/>
Weitere Informationen zu den konfigurierbaren
Attributdefinitionen, die dem Element zosConnectService zugeordnet sind, finden Sie in der Dokumentation zum Feature
z/OS Connect.
- (Optional) Fügen Sie der Datei server.xml das Konfigurationselement zosConnectManager
hinzu.
Dieses Element ist ein Singleton
in der Konfigurationsdatei server.xml und enthält globale Werte, die für alle
z/OS Connect-Services gelten, die für den Server definiert sind.
Das Element kann die Namen von
z/OS Connect-Interceptors oder Konfigurationselemente für den Datentransformationsprovider
enthalten, die für alle Services im Server gelten.
Das folgende Beispiel beschreibt das Konfigurationselement zosConnectManager, das
den Operationsgruppennamen "Operator1" unter dem Element
"globalOperationsGroup" definiert. Dies ist der Name der Sicherheitsgruppe (SAF oder LDAP),
zu der die Benutzer-ID des anfordernden Clients gehören muss, damit z/OS
Connect-Operationsanforderungen zulässig sind, z. B. action=start|stop|status.
Diese Gruppe gilt für alle Services in den z/OS Connect-Konfigurationen.
Das Element "dataxform" definiert den Elementnamen, unter dem z/OS Connect
einen Datentransformationsprovider finden kann. Wird dataxform im Element
"zosConnect" angegeben, bedeutet das, dass dies die Transformationsproviderimplementierung
für alle Services in der Konfiguration ist, die noch keinen eigenen
Elementverweis für die Datentransformation haben. Das Interceptorelement ist der Name des Elements in der Konfiguration, das den Satz von z/OS Connect-Interceptors beschreibt, die für alle
Services in der Konfiguration gelten.
<zosConnectManager id="zosConnectGlobals"
globalOperationsGroup="Operator1"
globalDataxformRef="XformJSON2Byte"
globalInterceptorsRef="GlobalInterceptors"/>
Weitere Informationen zu den konfigurierbaren
Attributdefinitionen, die dem Element zosConnectManager zugeordnet sind, finden Sie in der Dokumentation zum Feature
z/OS Connect.
Weitere Informationen zu jedem Attribut finden Sie in der Dokumentation zu den Liberty-Features.
- Wenn WOLA in Lilberty konfiguriert ist, setzt die Konfiguration für einen Anforderung
das Konfigurationselement localAdaptersConnectService
in der Datei server.xml voraus. Diese Konfiguration besteht mindestens aus dem
Zielnamen der WOLA-Verbindungsfactory, dem Registrierungsnamen und dem Servicenamen.
Die Konfiguration von z/OS Connect folgt den Liberty-Konventionen, d. h., es müssen nur die Mindestparameter
angegeben werden. Beachten Sie, dass Sie bei der Konfiguration einer WOLA-Verbindungsfactory
für die z/OS Connect-Interaktion einen Container als Authentifizierungsmechanismus verwenden müssen. WOLA-Verbindungsfactorys, die kein
containerAuthDataRef-Attribut angeben, werden nicht unterstützt.
Beispiel:
<!-- Definition der Verbindungsfactory für lokale Adapter -->
<authData id="cauth1" user="user1" password="{xor}LDo8Ki02KyY="/>
<connectionFactory id="wolaCF" jndiName="eis/ola"
containerAuthDataRef="cauth1" >
<properties.ola/>
</connectionFactory>
<!-- Konfiguration lokaler Adapter -->
<zosLocalAdapters wolaGroup="LIBERTY" wolaName2="LIBERTY"
wolaName3="LIBERTY" />
<!-- WOLA Connect- und z/OS Connect-Servicedefinitionen -->
<localAdaptersConnectService id="wolaOpsCreate"
registerName="BATCH01"
serviceName="COBLPGM1"
connectionFactoryRef="wolaCF"/>
<zosConnectService id="zcs1" serviceName="recordOpsCreate"
serviceRef="wolaOpsCreate"
runGlobalInterceptors="true"
interceptorsRef="serviceInterceptorList"/>
Die z/OS
Connect-Serviceimplementierung, die ermöglicht, dass z/OS Connect-Anforderungen
mit z/OS-Assets über WebSphere Optimized Local Adapters
(WOLA) interagieren, erfordern möglicherweise einen Datentransformer. Wenn ein Datentransformer
konfiguriert ist (global oder auf Serviceebene), werden Eingabe- und Ausgabenutzdaten mit dem konfigurierten
Datentransformer konvertiert. Wenn kein Datentransformer
konfiguriert ist und die Anforderung JSON-Nutzdaten enthält, geht der Service davon aus,
dass das Ausgabeprogramm die Datenkonvertierung vornimmt.
Der Service konvertiert die JSON-Nutzdaten unverändert in ein Byte-Array und verwendet dafür
die im Anforderungsheader angegebene Verschlüsselung oder die JSON-Standardverschlüsselung
"UTF-8". Wenn das Asset Nutzdaten zurückgibt und kein Datentransformer
konfiguriert ist, erwartet die WOLA-Serviceimplementierung den Empfang
von JSON-Nutzdaten als Byte-Array, das denselben Verschlüsselungsregeln folgend, die auch für die Transformation
von
JSON-Anforderungsnutzdaten in ein Byte-Array verwendet werden, in JSON-Antwortnutzdaten konvertiert wird.
Die WOLA-Service-Provider-Implementierung ermöglicht die Angabe eine Reihe weiterer
WOLA-Verbindungsfactory-Definitionen im
zugehörigen Konfigurationselement localAdaptersConnectService.
Die folgende Tabelle ist eine Liste mit localAdaptersConnectService-Attributdefinitionen und
jeweils einer zugehörigen Beschreibung.
| Attributdefinition |
Beschreibung |
serviceName
required="true"
type="String"
|
Name des WOLA-Zielservice. Dieser Servicename muss mit dem Namen
übereinstimmen, den eine externe Adressraumanwendung als Servicenamen
bei einem WOLA-Aufruf der API "Receive Request" oder "Host Service" verwendet, oder mit dem Namen, der für
SVC mit einem WOLA-CICS-Link-Server verwendet wird. |
registerName
required="true"
type="String"
|
Der Name der WOLA-Zielregistrierung. Diese Zielregistrierung muss mit dem Namen
übereinstimmen, den eine externe Adressraumanwendung als Registrierungsnamen
bei einem WOLA-Aufruf der API "Register" verwendet, oder mit dem Namen, der für
RGN mit einem WOLA-CICS-Link-Server verwendet wird. |
connectionFactoryRef
required="true"
type="String"
|
Der Name des Verbindungsfactory-Elements mit dem JNDI-Namen der zu verwendenden Verbindungsfactory für den
WOLA-Ressourcenadapter. Weitere Informationen hierzu finden Sie in der
Liberty-Dokumentation zum WOLA-Ressourcenadapter. |
connectionWaitTimeout
required="false"
type="Integer"
min="0"
max="2147483647"
|
Die Anzahl der Sekunden, für die auf eine externe Adressraumanwendung gewartet wird, die mit dem
Registrierungsnamen zum Absetzen und Aktivieren eines WOLA-Aufrufs der API "Receive Request"
oder "Host Service" verwendet wird. Weitere Informationen hierzu finden Sie in der
Liberty-Dokumentation zum WOLA-Ressourcenadapter. |
linkTaskTranID
required="false"
type="String"
|
Gibt den Namen der Transaktions-ID für die Linkaufruftask des WOLA-CICS-Link-Servers an.
Weitere Informationen hierzu finden Sie in der
Liberty-Dokumentation zum WOLA-Ressourcenadapter. |
useCICSContainer
required="false"
type="Boolean"
default="false"
|
Wird der WOLA-CICS-Link-Server verwendet, gibt dieses Attribut an, ob die Nutzdaten
in einem einzelnen CICS-Container oder in einem Kommunikationsbereich an das
CICS-Zielanwendungsprogramm übergeben werden. Weitere Informationen hierzu finden Sie in der
Liberty-Dokumentation zum WOLA-Ressourcenadapter. |
linkTaskTranID
required="false"
type="String"
|
Wird der WOLA-CICS-Link-Server verwendet und ist das Flag "useCICSContainer"
auf true gesetzt, gibt dieses Attribut den Namen des
CICS-Zielanforderungscontainers an. Weitere Informationen hierzu finden Sie in der
Liberty-Dokumentation zum WOLA-Ressourcenadapter. |
linkTaskReqContType
type="Integer"
min="0"
default="0"
|
Wird der WOLA-CICS-Link-Server verwendet und ist das Flag "useCICSContainer"
auf true gesetzt, gibt dieses Attribut den Typ des
CICS-Zielanforderungscontainers (0=CHAR, 1=BIT) an. Weitere Informationen hierzu finden Sie in der
Liberty-Dokumentation zum WOLA-Ressourcenadapter. |
linkTaskRspContID
required="false"
type="String"
|
Wird der WOLA-CICS-Link-Server verwendet und ist das Flag "useCICSContainer"
auf true gesetzt, gibt dieses Attribut den Namen des
CICS-Zielantwortcontainers an. Weitere Informationen hierzu finden Sie in der
Liberty-Dokumentation zum WOLA-Ressourcenadapter. |
linkTaskRspContType
type="Integer"
min="0"
default="0"
|
Wird der WOLA-CICS-Link-Server verwendet und ist das Flag "useCICSContainer"
auf true gesetzt, gibt dieses Attribut den Typ des
CICS-Zielantwortcontainers (0=CHAR, 1=BIT) an. Weitere Informationen hierzu finden Sie in der
Liberty-Dokumentation zum WOLA-Ressourcenadapter. |
linkTaskChanID
required="false"
type="String"
|
Wird der WOLA-CICS-Link-Server verwendet, gibt dieses Attribut den CICS-Kanalnamen
an, der für die Zustellung von Nachrichten und den Empfang von Antwortnachrichten
mit CICS-Containern verwendet werden soll. Weitere Informationen hierzu finden Sie in der
Liberty-Dokumentation zum WOLA-Ressourcenadapter. |
linkTaskChanType
required="false"
type="Integer"
min="0"
default="0"
|
Wird der WOLA-CICS-Link-Server verwendet und der Kanalname linkTaskChanID
angegeben, gibt dieses Attribut den Typ der CICS-Zielcontainer an,
die dem Kanal zugeordnet sind (0=CHAR, 1=BIT). Weitere Informationen hierzu finden Sie in der
Liberty-Dokumentation zum WOLA-Ressourcenadapter. |