Écriture de code spécifiant un environnement distant

  • Article

Les applications peuvent définir la SelectionHint propriété pour spécifier un environnement distant (RE) par programmation. En spécifiant le RE, l’application identifie la région CICS ou IMS où les programmes de transaction sont exécutés lorsque l’environnement d’exécution TI (Transaction Integrator) 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 nom MyRemEnvName RE 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 l’affectation SelectionHint sont gérés à l’aide du re d’origine affecté au composant, et non du nouveau. En d’autres termes, le remplacement par programme du RE par défaut ne se poursuit pas au-delà d’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 d’un environnement distant avec la propriété SelectionHint