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.
Procédure
- 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é.
- 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'"
- 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.
- 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>
- 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"/>
- 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.
- Créez des profils SERVER pour z/OS.
- 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)
- 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)
- 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.
- 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.
- 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)
- 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.
- Assurez-vous que le niveau de la bibliothèque des modules de chargement est le plus récent.
- 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.