Formato TRM para el modelo de programación de vínculos tcp

En este tema se describe el formato y el contenido del mensaje de solicitud de transacción (TRM) usado por el modelo de programación TCP TRM Link.

Mensaje de solicitud de TRM

En la tabla siguiente se muestra el contenido del mensaje de solicitud.

TranID Coma Cliente en datos
4 1 35

TranID
Identificador de transacción del servidor simultáneo que va a iniciar el agente de escucha.

Coma
Una coma (,) separa el identificador de transacción del cliente en los datos.

Cliente en datos
35 bytes de datos usados por la salida de seguridad TCP/IP de CICS y pasados al servidor simultáneo en el mensaje de inicio de la transacción (TIM).

Cliente en datos para el formato de salida de seguridad de Microsoft

El siguiente bloque de código describe el formato del cliente en los datos para la salida de seguridad de Microsoft.

struct CLIENT_IN_DATA {  
   BYTE    bUserID[8];  
   BYTE    bPassword[8];  
   BYTE    bLinkToName[8];  
   USHORT  usCommareaLen;  
   BYTE    bReserved[9];  
} UNALIGNED;  

Cliente en datos para el formato de salida de seguridad de IBM

El siguiente bloque de código describe el formato del cliente en los datos para la salida de seguridad de IBM.

struct CLIENT_IN_DATA2 {  
   BYTE    bSecFlag;  
   BYTE    bPassword[8];  
   BYTE    bUserID[8];  
   BYTE    bLinkToName[8];  
   USHORT  usCommareaLen;  
   BYTE    bReserved[8];  
} UNALIGNED;  

Mensaje de respuesta de TRM

En la tabla siguiente se muestra el contenido del mensaje de respuesta.

Longitud del mensaje de respuesta de TRM Longitud de campo con formato Código de campo con formato Datos
4 4 1 0-n

Nota:

La longitud del campo con formato, el código de campo con formato y los datos se pueden repetir varias veces en un único mensaje.

Longitud del mensaje de respuesta de TRM
Longitud total del mensaje de respuesta de TRM. Esta longitud es la suma de todas las longitudes de los campos con formato que siguen en el mensaje y no incluye la longitud del propio campo de longitud de mensaje de respuesta de TRM.

Longitud de campo con formato
Longitud del campo con formato.

La longitud del campo con formato es la suma de la combinación de la longitud de código de campo con formato y la longitud de datos.

Código de campo con formato
Código de 1 byte que describe la información que se pasa del servidor simultáneo al cliente.

No se puede cambiar el código de campo con formato.

Los códigos de campo son específicos del control de comunicaciones entre los transportes WIP y HIP TCP y los programas MSCMTICS, MSHIPLNK y TCP Concurrent Server.

Datos
0 o más bytes de información asociada a un campo con formato específico.

Puede cambiar la información almacenada en Datos. Si cambia Datos, asegúrese de que también cambia la respuesta de TRM y la longitud de campo con formato a los nuevos valores.

La longitud de Los datos es igual a la longitud del campo con formato menos el tamaño del código de campo con formato.

Códigos normales

En la tabla siguiente se muestra el significado de los códigos normales.

Código Tipo Meaning
0x01 Información Id. de versión para el servidor simultáneo integrador de transacciones de Microsoft®
0x02 Información Datos de usuario
0x07 Información Ejecución correcta

Códigos de error

En la tabla siguiente se muestra el significado de los códigos de error.

Código Tipo Meaning
0x03 Error ProgID no válido
0x04 Error TranID no válido
0x05 Error Error en la consulta
0x06 Error Estado de la consulta
0x08 Error Programa ABEND
0x09 Error Error de ejecución
0x0A Error TRM no válido

Para obtener más información sobre el formato del TRM, vea el archivo de definición de TRM en <unidad>:\Archivos de programa\Microsoft Host Integration Server\System\TIM\MicrosoftTRMDefs.tim. Use Visual Studio para ver el archivo.

Véase también