Schreiben von Code, der eine Remoteumgebung angibt

Anwendungen können die SelectionHint Eigenschaft so festlegen, dass eine Remoteumgebung (RE) programmgesteuert angegeben wird. Durch Angabe des RE identifiziert die Anwendung die CICS- oder IMS-Region, in der Transaktionsprogramme ausgeführt werden, wenn die Laufzeitumgebung Transaction Integrator (TI) Aufrufe an die 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"  
  

In diesem Beispiel wird gezeigt, wie die Anwendung die TI-Laufzeitumgebung explizit anweisen kann, den RE namens MyRemEnvName beim Behandeln des Aufrufs zu method1 verwenden. In diesem Beispiel MyRemEnvName ist die erste Zeichenfolge in der Datei MyREList.txt. Alle Methodenaufrufe, die nach der SelectionHint-Zuweisung mit method1 erfolgen, werden mit dem ursprünglichen RE behandelt, das der Komponente zugewiesen wurde, und nicht mit dem neuen. Mit anderen Worten, die programmgesteuerte Außerkraftsetzung der 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 eines RE 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 für das Objekt schlägt jedoch fehl, da eine deaktivierte RE ausgewählt wurde.

Die SelectionHint-Eigenschaft ist optional. Wenn die SelectionHint Eigenschaft keine RE angibt, verwendet die TI-Laufzeitumgebung die ursprüngliche RE.

Siehe auch

Remoteumgebungsauswahl mit der SelectionHint-Eigenschaft