Propriétés de la fabrique de connexions IMS

Les propriétés personnalisées de la fabrique de connexions d'un adaptateur de ressources IMS TM doivent être configurées de manière à correspondre aux caractéristiques de l'EIS cible.

Lorsque vous créez une définition de service IMS ou définissez une fabrique de connexions IMS dans WebSphere Application Server, vous devez indiquer des valeurs pour certaines propriétés de la connexion entre IMS Connector for Java et IMS Connect. La liste suivante décrit ces propriétés de connexion :

HostName
Cette valeur est obligatoire pour les connexions TCP/IP uniquement. Elle est ignorée pour les connexions Local Option. Vous devez remplacer la valeur "myHostNm " par l'adresse IP ou le nom d'hôte de la machine sur laquelle est exécuté le composant IMS Connect cible.
PortNumber
Cette valeur est obligatoire pour les connexions TCP/IP uniquement. Elle est ignorée pour les connexions Local Option. Vous devez remplacer la valeur "0 " par le numéro de port utilisé par le composant IMS Connect cible pour les connexions TCP/IP. Il est possible d'ouvrir plusieurs sockets sur un seul port TCP/IP et de configurer IMS Connect afin que ce dernier utilise plusieurs ports pour les communications avec IMS Connector for Java et d'autres clients. Voir "Configuration d'IMS Connect" dans le Guide d'utilisation et de référence d'IMS Connect (SC18-9287-02) pour plus d'informations sur la propriété PortNumber.
CM0Dedicated
Cette valeur est facultative et s'applique aux connexions TCP/IP uniquement. La valeur par défaut est FALSE. Une valeur FALSE indique que la fabrique de connexions générera des connexions socket persistantes partageables et qu'IMS Connector for Java générera une valeur clientID pour identifier la connexion socket. Ces connexions peuvent être utilisées par des interactions en mode de validation 0 et en mode de validation 1. Une valeur TRUE indique que la fabrique de connexions générera des connexions sockets persistantes dédiées, qui nécessitent des valeurs clientID définies par l'utilisateur pour identifier les connexions sockets. Chaque connexion socket persistante dédiée est réservée à un clientID donné et seules les interactions en mode de validation 0 sont autorisées sur ces connexions.
SSLEnabled
Cette valeur est facultative et s'applique aux connexions TCP/IP uniquement. La valeur par défaut est FALSE. Une valeur TRUE indique que la fabrique de connexions sera utilisée pour créer des connexions socket SSL à IMS Connect à l'aide des valeurs HostName et PortNumber définis dans les propriétés de connexion correspondantes. PortNumber doit être configuré en tant que port SSL dans la configuration d'IMS Connect. Une valeur FALSE indique que les sockets SSL ne seront pas utilisés pour la connexion au port défini dans la propriété PortNumber.
SSLKeyStoreName
Cette valeur, facultative, s'applique aux connexions TCP/IP uniquement et SSLEnabled doit être défini sur TRUE. Les clés privées SSL et les certificats de clés publiques associés sont stockés dans des bases de données protégées par un mot de passe et appelées fichiers de clés. Pour des raisons pratiques, les certificats sécurisés peuvent également être stockés dans les fichiers de clés et la propriété Nom du fichier de clés certifiées peut alors être vide ou pointer vers le fichier de clés. Si la propriété SSLKeyStoreName / SSKeyStorePassword est laissée vide, un message d'information est généré dans le fichier journal du serveur.
La propriété SSLKeyStoreName peut être utilisée pour indiquer un fichier de clés JKS ou un fichier de clé RACF si vous travaillez sous z/OS. Pour les plateformes non z/OS, spécifiez le nom de chemin qualifié complet de votre fichier de clés JKS. Pour les plateformes z/OS, définissez le nom de votre fichier de clés JKS comme ci-dessus, ou une chaîne spécifique fournissant les informations nécessaires pour accéder à votre fichier de clés RACF. Voici un exemple de nom de chemin qualifié complet de fichier de clés JKS : c:\keystore\MyKeystore.ks. Un fichier de clés RACF est défini sous la forme : keystore_type:keyring_name:racfid. keystore_type doit être JCERACFKS lorsque le chiffrement logiciel est utilisé pour SSL ou JCE4758RACFKS si le chiffrement matériel est utilisé. Remplacez keyring_name par le nom du fichier de clés RACF que vous utilisez comme fichier de clés et racfid par un ID RACF permettant d'accéder au fichier de clés spécifié. Les exemples suivants sont des exemples de définitions de fichiers de clés RACF : "JCERACFKS:myKeyring:kruser01" ou "JCE4758RACFKS:myKeyring:kruser01". Si, lorsque vous travaillez sous z/OS, la propriété SSLKeyStoreName correspond au format de fichier de clés RACF ci-dessus, IMS Connector for Java va utiliser le fichier de clés RACF en tant que fichier de clés. Si le type de fichier de clés défini est autre que JCERACFKS ou JCE4758RACFKS, IMS Connector for Java tente d'interpréter SSLKeyStoreName comme un nom de fichier de clés JKS.
Remarque : le fichier JKS peut avoir d'autres extensions de fichier que .ks.
SSLKeyStorePassword
Cette valeur, facultative, s'applique aux connexions TCP/IP uniquement et SSLEnabled doit être défini sur TRUE. Indiquez le mot de passe du fichier de clés.
SSLTrustStoreName
Cette valeur, facultative, s'applique aux connexions TCP/IP uniquement et SSLEnabled doit être défini sur TRUE. Pour les plateformes non z/OS, spécifiez le nom de chemin qualifié complet de votre fichier de clés certifiées JKS. Pour z/OS,définissez le nom JKS ou le fichier de clés RACF du fichier de clés certifiées. Le même format est utilisé pour les valeurs des propriétés SSLKeyStoreName et SSLTrustStoreName. Reportez-vous à la description de la propriété KeyStore Name pour plus d'informations sur ce format.
Un fichier de clés certifiées est un fichier de base de données de clés (fichier de clés) conçu pour contenir des clés publiques ou des certificats. Pour des raisons pratiques, les clés privées peuvent également êtres stockées dans le fichier de clés certifiées et la propriété Nom du fichier de clés peut alors être vide ou pointer vers le fichier de clés certifiées. Si la propriété SSLTrustStoreName / SSLTrustStorePassword est laissée vide, un message d'information est généré dans le fichier journal du serveur.
Remarque : le fichier JKS peut avoir d'autres extensions de fichier que .ks.
SSLTrustStorePassword
Cette valeur, facultative, s'applique aux connexions TCP/IP uniquement et SSLEnabled doit être défini sur TRUE. Indiquez le mot de passe du fichier de clés certifiées.
SSLEncryptionType
La valeur de la propriété SSLEncryptionType est insensible à la casse et son indication est optionnelle. Elle s'applique aux connexions TCP/IP uniquement et SSLEnabled doit être défini sur TRUE. Sélectionnez le type de chiffrement STRONG, WEAK ou ENULL. Ils font référence à la force des codes de chiffrement qui est liée à la longueur de la clé. Tous les codes de chiffrement dont l'utilisation est autorisée pour l'exportation (en dehors des Etats-Unis) se trouvent dans la catégorie des codes faibles et les autres dans la catégorie des codes forts. Le type de chiffrement par défaut est WEAK. Lorsque la valeur ENULL est spécifiée, l'adaptateur de ressources IMS TM utilise une spécification de chiffrement dont le nom contient la chaîne “NULL". Le chiffrement Null permet de réaliser l'authentification pendant la phase d'établissement de liaison SSL, comme c'est le cas actuellement. Une fois cette phase terminée (y compris l'authentification selon les besoins), tous les messages circulent en clair (non chiffrés) sur la connexion socket.
IMSConnectName
Cette valeur est obligatoire pour les connexions Local Option uniquement. Définissez le nom de travail du système IMS Connect cible. Si IMSConnectName est défini, les propriétés HostName, PortNumber et SSL seront ignorées. Lorsqu'un nom IMS Connect est défini pour une fabrique de connexions, celle-ci peut uniquement être utilisée pour la création de connexions Local Option.
UserName
Cette valeur est facultative et correspond au nom d'utilisateur de la fonction d'autorisation de sécurité par défaut (SAF) qui sera utilisé pour les connexions créées par cette fabrique de connexions si aucune propriété UserName n'est fournie par le composant d'application ou le conteneur.
Password
Cette valeur est facultative et correspond au mot de passe qui sera utilisé pour les connexions créées par cette fabrique de connexions si le nom d'utilisateur utilisé est celui par défaut.
GroupName
Cette valeur est facultative et correspond au nom de groupe IMS qui sera utilisé pour les connexions créées par cette fabrique de connexions si le nom d'utilisateur utilisé est celui par défaut.
Remarque : La propriété GroupName ne peut être fournie que dans un environnement de connexion EIS gérée par composant.
DataStoreName
Cette valeur est obligatoire et correspond au nom du magasin de données IMS cible. Vous devez remplacer la valeur par défaut, "myDStrNm", par le paramètre ID de l'instruction concernant le magasin de données défini dans le membre de configuration du système IMS Connect cible. Il est également utilisé comme nom de membre XCF pour IMS lors des communications internes XCF entre IMS Connect et IMS OTMA. La valeur définie pour DataStoreName est sensible à la casse.
TraceLevel
Cette valeur est facultative et correspond au niveau des informations à tracer. Pour plus d'informations sur le niveau de trace, voir Consignation et traçabilité avec l'adaptateur de ressources du gestionnaire de transactions IMS.
TransactionResourceRegistration
Cette valeur est facultative et correspond au type d'enregistrement de ressources d'une transaction (enregistrement de transaction). Cette propriété est dépréciée mais elle est toujours compatible avec les anciennes applications. Les valeurs valides sont STATIC (immédiat) ou DYNAMIC (différé). Si cette propriété est définie sur DYNAMIC, l'enregistrement de la ressource dans la portée de la transaction sera mis en différé jusqu'à la première utilisation de la ressource pour une interaction.
ID de référentiel MFS XMI
Cette valeur est facultative et correspond à un nom unique permettant d'identifier l'emplacement du référentiel. Cet ID s'applique aux transactions MFS uniquement et doit correspondre à la zone de référentiel définie dans le gestionnaire de format généré de votre application. La valeur par défaut de cette zone est "default".
URI du référentiel MFS XMI
Cette valeur est facultative et définit l'emplacement physique du référentiel XMI. Les URI qui s'appliquent aux formats valides de cette zone sont, entre autres :
  • file://path_to_xmi, où path_to_xmi est un répertoire du système de fichiers local contenant les fichiers xmi (par exemple, file://c:/xmi).
  • http://url_to_xmi, où url_to_xmi est une url valide indiquant un répertoire contenant les fichiers xmi (par exemple, http://sampleserver.com/xmi).
  • hfs://path_to_xmi où path_to_xmi est le répertoire HFS sur l'hôte z/OS. Ce format n'est pris en charge que pour WebSphere Application Server pour z/OS.

Vos commentaires