Pour plateformes z/OS

Utilisation de l'API Invoke de Liberty pour appeler un bean enterprise depuis un espace adresse externe

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

  1. 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.

  2. 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.
  3. 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.
  4. 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é.

Icône indiquant le type de rubrique Rubrique Tâche



Icône d'horodatage Dernière mise à jour: 7 juin 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_dat_connectejbinvokeapi
Nom du fichier : twlp_dat_connectejbinvokeapi.html