Écriture de code qui spécifie un environnement distant

Les applications peuvent définir la SelectionHint propriété pour spécifier un environnement distant (RE) par programmation. En spécifiant la re, l’application identifie la région CICS ou IMS dans laquelle les programmes de transaction 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 indiquer explicitement à l’environnement d’exécution TI d’utiliser le re nommé 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, qui suivent l'affectation de SelectionHint, sont gérés à l’aide du RE d’origine qui a été affecté au composant, et non après la nouvelle. En d’autres termes, le remplacement par programmation du 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, car un RE désactivé a été sélectionné.

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 de l’environnement distant avec la propriété SelectionHint