z/OS Connect-Services definieren

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.

Vorgehensweise

  1. 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.
  2. (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.
  3. 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.

Symbol das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 16.06.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_zconnect_srvcdef
Dateiname: twlp_zconnect_srvcdef.html