ImqWorkHeader C++类

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

图 1。 ImqWorkHeader
Booch类图显示了 ImqWorkHeader及其父类 ImqHeader。

此类的对象由将消息放入由 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_二进制数据长度错误