IBM MQ 预订属性

您可以为所有类型的预订设置属性。 某些属性不适用于所有类型的预订,某些属性特定于 z/OS® 预订。

以下各表列出了可以设置的所有属性:

对于每个属性,都有一个简短描述来说明在什么情况下您可能需要配置此属性。 这些表还给出了 DEFINE、ALTER 和 DISPLAY SUB 命令的等效 MQSC 参数。 有关 MQSC 命令的更多信息,请参阅 IBM® 文档中的 使用 MQSC 命令进行管理

“常规”页面

下表列出了您可以在 " 预订属性 " 对话框的 常规 页面上设置的属性。

属性 含义 MQSC 参数
预订名称 只读。 在创建了预订之后,您就不能更改其名称。 SUBNAME
主题名称 预订使用的主题对象的名称。 主题名称提供可选主题根。 最多允许使用 48 个字符。 TOPICOBJ
主题字符串 此属性指定为预订设置的标准主题名称或通配符主题。

此字符串中的斜杠 (/) 字符具有特殊含义。 它将主题树中的元素进行定界。 主题字符串可以使用 (/) 字符开头,但这不是必需的。 使用 (/) 字符开头的字符串与不使用 (/) 字符开头的字符串不同。

TOPICSTR
通配符用途 当解释主题字符串中包含的任何通配符时,将使用此方案。 有以下两个值:

TOPIC:通配符表示主题层次结构的部分。

CHAR:通配符表示字符串的部分。

WSCHEMA
作用域 作用域可确定是否将此预订转发至其他队列管理器,以便订户接收在这些其他队列管理器上发布的消息。 有以下两个值:
全部
预订将转发给直接通过发布/预订集合体或层次结构连接的所有队列管理器。
QMGR
预订仅转发对此队列管理器中的主题发布的消息。
注: 个别订户只能限制 SUBSCOPE。 如果在主题级别将该参数设置为 ALL,那么个人订户可以对此预订将其限制为 QMGR。 但是,如果在主题级别将该参数设置为 QMGR,那么将个人订户设置为 ALL 不起任何作用。
SUBSCOPE
目标类 目标类指定预订使用的目标是否是受管目标。 有以下两个值:

MANAGED:目标是受管目标。

PROVIDED:目标是一个队列。 这是缺省值。

DESTCLAS
目标队列管理器 发布至预订的消息的目标队列管理器。 DESTQMGR
目标名称 指定此预订的消息所放入的别名队列、本地队列、远程队列或集群队列的名称。 DEST
相关标识 相关标识的值将放入发送至预订的所有消息的消息描述符中。 如果未指定相关标识参数,那么消息将放入相关标识为 MQCI_NONE 的目标中。

空值(缺省值)会导致使用系统生成的相关标识。

如果设置为“000000000000000000000000000000000000000000000000”(48 个零),那么除非在发布/预订层次结构中传播消息,否则会将发布应用程序设置的 CorrelId 保留在发送至预订的消息副本中。

DESTCORL
注: 无法使用 JMS以编程方式设置 DESTCORL 属性。
持久 当创建预订的应用程序关闭其预订句柄时,不会删除持久预订。 预订的 Durable 参数可以是 YesNo。 当 Durable 设置为 Yes 时,如果创建应用程序关闭其预订句柄,则不会删除预订。 DURABLE
类型 预订的类型指示创建预订的方式。 预订类型有以下几种:

API:通过 MQSUB API 请求创建的预订。

ADMIN:通过 DEF SUB MQSCPCF 命令创建的预订。 ADMIN 还用于指示已通过管理命令修改了预订。

PROXY:在内部创建的预订,用于通过队列管理器网络传递发布。

尝试修改时,类型为 PROXY 的预订未修改为 ADMIN。

不能修改类型

SUBTYPE
属性 属性确定如何将与发布/预订相关的消息属性添加到发送至预订的消息中。 可用选项为:

兼容性: 将发布/预订属性添加到消息中,以保持与 IBM WebSphere® MQ 6.0 发布/预订的兼容性。

消息属性:发布/预订属性将添加为消息属性。

:发布/预订属性不会添加到消息中。

RFH2:发布/预订属性将添加到 RFH V2 头中的消息中。

PSPROP
用户数据 可以选择在发送至预订的消息中将用户数据的值作为消息属性传递。 USERDATA
选择器 选择器是一个 SQL92 字符串,它适用于针对指定主题发布的消息,用来选择这些消息对于预订是否合格。 SELECTOR
选择器类型 已指定的 SelectionString 的类型。 此显示属性已计算,并且不与对象相关联。 选择器类型将是可过滤的(例如,使用 WHERE 子句),以允许管理员仅显示内部选择器或仅显示外部选择器。 SELTYPE

“扩展”页面

下表列出了您可以在 " 预订属性 " 对话框的 扩展 页面上设置的属性。

属性 含义 MQSC 参数
可变用户标识 指定除预订创建者之外的用户是否可以连接至该预订并获取该预订的所有权。 有以下两个值:

ANY:如果其他用户具有正确的主题权限检查和目标权限检查,就可以连接至预订。 这是缺省值。

FIXED:其他用户不能连接至预订。

VARUSER
User 指定拥有此预订的用户概要文件。 SUBUSER
应用程序标识数据 应用程序身份数据的值将用于发送至预订的消息。 如果未指定应用程序身份数据,那么将使用空的缺省值。 PUBAPPID
记帐标记 记帐标记的值将用于已发送至预订的消息。 如果未指定记帐标记,那么将使用缺省值 MQACT_NONE。 PUBACCT
发布优先级 发布优先级确定将与发布/预订相关的消息属性添加到发送至预订的消息中的方式。 可用选项为:

作为已发布对象,它表示发送至该预订的消息的优先级,并且取自已发布的消息中所提供的优先级。

作为定义的队列,它表示发送至该预订的消息的优先级,并且取自定义为目标的队列的缺省优先级。

该优先级值允许您指定 0 - 9 范围内的优先级。

PUBPRTY
预订标识 预订标识的值由队列管理器指定,作为此预订在任何时候都唯一的标识。 如果由于格式问题而无法提供 SUBNAME,或者没有为应用程序创建的预订提供 SUBNAME,那么此标识可以代替 SUBNAME 来作为 DISPLAYALTERDELETE MQSC 命令的目标。 SUBID
到期 预订从创建日期和时间算起的生存时间。 到期以十分之一秒为单位。 有以下两个值:

无限,它表示预订永远不会到期,或者用户也可以输入自己的值(以十分之一秒为单位)。 零是缺省值。

EXPIRY
仅请求 “仅请求”指示订户是否将通过 MQSUBPRQ API 来轮询是否有更新。 有以下两个值:

全部,它表示所有发布都将传递至预订。 这是缺省值。

请求时,它表示发布仅在响应 MQSUBPRQ API 时传递至预订。

REQONLY
预订级别 这是与预订关联的级别。 如果此预订位于具有小于或等于发布时所用 PubLevel 的最高 SubLevel 值的预订集中,那么发布将仅传递到此预订。 值必须在 0 - 9 范围内。 0 是最低级别。 SUBLEVEL

“统计信息”页面

下表列出了 " 预订属性 " 对话框的 " 统计信息 " 页面上的属性。 统计信息页面显示有关预订的历史记录的信息。 统计信息页面上显示的信息是只读信息,用户无法改变。

属性 含义 MQSC 参数
创建日期 只读。 这是创建预订的日期。 CRDATE
创建时间 只读。 这是创建预订的时间。 CRTIME
变更日期 只读。 这是最近一次变更预订的属性的日期。 ALTDATE
变更时间 只读。 这是最近一次变更预订的属性的时间。 ALTTIME