mqsideploy 命令

支持的平台

  • Windows
  • Linux 和 UNIX 系统
  • z/OS

用途

使用 mqsideploy 命令向配置管理器发出部署请求。这样您便可以使用批处理命令脚本发出各种部署请求,而不需要手动交互。

缺省部署方式是增量或递增部署。选择 -m 可以覆盖缺省操作。

mqsideploy 不需要配置管理器名称参数,因为通过使用 -n-q-i-p 参数可以获得所需的全部连接详细信息。

语法

Windows 平台、Linux 和 UNIX 系统

z/OS 控制台命令

同义词: dp

参数

-n cfgParameterFileName
(可选)描述配置管理器连接参数的 .configmgr 文件的名称。
该文件为 XML 格式,使用 Eclipse GUI 保存的 .configmgr 格式。例如:
<?xml version="1.0" encoding="UTF-8" ?>
<configmgr host="localhost" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
如果在 z/OS 上使用此文件,则必须从第一行除去语句 encoding="UTF-8",让此语句变为:
<?xml version="1.0"?>
并除去主机属性的值,让此语句变为:
<configmgr host="" listenerPort="1414" queueManager="QNAME"
           securityExit="test.myExit"/>
注: 如果不提供此参数,则必须提供 -i-p-q 参数。
-i ipAddress
(可选)配置管理器的主机名或 IP 地址。

如果在 z/OS 上使用此文件,并且要连接到本地主机,则必须将该值设置为 ""

-p Port
(可选)配置管理器的端口号。
-q qMgr
(可选)配置管理器所使用的 WebSphere MQ 队列管理器的名称。

如果不提供 -i-p-q 参数,则必须指定 -n 参数。

-b Brokername
(必需)作为部署目的地的代理的名称。如果指定了 -t-l 标志,则忽略 -b 选项。这是因为在部署主题或拓扑时会影响域中的所有代理。如果未指定 -e-a 标志,则启动代理配置部署。

使用 -c 选项时将取消向特定代理进行的部署。

-e EGName
(可选)作为部署目的地的执行组的名称。-b-a 选项也必须使用此选项指定。
-aBARFileName
(可选)要用于消息流或消息集部署的 BAR(代理归档)文件的名称。-b-e 选项也必须使用此选项指定。

z/OS 上,BAR 文件必须在文件系统中。 BAR 文件可以在任何位置,只要运行该命令的用户标识或配置管理器能够访问和读取它即可。

-t
(可选)部署所有主题配置信息。将信息部署到域中的所有代理。
-l
(可选)此标志指定应该部署拓扑配置。如果还设置了 -m 标志,则会将信息部署到域中的所有代理,否则仅将信息部署到已更改拓扑配置的代理。
-c
(可选)告诉配置管理器停止,等待对先前提交的部署请求的响应。如果和 -b 选项一起使用,配置管理器将停止,等待来自指定代理的待处理部署响应;如果不和 -b 选项一起使用,配置管理器将停止,等待域中所有待处理部署请求的响应。

指定 -c 选项时需谨慎。仅当受影响的代理不可能响应部署请求时才使用它;如果代理随后处理已经被取消的部署请求,配置管理器将忽略响应,因此会与代理不同步。

-w timeoutValue
(可选)实用程序将控制权交还给命令行之前等待代理应答的时间(以秒为单位)。mqsideploy 命令轮询配置管理器日志记录以查找刚发送的部署请求的结果。相关的日志记录会指出部署是否成功。timeoutValue 是超时之前等待的时间,范围是 1 - 999 999 秒。 如果未提供 timeoutValue 或指定的值小于 1 或大于 999 999,则返回一个错误。
-dDeployedObjects
(可选)描述要从执行组中除去的对象集。可以指定多个部署的文件,用字符“:”分隔。

通过以下限制(即如果指定的对象名不明确(例如“top”,而“top.dictionary”和“top.cmf”都部署到同一个执行组),则整个命令失败,并返回消息 BIP1089)可以指定所有类型的对象。在这些情况下,必须指定要除去的对象的标准名称,例如“top.dictionary:top.cmf”。

-v TraceFileName
(可选)将内部配置管理器代理调试跟踪发送到指定的文件。
-m -complete
(可选)部署完整的信息:
  • 对于 BAR 文件部署-m 将当前部署的所有消息流和消息集作为部署的一部分从执行组中除去。如果未设置 -m,则除了已在执行组上部署的内容,还将部署 BAR 文件的内容。在这种情况下,名称与 BAR 中的项相同的任何已部署的对象由 BAR 中的版本替换。
  • 对于拓扑配置部署-m 将所有代理间配置信息部署到所有代理。如果未设置 -m,则仅将更改过的代理间配置部署到已更改代理间配置的代理。
  • 对于代理配置部署,此标志无效。
  • 对于主题树部署-m 将整个主题树部署到所有代理。如果未设置 -m,则仅将主题树的更改部署到所有代理。
  • 对于除去消息流或除去消息集操作,忽略此标志。

权限

为使部署取得成功,发出此命令的用户标识需要有配置管理器中定义的足够权限。 所需的许可权与在Message Brokers Toolkit中执行同等功能所需的许可权相同。 有关配置管理器中可以定义的许可权列表,请参阅 ACL 许可权

响应

该命令返回下列响应:
0
(成功)表示配置管理器在超时之前已发出部署请求,并且所有相关的代理均成功响应。
2
(失败)表示配置管理器已发出部署请求,但至少有一个代理响应指出发生了错误。有关更多信息,请查看实用程序的消息输出(或配置管理器的事件日志)。
3
(已启动)表明配置管理器已经回复,说明部署已启动,但是在超时之前未收到代理响应。
5
(已提交)表明部署消息已发送到配置管理器,但是在超时之前未收到响应。
6
(SuccessSoFar)表示配置管理器已发出部署请求,但是在超时之前,只有部分(并非所有)相关代理响应指出操作成功;没有任何代理响应指出发生了错误。
98
表示无法连接配置管理器
99
表示向实用程序提供的自变量无效。

示例

使用连接文件(其参数在文件 cm1.configmgr 中描述)部署 Publish/Subscribe邻居,允许代理在 10 分钟内应答并部署完整的代理间配置信息:
mqsideploy -n cm1.configmgr -m -w 600
使用 ipq 参数部署Publish/Subscribe邻居以便连接到配置管理器,允许代理在 10 分钟内应答并部署完整的代理间配置信息:
mqsideploy -i localhost -p 1414 -q QMNAME -m -w 600

请注意,在以下示例中您可以使用 ipq 参数代替 -n 参数。

使用连接文件(其参数在文件 cm1.configmgr 中描述)部署主题层次结构,允许代理在 10 分钟内应答并部署完整的代理间配置信息:
mqsideploy -n cm1.configmgr -t -m -w 600
使用连接文件(其参数在文件 cm1.configmgr 中描述)部署 BAR 文件,允许代理用 10 分钟时间来回复和从执行组中作为部署的一部分除去当前已部署的消息流和消息集。
mqsideploy -n cm1.configmgr -b broker1 -e default -a mybar.bar -m -w 600
使用连接文件(其参数在文件 cm1.configmgr 中描述)部署指定代理的代理配置,允许代理用 15 分钟时间进行回复。
mqsideploy -n cm1.configmgr -b broker1 -w 900

尝试使用连接文件(其参数在 cm1.configmgr 文件中描述)从代理 b1 上的执行组 default 中除去消息流 top 和目录 bar

请注意,如果没有其他名为 topbar 的对象部署到执行组,-d 选项的值便可缩写成 top:bar
   mqsideploy –n cm1.configmgr –b B1 –e default –d top.cmf:bar.dictionary
使用连接文件(其参数在文件 cm1.configmgr 中描述)取消部署,允许代理用 15 分钟时间进行回复。在此示例中,配置管理器停止,等待域中所有待处理的部署请求。要指定取消部署的某个特定代理,使用 -b 参数:
mqsideploy -n cm1.configmgr -c -w 900
相关概念
运行时环境
相关任务
部署
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
an09020_