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

本主题介绍 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    bLinkToName[8];  
   USHORT  usCommareaLen;  
   BYTE    bReserved[9];  
} UNALIGNED;  

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

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

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

TRM 回复消息

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

TRM 回复消息长度 格式化字段长度 格式化字段代码 数据
4 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 无效

有关 TRM 格式的详细信息,请参阅 drive>:\Program Files\Microsoft Host Integration Server\System\TIM\MicrosoftTRMDefs.tim 中的 <TRM 定义文件。 使用 Visual Studio 查看该文件。

另请参阅