migrateWMQMLP 命令
使用 migrateWMQMLP 命令将 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()
用途
使用 migrateWMQMLP 命令将 IBM MQ 消息侦听器端口定义迁移至激活规范定义。在创建激活规范之后,您可以删除侦听器端口。
注意,不会将最大重试次数侦听器端口设置迁移到新的激活规范,这是因为没有完全等同的项。
您要迁移与 subscriptionDurability 激活配置属性设置为 Durable 的消息驱动的 Bean 相关联的侦听器端口,并且该 MDB 已经具有活动的持久预订,那么不会迁移该持久预订。这是因为侦听器端口和 IBM MQ 激活规范使用不兼容的预订名称格式。因此,可能会向相同 MDB 的相关主题预订两个活动的持久预订。在迁移过程中,您必须删除与侦听器端口相关联的旧持久预订,并手动清理与该侦听器端口相关联的所有消息。有关如何执行此操作的信息,请参阅 IBM MQ 和 IBM Integration Bus 文档。
目标对象
要迁移的消息侦听器端口。
必需参数
- -asName
- 要创建的激活规范名称。
- -asJNDIName
- 要创建的激活规范的 JNDI 名称。
- -asScope
- 要创建激活规范范围的类型(服务器、节点、集群或单元)。 请注意,只有当包含消息侦听器端口的服务器为集群的一部分时才支持集群选项。 否则,请将此缺省指定至服务器上。 指定的范围与消息侦听器端口有关,因此 节点是包含该消息侦听器端口的服务器的节点。
可选参数
无。以下示例显示如何将消息侦听器端口迁移至激活规范。
- 使用 Jython:
wsadmin>AdminConfig.list("ListenerPort") lp1(cells/L3A3316Node09Cell/nodes/L3A3316Node10/servers/server1| server.xml#ListenerPort_1211265363796) wsadmin>AdminTask.migrateWMQMLP("lp1(cells/L3A3316Node09Cell/nodes/ L3A3316Node10/servers/server1|server.xml#ListenerPort_1211265363796)", ["-asName migratedFromLP -asJNDIName jms/as1 -asScope node"]) migratedFromLP(cells/L3A3316Node09Cell/nodes/L3A3316Node10| resources.xml#J2CActivationSpec_1211265679078)
- 使用 Jacl:
wsadmin>$AdminConfig list ListenerPort lp1(cells/L3A3316Node09Cell/nodes/L3A3316Node10/servers/server1| server.xml#ListenerPort_1211265363796) wsadmin>$AdminTask migrateWMQMLP lp1(cells/L3A3316Node09Cell/nodes/L3A3316Node10/servers/server1| server.xml#ListenerPort_1211265363796) {-asName migratedFromLP -asJNDIName jms/as1 -asScope node} migratedFromLP(cells/L3A3316Node09Cell/nodes/L3A3316Node10| resources.xml#J2CActivationSpec_1211265679078)