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.