Vous devez associer l'espace d'adressage en cours au groupe de démons WebSphere
Application Server et établir des attributs de connexion pour que les adaptateurs locaux optimisés puissent émettre un appel sortant vers votre groupe de démons local ou un appel entrant vers une cellule WebSphere
Application Server.
Avant de commencer
Le groupe de démons de
WebSphere
Application Server doit être activé
sur l'image z/OS d'où provient la demande d'enregistrement. Si vous utilisez CICS (Customer Information Control System), le programme TRUE (exit utilisateur associé à une tâche) doit être activé avant qu'une connexion soit établie entre CICS et
WebSphere
Application Server.
Si vous utilisez IMS (Information Management System), l'interface de sous-système externe des adaptateurs locaux optimisés doit être installée et activée avant que les applications ne commencent à appeler les API
des adaptateurs locaux optimisés.
Procédure
- Définissez les paramètres à utiliser dans la connexion. Lorsque vous utilisez CICS, l'indicateur reg_flag_trans prend la valeur 1 pour indiquer que les connexions créées sous ce nom de registre doivent être reliées à RRS et jointes au travail réalisé dans une transaction globale WebSphere
Application Server. Lorsque cet indicateur a pour valeur 0 (zéro), il n'existe aucune connexion créée sous ce nom de registre qui doive être reliée à RSS et jointe au travail effectué dans une transaction globale WebSphere
Application Server.
Pour les appels entrants, un contexte de sécurité est toujours propagé sur WebSphere
Application Server et il contient l'ID utilisateur de l'espace d'adressage qui effectue la demande. Pour CICS, l'indicateur reg_flag_C2Wprop propage l'ID utilisateur que la tâche CICS utilise actuellement plutôt que l'ID utilisateur de l'espace d'adressage.
Pour les appels sortants, l'indicateur reg_flag_W2Cprop demande à WebSphere
Application Server de propager l'ID utilisateur sur CICS. Ensuite, CICS tente de démarrer le programme cible avec cet ID utilisateur.
Pour en savoir plus sur l'utilisation de la sécurité, voir les rubriques "Sécurisation
des adaptateurs locaux optimisés pour la prise en charge en entrée" et "Sécurisation
des adaptateurs locaux optimisés pour la prise en charge en sortie".
- Vérifiez que le nom d'enregistrement n'est pas déjà utilisé dans une cellule
à laquelle cet espace d'adressage est connecté. Une vérification
de l'espace d'adressage est effectué pour s'assurer que le nom d'enregistrement n'est pas déjà
utilisé par une autre cellule. Si le nom d'enregistrement est utilisé par une autre cellule,
un code retour d'erreur est renvoyé et la requête d'enregistrement
échoue.
- Configurez l'application en langage natif de l'espace d'adressage du client
pour appeler l'API BBOA1REG. Le groupe de démons et le nom de serveur
sont transmis ainsi qu'une chaîne d'entrée qui représente le nom ou le nom de registre utilisé par le démon WebSphere
Application Server.
Un code retour et motif égal à 0 (zéro) indique que l'espace d'adressage client
est maintenant lié au groupe de démons et au serveur WebSphere
Application Server que vous avez sélectionnés. Les appels suivants qui interagissent avec ce serveur WebSphere
Application Server doivent posséder soit le nom de registre fourni, soit un descripteur de connexion spécifique qui a été créé en utilisant ce nom de registre.
Résultats
Une fois cette tâche terminée, la chaîne de nom d'enregistrement transmise
est mise en réserve dans l'espace d'adressage courant. Aucun autre appel d'enregistrement
ne peut être effectué avec ce jeton jusqu'à ce qu'un appel de désenregistrement soit reçu
pour lui.
Important : Si vous utilisez la configuration de connexions minimales pour cet appel, le résultat sera un pool de connexions pré-établies avec le
serveur cible et qui attendent les requêtes.
Un contexte d'entrée d'enregistrement
ou de bloc de contrôle sont également créés et associés à la chaîne de nom d'enregistrement. Chaque nom d'enregistrement possède un contexte d'enregistrement spécifique.
Plusieurs noms de registre avec le même espace d'adressage et la même unité d'exécution
peuvent être associés avec un ou plusieurs groupes de démons
WebSphere
Application Server.
Que faire ensuite
Pour en savoir plus sur l'API BBOA1REG, voir la rubrique Adaptateurs locaux
optimisés pour les API natives de z/OS.