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
- 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.
- 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.
- 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");
- 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.
- 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.
- 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.