For z/OS platforms

Enabling the Liberty server environment to use optimized local adapters

You must enable the Liberty server to receive inbound and outbound requests by using the optimized local adapters support. WebSphere optimized local adapters (WOLA) for z/OS are a set of callable services (APIs) that give native z/OS applications the ability to make inbound calls to application server enterprise beans and enable native programs to act as a server and accept requests from applications that run in the Liberty server.

Avant de commencer

Install the zosLocalAdapters-1.0 feature in your Liberty environment. For more information, see Installation d'actifs Référentiel Liberty.

Procédure

  1. Attribuez ou sélectionnez une bibliothèque de modules de chargement pour contenir les modules de chargement des adaptateurs locaux optimisés. Cette bibliothèque est utilisée par les applications qui s'exécutent hors du serveur Liberty. Il doit s'agir d'un ensemble de données partitionnées étendu (PDS-E) qui requiert environ 40 pistes (3390) pour accueillir les modules d'adaptateur local optimisé.
  2. Copiez les modules de chargement des adaptateurs locaux optimisés depuis wlp/clients/zos/* dans la bibliothèque des modules de chargement. L'exemple suivant copie des modules de chargement dans l'ensemble de données $DSNAME :
    cp -Xv wlp/clients/zos/* "//'$DSNAME'" 
  3. Pour activer la prise en charge des adaptateurs locaux optimisés sur le serveur Liberty, configurez la fonction zosLocalAdapters-1.0 dans le fichier server.xml.
    1. Pour activer la fonction zosLocalAdapters-1.0, ajoutez-la dans le fichier server.xml conformément à l'exemple suivant :
      <featureManager>
        <feature>zosLocalAdapters-1.0</feature>
      </featureManager>
    2. Créez un groupe WOLA en configurant un élément zosLocalAdapters avec un nom de groupe WOLA à trois parties dans le fichier server.xml. Le nom de groupe WOLA à trois parties est utilisé par les clients pour se connecter au serveur Liberty. Chaque partie doit comporter 1 à 8 caractères alphanumériques.
      Remarque : N'utilisez pas de caractères en minuscule dans le nom de groupe WOLA. Le sous-système de sécurité z/OS convertit les caractères en minuscule en majuscule, ce qui peut provoquer une non-concordance avec votre configuration.
      <zosLocalAdapters wolaGroup="LIB1" wolaName2="LIB2" wolaName3="LIB3"/>
  4. Configurez une fabrique de connexions en ajoutant un élément connectionFactory au fichier server.xml et en spécifiant ses propriétés dans un élément properties.ola.
    <connectionFactory jndiName="eis/ola">
     <properties.ola RegisterName="OLASERVER"/>
    </connectionFactory>
    Pour des informations sur les propriétés de fabrique de connexions WOLA, voir Propriétés de la fabrique de connexions pour les adaptateurs locaux optimisés sur Liberty.
  5. Créez des profils SERVER pour z/OS.
    1. Créez des profils SERVER pour le service autorisé de l'adaptateur local optimisé. Utilisez les commandes des options d'exploitation en temps partagé (TSO) suivantes :
      RDEF SERVER BBG.AUTHMOD.BBGZSAFM.LOCALCOM UACC(NONE)
      PERMIT BBG.AUTHMOD.BBGZSAFM.LOCALCOM CLASS(SERVER) ACCESS(READ) ID(wlpuser1)
      RDEF SERVER BBG.AUTHMOD.BBGZSAFM.WOLA UACC(NONE)
      PERMIT BBG.AUTHMOD.BBGZSAFM.WOLA CLASS(SERVER)ACCESS(READ) ID(wlpuser1)
    2. Créez un profil SERVER pour le module client autorisé BBGZSCFM et autorisez l'ID utilisateur de la tâche démarrée du serveur Liberty pour le profil. Cette action permet à un serveur Liberty de charger les services client autorisés z/OS. Pour permettre à un serveur s'exécutant comme WLPUSER1 d'accéder au module client autorisé :
      RDEF SERVER BBG.AUTHMOD.BBGZSCFM UACC(NONE)
      PERMIT BBG.AUTHMOD.BBGZSCFM CLASS(SERVER) ACCESS(READ) ID(wlpuser1)
    3. Créez des profils SERVER pour le service client autorisé de l'adaptateur local optimisé. Utilisez les commandes TSO suivantes :
      RDEF SERVER BBG.AUTHMOD.BBGZSCFM.WOLA UACC(NONE)
      PERMIT BBG.AUTHMOD.BBGZSCFM.WOLA CLASS(SERVER) ACCESS(READ) ID(wlpuser1)
    Pour plus d'informations, voir Activation des services autorisés z/OS sur Liberty for z/OS.
  6. Si CBIND est activé dans la fonction d'autorisation système (SAF), accordez l'accès aux clients qui vont utiliser les adaptateurs locaux optimisés.
    1. Définissez un profil pour le serveur Liberty dans la classe CBIND. Le nom de profil est BBG.WOLA.<WOLA1>.<WOLA2>.<WOLA3>, où WOLA1, WOLA2 et WOLA3 sont les trois parties du nom de groupe d'adaptateur local optimisé qui sont spécifiées dans l'élément <zosLocalAdapters> dans le fichier server.xml. Vous pouvez définir un profil en utilisant la commande TSO RDEFINE de la fonction d'autorisation système (SAF). Par exemple, la commande suivante crée un profil dans la classe CBIND pour un groupe WOLA nommé LIB1.LIB2.LIB3 :
      RDEF CBIND BBG.WOLA.LIB1.LIB2.LIB3 UACC(NONE)
    2. Accordez l'accès READ au profil. Par exemple, la commande suivante autorise l'accès en lecture pour le nom d'utilisateur nom_utilisateur sur le profil bbg.wola.lib1.lib2.lib3 :
      PERMIT BBG.WOLA.LIB1.LIB2.LIB3 CLASS(CBIND) ACCESS(READ) ID(username)
      Vous pouvez utiliser des astérisques pour autoriser un accès utilisateur à plusieurs profils. L'exemple suivant autorise l'accès READ à l'utilisateur nom_utilisateur pour tous les profils qui commencent par bbg.wola dans la classe CBIND :
      RDEF CBIND BBG.WOLA.* UACC(NONE)
      PERMIT BBG.WOLA.* CLASS(CBIND) ACCESS(READ) ID(username)
    Pour plus d'informations sur les commandes et la syntaxe SAF, voir la documentation de votre version de z/OS.

Résultats

A présent, vous pouvez déployer et démarrer des applications qui utilisent des adaptateurs locaux optimisés sur le serveur Liberty.

Que faire ensuite

Assurez-vous que toutes les connexions externes qui utilisent les adaptateurs locaux optimisés exécutent la version la plus récente de la bibliothèque des modules de chargement des adaptateurs locaux optimisés. Un client, tel qu'un serveur de liaison WOLA, doit utiliser les bibliothèques de programme de l'installation Liberty la plus récente qui soit susceptible de se connecter à lui. En outre, sauf indication contraire d'IBM®, les clients tels que le serveur de liaison WOLA sont compatibles avec les anciennes versions des bibliothèques de client WOLA.
  1. Assurez-vous que le niveau de la bibliothèque des modules de chargement est le plus récent.
  2. Assurez-vous que la bibliothèque est disponible pour tous les espaces adresse externes qui utilisent les adaptateurs locaux personnalisés. Par exemple, assurez-vous que la bibliothèque est disponible dans STEPLIB pour les travaux par lots ou dans la concaténation DFHRPL pour CICS (Customer Information Control System).

Si vous voulez utiliser les adaptateurs locaux optimisés avec CICS, vous devez activer la prise en charge des adaptateurs dans CICS. Pour plus d'informations, voir Activation de la prise en charge des adaptateurs locaux optimisés de Liberty dans CICS.

Si vous souhaitez utiliser les adaptateurs locaux optimisés avec IMS, vous devez activer la prise en charge des adaptateurs dans IMS. Pour plus d'informations, voir Activation de la prise en charge des adaptateurs locaux optimisés de Liberty dans IMS..

Si vous voulez créer une connexion, commencez par enregistrer l'espace adresse externe sur le serveur Liberty. Pour plus d'informations, voir Enregistrement d'un espace adresse externe sur un serveur Liberty local à l'aide d'adaptateurs locaux optimisés.


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

Nom du fichier : twlp_dat_enableconnector.html