Définition de services z/OS Connect

Les définitions de service z/OS® Connect fournissent le mécanisme d'accès aux actifs de l'application z/OS à l'aide d'appels REST. Pour activer ces services, vous devez ajouter une définition de service z/OS Connect au fichier server.xml de Liberty en indiquant le nom d'élément zosConnectService ainsi qu'un nom d'élément de référence et un fournisseur de service.

Pourquoi et quand exécuter cette tâche

Les services z/OS Connect sont définis par l'élément de configuration zosConnectService. Cet élément contient des définitions d'attributs pouvant avoir des contreparties définies au niveau global. Des attributs peuvent être définis globalement via l'élément zosConnectManager . Ces attributs, s'ils ont été définis, s'appliquent à tous les services. Si des attributs globaux tout comme des attributs au niveau du service ont été définis, les valeurs définies au niveau zosConnectService sont utilisées.

z/OS Connect fournit une implémentation de service qui permet aux requêtes z/OS Connect d'interagir avec des actifs z/OS via WOLA (WebSphere Optimized Local Adapters). Le service est automatiquement activé lorsque les fonctions zosConnect-1.0 et zosLocalAdapters-1.0 sont toutes deux configurées. Des instances de ce service peuvent être définies via l'élément de configuration localAdaptersConnectService.

z/OS Connect fournit également une implémentation de service autorisant les demandes z/OS Connect à contacter des noeuds finaux REST distants. Le service est disponible quand la fonction zosConnect-1.2 est configurée. Des instances de ce service peuvent être définies via l'élément de configuration zosConnectServiceRestClient. Pour plus d'informations, voir la documentation relative au service de client REST z/OS Connect.

Procédure

  1. Ajoutez un élément de configuration zosConnectService pour chaque service dans votre configuration server.xml. Vous devez configurer au minimum les attributs serviceRef et serviceName. L'élément serviceRef pointe vers l'élément de configuration du fournisseur de services. L'attribut serviceName est ce par quoi le fournisseur de services s'identifie auprès de z/OS Connect et représente également le nom à utiliser comme partie de l'URL pour les requêtes z/OS Connect ciblant un service spécifique. Le nom de service doit être unique. Ci-après figure un exemple de fichier server.xml illustrant comment ajouter un service z/OS Connect nommé recordOpsCreate :
    <!-- Définitions de service z/OS Connect --> 
    <zosConnectService id="zcs1"  
    	serviceName="recordOpsCreate"  
    	serviceRef="wolaCreateService"/> 
    Pour plus d'informations sur les définitions d'attribut configurables associées aux paramètres de l'élément zosConnectService, voir la documentation relative à la fonction z/OS Connect.
  2. (Facultatif) Ajoutez l'élément de configuration zosConnectManager au fichier server.xml.

    Cet élément est un singleton dans le fichier de configuration server.xml et contient des valeurs globales qui s'appliquent à tous les services z/OS Connect définis pour le serveur. L'élément peut contenir les noms d'intercepteurs z/OS Connect ou d'éléments de configuration de fournisseur de transformation des données qui s'appliquent à tous les services du serveur.

    L'exemple suivant décrit un élément de configuration zosConnectManager définissant un groupe d'opérations nommé Operator1 sous l'élément globalOperationsGroup. Il s'agit du nom du groupe de sécurité (SAF ou LDAP) auquel doit être rattaché l'ID du client demandeur pour que des demandes d'opérations z/OS Connect (telles que action=start|stop|status) puissent être autorisées. Ce groupe s'applique à tous les services dans les configurations z/OS Connect. L'entrée dataxform définit le nom d'élément où z/OS Connect trouvera un fournisseur de transformation de données. L'entrée dataxform dans l'élément zosConnect indique qu'il s'agit d'une implémentation de fournisseur de transformation pour tous les services dans la configuration qui n'ont pas encore leur propre référence d'élément de transformation de données. L'entrée interceptors est le nom de l'élément dans la configuration qui décrit le jeu d'intercepteurs z/OS Connect qui s'appliquent à tous les services dans la configuration.

    <zosConnectManager id="zosConnectGlobals"  
    	globalOperationsGroup="Operator1"  
    	globalDataxformRef="XformJSON2Byte"  
    	globalInterceptorsRef="GlobalInterceptors"/> 

    Pour plus d'informations sur les définitions d'attribut configurables associées aux paramètres de l'élément zosConnectManager, voir la documentation relative à la fonction z/OS Connect.

    Pour plus d'informations sur chaque attribut, reportez-vous à la documentation des fonctions Liberty.
  3. Si WOLA est configuré dans Liberty, la configuration d'une demande requiert un élément de configuration localAdaptersConnectService dans le fichier server.xml. Cette configuration est composée au minimum du nom de la fabrique de connexions WOLA, du nom de registre et du nom du service. La configuration de z/OS Connect suit les conventions Liberty en requérant uniquement de spécifier les paramètres minimum. Notez que lorsque vous configurez une fabrique de connexions WOLA pour interaction avec z/OS Connect, vous devez utiliser un conteneur comme mécanisme d'authentification. Les fabriques de connexions WOLA qui ne spécifient pas un attribut containerAuthDataRef ne sont pas prises en charge. Voici un exemple :
    <!-- Définition de fabrique de connexions d'adaptateurs locaux --> 
    <authData id="cauth1" user="user1" password="{xor}LDo8Ki02KyY="/> 
    <connectionFactory id="wolaCF" jndiName="eis/ola"        
    	containerAuthDataRef="cauth1"  >       
    	<properties.ola/> 
    </connectionFactory>     
    
    <!-- Configuration des adaptateurs locaux --> 
    <zosLocalAdapters wolaGroup="LIBERTY" wolaName2="LIBERTY"         
    	wolaName3="LIBERTY" /> 
    
    <!-- Définitions de service WOLA Connect et de service z/OS Connect --> 
    <localAdaptersConnectService id="wolaOpsCreate"             
    	registerName="BATCH01"   
    	serviceName="COBLPGM1"   
    	connectionFactoryRef="wolaCF"/> 
    
    <zosConnectService id="zcs1" serviceName="recordOpsCreate"    
    	serviceRef="wolaOpsCreate"   
    	runGlobalInterceptors="true"    
    	interceptorsRef="serviceInterceptorList"/> 

    L'implémentation du service z/OS Connect qui permet aux requêtes z/OS Connect d'interagir avec des actifs z/OS via WOLA (WebSphere Optimized Local Adapters) peut nécessiter un transformateur de données. Si un transformateur de données a été configuré, globalement ou au niveau du service, le contenu des entrées et des sorties est converti à l'aide du transformateur de données configuré. Si un transformateur de données n'a pas été configuré, et que la requête contient un contenu JSON, le service suppose que le programme dorsal se chargera de la conversion des données. Le service convertit le contenu JSON en tableau d'octets en utilisant le codage spécifié dans l'en-tête de la requête ou le codage JSON par défaut (UTF-8). De la même manière, si l'actif renvoie un contenu et qu'aucun transformateur de données n'a été configuré, l'implémentation du service WOLA s'attend à recevoir un contenu JSON sous forme de tableau d'octets, lequel est converti en contenu de réponse JSON d'après les mêmes règles de codage que celles utilisées pour transformer un contenu de requête JSON en tableau d'octets.

    L'implémentation du fournisseur de service WOLA permet de spécifier plusieurs définitions de fabriques de connexions dans son élément de configuration localAdaptersConnectService. Le tableau suivant contient une liste de définitions d'attributs localAdaptersConnectService et une description de chacun.

    Définition d'attribut Description

    serviceName

    required="true"

    type="String"

    Nom du service WOLA cible. Ce nom de service doit correspondre au nom qu'une application d'espace adresse externe utilise pour le nom du service sur une requête WOLA Receive ou un appel d'API de service hôte, ou encore au nom de programme utilisé pour SVC avec un serveur de liaison WOLA CICS.

    registerName

    required="true"

    type="String"

    Nom de l'enregistrement cible WOLA. Cet enregistrement cible doit correspondre au nom qu'une application d'espace adresse externe utilise pour le nom de registre sur un appel d'API WOLA Register ou au nom utilisé pour RGN avec un serveur de liaison WOLA CICS.

    connectionFactoryRef

    required="true"

    type="String"

    Nom de l'élément de fabrique de connexions avec le nom JNDI de la fabrique de connexions d'adaptateur de ressources WOLA à utiliser. Pour plus d'informations, reportez-vous à la documentation de l'adaptateur de ressources Liberty WOLA.

    connectionWaitTimeout

    required="false"

    type="Integer"

    min="0"

    max="2147483647"

    Nombre de secondes d'attente qu'une application d'espace adresse externe correspondant au nom d'enregistrement émette une requête WOLA Receive ou une API de service hôte et devienne active. Pour plus d'informations, reportez-vous à la documentation de l'adaptateur de ressources Liberty WOLA.

    linkTaskTranID

    required="false"

    type="String"

    Spécifie le nom de l'ID de transaction de tâche d'appel de serveur de liaison WOLA CICS. Pour plus d'informations, reportez-vous à la documentation de l'adaptateur de ressources Liberty WOLA.

    useCICSContainer

    required="false"

    type="Boolean"

    default="false"

    Lors d'une utilisation du serveur de liaison WOLA CICS, indique si le contenu est transmis au programme d'application CICS cible dans un seul conteneur CICS ou via un objet COMMAREA. Pour plus d'informations, reportez-vous à la documentation de l'adaptateur de ressources Liberty WOLA.

    linkTaskTranID

    required="false"

    type="String"

    Lors d'une utilisation du serveur de liaison WOLA CICS alors que l'indicateur useCICSContainer est défini à true, spécifie le nom du conteneur de requête CICS cible. Pour plus d'informations, reportez-vous à la documentation de l'adaptateur de ressources Liberty WOLA.

    linkTaskReqContType

    type="Integer"

    min="0"

    default="0"

    Lors d'une utilisation du serveur de liaison WOLA CICS alors que l'indicateur useCICSContainer est défini à true, spécifie le type du conteneur de requête CICS cible (0=CHAR, 1=BIT). Pour plus d'informations, reportez-vous à la documentation de l'adaptateur de ressources Liberty WOLA.

    linkTaskRspContID

    required="false"

    type="String"

    Lors d'une utilisation du serveur de liaison WOLA CICS alors que l'indicateur useCICSContainer est défini à true, spécifie le nom du conteneur de réponse CICS cible. Pour plus d'informations, reportez-vous à la documentation de l'adaptateur de ressources Liberty WOLA.

    linkTaskRspContType

    type="Integer"

    min="0"

    default="0"

    Lors d'une utilisation du serveur de liaison WOLA CICS alors que l'indicateur useCICSContainer est défini à true, spécifie le type du conteneur de réponse CICS cible (0=CHAR, 1=BIT). Pour plus d'informations, reportez-vous à la documentation de l'adaptateur de ressources Liberty WOLA.

    linkTaskChanID

    required="false"

    type="String"

    Lors d'une utilisation du serveur de liaison WOLA CICS, spécifie le nom de canal CICS à utiliser pour les messages envoyés et les messages de réponse reçus à l'aide de conteneurs CICS. Pour plus d'informations, reportez-vous à la documentation de l'adaptateur de ressources Liberty WOLA.

    linkTaskChanType

    required="false"

    type="Integer"

    min="0"

    default="0"

    Lors d'une utilisation du serveur de liaison WOLA CICS en spécifiant le nom du canal linkTaskChanID, spécifie le type des conteneurs CICS cibles associés à ce canal (0=CHAR, 1=BIT). Pour plus d'informations, reportez-vous à la documentation de l'adaptateur de ressources Liberty WOLA.

Icône indiquant le type de rubrique Rubrique Tâche



Icône d'horodatage Dernière mise à jour: 7 juin 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_zconnect_srvcdef
Nom du fichier : twlp_zconnect_srvcdef.html