Escritura de código que especifica un entorno remoto
Las aplicaciones pueden establecer la SelectionHint propiedad para especificar un entorno remoto (RE) mediante programación. Al especificar el RE, la aplicación identifica la región CICS o IMS en la que se llevan a cabo programas de transacción cuando el entorno en tiempo de ejecución del integrador de transacciones (TI) controla las llamadas a los métodos del componente de TI.
El siguiente código de Visual Basic muestra cómo establecer la SelectionHint propiedad :
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"
En este ejemplo se muestra cómo la aplicación puede indicar explícitamente al entorno en tiempo de ejecución de TI que use el RE denominado MyRemEnvName al controlar la llamada a method1. En este ejemplo, MyRemEnvName es la primera cadena del archivo MyREList.txt. Las llamadas de método realizadas después method1 de eso siguen la SelectionHint asignación se controlan mediante el RE original que se asignó al componente, no el nuevo. En otras palabras, la invalidación mediante programación del RE predeterminado no continúa más allá de una sola llamada de método.
Si una aplicación intenta establecer la SelectionHint propiedad en una cadena que no se corresponde con el nombre de un RE, se notifica un error y se usa el RE original.
La SelectionHint propiedad se puede establecer en un RE desactivado. Sin embargo, se producirá un error en la siguiente llamada de método al objeto porque se seleccionó una re desactivada.
La propiedad SelectionHint es opcional. Si la SelectionHint propiedad no especifica un RE, el entorno en tiempo de ejecución de TI usa el RE original.