Utilisez cette tâche quand vous voulez utiliser l'API Invoke
pour appeler un bean de session sans état à partir d'un espace d'adressage externe
se trouvant dans une application déployée sur un
serveur WebSphere
Application Server for z/OS
lié localement.
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. Assurez-vous que l'espace d'adressage actuel a déjà été enregistré et qu'il est lié à la cellule
WebSphere
Application Server cible en utilisant l'API Register.
Pourquoi et quand exécuter cette tâche
Cette méthode est conçue pour les utilisateurs avertis qui cherchent
une voie simplifiée, dans laquelle la longueur de la zone de réponse est connue à l'avance.
Procédure
- Configurez l'application en langage natif d'espace d'adressage client
(Cobol, PL/I, C/C++, ou programme assembleur), pour collecter ses paramètres
et désigner le nom du service cible en tant que nom de chemin de l'interface de base JNDI (Java™ Naming
and Directory Interface) pour le bean de session sans état
qu'elle veut démarrer.
- Appelez l'API Invoke BBOA1INV. Dans l'application
EJB (Enterprise JavaBeans) cible, la méthode execute
s'exécute puis démarre toute logique métier requise avant de renvoyer
les données de réponse sous forme d'un tableau d'octets sérialisé
au programme appelant en langage natif.
- Examinez les données de réponse. Un code retour
et un code raison 0 indiquent que l'API Invoke client s'est terminée avec
succès et que les données de réponse et la longueur des données de réponse sont
enregistrées dans les zones désignées par le programme appelant.
- L'application client répète ces étapes en utilisant le même nom d'appel enregistré,
appelant autant de bean sessions sans état que nécessaire,
et aussi souvent que nécessaire.
Avertissement : Avec cette
API, les trois fonctions primitives, Send_Request, Receive_RespLen,
et Get_Data se terminent toutes en utilisant l'api Invoke. L'unité d'exécution appelante
est bloquée jusqu'à ce que les données de réponse soient reçues et copiées dans la zone
de réponse.
Résultats
Le client a démarré un bean de session sans état à partir de
WebSphere
Application Server
en utilisant l'API Invoke des adaptateurs locaux optimisés.