manageWMQ 命令
使用 manageWMQ 命令来管理安装在特定作用域中的 IBM MQ 资源适配器的设置。
要运行此命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
wsadmin 脚本编制客户机是从 Qshell 运行的。有关更多信息,请参阅“配置 Qshell 以运行 WebSphere® Application Server 脚本”主题。
此命令仅适用于 WebSphere Application Server V7 和更高版本的应用程序服务器。请不要对先前版本使用此命令。
print AdminTask.help('WMQAdminCommands')
print AdminTask.help('command_name')
AdminConfig.save()
用途
使用 manageWMQ 命令来管理与安装在特定作用域中的 IBM MQ 资源适配器相关联的设置。
可使用 manageWMQ 命令来管理本机库路径和查询指定 IBM MQ 资源适配器的元数据。
目标对象
IBM MQ 资源适配器。
必需参数
无。
可选参数
- -nativePath
- 此参数指定 IBM MQ 资源适配器用于建立与队列管理器的绑定方式连接的 IBM MQ 消息传递提供程序本机库的路径。可在任何作用域的 IBM MQ 适配器上指定此参数。
- -query
- 此参数提供有关 IBM MQ 消息传递提供程序使用的 IBM MQ 资源适配器的级别的信息。可在任何作用域的 IBM MQ 资源适配器上指定此参数。
-enableInbound
此参数允许将入站 Java™ Platform, Enterprise Edition (Java EE) 连接器体系结构 (JCA) 消息传递至 z/OS® 平台上的 IBM MQ 资源适配器激活规范。仅当目标 IBM MQ 资源适配器在服务器作用域上时,才能指定此值。要使这些更改生效,需要重新启动应用程序服务器。
此参数的值必须是 true 或 false。
缺省值为 false。
- -disableWMQ
- 此参数指定是否在指定资源适配器的作用域及其后面的所有作用域禁用 IBM MQ 功能。
此参数的值必须是 true 或 false。
缺省值为 false。
在单服务器环境中,此参数仅在服务器作用域有效。在 Network Deployment 环境中,此参数在所有作用域中有效。将此参数设置为 true 的效果取决于您在其上设置此参数的作用域:
- 对于单元作用域的 IBM MQ 资源适配器,此单元中的所有应用程序服务器上的所有 IBM MQ 功能被禁用。
- 对于节点作用域的 IBM MQ 资源适配器,包含在该节点中的所有应用程序服务器上的所有 IBM MQ 功能被禁用。
- 对于集群作用域的 IBM MQ 资源适配器,该集群中的所有应用程序服务器上的所有 IBM MQ 功能被禁用。
- 对于服务器作用域的 IBM MQ 资源适配器,该特定应用程序服务器中的所有 IBM MQ 功能被禁用。
在所有情况下,所有受影响进程必须重新启动,这些更改才能生效。
参数在高作用域中的值优先于该参数在低作用域中的值。例如,如果在服务器作用域将参数设置为 false,但更高(例如,单元)作用域的 IBM MQ 消息传递提供程序将此参数设置为 true,那么单元作用域中的值优先,并且因此会在该单元的所有应用程序服务器中禁用 IBM MQ 功能(不管此参数值在服务器作用域如何都是如此)。
- -maxConnections
- 此参数指定与 IBM MQ 队列管理器的连接的最大数目。
缺省值为 10。
有关更多信息,请参阅 IBM MQ 信息中心中的 ResourceAdapter 对象的配置。
- -connectionConcurrency
- 此参数指定每个连接可提供的消息驱动的 Bean 的最大数目。
缺省值为 1。
设置此属性仅影响 WebSphere Application Server 7 的节点。该属性对 WebSphere Application Server V8 或更高版本的节点没有影响。
有关更多信息,请参阅 IBM MQ 信息中心中的 ResourceAdapter 对象的配置。
- -reconnectionRetryCount
- 此参数指定连接失败时 IBM MQ
消息传递提供程序激活规范为重新连接至 IBM MQ 队列管理器而尝试的最大次数。
缺省值为 5。
有关更多信息,请参阅 IBM MQ 信息中心中的 ResourceAdapter 对象的配置。
- -reconnectionRetryInterval
- 此参数指定再次尝试重新连接至 IBM MQ 队列管理器之前
IBM MQ 消息传递提供程序激活规范等待的时间(以毫秒计)。
缺省值为 300000。
有关更多信息,请参阅 IBM MQ 信息中心中的 ResourceAdapter 对象的配置。
- -customProperties
- 此参数指定要传递至 IBM MQ 资源适配器的定制属性。通常,定制属性用于设置并非直接通过
WebSphere Application Server 管理接口而受支持的
IBM MQ 资源适配器的属性。将使用名称和值表步骤参数指定每个定制属性。因为这些步骤都是表步骤,所以两个参数的顺序是固定的,因此必须始终先指定名称,然后指定值:
- 使用 Jython:[name value]
- 使用 Jacl:{name value}
使用以下规则,将新的“名称 - 值”对添加到定制属性的现有集合中:- 如果现有属性集未包含与所提供属性同名的属性,那么所提供属性将添加至此定制属性集,除非此定制属性未指定值(此时会忽略此属性)。
- 如果现有属性集包含(作为修改命令一部分所提供的)具有相同名称的属性,那么修改命令还将指定属性值,并且提供的值将替换现有的值。
- 如果现有属性集包含与修改命令中所提供属性同名的属性,但该修改命令未指定该属性的值,那么会从现有定制属性集中删除同名属性。
示例
以下示例说明如何在 z/OS 平台上启用入站 JCA 消息的传递。- 使用 Jython:
wsadmin>AdminTask.manageWMQ("IBM MQ Resource Adapter (cells/L3A3316Node04Cell/nodes/L3A3316Node05/servers/server1|resources.xml# J2CResourceAdapter_1201601803796)", ["-enableInbound true"])
- 使用 Jacl:
wsadmin>$AdminTask manageWMQ "IBM MQ Resource Adapter (cells/L3A3316Node04Cell/nodes/L3A3316Node05/servers/server1|resources.xml# J2CResourceAdapter_1201601803796)" {-enableInbound true}
- 使用 Jython:
AdminTask.manageWMQ("IBM MQ Resource Adapter( cells/L3A3316Node01Cell|resources.xml#J2CResourceAdapter_1284547647859)", ["-maxConnections 100 -customProperties [[name1 value1]]"])
- 使用 Jacl:
wsadmin>$AdminTask manageWMQ "IBM MQ Resource Adapter( cells/L3A3316Node01Cell|resources.xml#J2CResourceAdapter_1284547647859)" {-maxConnections 100 -customProperties {{name1 value1}}}