![[z/OS]](../images/ngzos.gif)
Remarques sur les fabriques de connexions pour les adaptateurs locaux optimisés
Cette rubrique contient des remarques sur l'utilisation des fabriques de connexions avec les adaptateurs locaux optimisés.
Vous devez configurer une fabrique de connexions pour que les adaptateurs locaux optimisés de z/OS prennent en charge les connexions entrantes et sortantes, même si vous l'utilisez uniquement et directement pour les connexions sortantes. Plusieurs fabriques de connexions sont prises en charge. Vous pouvez affecter n'importe quel nom à la fabrique de connexions.
Chaque fabrique de connexions configurée peut être associée à des paramètres différents. Les paramètres configurables incluent les tailles de pool de connexions et les propriétés personnalisées.
- Nom de registre
1 à 12 caractères alphanumériques.
Affectez le nom d'enregistrement cible cible à cette valeur.
- ID groupe IMS OTMA
1 à 8 caractères alphanumériques.
Affectez le nom IMS (Information Management System) OTMA (Open Transaction Manager Access) cible à cette valeur.Avertissement : Ce paramètre doit correspondre aux critères définis pour un nom de groupe OTMA XCF valide, comme décrit dans le centre de documentation IMS. - Nom de serveur IMS OTMA
1 à 16 caractères alphanumériques.
Affectez le nom de serveur IMS OTMA cible à cette valeur.
Avertissement : Ce paramètre doit correspondre aux critères définis pour un nom de serveur OTMA valide, comme décrit dans le centre de documentation IMS. - Niveau de synchronisation IMS OTMA
1 caractère : 0|1
Affectez 0 (zéro) à cette valeur pour SyncLevel NONE et 1 pour SyncLevel CONFIRM. Si vous voulez qu'IMS valide un travail pour une transaction traitée après avoir envoyé la réponse au serveur d'applications sans avoir reçu d'accusé de réception positif indiquant que la réponse a été acceptée, sélectionnez le niveau de synchronisation None. Si vous voulez qu'IMS valide la transaction après avoir reçu un accusé de réception positif uniquement, sélectionnez le niveau de synchronisation Confirm. Si l'accusé de réception est négatif, le travail en cours est annulé. Notez que tous les appels aux transactions IMS avec OLA over OTMA s'exécutent sous la forme SEND_THEN_COMMIT (CM1). Pour plus d'informations sur ces niveaux de synchronisation OTMA et le traitement CM1 SEND_THEN_COMMIT, consultez le centre de documentation d'IMS.
- Segments maximum OTMA IMS
Entier - 1
Définissez pour cette valeur le nombre maximal de segments de message IMS pris en charge pour l'envoi à IMS ou la réception depuis IMS.
- Taille maximale de réception des messages IMS OTMA
Entier - 32768
Définissez pour cette valeur la taille maximale des messages reçus, y compris tous les segments de message.
- RemoteHostname
String (chaîne)
Lors de l'exécution sur une plateforme non z/OS, indique le nom de l'hôte vers lequel la recherche JNDI de l'EJB proxy OLA est dirigée.
- RemotePort
Integer
Lors de l'exécution sur une plateforme non z/OS, indique le numéro de port de l'hôte distant vers lequel la recherche JNDI de l'EJB proxy OLA est dirigée.
- RemoteJNDIName
String (chaîne)
Lors de l'exécution sur une plateforme non z/OS, indique le nom JNDI de l'hôte distant auquel l'EJB proxy OLA est connecté. L'hôte distant est spécifié par les propriétés RemoteHostname et RemotePort.
- Username
String (chaîne)
Indique le nom d'utilisateur servant à envoyer des demandes à un enregistrement en cours d'exécution dont la sécurité activée est. L'ID utilisateur MVS associé au nom d'utilisateur est utilisé. Si aucun ID utilisateur MVS n'est associé au nom d'utilisateur, aucune identité n'est envoyée dans la demande. Si aucun nom d'utilisateur n'est spécifié, l'ID utilisateur du composant appelant est utilisé pour obtenir un ID utilisateur MVS.
- Mot de passe
String (chaîne)
Indique le mot de passe correspondant au nom d'utilisateur.
- RemoteJNDIUsername
String (chaîne)
Lors de l'exécution sur une plateforme non z/OS, indique le nom d'utilisateur servant à obtenir le contexte initial JNDI sur le système distant. Le contexte JNDI est utilisé pour la recherche de l'EJB proxy OLA.
- RemoteJNDIPassword
String (chaîne)
Lors de l'exécution sur une plateforme non z/OS, indique le mot de passe à utiliser avec RemoteJNDIUsername.
- RemoteJNDIRealm
String (chaîne)
Lors de l'exécution sur une plateforme non z/OS, indique le domaine de sécurité à utiliser avec RemoteJNDIUsername.
- UseCICSContainer
Entier - 0
Si le serveur Link CICS est utilisé, indique que les données de demande et de réponse doivent se trouver dans des conteneurs.
- LinkTaskTranID
String (chaîne)
Si le serveur Link CICS est utilisé, spécifie l'ID de transaction de la tâche Link de nom.
- LinkTaskReqContID
String (chaîne)
Si le serveur Link CICS est utilisé, spécifie le nom de la demande, ou le conteneur d'entrée.
- LinkTaskReqContType
Entier - 1
Si le serveur Link CICS est utilisé, spécifie le type de conteneur de demande (CHAR=0|BIT=1).
- LinkTaskRspContID
String (chaîne)
Si le serveur Link CICS est utilisé, spécifie le nom de la réponse, ou le conteneur de sortie.
- LinkTaskRspContType
Entier - 1
Si le serveur Link CICS est utilisé, spécifie le type du conteneur de réponse (CHAR=0|BIT=1).
- ConnectionWaitTimeout
Entier - 30
Délai d'attente d'une connexion client correspondante pour le nom de registre courant, exprimé en secondes. L'espace adresse externe doit déjà avoir été enregistré. Ce délai d'attente correspond à la durée pendant laquelle l'utilisateur attend qu'un service associé au nom de registre correspondant devienne disponible.
Le nom du client IMS OTMA, qui est automatiquement généré, comprend 16 caractères et ne peut pas être défini à l'aide de l'adaptateur de ressources des adaptateurs locaux optimisés. Pour plus d'informations sur l'utilisation des adaptateurs locaux optimisés sur IMS OTMA, voir la rubrique consacrée à l'activation des adaptateurs locaux optimisés avec le support OTMA/IMS.
Les paramètres de pool de connexions de l'adaptateur définissent le nombre de connexions logiques du pool de connexions de WebSphere Application Server. Ce nombre ne reflète pas le nombre de connexions physiques établies entre WebSphere Application Server et un espace d'adressage externe. Une connexion logique correspond à une connexion physique Java™ EE Connector Architecture (JCA) dans le cas présent. Les connexions logiques sont utilisées par les applications WebSphere lors des appels sortants à un espace d'adressage externe.
Les paramètres de pool de connexions de l'adaptateur définissent le nombre de connexions logiques du pool de connexions de WebSphere Application Server. Ce nombre ne reflète pas le nombre de connexions physiques établies entre WebSphere Application Server et un espace d'adressage externe. Une connexion logique correspond à la vue JCA d'une connexion physique dans le cas présent.
Le rapport entre les connexions logiques et physiques dépend du nombre d'unités d'exécution des applications WebSphere pouvant obtenir une connexion (logique) et du nombre de requêtes que vous voulez pouvoir envoyer ou recevoir vers et à partir d'un espace d'adressage externe (physique). Vous pouvez définir un nombre maximum de connexions physiques pour vous assurer qu'un espace d'adressage externe ne pourra pas saturer WebSphere Application Server avec un trop grand nombre de requêtes, car les connexions physiques sont utilisées aussi bien pour les communications entrantes que les communications sortantes avec l'espace d'adressage externe. Si un espace d'adressage externe tente de s'enregistrer dans WebSphere Application Server et spécifie un nombre de connexions égal au nombre maximum de connexions physiques pris en charge pour un serveur de ce noeud, la requête d'enregistrement est rejetée avec un code raison qui indique la cause de l'échec. L'enregistrement peut également échouer si le nombre maximum de connexions spécifié pour le groupe de démons est dépassé. Notez que les connexions physiques sont demandées par le client et diffèrent des connexions logiques accordées par l'adaptateur JCA. Quand une requête sortante est émise, la connexion logique JCA est couplée avec une connexion physique pendant toute la durée de l'interaction.
Après avoir créé et sauvegardé les fabriques de connexions, vous pouvez modifier les références de ressources définies dans les divers modules de l'application et spécifier les noms JNDI (Java Naming and Directory Interface) de ces fabriques de connexions lorsque cela est approprié.

La valeur de niveau de connexion Segments maximum peut être également définie en utilisant la méthode setOTMAMaxSegments(nnn) de la spécification de connexion.
Si vous voulez utiliser la fonction de haute disponibilité de l'adaptateur de ressource, vous devez définir des propriétés de pool de connexions supplémentaires dans chaque fabrique de connexions. Voir la rubrique Activation du support de haute disponibilité de l'adaptateur de ressource pour plus d'informations sur la configuration et l'utilisation de cette fonction.