ImqWorkHeader C++类
此类封装 MQWIH 数据结构的特定功能。

此类的对象由将消息放入由 z/OS® 工作负载管理器管理的队列的应用程序使用。
对象属性
- 消息标记 (message token)
- z/OS 工作负载管理器的消息令牌,长度为 MQ_MSG_TOKEN_LENGTH。 初始值为 MQMTOK_NONE。
- 服务名称
- 进程的 32 个字符的名称。 该名称最初为空白。
- 服务步骤
- 进程中步骤的 8 字符名称。 该名称最初为空白。
构造函数
- ImqWorkHeader( );
- 缺省构造函数。
- ImqWorkHeader( ( const ImqWorkHeader & header );
- 复制构造函数。
重载的 ImqItem 方法
- ImqBoolean copyOut( ( ImqMessage & msg );
- 将 MQWIH 数据结构插入到消息缓冲区的开头,进一步移动现有消息数据,并将 msg 格式 设置为 MQFMT_WORK_INFO_HEADER。
请参阅父类方法描述以获取更多详细信息。
- ImqBoolean pasteIn( ( ImqMessage & msg );
- 从消息缓冲区读取 MQWIH 数据结构。
要成功, msg 对象的编码必须是 MQENC_NATIVE。 使用 MQGMO_CONVERT 检索到 MQENC_NATIVE 的消息。
ImqMessage 格式必须为 MQFMT_WORK_INFO_HEADER。
请参阅父类方法描述以获取更多详细信息。
对象方法 (公用)
- 空操作符 = ( const ImqWorkHeader & header );
- 从 header复制实例数据,以替换现有实例数据。
- ImqBinary messageToken () 康斯特;
- 返回 消息令牌。
- ImqBoolean setMessageToken( ( const ImqBinary & token );
- 设置 消息令牌。 token 的数据长度必须为零或 MQ_MSG_TOKEN_LENGTH。 如果成功,将返回 TRUE。
- void setMessageToken( ( const MQBYTE16 token = 0 );
- 设置 消息令牌。 token 可以为零,这与指定 MQMTOK_NONE 相同。 如果 token 非零,那么它必须寻址二进制数据的 MQ_MSG_TOKEN_LENGTH 字节。
使用预定义值 (例如 MQMTOK_NONE) 时,您可能需要进行强制类型转换以确保签名匹配; 例如 (MQBYTE *) MQMTOK_NONE。
- ImqString serviceName () 康斯特;
- 返回 服务名称,包括尾部空格。
- void setServiceName( ( const char * name );
- 设置 服务名称。
- ImqString serviceStep () 康斯特;
- 返回 服务步骤,包括尾部空格。
- void setServiceStep( ( const char * step );
- 设置 服务步骤。
对象数据 (受保护)
- MQWIH omqwih
- MQWIH 数据结构。
原因码
- MQRC_二进制数据长度错误