modifyWMQTopic 命令
使用 modifyWMQTopic 命令来更改 IBM MQ 消息传递提供程序主题的某参数。
要运行此命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
wsadmin 脚本编制客户机是从 Qshell 运行的。有关更多信息,请参阅“配置 Qshell 以运行 WebSphere® Application Server 脚本”主题。
此命令仅适用于 WebSphere Application Server V7 和更高版本的应用程序服务器。请不要对先前版本使用此命令。
要获取可用的 IBM MQ 消息传递提供程序管理命令的列表以及每个命令的简短描述,请在 wsadmin 提示符处输入以下命令:
print AdminTask.help('WMQAdminCommands')
要获取有关给定命令的总体帮助,请在 wsadmin 提示符处输入以下命令:
print AdminTask.help('command_name')
在使用这些命令之后,保存对主配置所做的更改。例如,使用以下命令:
AdminConfig.save()
用途
使用 modifyWMQTopic 命令来修改在发布此命令的范围内所定义的 IBM MQ 消息传递提供程序主题。
注: 您不能更改主意名称。
目标对象
特定作用域上的 IBM MQ 消息传递提供程序主题。
必需参数
此命令的参数与那些用于创建 IBM MQ 消息传递提供程序主题的参数相同。
可选参数
此命令的参数与那些用于创建 IBM MQ 消息传递提供程序主题的参数相同。
请注意在 -customProperties 参数上的此命令的行为。
- -customProperties
- 此参数指定要传递到 IBM MQ 消息传递提供程序主题实现的定制属性。通常情况下,定制属性用于设置主题的属性,该主题不直接通过 WebSphere 管理接口受到支持。将使用名称和值表步骤参数指定每个定制属性。因为这些步骤都是表步骤,所以两个参数的顺序是固定的,因此必须始终先指定名称,然后指定值:
- 使用 Jython:[name value]
- 使用 Jacl:{name value}
使用以下规则,将新的“名称 - 值”对添加到定制属性的现有集合中:- 如果现有属性集不包含(作为修改命令一部分所提供的)具有相同名称的属性,那么所提供的属性将添加至定制属性集,除非定制属性没有指定的值(当忽略定制属性时)。
- 如果现有属性集包含(作为修改命令一部分所提供的)具有相同名称的属性,那么修改命令还将指定属性值,并且提供的值将替换现有的值。
- 如果现有属性集包含与修改命令中所提供属性同名的属性,但该修改命令未指定该属性的值,那么会从现有定制属性集中删除同名属性。
示例
- 使用 Jython:
wsadmin>AdminTask.modifyWMQTopic("t1(cells/L3A3316Node04Cell/ nodes/L3A3316Node05|resources.xml#MQTopic_1204538835312)", ["-priority 7"]) t1(cells/L3A3316Node04Cell/nodes/L3A3316Node05|resources.xml# MQTopic_1204538835312)
- 使用 Jacl:
wsadmin>$AdminTask modifyWMQTopic t1(cells/L3A3316Node04Cell/nodes/L3A3316Node05|resources.xml# MQTopic_1204538835312) {-priority 7} t1(cells/L3A3316Node04Cell/nodes/L3A3316Node05|resources.xml# MQTopic_1204538835312)