Schreiben von Code zum Festlegen einer Remoteumgebung

Anwendungen können die SelectionHint -Eigenschaft so festlegen, dass eine Remoteumgebung programmgesteuert angegeben wird. Durch Angabe des RE identifiziert die Anwendung die CICS- oder IMS-Region, in der Transaktionsprogramme ausgeführt werden, wenn die Transaktionsintegrator-Laufzeitumgebung (TI) Aufrufe der Methoden der TI-Komponente verarbeitet.

Der folgende Visual Basic-Code veranschaulicht, wie die SelectionHint Eigenschaft festgelegt wird:

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"  
  

Dieses Beispiel zeigt, wie die Anwendung die TI-Laufzeitumgebung explizit anweisen kann, den NAMEN MyRemEnvName RE zu verwenden, wenn der Aufruf von behandelt method1wird. In diesem Beispiel MyRemEnvName ist die erste Zeichenfolge in der Datei MyREList.txt. Alle Methodenaufrufe, die nach method1 der SelectionHint Zuweisung ausgeführt werden, werden mit dem ursprünglichen RE verarbeitet, der der Komponente zugewiesen wurde, nicht mit dem neuen. Anders ausgedrückt: Die programmgesteuerte Überschreibung des Standard-RE wird nicht über einen einzelnen Methodenaufruf hinaus fortgesetzt.

Wenn eine Anwendung versucht, die SelectionHint Eigenschaft auf eine Zeichenfolge festzulegen, die nicht dem Namen einer Re-Instanz entspricht, wird ein Fehler gemeldet, und die ursprüngliche RE wird verwendet.

Die SelectionHint -Eigenschaft kann auf eine deaktivierte RE festgelegt werden. Der nächste Methodenaufruf des Objekts schlägt jedoch fehl, da eine deaktivierte RE ausgewählt wurde.

Die SelectionHint-Eigenschaft ist optional. Wenn die SelectionHint Eigenschaft keinen RE angibt, verwendet die TI-Laufzeitumgebung den ursprünglichen RE.

Weitere Informationen

Auswahl der Remoteumgebung mit der SelectionHint-Eigenschaft