IBM MQ 预订属性
您可以为所有类型的预订设置属性。某些属性不适用于所有类型的预订,某些属性特定于 z/OS® 预订。
以下各表列出了可以设置的所有属性:
对于每个属性,都有一个简短描述来说明在什么情况下您可能需要配置此属性。此表还提供了等效的 MQSC 参数。有关 MQSC 命令的更多信息,请参阅 IBM® MQ 联机产品文档中的脚本 (MQSC) 命令。
“常规”页面
下表列出了您可以在“预订属性”对话框的常规页面上设置的属性。
属性 | 含义 | MQSC 参数 |
---|---|---|
预订名称 | 只读。在创建了预订之后,您就不能更改其名称。 | SUBNAME |
主题名称 | 预订使用的主题对象的名称。主题名称提供可选主题根。最多允许使用 48 个字符。 | TOPICOBJ |
主题字符串 | 此属性指定为预订设置的标准主题名称或通配符主题。 此字符串中的斜杠 (/) 字符具有特殊含义。它将主题树中的元素进行定界。主题字符串可以使用 (/) 字符开头,但这不是必需的。使用 (/) 字符开头的字符串与不使用 (/) 字符开头的字符串不同。 |
TOPICSTR |
通配符用途 | 当解释主题字符串中包含的任何通配符时,将使用此方案。有以下两个值: TOPIC:通配符表示主题层次结构的部分。 CHAR:通配符表示字符串的部分。 |
WSCHEMA |
作用域 | 作用域可确定是否将此预订转发至其他队列管理器,以便订户接收在这些其他队列管理器上发布的消息。
有以下两个值:
注: 个人订户只能限制 SUBSCOPE。如果在主题级别将该参数设置为 ALL,那么个人订户可以对此预订将其限制为 QMGR。但是,如果在主题级别将该参数设置为 QMGR,那么将个人订户设置为 ALL 不起任何作用。
|
SUBSCOPE |
目标类 | 目标类指定预订使用的目标是否是受管目标。有以下两个值: MANAGED:目标是受管目标。 PROVIDED:目标是一个队列。这是缺省值。 |
DESTCLAS |
目标队列管理器 | 发布至预订的消息的目标队列管理器。 | DESTQMGR |
目标名称 | 指定此预订的消息所放入的别名队列、本地队列、远程队列或集群队列的名称。 | DEST |
相关标识 | 相关标识的值将放入发送至预订的所有消息的消息描述符中。如果未指定相关标识参数,那么消息将放入相关标识为 MQCI_NONE 的目标中。 空值(缺省值)会导致使用系统生成的相关标识。 如果设置为“000000000000000000000000000000000000000000000000”(48 个零),那么除非在发布/预订层次结构中传播消息,否则会将发布应用程序设置的 CorrelId 保留在发送至预订的消息副本中。 |
DESTCORL |
持久 | 当创建预订的应用程序关闭其预订句柄时,不会删除持久预订。预订的持久参数可以为是或否。如果将持久设置为是,那么当创建预订的应用程序关闭其预订句柄时,不会删除这种预订。 | DURABLE |
类型 | 预订的类型指示创建预订的方式。预订类型有以下几种: API:通过 MQSUB API 请求创建的预订。 ADMIN:通过 DEF SUB MQSC 或 PCF 命令创建的预订。ADMIN 还用于指示已通过管理命令修改了预订。 PROXY:在内部创建的预订,用于通过队列管理器网络传递发布。
不能修改类型。 |
SUBTYPE |
属性 | 属性确定如何将与发布/预订相关的消息属性添加到发送至预订的消息中。可用选项为: 兼容性:发布/预订属性将添加到消息中以维持与 IBM WebSphere® MQ V6.0 发布/预订的兼容性。 消息属性:发布/预订属性将添加为消息属性。 无:发布/预订属性不会添加到消息中。 RFH2:发布/预订属性将添加到 RFH V2 头中的消息中。 |
PSPROP |
用户数据 | 可以选择在发送至预订的消息中将用户数据的值作为消息属性传递。 | USERDATA |
选择器 | 选择器是一个 SQL92 字符串,它适用于针对指定主题发布的消息,用来选择这些消息对于预订是否合格。 | SELECTOR |
选择器类型 | 已指定的 SelectionString 的类型。 此显示属性已计算,并且不与对象相关联。将可以过滤选择器类型(例如,使用 WHERE 子句),以使管理员可以仅显示内部或外部选择器。 | SELTYPE |
“扩展”页面
下表列出了您可以在“预订属性”对话框的扩展页面上设置的属性。
属性 | 含义 | MQSC 参数 |
---|---|---|
变量用户标识 | 指定除预订创建者之外的用户是否可以连接至该预订并获取该预订的所有权。
有以下两个值: ANY:如果其他用户具有正确的主题权限检查和目标权限检查,就可以连接至预订。这是缺省值。 FIXED:其他用户不能连接至预订。 |
VARUSER |
用户 | 指定拥有此预订的用户概要文件。 | SUBUSER |
应用程序标识数据 | 应用程序身份数据的值将用于发送至预订的消息。 如果未指定应用程序身份数据,那么将使用空的缺省值。 | PUBAPPID |
记帐标记 | 记帐标记的值将用于已发送至预订的消息。如果未指定记帐标记,那么将使用缺省值 MQACT_NONE。 | PUBACCT |
发布优先级 | 发布优先级确定将与发布/预订相关的消息属性添加到发送至预订的消息中的方式。可用选项为: 作为已发布对象,它表示发送至该预订的消息的优先级,并且取自已发布的消息中所提供的优先级。 作为定义的队列,它表示发送至该预订的消息的优先级,并且取自定义为目标的队列的缺省优先级。 该优先级值允许您指定 0 - 9 范围内的优先级。 |
PUBPRTY |
预订标识 | 预订标识的值由队列管理器指定,作为此预订在任何时候都唯一的标识。如果由于格式问题而无法提供 SUBNAME,或者没有为应用程序创建的预订提供 SUBNAME,那么此标识可以代替 SUBNAME 来作为 DISPLAY、ALTER 和 DELETE MQSC 命令的目标。 | SUBID |
到期 | 预订从创建日期和时间算起的生存时间。到期以十分之一秒为单位。有以下两个值: 无限,它表示预订永远不会到期,或者用户也可以输入自己的值(以十分之一秒为单位)。零是缺省值。 |
EXPIRY |
仅请求 | “仅请求”指示订户是否将通过
MQSUBPRQ API 来轮询是否有更新。有以下两个值: 全部,它表示所有发布都将传递至预订。这是缺省值。 请求时,它表示发布仅在响应 MQSUBPRQ API 时传递至预订。 |
REQONLY |
预订级别 | 这是与预订关联的级别。 如果此预订位于具有小于或等于发布时所用 PubLevel 的最高 SubLevel 值的预订集中,那么发布将仅传递到此预订。该值必须在 0 - 9 范围内。零是最低级别。 | SUBLEVEL |
“统计信息”页面
下表列出了“预订属性”对话框的统计信息页面上的属性。统计信息页面显示有关预订的历史记录的信息。统计信息页面上显示的信息是只读信息,用户无法改变。
属性 | 含义 | MQSC 参数 |
---|---|---|
创建日期 | 只读。这是创建预订的日期。 | CRDATE |
创建时间 | 只读。这是创建预订的时间。 | CRTIME |
变更日期 | 只读。这是最近一次变更预订的属性的日期。 | ALTDATE |
变更时间 | 只读。这是最近一次变更预订的属性的时间。 | ALTTIME |