MQWIH - 工作信息头

如果要由 z/OS® 工作负载管理器 (WLM) 处理消息，那么该消息必须以 MQWIH 结构开头。此结构描述了在要由 WLM 处理的消息开始时必须存在的信息。

可用性

所有 IBM® MQ 系统以及连接到这些系统的 IBM MQ 客户机。

格式名

MQFMT_WORK_INFO_HEADER。

字符集和编码

MQWIH 结构中的字段是由 MQWIH 之前的头结构中的 CodedCharSetId 和 Encoding 字段提供的字符集和编码，或者 MQMD 结构中的那些字段 (如果 MQWIH 位于应用程序消息数据的开头) 提供的编码。

字符集必须是对队列名称中有效的字符具有单字节字符的字符集。

用法

对于任何 IBM MQ 支持的平台，您可以创建和传输包含 MQWIH 结构的消息，但只有 IBM MQ for z/OS 队列管理器才能与 WLM 进行交互。因此，要使消息从非z/OS 队列管理器到达 WLM ，队列管理器网络必须至少包含一个 z/OS 队列管理器，通过该队列管理器可以路由消息。

字段

注: 在下表中，字段按用法 (而不是按字母顺序) 进行分组。子主题遵循相同的顺序。

表 1. MQWIH 中的字段
字段名称和描述	常量的名称	常量的初始值 (如果有)
StrucId (结构标识)	MQWIH_STRUC_ID	`'WIH¬'`
版本 (结构版本号)	MQWIH_VERSION_1	`1`
StrucLength (MQWIH 结构的长度)	MQWIH_LENGTH_1	`120`
编码 (MQWIH 之后的数据的数字编码)	None	`0`
CodedCharSetId（MQWIH 之后数据的字符集标识符）	MQCCSI_UNDEFINED	`0`
格式 (MQWIH 之后的数据的格式名称)	MQFMT_NONE	空白
标志 (标志)	MQWIH_NONE	`0`
ServiceName (服务名称)	None	空白
ServiceStep (服务步骤名称)	None	空白
MsgToken (消息令牌)	MQMTOK_NONE	Null
保留 (保留)	None	空白
备注信息：符号 `¬` 表示单个空白字符。在 C 编程语言中，宏变量 MQWIH_DEFAULT 包含表中列出的值。通过以下方式使用它来为结构中的字段提供初始值: `MQWIH MyWIH = {MQWIH_DEFAULT};`

语言声明

MQWIH 的 C 声明

typedef struct tagMQWIH MQWIH;
struct tagMQWIH {
  MQCHAR4   StrucId;         /* Structure identifier */
  MQLONG    Version;         /* Structure version number */
  MQLONG    StrucLength;     /* Length of MQWIH structure */
  MQLONG    Encoding;        /* Numeric encoding of data that follows
                                MQWIH */
  MQLONG    CodedCharSetId;  /* Character-set identifier of data that
                                follows MQWIH */
  MQCHAR8   Format;          /* Format name of data that follows
                                MQWIH */
  MQLONG    Flags;           /* Flags */
  MQCHAR32  ServiceName;     /* Service name */
  MQCHAR8   ServiceStep;     /* Service step name */
  MQBYTE16  MsgToken;        /* Message token */
  MQCHAR32  Reserved;        /* Reserved */
};

MQWIH 的 COBOL 声明

**   MQWIH structure
  10 MQWIH.
**    Structure identifier
   15 MQWIH-STRUCID        PIC X(4).
**    Structure version number
   15 MQWIH-VERSION        PIC S9(9) BINARY.
**    Length of MQWIH structure
   15 MQWIH-STRUCLENGTH    PIC S9(9) BINARY.
**    Numeric encoding of data that follows MQWIH
   15 MQWIH-ENCODING       PIC S9(9) BINARY.
**    Character-set identifier of data that follows MQWIH
   15 MQWIH-CODEDCHARSETID PIC S9(9) BINARY.
**    Format name of data that follows MQWIH
   15 MQWIH-FORMAT         PIC X(8).
**    Flags
   15 MQWIH-FLAGS          PIC S9(9) BINARY.
**    Service name
   15 MQWIH-SERVICENAME    PIC X(32).
**    Service step name
   15 MQWIH-SERVICESTEP    PIC X(8).
**    Message token
   15 MQWIH-MSGTOKEN       PIC X(16).
**    Reserved
   15 MQWIH-RESERVED       PIC X(32).

MQWIH 的 PL/I 声明

dcl
 1 MQWIH based,
  3 StrucId        char(4),       /* Structure identifier */
  3 Version        fixed bin(31), /* Structure version number */
  3 StrucLength    fixed bin(31), /* Length of MQWIH structure */
  3 Encoding       fixed bin(31), /* Numeric encoding of data that
                                     follows MQWIH */
  3 CodedCharSetId fixed bin(31), /* Character-set identifier of data
                                     that follows MQWIH */
  3 Format         char(8),       /* Format name of data that follows
                                     MQWIH */
  3 Flags          fixed bin(31), /* Flags */
  3 ServiceName    char(32),      /* Service name */
  3 ServiceStep    char(8),       /* Service step name */
  3 MsgToken       char(16),      /* Message token */
  3 Reserved       char(32);      /* Reserved */

MQWIH 的 High Level Assembler 声明

MQWIH                 DSECT
MQWIH_STRUCID         DS   CL4   Structure identifier
MQWIH_VERSION         DS   F     Structure version number
MQWIH_STRUCLENGTH     DS   F     Length of MQWIH structure
MQWIH_ENCODING        DS   F     Numeric encoding of data that follows
*                                MQWIH
MQWIH_CODEDCHARSETID  DS   F     Character-set identifier of data that
*                                follows MQWIH
MQWIH_FORMAT          DS   CL8   Format name of data that follows MQWIH
MQWIH_FLAGS           DS   F     Flags
MQWIH_SERVICENAME     DS   CL32  Service name
MQWIH_SERVICESTEP     DS   CL8   Service step name
MQWIH_MSGTOKEN        DS   XL16  Message token
MQWIH_RESERVED        DS   CL32  Reserved
*
MQWIH_LENGTH          EQU  *-MQWIH
                      ORG  MQWIH
MQWIH_AREA            DS   CL(MQWIH_LENGTH)

MQWIH 的 Visual Basic 声明

Type MQWIH
  StrucId        As String*4  'Structure identifier'
  Version        As Long      'Structure version number'
  StrucLength    As Long      'Length of MQWIH structure'
  Encoding       As Long      'Numeric encoding of data that follows'
                              'MQWIH'
  CodedCharSetId As Long      'Character-set identifier of data that'
                              'follows MQWIH'
  Format         As String*8  'Format name of data that follows MQWIH'
  Flags          As Long      'Flags'
  ServiceName    As String*32 'Service name'
  ServiceStep    As String*8  'Service step name'
  MsgToken       As MQBYTE16  'Message token'
  Reserved       As String*32 'Reserved'
End Type