Utilisez l'API Invoke de WebSphere Optimized Local Adapters (WOLA) pour effectuer un appel depuis un espace adresse externe à un bean session
sans état qui est déployé sur un serveur Liberty pour z/OS.
Avant de commencer
Pour identifier votre bean enterprise comme cible potentielle d'un appel d'adaptateur local optimisé, votre application EJB
(Enterprise JavaBean) doit implémenter l'interface com.ibm.websphere.ola.ExecuteLocalBusiness en tant qu'interface métier locale. L'interface se trouve dans le fichier wlp/dev/api/ibm/com.ibm.websphere.appserver.api.zosLocalAdapters_1.0.0.jar.
Le serveur Liberty doit être actif sur l'image
z/OS de laquelle provient la demande d'enregistrement. Vérifiez que l'espace adresse courant est déjà enregistré et lié au groupe d'adaptateurs locaux optimisés cible à l'aide de l'API Register. Pour plus
d'informations sur l'enregistrement d'un espace adresse externe, voir Enregistrement d'un espace adresse externe sur un serveur Liberty local à l'aide d'adaptateurs locaux optimisés.
Pourquoi et quand exécuter cette tâche
Cette méthode d'appel d'un bean enterprise est une méthode simple lorsque vous connaissez la longueur de la zone de réponse avant d'appeler
le bean. Si vous ne connaissez pas la longueur de la zone de réponse ou souhaitez plus de souplesse lorsque vous appelez le bean, voir
Utilisation des API des adaptateurs locaux optimisés de Liberty pour appeler un bean enterprise depuis un espace adresse externe.
Procédure
- Choisissez les paramètres à utiliser lorsque vous appelez le bean avec l'API Invoke, BBOA1INV.
L'API accepte des paramètres pour les éléments suivants :
- Le nom d'enregistrement que vous avez spécifié lorsque vous avez appelé l'API Register
- Le type de demande, qui doit avoir pour valeur 1 pour les demandes de travail EJB locales
- Le nom du service à appeler, qui doit être le chemin d'accès à l'interface métier locale JNDI (Java™ Naming and
Directory Interface) du bean session sans état
- La longueur du nom de service
- Un pointeur désignant l'adresse de départ des données de demande à envoyer
- La longueur des données de demande à envoyer
- Un pointeur désignant l'adresse de départ de la zone de données de réponse
- La longueur des données de réponse à envoyer
- Le nombre de secondes avant l'expiration de la connexion
Pour plus d'informations sur les paramètres d'API, voir API des adaptateurs locaux optimisés dans Liberty sous z/OS.
- Appelez l'API Invoke pour votre programme appelant avec les paramètres que vous avez sélectionnés depuis une application en langage natif dans l'espace
adresse client. 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 de tableau d'octets sérialisé au programme appelant en langage natif.
- Examinez les données de réponse. Le code retour et anomalie 0 indique que l'appel de l'API Invoke du client a abouti et que les données de réponse et la longueur des
données de réponse sont sauvegardées dans les zones désignées par le programme appelant.
- L'application client répète ces étapes en utilisant le même appel de nom d'enregistrement pour appeler autant de beans session sans état que nécessaire,
aussi souvent que nécessaire.
Avertissement : Avec l'API Invoke, les trois fonctions primitives, Send_Request, Receive_RespLen et Get_Data, sont toutes exécutées. 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 démarre un bean session sans état depuis le serveur Liberty en utilisant l'API Invoke de l'adaptateur local optimisé.