Écriture de code spécifiant un environnement distant

Les applications peuvent définir la SelectionHint propriété pour spécifier un environnement distant (re) par programmation. En spécifiant le nouveau, l’application identifie la région CICS ou IMS dans laquelle les programmes de transactions sont exécutés lorsque l’environnement d’exécution de l’intégrateur de transactions (TI) gère les appels aux méthodes du composant TI.

le code Visual Basic suivant montre comment définir la SelectionHint propriété :

Dim objExample As Object  
Dim Store As String  
Set objExample = CreateObject("MyComponent.MyInterface")  
Open "My REList.txt" for Input as #1  
Line Input #1, strRE  
Close #1  
  
objExample.SelectionHint = strRE  
RtrnVal = objExample.method1(parm1,  , parmN) 'Use RE named "MyRemEnvName"  
  

Cet exemple montre comment l’application peut demander explicitement à l’environnement d’exécution TI d’utiliser le nouveau nom MyRemEnvName lors de la gestion de l’appel à method1 . Dans cet exemple, MyRemEnvName est la première chaîne du fichier MyREList.txt. Tous les appels de méthode effectués après method1 cela suivent l' SelectionHint attribution sont gérés à l’aide du re d’origine qui a été assigné au composant, et non du nouveau. En d’autres termes, la substitution par programme de RE par défaut ne continue pas après un seul appel de méthode.

Si une application tente de définir la SelectionHint propriété sur une chaîne qui ne correspond pas au nom d’un re, une erreur est signalée et le re d’origine est utilisé.

La SelectionHint propriété peut être définie sur un re désactivé. Toutefois, l’appel de méthode suivant à l’objet échouera en raison de la sélection d’un RE désactivé.

La propriété SelectionHint est facultative. Si la SelectionHint propriété ne spécifie pas de re, l’environnement d’exécution TI utilise le re d’origine.

Voir aussi

Sélection d’un environnement distant avec la propriété SelectionHint