TCP TRM 用户数据编程模型的 TRM 格式

项目
07/21/2023

本部分介绍 TCP TRM 用户数据编程模型使用的事务请求消息 (TRM) 的格式和内容。

TRM 请求消息

下表显示了请求消息的内容。

TranID	逗号	数据中的客户端
4	1	35

TranID
侦听器要启动的并发服务器的事务 ID。

逗号
一个逗号 (,)，用于将事务 ID 与数据中的客户端分隔开来。

数据中的客户端
35 字节的数据，由 CICS TCP/IP 安全出口使用，并在事务启动消息 (TIM) 中传递到并发服务器。

Microsoft 安全出口数据中的客户端的格式

以下代码块描述了 Microsoft 安全出口数据中的客户端的格式。

struct CLIENT_IN_DATA {  
   BYTE    bUserID[8];  
   BYTE    bPassword[8];  
   BYTE    bReserved[19];  
} UNALIGNED;

IBM 安全出口数据中的客户端的格式

以下代码块描述了 IBM 安全出口数据中的客户端的格式。

struct CLIENT_IN_DATA2 {  
   BYTE    bSecFlag;  
   BYTE    bPassword[8];  
   BYTE    bUserID[8];  
   BYTE    bReserved[18];  
} UNALIGNED;

COBOL 数据中的客户端

以下代码块描述了 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.

COBOL 的数据常量中的客户端

以下代码块描述 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'.

TRM 回复消息

下表显示了回复消息的内容。

TRM 回复消息长度	格式化字段长度	格式化字段代码	数据
2	4	1	0-n

注意

可以在单个消息中多次重复格式化字段长度、格式化字段代码和数据。

TRM 回复消息长度
TRM 回复消息的总长度。此长度是消息中跟随的所有格式化字段的长度总和，不包括 TRM 回复消息长度字段本身的长度。

格式化字段长度
格式化字段的长度。

格式化字段长度是格式化字段代码长度和数据长度的总和。

格式化字段代码
一个单字节代码，用于描述从并发服务器传回到客户端的信息。

无法更改格式化字段代码。

字段代码特定于 WIP 与 HIP TCP 传输和 MSCMTICS、MSHIPLNK 与 TCP 并发服务器程序之间的通信处理。

数据
与特定格式化字段关联的包含 0 字节或更多字节的信息。

可以更改“数据”中存储的信息。如果更改“数据”，请务必也将 TRM 回复和格式化字段长度更改为新值。

“数据”的长度等于格式化字段长度减去格式化字段代码的大小。

普通代码

下表显示了普通代码的含义。

代码	类型	含义
0x01	信息	Microsoft® 事务集成器并发服务器的版本 ID
0x02	信息	用户数据
0x07	信息	执行正常

错误代码

下表显示了错误代码的含义。

代码	类型	含义
0x03	错误	ProgID 无效
0x04	错误	TranID 无效
0x05	错误	查询失败
0x06	错误	查询状态
0x08	错误	程序 ABEND
0x09	错误	执行失败
0x0A	错误	TRM 无效
0x0B	错误	服务器生成了异常
0x0C	错误	异常错误信息位于元数据错误块中

有关 TRM 格式的详细信息，请参阅驱动器>：\Program Files\ Microsoft Host IntegrationServer\System\TIM\MicrosoftTRMDefs.tim 中的 <TRM 定义文件。使用 Visual Studio 查看该文件。

另请参阅

TCP TRM 链接编程模型的 TRM 格式

通过