[z/OS]

Utilisation d'adaptateurs locaux optimisés pour la connexion à une application dans un espace d'adressage externe à partir d'une application WebSphere

Utilisez cette tâche quand vous voulez utiliser les API sortantes pour vous connecter à une application dans un espace d'adressage externe à partir d'une application déployée sur WebSphere Application Server for z/OS.

Avant de commencer

Le groupe de démons, l'espace d'adressage et l'espace d'adressage externe doivent être définis pour utiliser les API des adaptateurs locaux optimisés. L'espace d'adressage externe doit être enregistré dans le groupe de démons en appelant l'API BBOA1REG.

L'application en cours d'exécution dans l'espace d'adressage externe doit s'être établie en tant que tâche de serveur d'adaptateurs locaux optimisés en utilisant une des API, par exemple BBOA1SRV, BBOA1RCA ou BBOA1RCS.

Le fichier RAR de l'adaptateur de ressources des adaptateurs locaux optimisés, ola.rar, se déploie et se configure en utilisant la console d'administration de WebSphere Application Server ou le script olaRar.py.

Procédure

  1. Localisez le descripteur de déploiement d'application dans l'application qui émet l'appel externe. Il s'agit de l'application qui est déployée sur le serveur WebSphere Application Server à partir duquel vous souhaitez effectuer un appel sortant.
  2. Créez une référence de ressource qui pointe vers la fabrique de connexions de l'adaptateur local optimisé. La fabrique de connexions de l'adaptateur local optimisé a été créée lors de l'installation du fichier ola.rar sur WebSphere Application Server.
  3. Localisez la fabrique de connexions de l'adaptateur local optimisé. Vous pouvez trouver la fabrique de connexions en recherchant la référence de ressource dans l'interface JNDI (Java™ Naming Directory Interface). Par exemple :
    Context ctx = new InitialContext();
    ConnectionFactory cf = ctx.lookup("java:comp/env/ola");
  4. Créez un appel de méthode ConnectionSpecImpl et fournissez le nom d'enregistrement auquel se connecter. Vous pouvez utiliser le nom de registre comme un attribut sur la fabrique de connexions gérées ou la méthode setRegisterName pour fournir le nom d'enregistrement à l'application en cours d'exécution dans l'espace d'adressage externe ou au sous-système auquel vous voulez vous connecter. Ce doit être le même que le nom d'enregistrement fourni par l'application dans l'espace d'adressage externe ou le sous-système utilisant une des API d'adaptateurs locaux optimisés du serveur, BBOA1SRV, BBOA1RCA ou BBOA1RCS. Exemple,
    ConnectionSpecImpl csi = new ConnectionSpecImpl();
    csi.setRegisterName ("MyRES1");
    Avertissement : Il n'est pas nécessaire de paramétrer le nom de registre pour l'objet ConnectionSpecImpl si ce nom a été défini à l'aide de la propriété personnalisée RegisterName de l'objet ConnectionFactory.
    Avertissement : Si vous voulez utiliser la fonction haute disponibilité de l'adaptateur de ressources, vous devez veiller à ce que votre application n'utilise pas la méthode setRegisterName. A la place, vous devez configurer le nom de registre cible dans les attributs de fabrique de connexions de la connexion gérée. Pour plus d'informations sur la manière de configurer la haute disponibilité, consultez la rubrique Activation du support haute disponibilité avec les adaptateurs locaux optimisés.
  5. Facultatif : Si vous appelez une transaction Information Management System (IMS) qui n'utilise pas les API de serveur d'adaptateur local optimisé BBOA1SRV, BBOA1RCA ou BBOA1RCS, exécutez cette étape pour paramétrer IMS Open Transaction Manager Access (OTMA). Vous pouvez soit paramétrer le nom de serveur IMS OTMA, l'ID de groupe XCF et le niveau de transaction sous forme d'attributs sur la fabrique de connexions gérées, soit utiliser les méthodes de paramétreur ConnectionSpecImpl correspondantes setOTMAServerName, setOTMAGroupID et setOTMATranLevel pour fournir ces informations sur l'application exécutée à l'espace d'adressage externe ou au sous-système auquel vous souhaitez vous connecter.
    Avertissement : Lorsque vous utilisez les adaptateurs locaux optimisés sur OTMA, le nom d'enregistrement n'a pas d'équivalent du côté de la transaction IMS. Le nom d'enregistrement peut être défini, mais il n'est pas utilisé pour les appels aux adaptateurs locaux optimisés sur OTMA. Pour plus d'informations, reportez-vous à la rubrique Appel de transactions IMS existantes avec les adaptateurs locaux optimisés sur OTMA.
  6. Utilisez la fabrique de connexions pour créer une connexion, par exemple :
    Connection con = cf.getConnection(csi);

Résultats

Votre application déployée sur WebSphere Application Server est connectée à un espace d'adressage externe et est prête à appeler les services hébergés dans cet espace.

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_connect2wasapp
Nom du fichier : tdat_connect2wasapp.html