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

本部分介绍 TCP ELM 用户数据编程模型使用的增强型侦听器消息 (ELM) 的格式和内容。

ELM 请求消息

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

数据中的客户端
35

数据中的客户端
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;  

ELM 回复消息

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

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

注意

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

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

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

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

格式化字段代码
1 个字节的代码,描述从并发服务器传回到客户端的信息。

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

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

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

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

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

普通代码

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

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

错误代码

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

代码 类型 含义
0x03 错误 ProgID 无效
0x04 错误 TranID 无效
0x05 错误 查询失败
0x06 错误 查询状态
0x08 错误 程序 ABEND
0x09 错误 执行失败
0x0A 错误 ELM 无效

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

另请参阅

TCP ELM 链接编程模型的 ELM 格式
增强的侦听器 CICS 管理