[z/OS]

Utilisation des adaptateurs locaux optimisés pour une prise en charge en entrée

Utilisez cette tâche quand vous voulez implémenter la prise en charge des adaptateurs locaux optimisés pour effectuer un appel en entrée vers les applications EJB (Enterprise JavaBeans) de WebSphere Application Server for z/OS.

Pourquoi et quand exécuter cette tâche

Les adaptateurs locaux optimisés permettent de recevoir des appels entrants, c'est-à-dire provenant d'un espace d'adressage externe et ciblant des applications EJB déployées sur un serveur WebSphere Application Server for z/OS local. Réciproquement, ces mêmes adaptateurs permettent d'émettre des appels sortants, c'est-à-dire émis par une application exécutée dans WebSphere Application Server for z/OS à destination d'un programme serveur exécuté dans un espace d'adressage externe. Les étapes suivantes illustrent le processus requis pour appeler une application EJB déployée sur un serveur local WebSphere Application Server for z/OS en utilisant les API des adaptateurs locaux optimisés.

La figure suivante présente le flux lors de l'utilisation des adaptateurs locaux optimisés avec Customer Information Control System (CICS). La figure suivante présente le flux lors de l'utilisation des adaptateurs locaux optimisés avec Customer Information Control System (CICS).Appel entrant CICS vers une application EJB de serveur d'applications

L'illustration suivante décrit le flux d'un cas d'utilisation des adaptateurs locaux optimisés avec un système IMS. Appel entrant d'IMS vers Application Server via les adaptateurs locaux optimisés

Procédure

  1. Activez l'environnement du serveur. Cette étape décrit comment activer la prise en charge des adaptateurs locaux optimisés avec les variables d'environnement WebSphere dans un groupe de démons ou une cellule WebSphere Application Server. Cette étape prépare WebSphere Application Server à recevoir les demandes entrantes.
  2. Développez une application EJB. Vous pouvez développer une application EJB ou préparer une application existante. Si vous prévoyez un échange d'appels vers ou depuis un programme Cobol ou C/C++, vous pouvez des outils d'assemblage tels que ceux de Rational Application Developer pour créer une classe Java™ avec des méthodes auxiliaires d'accès get et set correspondant au copybook Cobol ou à la structure C/C++, ou pour créer une application EJB à lancer avec les API natives des adaptateurs locaux optimisés.

    Pour plus d'informations sur l'utilisation des outils d'assemblage pour convertir un copybook Cobol ou une structure C en une classe auxiliaire (helper) de liaison de données Java, consultez le centre de documentation des outils d'assemblage.

    Les outils d'assemblage sont fournis avec WebSphere Application Server for z/OS et comprennent un fichier JAR contenant le package com.ibm.websphere.ola, dont vous aurez besoin pour identifier votre bean enterprise comme cible potentielle de l'appel d'un adaptateur local optimisé. Ce package contient les classes ExecuteHome et Execute qui contiennent les interfaces abstraites nécessaires pour appeler l'adaptateur. Vous devez créer un bean de session sans état implémentant une méthode appelée execute(), qui accepte un tableau d'octets en entrée, renvoie un tableau d'octets en sortie et spécifie le nom com.ibm.websphere.ola.ExecuteHome pour l'interface home EJB et com.ibm.websphere.ola.Execute pour l'interface distante. Le bean enterprise que vous voulez démarrer à partir d'un espace d'adressage externe doit comporter une méthode execute() acceptant un tableau d'octets en entrée et renvoyant un tableau d'octets en sortie. C'est dans cette méthode que vous recevez le contrôle quand un espace d'adressage externe utilise un des appels d'API d'adaptateur tel que Invoke ou Send Request. La méthode execute est définie sur l'interface distante com.ibm.websphere.ola.Execute et contient la logique métier de l'application.

    Avertissement : Votre implémentation EJB ne doit en aucun cas modifier ou augmenter les interfaces home et distante. Les exceptions d'application ne sont pas prises en charge dans la méthode execute de l'interface distante. Si votre application doit émettre une exception, ce doit être une exception EJBException, qui peut éventuellement encapsuler l'exception d'origine rencontrée.
  3. Déployez l'application EJB. Après avoir développé l'application EJB, vous devez la placer dans un fichier d'archive d'entreprise (EAR) et la déployer dans WebSphere Application Server. Cette application EJB utilise les interfaces home et distante fournies dans le package com.ibm.websphere.ola. Les beans enterprise développés de cette manière reçoivent un nom d'interface home JNDI (Java Naming and Directory Interface) et sont déployés comme tout autre composant EJB. Pour en savoir plus sur l'installation de l'application, lire la rubrique Installation des fichiers d'application d'entreprise.
  4. (Facultatif) Utilisez l'environnement CICS. Effectuez cette étape uniquement si vous êtes connecté à CICS (Customer Information Control System) et que vous l'utilisez. Si vous utilisez CICS, effectuez cette étape pour activer les adaptateurs dans la région CICS afin d'effectuer des appels en sortie vers les applications EJB qui sont déployées sur votre serveur local WebSphere Application Server. Les appels en sortie sont effectués avec les API natives des adaptateurs locaux optimisés. Si vous n'utilisez pas CICS, passez à l'étape suivante.
    Avertissement : Vérifiez que le produit utilise un registre d'utilisateurs SAF si vous prévoyez de propager un ID utilisateur SAF de WebSphere Application Server for z/OS vers le système CICS.
  5. (Facultatif) Utilisez l'environnement IMS. Effectuez cette étape si vous êtes connecté aux applications IMS et que vous les utilisez.
  6. Enregistrez un espace d'adressage externe. Vous devez associer l'espace d'adressage courant au groupe WebSphere Application Server et établir des attributs de connexion afin que les adaptateurs locaux optimisés puissent envoyer des appels à votre groupe de démons local ou à la cellule WebSphere Application Server.
  7. Sécurisez les adaptateurs locaux optimisés pour la prise en charge en entrée.
  8. Effectuez des appels en entrée. Choisissez la méthode que vous souhaitez utiliser pour effectuer des appels avec les API natives, en fonction du système sur lequel vous travaillez et de vos projets.
    1. Utilisez les API natives des adaptateurs locaux optimisés pour appeler un bean session sans état et vous connecter depuis un espace d'adressage externe à WebSphere Application Server. Avec cette méthode, vous démarrez une application EJB depuis un programme externe en langage natif à l'aide des API primitives et vous récupérez la réponse. Cette méthode a été conçue pour les applications qui veulent plus de flexibilité et dans lesquelles la longueur maximale de la zone de réponse n'est pas connue à l'avance.
    2. Utilisez l'API Invoke de l'adaptateur local optimisé pour appeler un bean session sans état et vous connecter depuis un espace d'adressage externe à WebSphere Application Server. Avec cette méthode, vous démarrez une application EJB avec l' API Invoke depuis un programme externe en langage natif et vous récupérez la réponse. Cette méthode est conçue pour les utilisateurs qui cherchent une voie simplifiée, dans laquelle la longueur de la zone de réponse est connue à l'avance.
    3. Utilisez les adaptateurs locaux optimisés pour appeler une application EJB de WebSphere Application Server depuis un espace d'adressage externe dans une transaction émise par le client. Avec cette méthode, vous commencez une transaction dans l'environnement client et appelez une application EJB en cours d'exécution sur WebSphere Application Server. La nouvelle transaction est propagée au serveur WebSphere Application Server. Cette méthode n'est prise en charge que pour les appels provenant d'un environnement autorisant les transactions, comme CICS.
    4. Utilisez les adaptateurs locaux optimisés pour appeler une application EJB de WebSphere Application Server en ignorant le contexte de transaction. Avec cette méthode, vous commencez une transaction dans un environnement client et appelez une application EJB déployée sur WebSphere Application Server en ignorant le contexte de transaction. Cette méthode n'est prise en charge que pour les appels provenant d'un environnement autorisant les transactions, comme CICS.
  9. (Facultatif) Contrôlez les adaptateurs locaux optimisés.

Résultats

Vous avez implémenté la prise en charge des adaptateurs locaux optimisés pour effectuer des appels en entrée vers des applications EJB déployées sur WebSphere Application Server.

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



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