Datos de usuario de mensajes de solicitud de transacción TCP
El modelo de programación de datos de usuarios de mensajes de solicitud de transacción TCP (TRM) permite intercambiar datos y parámetros directamente entre TI y el procesamiento de transacciones del host. El modelo de datos de usuarios TRM de TCP se basa en el modelo de servidor simultáneo de CICS. El agente de escucha estándar usa dos intercambios de red para ejecutar un único programa de transacción y requiere que el cliente:
Envíe un mensaje de solicitud de transacción (TRM) al agente de escucha estándar.
Reciba una respuesta TRM del programa de aplicación.
Envíe el flujo de datos de solicitud de aplicación al programa de transacción de servidor.
Reciban los datos de respuesta de la aplicación del programa de transacción de servidor.
En la ilustración siguiente se resume el flujo de trabajo entre el cliente, el agente de escucha de CICS estándar y el servidor simultáneo. Los números entre paréntesis indican el orden aproximado en el que se producen los eventos. Después de la ilustración se muestra una descripción más detallada de los eventos.
Proceso por el que el cliente inicia el agente de escucha predeterminado, que pasa la llamada al servidor simultáneo, que envía y recibe datos del cliente.
Diagrama de flujo de trabajo de resumen para el modelo de programación de datos de usuario TRM de TCP
El modelo de programación de datos de usuario TRM de TCP funciona de la siguiente manera:
Una aplicación invoca un método en un objeto .NET de TI configurado en servicios de componentes o en .NET Framework.
El runtime de TI llama al proxy de TI.
El proxy de TI realiza las siguientes acciones:
Lee el ensamblado y los metadatos que creó anteriormente el Diseñador del integrador de transacciones.
Asigna los tipos de datos de .NET Framework a los tipos de datos COBOL.
A continuación, el proxy de TI realiza estas acciones:
Llama a las rutinas de conversión para convertir los datos de la aplicación en tipos COBOL del equipo central.
Compila el búfer del flujo de datos plano que representa el cuaderno de copia o la declaración de COBOL.
Pasa el mensaje al componente de transporte TCP.
El transporte TCP de TI envía una solicitud de conexión al agente de escucha estándar mediante la dirección IP (Protocolo de Internet) del equipo central y la dirección de puerto del agente de escucha.
El agente de escucha estándar acepta la solicitud de conexión e indica al tiempo de ejecución de TI que envíe el TRM. A continuación, el agente de escucha estándar espera el TRM.
El TRM es un registro de datos con formato que identifica el procesamiento de transacciones del servidor que se va a invocar mediante su TRANID. El TP del agente de escucha de CICS es un procesamiento de transacciones del sistema central especial, cuya función principal es recibir invocaciones de procesamiento de transacciones de servidor enviadas por aplicaciones cliente que ejecutan TCP/IP.
El TRANID del procesamiento de transacciones de escucha estándar proporcionado por IBM es CSKL. El nombre del procesamiento de transacciones del procesamiento de transacciones del agente de escucha tal y como aparece en la tabla de control de programa (PCT) es EZACIC02.
El tiempo de ejecución de TI da formato al TRM y lo envía al agente de escucha estándar. TI espera la respuesta del TRM.
El agente de escucha estándar recibe el TRM, envía al tiempo de ejecución de TI una confirmación de recepción y, a continuación, lee el contenido del TRM. El agente de escucha interpreta la información del TRM y extrae el identificador de transacción del programa servidor simultáneo que va a dar servicio a la solicitud.
El agente de escucha estándar inicia el programa de procesamiento de transacciones de servidor simultáneo identificado por TRANID en la aplicación de ejemplo TRM (Mscmtics.cbl) mediante el inicio de EXEC CICS.
Mscmtics.cbl es el archivo de procesamiento de transacciones de ejemplo de Microsoft que se usa para pasar datos entre TI y el método de procesamiento de transacciones del servidor mediante COMMAREA. Microsoft desarrolla el método de procesamiento de transacciones de ejemplo Mscmtics.cbl y se proporciona como parte del software de Host Integration Server. Se encuentra en $\Microsoft Host Integration Server\SDK\Samples\Comti\ProgrammingSpecifics\Tcp. Antes de usar este modelo, debe compilarse, vincularse e instalarse en el equipo central.
Nota
Si el agente de escucha estándar no puede iniciar el servidor simultáneo, el agente de escucha da formato a un mensaje de error y lo devuelve al transporte TCP de TI. Estos son algunos de los motivos por los que es posible que el agente de escucha no pueda iniciarse:
Se rechazó la conexión debido a recursos de CICS limitados (por ejemplo, supera el número máximo de tareas CICS o tareas de servidor simultáneas).
El TRANID no es válido o está deshabilitado para el servidor simultáneo.
El programa de servidor simultáneo asociado al identificador de transacción no es válido, está deshabilitado o no se encuentra disponible.
Nota
El mensaje de error del agente de escucha de CICS se basa en caracteres y siempre comienza con las letras EZY. La longitud del mensaje de error es variable, y el final del mensaje viene determinado por el socket que cerró el agente de escucha de CICS.
El agente de escucha estándar llama a la interfaz de protocolo de aplicación de socket (API) en el entorno de host. El agente de escucha estándar no puede enviar la respuesta TRM. La respuesta TRM representa un proceso de sincronización que permite que el programa de transacciones se pueda iniciar antes de que el cliente envíe los datos de solicitud de aplicación. Este proceso de sincronización es necesario debido a la consideración interna de la arquitectura de CICS (no hay ninguna garantía sobre cuándo se inicia un programa de transacciones después de realizar la solicitud).
Después de que el agente de escucha de CICS estándar haya emitido el comando start para la transacción de servidor simultánea, el agente de escucha estándar está fuera del bucle de procesamiento de la aplicación y es libre de escuchar otra solicitud entrante.
Una vez que se ejecuta el servidor simultáneo, lee el mensaje inicial de transacción (TIM) enviado por el agente de escucha estándar.
El mensaje TIM describe el entorno TCP/IP en el que se ejecuta el servidor y contiene la información de socket TCP/IP que usa el servidor simultáneo para comunicarse con el transporte TCP de COMTI y el encabezado del mensaje de cliente que usa el servidor simultáneo para personalizar su comportamiento de ejecución.
El servidor simultáneo:
Da formato a la respuesta TRM.
Envía una respuesta TRM al transporte TCP de TI para informarle de que ahora puede enviar los datos de solicitud de la aplicación.
Emite una recepción y espera los datos de solicitud de la aplicación.
El envío de la respuesta TRM completa la primera parte de la secuencia de intercambio del agente de escucha estándar.
TI evalúa el TRM y pasa los datos al servidor simultáneo. TI también envía el apagado del socket y, a continuación, TI espera los datos de respuesta.
Una vez que el servidor simultáneo recibe los datos de solicitud de la aplicación, el servidor realiza la lógica de negocios en los datos.
Una vez que el servidor haya terminado de procesar la solicitud y formular la respuesta, prepara los datos de respuesta y, a continuación, envía la respuesta directamente al cliente. Completar el procesamiento de los datos de la aplicación indica el final de la segunda secuencia de intercambio.
El servidor simultáneo cierra el socket.
El proxy de TI recibe los datos de respuesta y procesa dicha respuesta. El proxy de TI realiza las siguientes acciones:
Recibe el mensaje del componente de transporte TCP.
Lee el búfer de mensajes.
El proxy de TI realiza las siguientes acciones:
Asigna los tipos de datos COBOL a los tipos de datos de .NET Framework.
Llama a las rutinas de conversión para convertir los tipos COBOL del equipo central en los datos de la aplicación.
El tiempo de ejecución de TI devuelve los datos convertidos a la aplicación .NET Framework que invocó el método.
Para implementar este modelo, debe proporcionar a TI una dirección IP, un número de puerto y un nombre de programa CICS para ejecutar la aplicación pasada por el programa de servidor simultáneo (Mscmtics.cbl). El modelo requiere la instalación, dentro de CICS, del agente de escucha predeterminado proporcionado por IBM (EZACIC02). El agente de escucha predeterminado de IBM de CICS usa la configuración predeterminada proporcionada por IBM.
Host Integration Server incluye código de ejemplo que muestra cómo implementar el modelo de programación tcp TRM Link. El código de ejemplo se encuentra en el \directorio de instalación\SDK\Samples\AppInt. Inicie Visual Studio, abra el tutorial que desea usar y siga las instrucciones del archivo Léame.
Para obtener información sobre cómo configurar el equipo central y escribir aplicaciones de servidor para TCP/IP, consulte TCP/IP V3R2 para MVS: Guía de interfaz de sockets TCP/IP de CICS (documento de IBM SC31-7131).
Consulte también
Componentes del Integrador de transacciones
Mensajes de solicitud de transacciones
Convertir tipos de datos de Automation a z/OS COBOL]
Conversión de tipos de datos de COBOL de z/OS a Automation
Componentes de CICS
Runtime de TI
Selección del modelo de programación adecuado
Modelos de programación