Configuration de l’adaptateur BizTalk pour les applications d’hôte
La boîte de dialogue Adaptateur BizTalk pour la configuration de l’application hôte permet de définir et de gérer les connexions aux systèmes IBM CICS, IMS et iSeries distants. Elle se lance lorsque vous cliquez sur le champ de la valeur de propriété Chaînes de connexion. Vous pouvez utiliser cette boîte de dialogue pour ajouter un assembly .NET TI. Elle peut également servir dans le cadre du mappage, pour importer, exporter et supprimer des mappages, modifier des chaînes de connexion et afficher les propriétés d’un assembly .NET TI.
La boîte de dialogue Configuration de l’application hôte comprend les composants suivants : une barre d’outils, un menu, une grille de données et un volet de résultats. Cette rubrique contient les sections suivantes, qui décrivent les différentes tâches possibles.
Commandes de menu et de barre d’outils
Création et gestion de mappages
Paramètres et mappages de chaînes de connexion
Mise à niveau à partir de versions antérieures de Host Integration Server
Commandes de menu et de barre d’outils
Vous avez accès à des commandes qui permettent de créer et de gérer des chaînes de connexion par le biais des barres d’outils et des menus contextuels. Vous pouvez cliquer avec le bouton droit n’importe où dans la grille de données pour afficher des menus contextuels. Par exemple, lorsque vous cliquez avec le bouton droit sur une chaîne de connexion, vous avez la possibilité d’afficher, de modifier, de supprimer, d’importer et d’exporter des mappages. Vous pouvez double-cliquer sur la chaîne de connexion pour la mettre en mode d’édition. La touche Suppr permet de supprimer l’élément actuellement sélectionné, et la touche F1 d’ouvrir l’aide en ligne.
La liste suivante décrit les actions que vous pouvez effectuer :
Ajouter un assembly .NET TI à partir du Global Assembly Cache (GAC) ou ajouter un assembly au mappage en utilisant le chemin du fichier local. Les colonnes sont remplies avec les valeurs par défaut reflétées à partir de l’assembly. La chaîne de connexion par défaut n’est utilisable que si vous entrez les valeurs requises.
Supprimer le mappage sélectionné. Une boîte de dialogue apparaît, vous demandant de confirmer la suppression.
Modifier la chaîne de connexion dans le mappage sélectionné. La boîte de dialogue Chaîne de connexion, permettant de modifier la chaîne de connexion, s’ouvre alors.
Exporter des mappages au format XML afin de les sauvegarder. Vous pouvez les restaurer ultérieurement à l’aide de la fonctionnalité Importer un mappage. Les fonctionnalités d’importation/exportation permettent de partager des mappages entre différents points de terminaison.
Importer des mappages ou des définitions RE afin d’importer les données XML exportées par la boîte de dialogue Adaptateur BizTalk pour la configuration de l’application hôte. Vous pouvez également importer les définitions RE exportées par le gestionnaire TI lorsqu’un mappage est sélectionné.
Afficher les propriétés de l’assembly .NET TI afin d’afficher les propriétés de l’assembly. La balise XML indique le nom du document d’entrée/sortie pris en charge par cet assembly. Le nom de la méthode fait partie du nom de la balise, mais il n’est pas utilisé pour trouver un mappage. Toutes les propriétés sont en lecture seule.
Fenêtre Mappage de DataGrid
La boîte de dialogue Mappage de DataGrid contient les éléments suivants :
État (complet ou incomplet). Si la chaîne de connexion ne contient pas toutes les informations de connexion nécessaires, un avertissement signalé par un point d’exclamation blanc entouré en rouge apparaît. Une fois les informations manquantes ajoutées, l’avertissement disparaît.
Nom de la classe et nom de l’interface de l’assembly TI utilisé dans le cadre du mappage.
Nom de l’assembly : le nom fort de l’assembly si celui-ci est chargé à partir du cache GAC, ou le chemin complet de l’assembly s’il s’agit d’un assembly local. Ce champ est rempli automatiquement lorsqu’un assembly est ajouté. Il est en lecture seule.
Environnement distant, qui définit la chaîne de connexion. Il représente les caractéristiques d’un système distant qui reçoit les demandes de l’adaptateur d’applications hôtes BizTalk. La chaîne de connexion se compose du type d’environnement distant, du modèle de programmation, de l’identification de l’hôte distant, du transport réseau et d’autres paramètres utilisés lors de la communication avec l’hôte distant.
Point de terminaison distant : nom DNS ou adresse IP de l’hôte IBM distant.
Volet de résultats, qui affiche les valeurs de la chaîne de connexion du mappage sélectionné.
Création et gestion de mappages
Cette section décrit les tâches de maintenance possibles.
Ajouter des assemblys pour créer une chaîne de connexion
Dans la barre d’outils, cliquez sur l’icône de dossier, puis sélectionnez Ajouter des assemblys à partir du cache GAC ou Ajouter un assembly local. L’option Ajouter des assemblys à partir du cache GAC lance une boîte de dialogue dans laquelle figurent tous les assemblys du cache GAC que vous pouvez sélectionner. Si vous sélectionnez Ajouter un assembly local, vous pouvez parcourir les assemblys installés localement.
Les assemblys peuvent également être ajoutés à l’aide des options Ajouter un cache GAC et Ajouter un assembly local du menu.
Supprimer une chaîne de connexion
Sélectionnez le ou les mappages à supprimer. Cliquez sur l’icône [X] dans la barre d’outils pour supprimer les mappages sélectionnés. Une boîte de dialogue s’affiche pour vous permettre de confirmer la suppression.
Vous pouvez également supprimer des mappages avec l’option Supprimer les mappages du menu.
Modifier la chaîne de connexion
La chaîne de connexion est utilisée pour sérialiser l’instance RE. Elle est remplie avec des valeurs par défaut lorsqu’un assembly est spécifié. Double-cliquez sur le mappage sélectionné, sélectionnez l’option Modifier ou le menu Modifier la chaîne de connexion pour ouvrir la boîte de dialogue Chaîne de connexion. Vous pouvez alors modifier la chaîne de connexion de l’instance RE spécifiée. Si les valeurs requises ne sont pas entrées, un indicateur d’erreur s’affiche.
L’objet RE valide les valeurs de propriété minimales requises. Un indicateur est associé à la cellule Chaîne de connexion si les valeurs de propriété requises ne sont pas définies. Les propriétés requises figurent dans la section Paramètres et mappages de la chaîne de connexion de cette rubrique. La validation RE couvre une étendu limitée. Par ailleurs, des valeurs inappropriées risquent d’entraîner des erreurs de runtime TI.
La boîte de dialogue présente les propriétés modifiables ou non dans une grille. Dans la zone de texte en lecture seule dans la partie inférieure figure la chaîne de connexion créée en fonction des valeurs entrées dans la grille de propriétés. Les propriétés sont collectées en fonction des méthodes publiques définies par l’objet RE, avec les valeurs définies par l’objet lui-même. Différents convertisseurs de type et éditeurs de propriétés sont fournis pour faciliter la modification des valeurs de propriété.
L’environnement distant affiche les propriétés requises pour se connecter à l’hôte. Elles sont indiquées par un astérisque (*) dans la grille de propriétés. S’il manque une ou plusieurs propriétés, un point d’exclamation blanc entouré en rouge apparaît sur la grille de données. Cet avertissement vous informe que les propriétés manquantes peuvent être fournies à l’aide de remplacements à l’exécution.
Les paramètres de sécurité sont contrôlés par des énumérations de sécurité prédéfinies qui peuvent être combinées à l’aide de l’opérateur OR pour former de nouveaux paramètres de sécurité.
L’indicateur Désactivé est exclusif au Client, au Package et à l’Utilisateur. Il est effacé dès lors que l’un des trois autres est coché. Lorsque l’indicateur Désactivé est coché, les trois autres options sont effacées.
L’éditeur SSOApplication est porté à partir d’une version précédente avec des modifications mineures. Vous pouvez spécifier une application associée directement dans la grille de propriétés ou utiliser l’éditeur pour en sélectionner une déjà créée.
Paramètres et mappages de chaînes de connexion
Dans les tableaux suivants figurent les propriétés prises en charge qui définissent l’environnement hôte et le modèle de programmation. Des astérisques indiquent les propriétés requises.
Les valeurs par défaut sont définies par les objets RE eux-mêmes. La validation effectuée est limitée.
Données utilisateur SNA
| Propriété | Valeur |
|---|---|
| Propriété | Valeur |
| CodePage | 37 |
| Paramètres régionaux | 1033 |
| **LocalLUName* | |
| **ModeName* | PA62TKNU |
| Nom | SNAUserData. Lecture seule. |
| **RemoteLUName* | |
| Sécurité | Désactivé |
| SSOApplication | |
| SynLevel2Supported | False |
| TimeOut | 0 |
\* Champ obligatoire.
Lien SNA
| Propriété | Valeur |
|---|---|
| Propriété | Valeur |
| AdministrationFlags | 0 |
| CodePage | 37 |
| Paramètres régionaux | 1033 |
| **LocalLUName* | |
| MirrorTranId | CSMI |
| **ModeName* | PA62TKNU |
| Nom | SNALink. Lecture seule. |
| **RemoteLUName* | |
| Sécurité | Désactivé |
| SSOApplication | |
| SyncLevel2Supported | False |
| TimeOut | 0 |
\* Champ obligatoire.
Données utilisateur HTTP
| Propriété | Valeur |
|---|---|
| Propriété | Valeur |
| AliasTransactionId | |
| AllowRedirects | False |
| CodePage | 37 |
| **HttpPort* | |
| **Ipaddress* | |
| Paramètres régionaux | 1033 |
| Nom | HttpUserData. Lecture seule. |
| Sécurité | Désactivé |
| SSOApplication | |
| TimeOut | 0 |
| UserAgent | |
| UseSsl | False |
\* Champ obligatoire.
Lien HTTP
| Propriété | Valeur |
|---|---|
| Propriété | Valeur |
| AliasTransactionId | |
| AllowRedirects | False |
| CodePage | 37 |
| Converter | |
| **HttpPort* | |
| **Ipaddress* | |
| Paramètres régionaux | 1033 |
| MirrorProgramName | |
| Nom | HttpLink. Lecture seule. |
| Sécurité | Désactivé |
| SSOApplication | |
| TimeOut | 0 |
| UseConverter | False |
| UserAgent | |
| UseSsl | False |
\* Champ obligatoire.
IMS LU6.2
| Propriété | Valeur |
|---|---|
| Propriété | Valeur |
| CodePage | 37 |
| Paramètres régionaux | 1033 |
| **LocalLUName* | |
| **ModeName* | PA62TKNU |
| Nom | IMSLU62. Lecture seule. |
| **RemoteLUName* | |
| Sécurité | Désactivé |
| SSOApplication | |
| TimeOut | 0 |
\* Champ obligatoire.
Se connecter à IMS
| Propriété | Valeur |
|---|---|
| Propriété | Valeur |
| CodePage | 37 |
| ImsFormatModName | |
| **Ipaddress* | |
| ItocExitName | |
| Paramètres régionaux | 1033 |
| Nom | IMSConnect. Lecture seule. |
| OtmaSystemId | |
| Sécurité | Désactivé |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
\* Champ obligatoire.
Données utilisateur/lien TRM
| Propriété | Valeur |
|---|---|
| Propriété | Valeur |
| CodePage | 37 |
| ConcurrentServerTransactionId | MSCS |
| **Ipaddress* | |
| Paramètres régionaux | 1033 |
| Nom | TRMUserData. Lecture seule. |
| Sécurité | Désactivé |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
\* Champ obligatoire.
Données utilisateur/lien ELM
| Propriété | Valeur |
|---|---|
| Propriété | Valeur |
| CodePage | 37 |
| **Ipaddress* | |
| Paramètres régionaux | 1033 |
| Nom | ELMUserData. Lecture seule. |
| Sécurité | Désactivé |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
\* Champ obligatoire.
Appel de programmes distribué
| Propriété | Valeur |
|---|---|
| Propriété | Valeur |
| CodePage | 37 |
| **Ipaddress* | |
| Paramètres régionaux | 1033 |
| Nom | DistributedProgramCall. Lecture seule. |
| Sécurité | Désactivé |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
\* Champ obligatoire.
Données utilisateur/lien des sockets du système Z
| Propriété | Valeur |
|---|---|
| Propriété | Valeur |
| CodePage | 37 |
| **Ipaddress* | |
| Paramètres régionaux | 1033 |
| Nom | SystemzSocketsUserData. Lecture seule. |
| Sécurité | Désactivé |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
\* Champ obligatoire.
Données utilisateur des sockets du système I
| Propriété | Valeur |
|---|---|
| CodePage | 37 |
| **Ipaddress* | |
| Paramètres régionaux | 1033 |
| Nom | SystemSocketUserData. Lecture seule. |
| Sécurité | Désactivé |
| SSOApplication | *TCPPorts |
| TimeOut | 0 |
\* Champ obligatoire.
Importer des mappages
Pour importer des mappages exportés par l’adaptateur BizTalk pour la configuration de l’application hôte, cliquez sur l’icône Importer des mappages ou des définitions RE. Sélectionnez Importer des mappages, ou bien Importer des mappages dans le menu Fichier. Vous pouvez alors rechercher les données XML exportées par la boîte de dialogue Adaptateur BizTalk pour la configuration de l’application hôte. Sélectionnez le fichier à importer. Le processus d’importation ne remplace pas les mappages existants.
Importer une définition RE
Utilisez cette option pour importer des définitions RE exportées par le gestionnaire TI. Après avoir sélectionné un mappage, cliquez sur l’icône Importer des mappages ou des définitions RE. Sélectionnez Importer des définitions RE, ou bien Importer des définitions RE dans le menu Fichier. Vous pouvez alors rechercher les données XML exportées par le gestionnaire TI. La boîte de dialogue qui s’affiche présente les définitions RE que vous pouvez sélectionner. Seules les définitions RE qui possèdent le même modèle de programme que le mappage sélectionné apparaissent.
Exporter des mappages
Pour exporter des mappages dans un fichier XML, cliquez sur l’icône Exporter des mappages au format XML ou sélectionnez Exporter des mappages dans le menu Fichier. Vous pouvez alors accéder à l’emplacement d’enregistrement du fichier. Vous avez la possibilité d’importer ce fichier avec la fonctionnalité Importer un mappage.
Propriétés de l’assembly
Vous pouvez afficher les propriétés pertinentes de l’assembly, ainsi que le nom de la balise XML du document d’entrée/sortie pris en charge par cet assembly. Le nom de la méthode fait partie du nom de la balise, mais il n’est pas utilisé pour trouver un mappage. Toutes les propriétés sont en lecture seule. Sélectionnez le mappage, puis cliquez sur l’icône Propriétés de l’assembly, ou sélectionnez Afficher les propriétés de l’assembly dans le menu.
Mise à niveau à partir de versions antérieures de Host Integration Server
Cette section explique comment migrer des applications existantes de type adaptateur BizTalk pour les applications hôtes de façon à utiliser la chaîne de connexion :
Si la définition RE utilisée dans l’adaptateur BizTalk pour les applications hôtes est la définition RE par défaut, exportez la configuration avec le gestionnaire TI, puis importez-la à l’aide de la boîte de dialogue Chaînes de connexion.
Si une autre définition RE a été employée, associez l’objet de déploiement à la nouvelle définition RE et exportez la configuration dans le gestionnaire TI. Importez la configuration à l’aide de la boîte de dialogue Chaînes de connexion.
Il n’est pas possible de changer de définition RE dans l’administration BizTalk Server sans utiliser la chaîne de connexion, car la boîte de dialogue Type d’hôte a été supprimée.
Le remplacement de la définition RE par l’intermédiaire de l’administration BizTalk Server n’est pas pris en charge. Il est possible mais déconseillé d’utiliser le contexte de message pour effectuer ce remplacement. Nous vous recommandons d’utiliser des chaînes de connexion.
Si l’application SSO spécifiée n’est pas l’application par défaut, vous pouvez utiliser le gestionnaire TI pour associer la définition RE à cette application SSO et continuer à utiliser la définition RE statique. Une autre possibilité consiste à la spécifier dans la chaîne de connexion.
Importation des données XML exportées par le gestionnaire TI
Le gestionnaire TI n’est pas nécessaire, sauf en cas de migration. Vous pouvez exporter la définition d’instances RE et d’objets WIP dans un fichier XML, qui peut être importé par la boîte de dialogue Chaînes de connexion.
Avertissement
La propriété Inclure le paramètre de contexte des assemblys .NET TI utilisés dans les mappages doit être définie sur True. Sinon, l’appel de la méthode TI échoue à l’exécution.
L’adaptateur BizTalk pour la configuration de l’application hôte utilise la fonctionnalité de définition RE dynamique introduite dans Host Integration Server 2009. Avec cette fonctionnalité, les informations de l’hôte requises par le runtime TI peuvent être spécifiées juste avant que la méthode soit appelée, à condition que les informations de connexion de l’hôte soient connues. Il n’est pas nécessaire de déployer l’assembly client .NET ni de l’associer à une définition RE prédéfinie dans le gestionnaire TI pour que ses méthodes puissent être appelées.
Avec l’adaptateur BizTalk pour les applications hôtes, les informations de connexion peuvent être générées dans une chaîne de connexion qui est analysée et définie sur l’objet RE à l’exécution. Des informations sur une définition RE peuvent être spécifiées lorsque le port hébergeant l’adaptateur d’applications hôtes est configuré. Il est stocké dans le cadre des informations de configuration de port gérées par l’utilitaire d’administration BizTalk. Si vous appliquez cette approche et que vous avez recours à l’adaptateur BizTalk pour les applications hôtes afin d’intégrer une application .NET à des applications hôtes, il vous suffit d’utiliser le concepteur TI pour créer les assemblys du client .NET TI. Toutes les autres tâches peuvent être effectuées dans BizTalk Server.
Dans le tableau suivant figurent les menus et actions de la barre d’outils.
| Barre d’outils/menu | Actions |
|---|---|
| Ajouter des assemblys pour créer une chaîne de connexion | Ajouter un assembly .NET TI à partir du cache GAC ou ajouter un assembly au mappage en utilisant le chemin du fichier local. Toutes les colonnes sont remplies avec les valeurs par défaut reflétées à partir de l’assembly. La chaîne de connexion par défaut n’est utilisable que si vous entrez toutes les valeurs requises. |
| Supprimer une chaîne de connexion | Supprimer les mappages sélectionnés. Une boîte de dialogue apparaît, vous demandant de confirmer la suppression. |
| Modifier la chaîne de connexion | Modifier la chaîne de connexion dans le mappage sélectionné. La boîte de dialogue Chaîne de connexion, permettant de modifier la chaîne de connexion, s’ouvre alors. |
| Exporter des mappages au format XML | Exporter des mappages pour les sauvegarder. Ils peuvent être importés ultérieurement à l’aide de la fonctionnalité Importer un mappage. Les fonctionnalités d’importation/exportation permettent de partager facilement des mappages entre différents points de terminaison. |
| Importer des mappages ou des définitions RE | Importer les données XML exportées par la boîte de dialogue Adaptateur BizTalk pour la configuration de l’application hôte, ou importer les définitions RE exportées par le gestionnaire TI lorsqu’un mappage est sélectionné. |
| Afficher les propriétés de l’assembly .NET TI | Afficher les propriétés pertinentes de l’assembly, ainsi que le nom de la balise XML du document d’entrée/sortie pris en charge par cet assembly. Le nom de la méthode fait partie du nom de la balise, mais il n’est pas utilisé pour trouver un mappage. Toutes les propriétés sont en lecture seule. |