Messages de demande de transaction et messages d’écouteur amélioré avec COMTIContext
Les développeurs d’intégrateurs de transactions (TI) peuvent passer des messages de demande de transaction (TRM) mis en forme personnalisés ou des messages d’écoute améliorés (ELM) d’un programme client au système CICS et recevoir des trms ou des modules ELM mis en forme personnalisés.
Les modules TRM ou ELM personnalisés sont transmis via des données de contexte. Les données de contexte sont contenues dans le paramètre FACULTATIF COMTIContext défini dans le code de l’application cliente et doivent être le paramètre final dans l’appel de méthode. Un TRM destiné à l’hôte doit être défini en tant que type défini par l’utilisateur (UDT) pour le modèle COM, ou en tant que structure pour le modèle .NET Framework. Le nom de l’UDT doit commencer par les caractères TRMIN. Une réponse TRM de l’hôte doit également être définie comme un type défini par l’utilisateur. Le nom de l’UDT doit commencer par les caractères TRMOUT. Voici quelques exemples de noms TRM valides : TRMINMyVeryOwn, TRMINStandard, TRMOUTMyVeryOwn et TRMOUTStandard.
La bibliothèque ou la structure de types peut contenir plusieurs définitions TRM, mais vous ne devez inclure qu’un seul TRM pour chaque direction (c’est-à-dire, un TRMIN et un TRMOUT) dans le paramètre COMTIContext dans un seul appel de méthode. Par exemple, dans Visual Basic, chaque tableau COMTIContext est déclaré comme un tableau dynamique de dimension unique de variantes (autrement dit, le nombre d’occurrences n’est pas spécifié).
Si vous définissez plusieurs TRM dans la même direction, le temps d’exécution ti utilise uniquement le premier TRM rencontré dans le tableau de contexte. (Dans certains cas, le premier TRM rencontré peut ne pas toujours être le premier que vous avez ajouté au tableau de contexte). Le temps d’exécution ti ignore les TRM restants dans le tableau jusqu’à ce que le TRM en cours d’utilisation soit détruit. Pour vous assurer que l’heure d’exécution de ti utilise le TRM approprié, n’ajoutez pas plusieurs trms destinées à la même direction à un tableau de contexte.
Notes
L’application cliente qui manipule le tableau context doit être en mesure d’accéder au fichier approprié au moment de l’exécution. Si vous utilisez Visual Basic6.0, l’application doit pouvoir accéder à COMTIContext.dll. Si vous utilisez Visual Basic .NET, l’application doit pouvoir accéder à Microsoft.HostIntegration.TI.ClientContext.dll.
Notes
Lorsque vous utilisez Visual Basic .NET, la structure de données utilisée en tant que TRM personnalisé doit être associée à un paramètre dans l’assembly. Par conséquent, vous devez créer une méthode factice dans l’assembly, un paramètre affecté à la méthode et la structure de données à utiliser comme TRM. Si vous ne le faites pas, vous ne pouvez pas référencer la structure dans l’application .NET Visual Basic. L’association d’un type défini par l’utilisateur à une méthode n’était pas obligatoire dans Visual Basic 6.0, car Visual Basic 6.0 autorisait le référencement des types définis par l’utilisateur non associés aux méthodes.
Voir aussi
Messages de requête de transaction
Comment passer un TRM personnalisé