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 re, la aplicación identifica la región CICS o IMS donde se llevan a cabo los 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.

En el Visual Basic siguiente se 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 MyRemEnvName denominado al controlar la llamada a method1. En este ejemplo, MyRemEnvName es la primera cadena del archivo MyREList.txt. Todas las llamadas a métodos method1SelectionHint realizadas después de esa 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 después de una sola llamada de método.

Si una aplicación intenta establecer SelectionHint la 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 al método al objeto porque se seleccionó un RE desactivado.

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.

Consulte también

Selección de entorno remoto con la propiedad SelectionHint