Pour que WebSphere Optimized Local Adapters (WOLA) puisse envoyer un appel sortant à votre groupe d'adaptateurs locaux optimisés local ou un
appel entrant sur un serveur Liberty, vous devez lier l'espace adresse courant au serveur Liberty et définir des attributs de connexion à
l'aide de l'API Register.
Procédure
- Choisissez les paramètres à utiliser lorsque vous enregistrez l'espace adresse à l'aide de l'API Register, BBOA1REG.
L'API accepte des paramètres pour les éléments suivants :
- Les trois parties du nom de groupe WOLA que vous avez spécifiées lorsque vous avez ajouté la fonction au fichier server.xml
- Le nom d'enregistrement
- Le nombre minimal de connexions initiales
- Le nombre maximal de connexions
- Les mots d'indicateur d'enregistrement spécifiant le comportement de la fonction de trace
Pour les appels entrants sur un serveur Liberty, un contexte de sécurité contenant l'ID utilisateur de l'espace adresse à l'origine de la
demande est toujours propagé sur le serveur Liberty. Pour CICS, l'indicateur d'enregistrement
reg_flag_C2Wprop propage l'ID utilisateur de la tâche CICS plutôt que l'ID utilisateur de l'espace adresse.
Pour les appels sortants provenant du serveur Liberty, l'indicateur d'enregistrement reg_flag_W2Cprop indique au serveur
Liberty qu'il doit propager l'ID utilisateur dans CICS. Ensuite, CICS tente de démarrer le programme cible avec cet ID utilisateur.
Pour plus d'informations sur les paramètres d'API, voir API d'adaptateurs locaux optimisés sur Liberty pour z/OS et Sécurisation des adaptateurs locaux optimisés dans Liberty pour z/OS.
- Vérifiez qu'un autre groupe d'adaptateurs locaux optimisés auquel cet espace adresse est connecté n'utilise pas déjà le nom d'enregistrement
sélectionné. Si le nom d'enregistrement est utilisé par un autre groupe d'adaptateurs locaux optimisés, un code retour d'erreur est renvoyé et la demande
d'enregistrement échoue.
- Appelez l'API Register pour votre programme appelant depuis l'application en langage natif dans l'espace adresse client avec les paramètres que vous
avez sélectionnés.
Le code retour et anomalie 0 indique que l'espace adresse client est désormais lié au serveur Liberty.
Résultats
La chaîne de nom d'enregistrement transmise est réservée dans l'espace adresse courant. Aucun autre appel d'enregistrement ne peut être effectué avec ce
jeton tant qu'un appel d'API Unregister n'a pas été reçu pour l'enregistrement.
Important : Si vous utilisez le paramètres de nombre minimal de
connexions dans cet appel, le résultat est un pool de connexions établies préalablement au serveur cible
et qui attendent des demandes.
Un contexte d'entrée d'enregistrement ou un bloc de contrôle est également
créé et associé à la chaîne de nom d'enregistrement. Chaque nom d'enregistrement possède un contexte d'enregistrement spécifique. Plusieurs noms d'enregistrement associés au même espace adresse et à la
même unité d'exécution peuvent être liés à un ou plusieurs groupes d'adaptateurs locaux optimisés
Liberty.
Que faire ensuite
Vous pouvez utiliser l'enregistrement pour effectuer des appels entrants et sortants entre l'environnement
Liberty et l'espace adresse
externe. Pour plus d'informations, voir
Développement d'applications en vue de l'utilisation d'adaptateurs locaux optimisés dans Liberty.