Pour plateformes z/OS

Activation de l'environnement de serveur Liberty en vue de l'utilisation des adaptateurs locaux optimisés

Vous devez activer le serveur Liberty pour qu'il puisse recevoir des demandes entrantes et sortantes avec la prise en charge des adaptateurs locaux optimisés. WebSphere Optimized Local Adapters (WOLA) pour z/OS est un ensemble de services appelables (API) qui permettent aux applications z/OS natives d'envoyer des appels entrants à des beans enterprise de serveur d'applications et qui permettent à des programmes natifs de faire office de serveur et d'accepter des demandes provenant d'applications qui s'exécutent sur le serveur WebSphere Liberty.

Avant de commencer

Installez la fonction zosLocalAdapters-1.0 dans votre environnement Liberty. Pour plus d'informations, voir Installation des actifs du 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ère en minuscule en majuscule, ce qui peut provoquer une non correspondance 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 qui s'exécute en tant que 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(nom_utilisateur)
      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(nom_utilisateur)
    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.
  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 Enabling support for Liberty optimized local adapters in 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



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_dat_enableconnector
Nom du fichier : twlp_dat_enableconnector.html