Sun Java System Message Queue 3.7 UR1 管理指南

命令实用程序

命令实用程序 (imqcmd) 用于管理代理、连接服务、连接、物理目的地、长期订阅和事务。

所有 imqcmd 命令都必须包含一个子命令（使用 -v 或 -h 选项显示产品版本信息或使用帮助的命令除外）。下面列出了一些可用的子命令，并在后面的相应章节中进行了详细介绍。在任何情况下，如果子命令接受代理地址（-b 选项），并且未指定主机名或端口号，则默认情况下都将采用值 localhost 和 7676。

代理管理
`shutdown bkr`	关闭代理
`restart bkr`	重新启动代理
`pause bkr`	暂停代理
`resume bkr`	恢复代理
`update bkr`	设置代理属性
`reload cls`	重新装入群集配置
`query bkr`	列出代理属性值
`metrics bkr`	显示代理度量
连接服务管理
`pause svc`	暂停连接服务
`resume svc`	恢复连接服务
`update svc`	设置连接服务属性
`list svc`	列出代理中可用的连接服务
`query svc`	列出连接服务属性值
`metrics svc`	显示连接服务度量
连接管理
`list cxn`	列出代理中的连接
`query cxn`	显示连接信息
物理目的地管理
`create dst`	创建物理目的地
`destroy dst`	销毁物理目的地
`pause dst`	暂停物理目的地的消息传送
`resume dst`	恢复物理目的地的消息传送
`update dst`	设置物理目的地属性
`purge dst`	清除来自物理目的地的所有消息
`compact dst`	压缩物理目的地
`list dst`	列出物理目的地
`query dst`	列出物理目的地属性值
`metrics dst`	显示物理目的地度量
长期订阅管理
`destroy dur`	销毁长期订阅
`purge dur`	清除来自长期订阅的所有消息
`list dur`	列出主题的长期订阅
事务管理
`commit txn`	提交事务
`rollback txn`	回滚事务
`list txn`	列出代理正在跟踪的事务
`query txn`	显示事务信息

代理管理

无法使用命令实用程序启动代理，而应使用代理实用程序 (imqbrokerd)。代理启动后，您可以使用表 13–2 中列出的 imqcmd 子命令来管理和控制代理。

表 13–2 用于代理管理的命令实用程序子命令


语法	描述
`shutdown bkr` [`-b` `hostName` `:portNumber`]	关闭代理
`restart bkr` [`-b` `hostName` `:portNumber`]	重新启动代理关闭代理，再使用最初启动代理时指定的选项重新启动代理。
`pause bkr` [`-b` `hostName` `:portNumber`]	暂停代理有关详细信息，请参见暂停代理。
`resume bkr` [`-b` `hostName` `:portNumber`]	恢复代理
`update bkr` [`-b` `hostName` `:portNumber`] `-o` `property1=` `value1` [ [`-o` `property2` `=value2`] … ]	设置代理属性有关代理属性的信息，请参见第 14 章，代理属性参考。
`reload cls`	重新装入群集配置 [仅适用于代理群集。] 将所有持久性信息强制更新为最新状态。
`query bkr` `-b` `hostName` `:portNumber`	列出代理属性值还列出连接到群集中指定代理的所有正在运行的代理。
`metrics bkr` [`-b` `hostName` `:portNumber`] [`-m` `metricType`] [`-int` `interval`] [`-msp` `numSamples`]	显示代理度量 `-m` 选项指定要显示的度量的类型： `ttl`：流入和流出代理的消息和包 `rts`：消息和包流入和流出代理的速率（以一秒为衡量单位） `cxn`：连接、虚拟内存堆和线程默认值：`ttl`。 `-int` 选项指定显示度量的时间间隔（以秒为单位）。默认值：`5`。 `-msp` 选项指定要显示的样例的数量。默认值：无限制（无穷多）。

连接服务管理

表 13–3 列出了用于管理连接的 imqcmd 子命令。

表 13–3 用于连接服务管理的命令实用程序子命令


语法	描述
`pause svc` `-n` `serviceName` [`-b` `hostName:` `portNumber`]	暂停连接服务无法暂停 `admin` 连接服务。
`resume svc` `-n` `serviceName` [`-b` `hostName:` `portNumber`]	恢复连接服务
`update svc` `-n` `serviceName` [`-b` `hostName:` `portNumber`] `-o` `property1=` `value1` [ [`-o` `property2` `=value2`] … ]	设置连接服务属性有关连接服务属性的信息，请参见连接属性。
`list svc` [`-b` `hostName` `:portNumber`]	列出代理中可用的连接服务
`query svc` `-n` `serviceName` [`-b` `hostName:` `portNumber`]	列出连接服务属性值
`metrics svc` `-n` `serviceName` [`-b` `hostName:` `portNumber`] [`-m` `metricType`] [`-int` `interval`] [`-msp` `numSamples`]	显示连接服务度量 `-m` 选项指定要显示的度量的类型： `ttl`：通过指定的连接服务流入和流出代理的消息和包 `rts`：消息和包通过指定的连接服务流入和流出代理的速率 `cxn`：连接、虚拟内存堆和线程默认值：`ttl`。 `-int` 选项指定显示度量的时间间隔（以秒为单位）。默认值：`5`。 `-msp` 选项指定要显示的样例的数量。默认值：无限制（无穷多）。

连接管理

表 13–4 列出了用于管理连接服务的 imqcmd 子命令。

表 13–4 用于连接服务管理的命令实用程序子命令


语法	描述
`list cxn` [`-svn` `serviceName`] [`-b` `hostName:` `portNumber`]	列出代理中的连接列出代理到指定连接服务的所有连接。如果未指定连接服务，则列出所有连接。
`query cxn` `-n` `connectionID` [`-b` `hostName:` `portNumber`]	显示连接信息

物理目的地管理

表 13–5 列出了用于管理物理目的地的 imqcmd 子命令。在任何情况下，-t（目的地类型）选项都可以采用以下两个值之一：

q：队列目的地

t：主题目的地

表 13–5 用于物理目的地管理的命令实用程序子命令


语法	描述
`create dst` `-t` `destType` `-n` `destName` [`-o` `property1` `=value1`] [ [ `-o` `property2` `=value2`] … ]	创建物理目的地 [不能在主代理暂时不可用的代理群集中执行] 目的地名称 `destName` 只能包含字母数字字符（不包括空格），并且必须以字母字符开头，或者以下划线 (`_`) 或美元符号 (`$`) 开头。目的地名称不能以字符 `mq` 开头。
`destroy dst` `-t` `destType` `-n` `destName`	销毁物理目的地此操作不能应用于系统创建的目的地，如停用消息队列。
`pause dst` [`-t` `destType` `-n` `destName`] [`-pst` `pauseType`]	暂停物理目的地的消息传送暂停由 `-t` 和 `-n` 选项指定的物理目的地的消息传送。如果未指定这些选项，将暂停所有目的地。 `-pst` 选项指定要暂停的消息传送的类型： `CONSUMERS`：暂停向消息使用方传送消息 `PRODUCERS`：暂停向消息生成方传送消息 `ALL`：暂停所有消息传送默认值：`ALL`
`resume dst` [`-t` `destType` `-ndestName`]	恢复物理目的地的消息传送恢复由 `-t` 和 `-n` 选项指定的物理目的地的消息传送。如果未指定这些选项，将恢复所有目的地。
`update dst` `-t` `destType` `-n` `destName` `-o` `property1=` `value1` [ [ `-o` `property2` `=value2`] … ]	设置物理目的地属性有关物理目的地属性的信息，请参见第 15 章，物理目的地属性参考。
`purge dst` `-t` `destType` `-n` `destName`	清除来自物理目的地的所有消息
`compact dst` [`-t` `destType` `-n` `destName`]	压缩物理目的地压缩物理目的地（由 `-t` 和 `-n` 选项指定）的基于文件的持久性数据存储库。如果未指定这些选项，将压缩所有目的地。压缩之前必须先暂停目的地。
`list dst` [`-t` `destType`] [`-tmp`]	列出物理目的地列出某个类型的所有物理目的地，该类型由 `-t` 选项指定。如果未指定任何目的地类型，则同时列出队列目的地和主题目的地。如果指定了 `-tmp` 选项，还会列出临时目的地。
`query dst` `-t` `destType` `-n` `destName`	列出物理目的地属性值
`metrics dst` `-t` `destType` `-n` `destName` [`-m` `metricType`] [`-int` `interval`] [`-msp` `numSamples`]	显示物理目的地度量 `-m` 选项指定要显示的度量的类型： `ttl`：流入和流出目的地以及驻留在内存中的消息和包 `rts`：消息和包流入和流出代理的速率（以一秒为衡量单位），以及其他速率信息 `con`：与消息使用方相关的度量 `dsk`：磁盘使用情况默认值：`ttl`。 `-int` 选项指定显示度量的时间间隔（以秒为单位）。默认值：`5`。 `-msp` 选项指定要显示的样例的数量。默认值：无限制（无穷多）。

长期订阅管理

表 13–6 列出了用于管理连接服务的 imqcmd 子命令。

表 13–6 用于长期订阅管理的命令实用程序子命令


语法	描述
`destroy dur` `-c` `clientID` `-n` `subscriberName`	销毁长期订阅 [不能在主代理暂时不可用的代理群集中执行]
`purge dur` `-c` `clientID` `-n` `subscriberName`	清除来自长期订阅的所有消息
`list dur` `-d` `topicName`	列出主题的长期订阅

事务管理

表 13–7 列出了用于管理事务的 imqcmd 子命令。

表 13–7 用于事务管理的命令实用程序子命令


语法	描述
`commit txn` `-n` `transactionID`	提交事务
`rollback txn` `-n` `transactionID`	回滚事务
`list txn`	列出代理正在跟踪的事务
`query txn` `-n` `transactionID`	显示事务信息

常规命令实用程序选项

表 13–8 中列出的附加选项适用于 imqcmd 命令的所有子命令。

表 13–8 常规命令实用程序选项


选项	描述
`-secure`	通过 `ssladmin` 连接服务使用安全的代理连接
`-u` `userName`	用于验证的用户名如果省略此选项，命令实用程序将以交互方式提示用户输入用户名。
`-p` `password`	用于验证的密码 [不建议使用此选项，它最终将被删除。请省略该密码（这样，系统将以交互的方式提示用户输入密码）或使用 `-passfile` 选项来指定包含密码的文件。]
`-passfile` `path`	密码文件的位置有关详细信息，请参见密码文件。
`-rtm` `timeoutInterval`	初始超时时间间隔（以秒为单位）初始超时时间间隔是命令实用程序最初等待代理回复的时间长度，超过此时间后，将重试请求。随后的每次重试都将使用此初始时间间隔的倍数作为超时时间间隔。默认值：`10`。
`-rtr` `numRetries`	代理请求超时后尝试重试的次数默认值：`5`。
`-javahome` `path`	可选 Java 运行时环境的位置默认行为：使用系统上安装的运行时环境或 Message Queue 附带的运行时环境。
`-f`	执行操作时无需用户确认
`-s`	无提示模式（不显示输出）
`-v`	显示版本信息 [忽略命令行中指定的任何其他选项。] ^, [不需要用户名和密码]
`-h`	显示使用帮助^,
`-H`	显示详细的使用帮助，包括属性列表和示例^,