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 transacciones cuando el entorno 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 a métodos realizadas después de method1, que siguen a la asignación SelectionHint, se gestionan mediante el RE original asignado 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 configurar como un RE desactivado. Sin embargo, la siguiente llamada de método al objeto fallará 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.

Véase también

Selección de entorno remoto con la propiedad SelectionHint