消息属性
消息属性显示在“消息属性”对话框中。 您不能编辑任何消息属性。
下表列出了可以从队列中放入和获取的 IBM® MQ 消息的属性:
对于每个属性,都有一个对此属性的含义的简短描述。 这些表还显示了 API 中所用名称的 MQMD 格式。 这在 MQMD-消息描述符中进行了描述。
“常规”页面
下表列出了“消息属性”对话框的常规页面上的属性。
属性 | 含义 | MQMD 格式 |
---|---|---|
位置 | 只读。 消息队列中的当前位置。 | (不适用。) |
消息类型 | 只读。 以下是消息的类型:Datagram 表示消息不需要应答;Request 表示消息需要应答;Reply 表示消息是先前的请求消息的应答;Report 表示消息正在报告一些预期或意外的事件,通常与某些其他消息相关。 例如,包含无效数据的请求消息。 |
MsgType |
优先级 | 只读。 这是消息的优先级。 最低优先级是 0。 | 优先级 |
持久 | 只读。 此属性指示消息是持久消息还是非持久消息。 如果消息是持久消息,那么在系统发生故障以及队列管理器重新启动之后,此消息仍会保留。 如果消息是非持久消息,那么仅当它存在于具有 NPMCLASS (HIGH) 属性的队列上时,它才会继续重新启动。 但是,即使有 NPMCLASS(HIGH) 属性,消息仍然不会在经历 QMGR 类之后留存。 队列管理器重新启动时会丢弃具有 NPMCLASS(NORMAL) 属性的队列上的非持久消息,即使重新启动过程中在辅助存储器上能找到此消息也是如此。 | 持久 |
放置日期/时间 | 只读。 这是放置消息的日期。 | PutDate; PutTime |
到期 | 只读。 这是以十分之一秒计的时间段,在此时间段之后,如果尚未从目标队列中除去消息,那么就可以废弃此消息。 由放置消息的应用程序设置到期时间间隔。 | 到期 |
应答队列 | 只读。 这是消息队列的名称,对消息发出获取请求的应用程序应对该队列发送应答消息和报告消息。 | ReplyToQ |
应答队列管理器 | 只读。 这是定义应答队列的队列管理器的名称。 | ReplyToQmgr |
回退计数 | 只读。 这是消息作为工作单元的一部分由 MQGET 调用先前返回的并在随后又被回退的次数。 | BackoutCount |
“报告”页面
下表列出了“消息属性”对话框的报告页面上的属性。 报告是关于其他消息的消息,用于通知应用程序与原始消息相关的期望的事件或意外的事件。 报告页面显示与报告消息相关的属性。 有关更多信息,请参阅 报告选项和消息标志。
属性 | 含义 | MQMD 格式 |
---|---|---|
报告 | 只读。 发送方应用程序在此字段中指定是否需要报告消息、应用程序数据是否要包括在报告消息中以及如何设置报告或应答消息中的消息标识和相关标识。 | 报告 |
Feedback | 只读。 此属性仅与报告消息一起使用以指示报告的性质。 | Feedback |
原始长度 | 只读。 此属性仅与报告消息一起使用以指示与报告相关的原始消息的长度。 | OriginalLength |
“上下文”页面
下表列出了“消息属性”对话框的上下文页面上的属性。 上下文页面显示来自发送方应用程序的有关消息的信息。
属性 | 含义 | MQMD 格式 |
---|---|---|
用户标识 | 只读。 这是发起消息的应用程序的用户标识。 | UserIdentifier |
应用程序类型 | 只读。 这是放置消息的应用程序类型,例如 CICS® 或 AIX®。 | PutApplType |
放置应用程序名称 | 只读。 这是放置消息的应用程序的名称。 显示的此名称为截断形式。 | PutApplName |
应用程序标识数据 | 只读。 这是由应用程序套件定义的信息,可用来提供有关消息或其发起方的信息。 | ApplIdentityData |
应用程序原始数据 | 只读。 这是由应用程序套件定义的信息,可用来提供有关原始消息的附加信息。 | ApplOriginData |
记帐标记 | 只读。 这是允许应用程序适当地计算由消息引起的工作量的信息。 | AccountingToken |
“标识”页面
下表列出了“消息属性”对话框的标识页面上的属性。 标识页面显示与消息关联的标识信息。
属性 | 含义 | MQMD 格式 |
---|---|---|
消息标识 | 只读。 这是消息标识,它用来区分消息。 | MsgId |
消息标识字节 | 只读。 这是以字节格式表示的消息标识。 | MsgId |
相关标识 | 只读。 这是相关标识,应用程序可使用它来将一个消息与另一个消息相关,或将一个消息与应用程序正在执行的其他工作相关。 | CorrelId |
相关标识字节 | 只读。 这是以字节格式表示的相关标识。 | CorrelId |
组标识 | 只读。 这是组标识,它用来标识特定的消息组或物理消息所属的逻辑消息。 | GroupId |
组标识字节 | 只读。 这是以字节格式表示的组标识。 | GroupId |
“分段”页面
下表列出了“消息属性”对话框的分段页面上的属性。 分段页面显示与对大型消息进行分段有关的属性。
属性 | 含义 | MQMD 格式 |
---|---|---|
逻辑序号 | 只读。 这是组中逻辑消息的序号。 序号从 1 开始,并对组中的每条新逻辑消息增加 1,最大序号是 999,999,999。 不在组中的物理消息的序号是 1。 | MsgSeqNumber |
偏移量 | 只读。 这是物理消息中的数据的偏移量,此偏移量从逻辑消息的开头算起。 | 偏移量 |
标志 | 只读。 这些是指定消息属性或控制其处理的消息标志。 | MsgFlags |
“命名的属性”页面
下表列出了 " 消息属性 " 对话框的 指定属性 页面上的属性。 仅当您在 " 首选项 " 对话框的 " 消息属性 " 页面上选择了 作为指定属性 ,并且所选消息具有属性时,才会显示 " 指定属性 " 页面。 除了消息描述符或扩展中包含的消息属性之外,其余消息属性必须采用名称值对的形式表示在命名的属性面板中,并且这些属性将从消息数据中除去。
MQGMO 选项为 MQGMO_PROPERTIES_IN_HANDLE,有关相关 "获取消息选项" 的更多信息,请参阅MQ 获取消息选项。有关 " 首选项 " 对话框的更多信息,请参阅 配置 MQ Explorer。
属性 | 含义 |
---|---|
名称 | 只读。 消息属性的名称。 |
值 | 只读。 这是命名属性的实际值。 |
“MQRFH2 属性”页面
- 在 " 首选项 " 对话框的 " 消息 " 页面上,选择 作为消息体 中的 MQRFH2 结构。
除了消息描述符或扩展中包含的消息属性之外,其余消息属性必须表示在“MQRFH2 属性”中,并且这些属性保留在消息数据中。 MQGMO 选项为 MQGMO_PROPERTIES_FORCE_MQRFH2,有关相关 "获取消息选项" 的更多信息,请参阅 MQ 获取消息选项。
- 在 " 首选项 " 对话框的 消息 页面上,选择 作为与 WebSphere MQ V6 兼容的消息体中的 MQRFH2 结构。 仅当消息包含前缀为 mcd, jms, usr或 mqext 的属性时,才会显示 MQRFH2 属性 页面
如果消息包含前缀为 mcd、jms、usr 或 mqext 的属性,那么除了消息描述符或扩展中包含的消息属性之外,其余所有消息属性均必须表示在“MQRFH2 属性”面板中,并且这些属性保留在消息数据中。 否则,将废弃除了消息描述符或扩展中包含的消息属性之外的所有消息属性,并且不会对它们进行显示。 MQGMO 选项为 MQGMO_PROPERTIES_IN_COMPATIBILITY,有关相关 "获取消息选项" 的更多信息,请参阅MQ 获取消息选项。
因为 MQRFH2 结构是嵌套的 xml,所以“MQRFH2 属性”页面以树形视图的形式显示 MQRFH2 属性。 具有相同同义词的所有属性组合在同义词树下,可以展开该树以显示所有属性,也可以折叠该树以隐藏所有属性。
属性 | 含义 |
---|---|
名称 | 只读。 消息属性的名称。 |
值 | 只读。 这是命名属性的实际值。 |
“数据”页面
下表列出了“消息属性”对话框的数据页面上的属性。 数据页面显示消息数据本身以及有关数据格式的信息。
属性 | 含义 | MQMD 格式 |
---|---|---|
数据长度 | 只读。 这是原始消息的长度。 | OriginalLength |
格式 | 只读。 这是消息的发送方用来向接收方说明消息中数据性质的名称。 | 格式 |
编码字符集标识 | 只读。 这是应用程序消息数据中字符数据的编码字符集标识。 | CodedCharSetId |
编码 | 只读。 这是消息中的数字数据的数字编码。 此值不适用于 MQMD 结构本身的数字数据。 | 编码 |
消息数据 | 只读。 这是以可读的 ASCII 码文本表示的消息数据。 | (不适用。) |
消息数据字节 | 只读。 这是以十六进制格式表示的消息数据。 | (不适用。) |
“死信头”页面
下表列出了“消息属性”对话框的死信头页面上的属性。 仅当消息有死信头时,才显示死信头页面。
属性 | 含义 | MQMD 格式 |
---|---|---|
原因 | 它会找出消息放在死信(未传递的消息)队列而不是原始目标队列的原因。 | 原因 |
目标队列 | 消息原始目标的消息队列名称。 | DestQName |
目标队列管理器 | 消息原始目标的队列管理器的名称。 | DestQMgrName |
原始编码 | 它会指定遵循 MQDLH 结构的数据(通常数据来自原始消息)的数字编码;它不适用于 MQDLH 结构自身中的数字数据。 | 编码 |
原始 CCSID | 它会指定遵循 MQDLH 结构的数据(通常数据来自原始消息)的字符集标识;它不适用于 MQDLH 结构自身中的字符数据。 | CodedCharSetId |
原始格式 | 它会指定遵循 MQDLH 结构的数据(通常数据来自原始消息)的格式名称。 | 格式 |
放置应用程序类型 | 放置消息的应用程序类型。 这是消息的原始上下文的一部分。 有关消息上下文的更多信息,请参阅 消息上下文。 | PutApplType |
放置应用程序名称 | 将消息放置到死信队列的应用程序的名称。 名称的格式取决于 Put Application
Type 属性。 显示的此名称为截断形式。 |
PutApplName |
放置日期 | 消息放置到死信队列的日期。 | PutDate |
放置时间 | 消息放置到死信队列的时间。 | PutTime |