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