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
- 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.
- 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.
- 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.
- Appelez l'API Get Message Data API, BBOA1GET, pour copier les données de réponse dans le tampon de l'application client.
- 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.