TCP/IP peut être utilisé pour les connexions entre l'adaptateur de
ressources IMS TM et
IMS Connect dans les environnements
distribués et les environnements z/OS.
Si votre application fonctionne sur une plateforme distribuée, la connexion entre l'adaptateur de ressources
IMS TM,
et IMS Connect doit être une connexion
TCP/IP. Par exemple, si l'adaptateur de
ressources IMS TM
est installé sur WebSphere Application
Server sous Windows, AIX®,
Solaris, Linux,
Linux
for z/OS ou
HP-UX, il doit utiliser des connexions TCP/IP pour se
connecter à IMS Connect. En option, vous
pouvez également utiliser des connexions TCP/IP
si l'adaptateur de ressources IMS TM est
installé sur WebSphere Application Server for
z/OS.
Les connexions TCP/IP à IMS Connect sont associées à un identifiant appelé ID client. IMS Connect vérifie que chacun de ces ID client est propre à chacune des connexions socket.
Il existe deux types de connexions TCP/IP à IMS Connect :
- Les connexions socket persistantes dédiées
- Les connexions socket persistantes partageables
L'ID client se définit différemment pour ces deux types de connexions.
Les connexions socket persistantes dédiées
L'ID client d'une connexion socket persistante dédiée est fourni par l'application. De manière générale, une connexion socket persistante dédiée est utilisée (ou réutilisée) à plusieurs reprises par une seule application. Néanmoins, elle peut également être réutilisée par plusieurs applications qui obtiennent la connexion en utilisant le même ID client. Si différentes applications tentent
simultanément d'utiliser une connexion socket persistante dédiée avec le même ID client, la tentative de la première application aboutira mais les tentatives suivantes par d'autres applications alors que la première application utilise toujours cette connexion recevront des erreurs de client en double (DUPCLNT) d'IMS Connect.
Une
erreur de client en double peut aussi survenir lorsqu'une application obtenant une connexion socket persistante dédiée avec un ID client donné fonctionne dans un environnement où les connexions socket persistantes dédiées peuvent provenir de plusieurs instances de WebSphere Application
Server. Par exemple, un environnement comportant plusieurs instances de WebSphere Application
Server gérées par un gestionnaire de charge de travail peut rencontrer plusieurs erreurs de client en double. Il est vivement conseillé de ne pas déployer votre application
dans un tel environnement si une connexion persistante dédiée est utilisée.
Le propre d'une connexion socket persistante dédiée est d'être :
- réutilisée à plusieurs reprises par des applications
- utilisée dans un environnement où une seule instance de WebSphere Application Server est connectée à un seul IMS Connect.
Dans certaines situations, une seule instance de WebSphere Application Server peut être connectée à plusieurs instances d'IMS Connect. Dans cette configuration, si Sysplex
Distributor est utilisé entre WebSphere Application Server et IMS Connect, les interactions suivantes ne sont pas prises en charge :
- récupération de la validation en deux phases
- transactions conversationnelles IMS
Par ailleurs, il est possible que vous ne puissiez pas récupérer tous les messages de sortie disponibles à l'aide des interactions SYNC_RECEIVE_ASYNCOUTPUT_SINGLE_NOWAIT lorsque vous utilisez plusieurs systèmes IMS sans Super Member. Pour plus d'informations, veuillez vous référer au Guide d'utilisation et références IMS OTMA.
Les connexions socket persistantes partageables
Les connexions socket persistantes partageables utilisent les ID client générés par IMS Connector for Java.
Cet ID client est invisible pour l'application qui utilise une connexion partageable. Une connexion socket persistante partageable peut être réutilisée à plusieurs reprises par plusieurs applications et n'est pas limitée comme une connexion dédiée.
Etablissement de connexions socket persistantes dédiées
Pour établir une connexion socket persistante dédiée, vous devez :
- • Utiliser WebSphere Application
Server pour configurer une fabrique de connexions J2C qui crée les connexions socket persistantes dédiées. Pour cela, la valeur
TRUE doit être définie pour la propriété CM0Dedicated de la fabrique de connexions. Pour localiser cette fabrique de connexions pour les connexions gérées, votre application utilise
l'interface JNDI. Votre application doit également être configurée
pour définir la propriété commitMode d'IMSInteractionSpec sur 0.
- Attribuer une valeur à la propriété ID client de l'objet IMSConnectionSpec
utilisé pour obtenir la connexion. Si votre application utilise du code généré,
vous pouvez définir cette valeur en exposant la propriété ID client d'IMSConnectionSpec
en tant que données. Si votre application utilise l'interface CCI (Common Client Interface)
de l'adaptateur de ressources IMS TM,
vous pouvez définir cette valeur en utilisant la méthode setClientID de l'objet IMSConnectionSpec qui est
passé dans l'appel à la méthode getConnection.
Etablissement de connexions socket persistantes partageables
Pour établir une connexion socket persistante partageable, vous devez :
- Utiliser WebSphere Application
Server pour configurer une fabrique de connexions J2C qui crée les connexions socket persistantes partageables. Définissez la valeur FALSE
pour la propriété CM0Dedicated de la fabrique de connexions. Pour localiser cette fabrique de connexions pour les connexions gérées, votre application utilise
l'interface JNDI.
- Pour les connexions socket persistantes partageables, l'ID client est automatiquement défini pour vous
par l'adaptateur de ressources IMS TM. Si votre application utilise du code généré,
la connexion persistante partageable est obtenue grâce à ce dernier. Si votre application utilise l'interface CCI (Common Client Interface) de l'adaptateur de ressources IMS TM, vous devez vous assurer de ne pas fournir de valeur pour la propriété d'ID client de l'objet IMSConnectionSpec qui est transmis dans la méthode getConnection.