集群主题属性
您可以为集群主题设置属性。 但是,某些属性只能在创建新集群主题时更改。 创建集群主题后,不能再更改这些属性。
要配置标准的队列管理器集群以进行发布/预订消息传递,可在集群中的一个队列管理器上定义一个或多个受管主题对象。 要使该主题成为集群主题,可配置“集群名称”属性。 执行此操作后,主题树中自该点起的发布者或订户所使用的任何主题均在集群中的所有队列管理器间共享。 发布到主题树的集群分支的消息也会自动路由至集群中其他队列管理器上的预订。
下表列出了 IBM® MQ 集群主题的所有属性。 这些表中列出的某些属性只能在创建新主题时进行更改,一旦创建了 IBM MQ 集群主题,就无法对其进行修改。
对于每个属性,都有一个简短描述来说明在什么情况下您可能需要配置它。 这些表还给出了可用于(例如)DISPLAY TCLUSTER 命令的等效 MQSC 参数。 有关 MQSC 命令的更多信息,请参阅 IBM 文档中的 使用 MQSC 命令进行管理 。
常规
下表列出了“集群主题属性”对话框中“常规”页面上的属性。属性 | 含义 | MQSC 参数 |
---|---|---|
主题名称 | 一旦创建主题后,就无法更改此值。 此参数是必需参数,并且不能包含空字符串。 要创建的管理主题定义的唯一标识。 最多允许使用 48 个字符。 名称不得与所选队列管理器上定义的任何其他主题定义相同。 |
TOPNAME |
主题类型 | 此值是只读的。 此值显示主题是本地的(Local )还是在集群中(Cluster )。 |
不适用 |
主题字符串 | 一旦创建主题后,就无法更改此值。 此参数是必需参数,并且不能包含空字符串。 此字符串中的“/”字符具有特殊含义。 它将主题树中的元素进行定界。 主题字符串可以使用“/”字符开头,但这不是必需的。 使用“/”字符开头的字符串与不使用“/”字符开头的字符串不同。 主题字符串不得 与另一主题对象定义已表示的任何其他主题字符串相同。 主题字符串的最大长度为 10 240 个字符。 |
TOPICSTR |
描述 | 此值是管理员输入的字符串。 它包含关于主题的描述性信息。 它必须只包含可显示的字符。 最多
64 个字符。 如果对所选队列管理器使用了不在编码字符集标识(CCSID)中的字符,那么在将信息发送至其他队列管理器时,可能会错误地转换这些字符。 |
DESC |
发布 | 此属性控制是否可以针对主题发布消息。 缺省值是与父代一样。 提供的其他两个选项如下: 允许,它表示已授权的应用程序可以针对主题发布消息。 禁止,它表示不能针对主题发布消息。 |
PUB |
预订 | 此属性控制消息是否可以预订主题。 缺省值是与父代一样。 提供的其他两个选项如下: 允许,它表示已授权的应用程序可以预订主题。 禁止,它表示应用程序不能预订主题。 |
SUB |
持久预订 | 此属性控制主题是否允许进行持久预订。 缺省值是与父代一样。 提供的其他两个选项如下: 允许,它表示应用程序可以对主题进行持久预订。 禁止,它表示应用程序不能对主题进行持久预订。 |
DURSUB |
缺省优先级 | 针对主题发布的消息的缺省优先级。 缺省值是与父代一样。 可以在 0(最低优先级)至 9(最高优先级)范围内设置缺省优先级。 |
DEFPRTY |
缺省持久性 | 新主题的缺省持久性是与父代一样。 选择持久以指定使用 MQPER_PERSISTENCE_AS_Q_DEF 的应用程序所创建的消息成为持久消息。 选择非持久以指定使用 MQPER_PERSISTENCE_AS_Q_DEF 的应用程序所创建的消息成为非持久消息。 | DEFPSIST |
缺省 PUT 响应类型 | 放置消息的缺省响应类型。 缺省值是与父代一样。 提供的其他两个选项如下: 同步,它表示以同步方式放置响应。 异步,它表示以异步方式放置响应。 |
DEFPRESP |
非持久消息传送 | 针对此主题发布的非持久消息的传递方法。 有四个选项: 与父代一样,使用的传递机制基于主题树中找到的第一个与此主题相关的父代管理节点的设置。 这是 IBM MQ随附的缺省值,但您的安装可能已对其进行了更改。 至所有可用订户,非持久消息将传递至所有可以接受该消息的订户。 将消息传递至任何一个订户的失败不会阻止其他订户接收到该消息。 至所有持久订户,必须将非持久消息传递至所有持久订户。 将非持久消息传递至任何一个非持久订户的失败不会将错误返回至 MQPUT 调用。 如果至某个持久订户的传递失败,那么其他订户也不会接收到消息,并且 MQPUT 调用将失败。 至所有订户,无论 MQPUT 调用是否一直报告成功,必须将非持久消息传递至所有订户。 如果至任何一个订户的传递失败,那么其他订户也不会接收到消息,并且 MQPUT 调用将失败。 |
NPMSGDLV |
持久消息传送 | 针对此主题发布的持久消息的传递方法。 有四个选项: 与父代一样,使用的传递机制基于主题树中找到的第一个与此主题相关的父代管理节点的设置。 这是 IBM MQ随附的缺省值,但您的安装可能已对其进行了更改。 至所有可用订户,持久消息将传递至所有可以接受该消息的订户。 将消息传递至任何一个订户的失败不会阻止其他订户接收到该消息。 至所有持久订户,必须将持久消息传递至所有持久订户。 将持久消息传递至任何一个非持久订户的失败不会将错误返回至 MQPUT 调用。 如果至某个持久订户的传递失败,那么其他订户也不会接收到消息,并且 MQPUT 调用将失败。 至所有订户,无论 MQPUT 调用是否一直报告成功,必须将持久消息传递至所有订户。 如果至任何一个订户的传递失败,那么其他订户也不会接收到消息,并且 MQPUT 调用将失败。 |
PMSGDLV |
通配符操作 | 此值控制与主题相关的通配符预订的行为。 有以下两个值: 阻塞。 如果对通配符主题发出的预订相对于此主题对象的主题字符串而言不明确,那么将不会接收到对此主题或比此主题更明确的主题字符串进行的发布。 传递。 如果对通配符主题发出的预订相对于此主题对象的主题字符串而言不明确,那么将接收到对此主题或比此主题更明确的主题字符串进行的发布。 这是缺省值。 |
WILDCARD |
分布式发布/预订
下表列出了“集群主题属性”对话框中“>分布式发布/预订”页面上的属性。属性 | 含义 | MQSC 参数 |
---|---|---|
代理预订行为 | 代理预订与创建它们的队列管理器名称相关联。 如果存在包含发布主题的代理预订,那么发布只会转发至直接连接的队列管理器。 此值具有以下两个选项: 强制。 这样会强制将与集群中每个队列管理器内此主题关联的主题字符串的通配符式代理预订发送至发布/预订拓扑中的每个队列管理器, 而不管是否已进行任何本地预订。 该强制代理预订通过拓扑传播后,所有新的预订会立即收到来自其他相连队列管理器的所有发布,尽管所有发布会传播到集群中所有其他队列管理器,而不管是否请求预订。 在主题树中给定级别设置此值,还可防止为主题树中后续级别的单个主题字符串生成代理预订,从而减少代理预订开销。 首次使用。 因为发布/预订队列管理器的各种拓扑具有互连性质,所以在传播代理预订时会存在简短的延迟,延迟时间的长短取决于拓扑复杂性。 这意味着在进行了预订后,不一定会立即接收到远程发布。 |
PROXYSUB |
发布作用域 | 可以使用 PUBSCOPE 主题属性在管理上控制发布作用域。 可以将此属性设置以下三个值之一:
|
PUBSCOPE |
预订作用域 | 可以使用 SUBSCOPE 主题属性在管理上控制预订作用域。 可以将此属性设置以下三个值之一:
|
SUBSCOPE |
集群
下表列出了“集群主题属性”对话框中“集群”页面上的属性。属性 | 含义 | MQSC 参数 |
---|---|---|
集群名称 | 要使主题成为集群主题,可配置此属性。 执行此操作后,位于该点或主题树中的发布者或订户所使用的任何主题均在集群中的所有队列管理器间共享,发布到主题树的集群分支的消息也会自动路由至集群中其他队列管理器上的预订。 | 集群 |
集群对象状态 | 此集群中该主题对象的当前状态。 其值如下所示:
|
CLSTATE |
集群队列管理器 | 这是拥有集群主题的集群中的队列管理器的名称。 | 不适用 |
集群路由 | 用于 CLUSTER 参数所定义集群中的主题的路由行为。 共有两个可能的值:
|
CLROUTE |
QMID | 内部生成的集群队列管理器的唯一名称。 为了避免含糊不清,使用 QMID(队列管理器标识)要比使用 QMNAME 更好。 | QMID |
统计信息
下表列出了“集群主题属性”对话框中“统计信息”页面上的属性。属性 | 含义 | MQSC 参数 |
---|---|---|
变更日期 | 不能更改此值,它仅供参考。 这是最近一次变更主题属性的日期。 |
MQCA_ALTERATION_DATE |
变更时间 | 不能更改此值,它仅供参考。 这是最近一次变更主题的属性的时间。 |
MQCA_ALTERATION_TIME |