Formato TRM para el modelo de programación de datos de usuario de TCP TRM

En esta sección se describe el formato y el contenido del mensaje de solicitud de transacción (TRM) usado por el modelo de programación de datos de usuario de TCP TRM.

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    bReserved[19];  
} 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    bReserved[18];  
} UNALIGNED;  

Cliente en datos para COBOL

El siguiente bloque de código describe el formato del cliente en COBOL

01 CLIENT-IN-DATA                       PIC X(35).  
       01 FILLER REDEFINES CLIENT-IN-DATA.  
          05 CID-USERID                 PIC X(8).  
          05 CID-PASSWORD               PIC X(8).  
          05 CID-LINK-TO-PROG           PIC X(8).  
          05 CID-COMMAREA-LEN           PIC S9(4) COMP.  
          05 CID-DATA-LEN               PIC S9(8) COMP.  
          05 CID-VERSION                PIC X.  
          05 CID-FLAG-1                 PIC X.  
          05 CID-FLAG-2                 PIC X.  
          05 CID-RESERVED               PIC X.  
          05 CID-FORMAT                 PIC X.  

Cliente en constantes de datos para COBOL

En el bloque de código siguiente se describen las constantes del cliente en los datos de COBOL.

01 CLIENT-IN-DATA-CONSTANTS.

05 CID-C-VERSION.

10 CID-VERSION-1 PIC X VALUE X'00'.

10 CID-VERSION-2 PIC X VALUE X'01'.

05 CID-C-FLAG-1.

10 CID-USE-TICS-WORK-AREA PIC X VALUE X'01'.

05 CID-C-FLAG-2.

10 CID-PC-NONE PIC X VALUE X'01'.

10 CID-PC-OPEN PIC X VALUE X'02'.

10 CID-PC-USE PIC X VALUE X'04'.

10 CID-PC-CLOSE PIC X VALUE X'08'.

10 CID-NO-OBJ-PERSIST PIC X VALUE X'10'.

05 CID-C-FORMAT.

10 CID-FORMAT-NOTSET PIC X VALUE X'00'.

10 CID-FORMAT-MS PIC X VALUE X'01'.

10 CID-FORMAT-IBM PIC X VALUE X'02'.

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
2 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
0x0B Error El servidor generó una excepción
0x0C Error La información del error de excepción está en el bloque de errores de metadatos

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 IntegrationServer\System\TIM\MicrosoftTRMDefs.tim. Use Visual Studio para ver el archivo.

Véase también

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