MQCIH- CICS-MQ 网桥头
MQCIH 结构描述通过 IBM® MQ for z/OS®发送到 CICS®-MQ 网桥的消息开始时可能提供的信息。
有关 MICIH 中的字段，请参阅 MQCIH 中的字段 ( CICS-MQ 网桥头)。
可用性
AIX®, HP-UX, z/OS, Solaris, Linux®, Windows, 以及连接至这些 IBM MQ 系统的客户端。
对于C++应用程序， ImqCICSBridgeHeader 类封装了MQCIH数据结构的特定功能。 请参阅 IBM MQ C++ 消息头，用于 CICS 与 MQ 之间的桥接。
格式名称
MQFMT_CICS。
版本
MQCIH 的当前版本为 MQCIH_VERSION_2。 为受支持编程语言提供的头 COPY 和 INCLUDE 文件包含最新版本的 MQCIH ， "版本" 字段的初始值设置为 MQCIH_VERSION_2。
如果版本低于 MQCIH_VERSION_2 ，则不存在 CursorPosition, ErrorOffset, InputItem, 和 Reserved4 字段。
字符集和编码
- 连接到拥有 CICS-MQ 网桥队列的队列管理器的应用程序必须提供队列管理器的字符集和编码中的 MQCIH 结构，因为在这种情况下不会执行 MQCIH 结构的数据转换。
- 连接到其他队列管理器的应用程序可以提供 MQCIH 结构，该结构位于任何受支持的字符集和编码中; 连接到拥有 CICS-MQ 网桥队列的队列管理器的接收消息通道代理将转换 MQCIH 结构。
- 遵循 MQCIH 结构的应用程序消息数据必须采用与 MQCIH 结构相同的字符集和编码。 您不能使用MQCIH结构中的 CodedCharSetId 和Encoding字段来指定应用程序消息数据的字符集和编码。 如果数据不是队列管理器支持的其中一种内置格式，那么必须提供数据转换出口以转换应用程序消息数据。
用法
如果应用程序需要与初始值相同的值，并且 CICS-MQ 网桥正在使用 AUTH=LOCAL 或 AUTH=IDENTIFY 运行，那么可以从消息中省略 MQCIH 结构。 在所有其他情况下，该结构必须存在。
CICS-MQ 网桥接受 version-1 或 version-2 MQCIH 结构，但对于 3270 事务，必须使用 version-2 结构。
应用程序必须确保记录为请求字段的字段在发送到 CICS-MQ 网桥的消息中具有相应的值; 这些字段用作 CICS-MQ 网桥的输入。
记录为响应字段的字段由 CICS-MQ 网桥在 CICS-MQ 网桥发送到应用程序的应答消息中设置。 错误信息ReturnCode,、Function CompCode,、Reason和 AbendCode 字段中返回，但并非在所有情况下都设置这些字段。 下表显示为 ReturnCode的不同值设置了哪些字段。
ReturnCode |
Function |
CompCode |
Reason |
AbendCode |
|---|---|---|---|---|
| MQCRC_OK | – | – | – | – |
| mqcrc_bridge_error | – | – | MQFB_CICS_ * | – |
| mqcrc_mq_api_error mqcrc_bridge_timeout | MQ 调用名称 | MQ CompCode |
MQ Reason |
– |
| mqcrc_cics_exec_error mqcrc_security_error mqcrc_program_not_available mqcrc_transid_not_available | CICS 欧洲投资银行基金会 | CICS 欧洲投资银行 | CICS EIBRESP2 | – |
| mqcrc_bridge_abend mqcrc_application_abend | – | – | – | CICS ABCODE |