Pour plateformes z/OS

Utilisation des API des adaptateurs locaux optimisés de Liberty pour appeler un bean enterprise depuis un espace adresse externe

Utilisez les API WebSphere Optimized Local Adapters (WOLA) pour connecter un espace adresse externe à un serveur Liberty et appeler un bean session sans état local.

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.

Pour les programmes qui s'exécutent sous Customer Information Control System (CICS), les exits utilisateur associés à une tâche (TRUE) des adaptateurs locaux optimisés doivent être activés avant l'établissement d'une connexion entre CICS et le serveur Liberty. Pour plus d'informations, voir Transactions de serveur Liberty pour CICS : BBOC, BBO$ et BBO#.

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 session sans état permet plus de souplesse et est adaptée aux cas dans lesquels vous ne connaissez pas la longueur maximale de la zone de réponse avant l'appel. Pour une méthode simplifiée d'appel du bean lorsque la longueur de la zone de réponse est connue, voir Utilisation de l'API Invoke de Liberty pour appeler un bean enterprise depuis un espace adresse externe.

Procédure

  1. Appelez l'API Connection Get, BBOA1CNG, depuis l'application en langage natif dans l'espace adresse client en transmettant le nom d'enregistrement que vous avez utilisé lorsque vous avez appelé l'API Register, BBOA1REG. L'appel renvoie un descripteur de connexion qui doit être utilisé pour tous les appels d'API suivants.
  2. Appelez l'API Send Request, BBOA1SRQ, depuis l'application en langage natif dans l'espace adresse client. Pour le paramètre requestservicename, spécifiez le chemin d'accès à l'interface métier locale JNDI (Java Naming and Directory Interface) pour le bean enterprise que vous voulez appeler. Utilisez le nom JNDI dans l'espace de nom JNDI global. Le serveur Liberty appelle ensuite la méthode execute pour l'interface métier locale que l'application EJB implémente.

    Si vous associez le paramètre async de l'API Send Request à la valeur 0, l'API renvoie la longueur de la réponse et la valeur de retour. Vous pouvez ensuite appeler directement l'API Get Message Data.

    Si vous associez le paramètre async de l'API Send Request à la valeur 1, le contrôle revient à l'application client pour que vous puissiez appeler l'API Receive Response Length.

  3. Si vous avez appelé l'API Send Request avec le paramètre async associé à la valeur 1, appelez l'API Receive Response Length, BBOA1RCL en associant le paramètre async à la valeur 0 ou 1. L'application client utilise la longueur de la réponse qui est renvoyée par l'API Receive Response Length pour garantir que la zone est suffisamment grande pour contenir les données de réponse.

    Si vous associez le paramètre async de l'API Receive Response Length à la valeur 0, l'API bloque l'unité d'exécution jusqu'à ce qu'une réponse soit reçue.

    Si vous associez le paramètre async de l'API Receive Response Length à la valeur 1, l'API renvoie les données immédiatement, qu'elle ait reçu une réponse ou non.

  4. Appelez l'API Get Message Data API, BBOA1GET, pour copier les données de réponse dans le tampon de l'application client.
  5. L'application client peut continuer à envoyer des demandes et à recevoir des données de message avec le même descripteur de connexion jusqu'à ce qu'elle ait envoyé toutes les demandes et qu'elle soit prête à libérer la connexion. Pour libérer la connexion, l'application appelle l'API Connection Release, BBOA1CNR. Les descripteurs de connexion doivent être libérés avant d'être retenus sur un appel d'API Connection Get et utilisés à nouveau.

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_connectejbapi
Nom du fichier : twlp_dat_connectejbapi.html