Scrittura di codice che specifica un ambiente remoto

Le applicazioni possono impostare la SelectionHint proprietà per specificare un ambiente remoto (RE) a livello di codice. Specificando RE, l'applicazione identifica l'area CICS o IMS in cui vengono eseguiti i programmi di transazione quando l'ambiente di runtime di Transaction Integrator (TI) gestisce le chiamate ai metodi del componente TI.

Nel codice di Visual Basic seguente viene illustrato come impostare la SelectionHint proprietà :

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"  
  

In questo esempio viene illustrato come l'applicazione può indicare in modo esplicito all'ambiente di runtime TI di usare il re denominato MyRemEnvName durante la gestione della chiamata a method1. In questo esempio MyRemEnvName è la prima stringa nel file MyREList.txt. Tutte le chiamate al metodo effettuate dopo method1 che seguono l'assegnazione SelectionHint vengono gestite usando il re originale assegnato al componente, non quello nuovo. In altre parole, l'override programmatico dell'istanza RE predefinita non continua oltre una singola chiamata al metodo.

Se un'applicazione tenta di impostare la SelectionHint proprietà su una stringa che non corrisponde al nome di un RE, viene segnalato un errore e viene usato re originale.

La SelectionHint proprietà può essere impostata su un RE disattivato. Tuttavia, la chiamata al metodo successivo all'oggetto avrà esito negativo perché è stata selezionata l'opzione RE disattivata.

La proprietà SelectionHint è facoltativa. Se la SelectionHint proprietà non specifica un RE, l'ambiente di runtime TI usa il re originale.

Vedere anche

Selezione di un ambiente remoto con la proprietà SelectionHint