For z/OS platforms

Activation de la prise en charge des adaptateurs locaux optimisés de Liberty dans CICS

Vous devez activer l'environnement CICS (Customer Information Control System) afin de recevoir les demandes entrantes et sortantes avec WebSphere Optimized Local Adapters (WOLA).

Avant de commencer

Activez votre environnement de serveur Liberty afin d'utiliser des adaptateurs locaux optimisés. Pour plus d'informations, voir Enabling the Liberty server environment to use optimized local adapters.

Procédure

  1. Ajoutez les définitions de ressource CICS pour les adaptateurs locaux optimisés au fichier de définition de système CICS (CSD) principal, DFHCSD. Vous pouvez ajouter les définitions manuellement dans CICS ou télécharger et exécuter l'exemple CSUPDAT.
    • Dans CICS, utilisez la transaction CEDA ou une transaction équivalente pour ajouter les définitions à DFHCSD. Voir Définitions d'adaptateur local optimisé pour CICS pour prendre connaissance des définitions requises.
    • Utilisez le programme de mise à jour du fichier CSD hors ligne de CICS, DFHCSDUP, pour ajouter les définitions à DFHCSD. Pour plus d'informations sur le programme DFHCSDUP, voir la documentation de votre version de CICS. Voir Définitions d'adaptateur local optimisé pour CICS pour prendre connaissance des définitions requises.
    • Mettez à jour les définitions en exécutant l'exemple de travail CSDUPDAT.jclsamp.
      1. Téléchargez les exemples d'adaptateur local optimisé. Pour plus d'informations sur le téléchargement et l'installation des exemples, voir Exemples d'adaptateur local optimisé pour Liberty.
      2. Copiez les exemples et le membre CSDUPDAT dans un ensemble de données.
      3. Personnalisez l'exemple de travail CSDUPDAT.jclsamp pour votre environnement. Par exemple, dans l'exemple de travail, entrez le nom de l'ensemble de données dans lequel se trouve le CSD.
      4. Exécutez l'exemple de travail CSDUPDAT.jclsamp.
  2. Copiez les modules de chargement et les fichiers DLL qui sont requis pour CICS depuis le système hiérarchique de fichiers (HFS) ou depuis le système de fichiers zSeries (sFS) de Liberty dans un ensemble de données partitionnées en vue de leur utilisation dans CICS. L'exemple suivant copie des modules de chargement dans l'ensemble de données $DSNAME :
    cp -Xv wlp/clients/zos/* "//'$DSNAME'" 
  3. Placez l'ensemble de données dans la concaténation CICS DFHRPL.
  4. Configurez le catalogue de messages Liberty dans la région CICS. Les programmes des adaptateurs locaux optimisés émettent des messages provenant d'un catalogue de messages fourni avec Liberty. Pour que les programmes puissent émettre des messages, la variable d'environnement NLSPATH dans la région CICS doit désigner le répertoire contenant le catalogue de messages. Ce répertoire est wlp/lib/native/zos/s390x/nls/%N.cat, où wlp est le répertoire dans lequel est installé le serveur Liberty.

    Pour définir la variable d'environnement, utilisez l'option Language Environment ENVAR, que vous pouvez définir en éditant l'élément CEEROPT CSECT que la région CICS utilise. Après avoir éditer l'élément CSECT, vous pouvez générer, compiler, lier et copier l'élément CSECT dans l'ensemble de données DFHRPL. Pour plus d'informations sur les autres façons de définir des options Language Environment, voir la documentation de votre version de CICS.

    Remarque : Les façons de définir les options Language Environment qui impliquent l'édition du code source de l'application ou une nouvelle liaison de l'application ne sont pas prises en charge car les programmes des adaptateurs locaux optimisés ne peuvent pas être compilés ni liés à nouveau.
    L'exemple suivant présente un élément CEEROPT CSECT qui définit la variable d'environnement NLSPATH pour un serveur Liberty installé dans /u/MSTONE1/wlp. La définition apparaît sur deux lignes et inclut un caractère de continuation, X, à la colonne 72.
    CEEROPT CSECT
    CEEROPT AMODE ANY
    CEEROPT RMODE ANY
    *****************************************************************
    *
    * Utility: CEEROPT
    * Purpose: Set default LE runtime options for CICS region.
    *
    *****************************************************************
            CEEXOPT ENVAR=(('NLSPATH=/u/MSTONE1/wlp/lib/native/zos/s390x/nlX
                   s/%N.cat'),OVR)
            END
  5. Sécurisez vos connexions d'adaptateur local optimisé en effectuant les actions suivantes :
    • Créez des profils SERVER pour z/OS.
    • 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.

    Pour plus d'informations, voir Sécurisation des adaptateurs locaux optimisés pour la prise en charge des appels entrants sur Liberty for z/OS.

  6. Démarrez le programme d'exit utilisateur associé à une tâche (TRUE) des adaptateurs locaux optimisés.

    Vous pouvez démarrer le programme TRUE avec BBOC, une transaction d'adaptateurs locaux optimisés pour CICS. Vous pouvez utiliser cette transaction pour démarrer, arrêter, activer et désactiver la fonction de trace pour le module TRUE. Le nom du programme TRUE est BBOATRUE ; vous l'activez à l'aide de la transaction BBOC avec le paramètre START_TRUE.

    Lorsque la sécurité CICS est activée, l'ID utilisateur pour lequel les paramètres BBOC START_TRUE et STOP_TRUE s'exécutent doit disposer des droits permettant d'émettre des commandes EXEC CICS ENABLE PROGRAM(BBOATRUE) et DISABLE PROGRAM(BBOATRUE) EXITALL. Les messages qui sont émis par le serveur Liberty dans CICS sont acheminés vers une file d'attente de données transitoires (TDQ) d'extra-partition BBOQ qui est allouée sous DD BBOOUT dans la région CICS.

    Pour plus d'informations, voir Transactions de serveur Liberty pour CICS : BBOC, BBO$ et BBO#.

  7. Facultatif : Si vous voulez utiliser le serveur de liaison CICS, démarrez la tâche de serveur de liaison CICS des adaptateurs locaux optimisés en émettant la commande BBOC_START_SRVR dans un poste de travail CICS. Pour plus d'informations, voir Transactions de serveur Liberty pour CICS : BBOC, BBO$ et BBO#.

Que faire ensuite

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_enableconnectorcics.html