|
| |
| Sun Java System Message Queue 3 2005Q1 管理指南 | |
第 13 章
命令参考本章包含的一个小节介绍了通用命令行语法，并提供了各个 Message Queue 命令的参考信息。本章包含以下小节：
命令行语法Message Queue 命令行实用程序是 shell 命令。实用程序的名称是命令，其子命令或选项是传递给该命令的参数。因此，没有、也不需要用于启动或退出实用程序的命令。
所有的命令行实用程序均共享以下命令语法：
Utility_Name [subcommand] [argument] [[-option_name [-option_argument]]…]
Utility_Name 指定 Message Queue 实用程序的名称，例如，imqcmd、imqobjmgr 和 imqusermgr 等。
输入命令的规则
输入命令时要遵循的一些通用规则：
命令行示例
以下是不包含子命令子句的一个命令行示例。此命令启动默认代理。
imqbrokerd
以下命令更复杂一些。此命令用于销毁类型为 queue、名为 myQueue 的目标。验证是基于用户 admin 执行的；此命令将提示用户输入用户密码。-f 选项指定将没有确认；-s 选项指定在静音模式下执行此命令。
imqcmd destroy dst -t q -n myQueue -u admin -f -s
通用命令选项
表 13-1 介绍了所有 Message Queue 管理实用程序的通用选项。在命令行中，必须在子命令之后指定这些选项。选项的输入顺序是任意的。
imqbrokerdimqbrokerd 命令将启动一个代理。命令行选项覆盖代理配置文件中的值，但仅对当前代理会话有效。
语法
命令选项
表 13-2 说明了 imqbrokerd 命令的选项以及受到各个选项影响的配置属性（如果存在）。
表 13-2 imqbrokerd 选项
选项
所影响的属性
说明
-backup fileName
不影响任何属性。
仅适用于代理群集。将主代理的配置更改记录备份到指定的文件。请参见管理配置更改记录。
-cluster“broker1]
[[,broker2]…]”
其中 broker 可以是用要连接的代理的列表覆盖 imq.cluster.brokerlist。
仅适用于代理群集。连接至指定的主机和端口上的所有代理。该列表将与 imq.cluster.brokerlist 属性中的列表合并。如果没有指定 host 的值，将使用 localhost。如果没有指定 port 的值，将使用值 7676。关于如何使用该选项连接多个代理的详细信息，请参见使用代理群集。
-dbpassword password
使用指定密码覆盖 imq.persist.jdbc.password
指定插入的 JDBC 兼容数据存储库的密码。不赞成使用此选项，在今后的版本中会将其删除。使用下列替代方法之一：
-dbuser userName
使用指定用户名覆盖 imq.persist.jdbc.user
指定插入的 JDBC 兼容数据存储库的用户名。请参见设置持久性存储。
-Dproperty=value
设置系统属性。覆盖实例配置文件中的相关属性值。
将指定属性设置为指定值。有关代理配置属性的信息，请参见第 14 章“代理属性参考”。
注意：请仔细检查使用 -D 选项设置的属性的拼写和格式。如果传送了不正确的值，系统不会向您发出警告，Message Queue 将无法对这些属性进行设置。
-force
不影响任何属性。
执行操作，而无需用户确认。此选项仅用于 -remove instance 和 -upgrade-store-nobackup 选项，通常要求确认。
-h|-help
不影响任何属性。
显示帮助。不执行命令行上的其他选项。
-javahome path
不影响任何属性。
指定替代 Java 2 兼容 JDK 的路径。默认使用捆绑的运行时。
-ldappassword
password使用指定密码覆盖 imq.user_repository.ldap.password
指定访问 LDAP 用户系统信息库的密码。不赞成使用此选项，在今后的版本中会将其删除。使用下列替代方法之一：
-license [licenseName]
不影响任何属性。
指定装入一个与 Message Queue 产品版本的默认许可证不同的许可证。如果不指定许可证名称，该选项将列出系统中安装的所有许可证。根据所安装的 Message Queue 版本的不同，licenseName 的取值也不同：pe（平台版，只具有基本功能）、try（平台版的 90 天试用企业功能）和 unl（企业版）。
-loglevel level
使用指定级别覆盖 imq.broker.log.level。
将日志记录级别指定为下列四项之一：NONE、ERROR、WARNING 或 INFO。默认值是 INFO。
-metrics interval
使用指定秒数覆盖 imq.metrics.interval。
指定将代理度量写入记录程序的时间间隔（以秒为单位）。
-name instanceName
将 imq.instancename 设置为指定名称。
指定该代理的实例名称，并使用相应的实例配置文件。如果不指定代理名称，实例名将设置为 imqbroker。
注：如果在同一台主机上运行了多个代理实例，每个实例必须具有唯一的名称。-passfile fileName
覆盖 imq.passfile.enabled 并将其设置为 true。使用包含该文件的路径覆盖 imq.passfile.dirpath。使用该文件的名称覆盖 imq.passfile.name。
指定文件名，从该文件中可以读取 imqcmd 命令实用程序、SSL 密钥库、LDAP 用户系统信息库、JDBC 兼容数据库或它们的任意组合的密码。有关详细信息，请参见使用密码文件。
-password keypassword
使用指定密码覆盖 imq.keystore.password。
指定 SSL 证书密钥库的密码。不赞成使用此选项，在今后的版本中会将其删除。使用下列替代方法之一：
-port number
使用指定号码覆盖 imq.portmapper.port。
指定代理的端口映射器的端口号。默认情况下，将其设置为 7676。要在同一台服务器上运行两个代理实例，每个代理的端口映射器必须拥有不同的端口号。Message Queue 客户机使用此端口号连接到代理实例。
-remove instance
不影响任何属性。
导致代理实例被删除：删除与实例相关联的实例配置文件、日志文件、持久性存储与其他文件和目录。除非指定 -force 选项，否则需要用户确认。
-reset store| messages|
durables|
props不影响任何属性。
根据给定变量，重置代理实例的数据存储库（或数据存储库的子集）或配置属性。
重置数据存储库将清除所有的持久性数据，包括持久性消息、长期订阅和事务信息。这使您可以启动一个完全清空的代理实例。也可以仅清除所有的持久性消息或仅清除所有的长期订阅。（如果不希望下次重新启动代理实例时重置持久性存储，请勿使用 -reset 选项重新启动代理实例。）
重置代理的属性，用一个空文件代替现有的实例配置文件 (config.properties)：所有的属性将使用默认值。
-restore fileName
不影响任何属性。
仅适用于代理群集。使用指定备份文件替换主代理的配置更改记录。该文件必须是原来用 -backup 选项创建的那个备份文件。请参见管理配置更改记录。
-shared
覆盖 imq.jms.threadpool_model 并将其设置为 shared。
指定使用共享线程池模型来实现 jms 连接服务。在该模型中，连接之间共享线程，以增加代理实例支持的连接数量。
-silent|-s
覆盖 imq.log.console.output 并将其设置为 NONE。
停止向控制台记录日志信息。
-tty
覆盖 imq.log.console.output 并将其设置为 ALL
指定在控制台上显示所有消息。默认情况下，只显示 WARNING 和 ERROR 级别的消息。
-upgrade-store-
nobackup不影响任何属性。
指定从不兼容版本升级到 Message Queue 3.5 或 Message Queue 3.5 SPx 将自动删除原有的数据存储库。有关其他详细信息，请参见 Message Queue Installation Guide。
-version
不影响任何属性。
显示所安装产品的版本号。
-vmargs arg1 [[arg2]…]
不影响任何属性。
指定传送到 Java VM 的变量。变量之间以空格分隔。如要传送多个变量，或是变量内包含空格，请使用闭合的引号。例如：
imqbrokerd -tty -vmargs "-Xmx128m -Xincgc"只能在命令行中传递这些参数。config.props 文件中没有相关联的配置属性。
另请参见
有关使用 imqbrokerd 及命令示例的详细信息，请参见以交互方式启动代理。
imqcmdimqcmd 命令实用程序使您可以管理代理及其服务。
语法
imqcmd subcommand argument [options]
imqcmd -h|H
imqcmd -v子命令
必须始终将子命令与 imqcmd 配合使用，除非您希望显示帮助或显示产品版本。 表 13-3 列出了 imqcmd 子命令，并指定了该子命令的参考信息所在的位置。
表 13-3 imqcmd 子命令
子命令和参数
说明
参考
commit txn
提交事务。
destroy dur
销毁长期订阅。
list cxn
列出代理的连接。
list dur
列出对主题的长期订阅。
list svc
列出代理中的服务。
list txn
列出代理中的事务。
metrics bkr
显示代理度量。
metrics svc
显示服务度量。
pause bkr
暂停代理中的所有服务。
pause svc
暂停代理中的单项服务。
purge dur
清除长期订阅中的所有消息，但不销毁该长期订阅。
query bkr
查询并显示代理中的信息。
query cxn
查询并显示连接中的信息。
query svc
查询并显示服务中的信息。
query txn
查询并显示事务中的信息。
reload cls
重新装入代理群集配置。
restart bkr
重新启动当前运行的代理实例。
resume bkr
恢复代理中的所有服务。
resume svc
恢复一项服务。
rollback txn
回滚某项事务。
shutdown bkr
关闭代理实例。
update bkr
更新代理属性。
update svc
更新服务属性。
imqcmd 命令实用程序也包含用于代理中物理目标的子命令。第 6 章“管理物理目标”中介绍了目标子命令。
以下各节按功能列出了 imqcmd 子命令。
代理管理子命令
表 13-4 列出了用于管理代理的 imqcmd 子命令。如果未指定主机名和端口，则会假定为默认值 (localhost:7676)。
表 13-4 用于管理代理的 imqcmd 子命令
子命令语法
说明
metrics bkr [-b hostName:port]
[-m metricType]
[-int interval]
[-msp numSamples]显示默认代理的代理度量，或显示指定主机和端口上的代理的代理度量。
使用 -m 选项指定要显示的度量类型：
ttl 显示消息和包流入和流出代理的度量。（默认度量类型）
rts 显示消息和包流入和流出代理的速率（每秒）的度量。
cxn 显示连接、虚拟内存堆和线程。
使用 -int 选项指定显示度量的时间间隔（以秒为单位）。默认值为 5 秒。
使用 -msp 选项指定在输出中显示的样例数量。默认值为无限数（无穷大）。
pause bkr [-b hostName:port]
暂停默认代理或指定主机和端口上的代理。请参见暂停和恢复代理。
query bkr -b hostName:port
列出默认代理或指定主机和端口上的代理的当前属性设置。还将列出与指定代理连接且正在运行的代理（在多代理群集中）。
reload cls
仅适用于代理群集。强制群集中的所有代理重新装入 imq.cluster.brokerlist 属性并更新群集信息。有关详细信息，请参见将代理添加到群集。
restart bkr [-b hostName:port]
使用代理启动时指定的选项，关闭并重新启动默认代理或指定主机和端口上的代理。
resume bkr [-b hostName:port]
恢复默认代理或指定主机和端口上的代理。
shutdown bkr [-b hostName:port]
关闭默认代理或指定主机和端口上的代理。
update bkr [-b hostName:port]
-o attribute=value
[-o attribute=value1]…更改默认代理或指定主机和端口上的代理的指定属性。
物理目标管理子命令
表 13-5 列出了用于管理物理目标的 imqcmd 子命令。如果未指定主机名和端口，则会假定为默认值 (localhost:7676)。
表 13-5 用于管理目标的 imqcmd 子命令
子命令语法
说明
compact dst [-t destType
-n destName]为指定类型和名称的目标压缩内置的、基于文件的数据存储库。如果未指定目标类型和名称，则会压缩所有目标。在压缩之前必须暂停目标。
create dst -t destType
-n destName
[-o attribute=value]
[-o attribute=value1]…创建指定类型、名称和属性的目标。目标名称必须只包含字母数字字符（不包括空格），可以以字母字符或 "_" 和 "$" 字符开头。它不能以字符串 "mq." 开头。
如果群集的主代理暂时不可用，则不能在群集中执行此操作。
destroy dst -t destType
-n destName销毁指定类型和名称的目标。不能销毁系统创建的目标，如停用消息队列。
如果群集的主代理暂时不可用，则不能在群集中执行此操作。
list dst [-t destType] [-tmp]
列出指定类型的所有目标，同时包含列出临时目标的选项。
类型参数可有两个值：
destType = q（队列）
destType = t（主题）如果未指定类型，将列出所有类型的所有目标。
metrics dst -t destType
-n destName
[-m metricType]
[-int interval]
[-msp numSamples]显示指定类型和名称的目标的度量信息。
使用 -m 选项指定要显示的度量类型：
ttl 显示消息和包流入和流出目标以及占用内存的度量。（默认度量类型）
rts 显示消息和包（每秒）流入和流出目标的速率度量及其他比率信息。
con 显示使用方相关度量。
dsk 显示磁盘使用情况度量。
使用 -int 选项指定显示度量的时间间隔（以秒为单位）。默认值为 5 秒。
使用 -msp 选项指定在输出中显示的样例数量。默认值为无限数（无穷大）。
pause dst [-t destType
-n destName]
[-pst pauseType]对于指定类型和名称的目标，暂停将消息传送给使用方 (-pst CONSUMERS)，或暂停从生产方传送消息 (-pst PRODUCERS)，或二者同时暂停 (-pst ALL)。如果未指定目标类型和名称，则暂停所有目标。默认值为 ALL。
purge dst -t destType
-n destName清除指定类型和名称的目标中的消息。
query dst -t destType
-n destName列出指定类型和名称的目标的相关信息。
resume dst [-t destType
-n destName]恢复指定类型和名称的暂停目标中的消息传送。如果未指定目标类型和名称，则恢复所有目标。
update dst -t destType
-n destName
-o attribute=value
[-o attribute=value1]…更新指定目标上指定属性的值。
属性名称可以是表 15-1 中所描述的任何属性，除非该目标是停用消息队列 mq.sys.dmq。
连接服务管理子命令
表 13-6 列出了用于管理连接服务的 imqcmd 子命令。如果未指定主机名和端口，则会假定为默认值 (localhost:7676)。
表 13-6 用于管理连接服务的 imqcmd 子命令
子命令语法
说明
list svc [-b hostName:port]
列出默认代理或指定主机和端口上的代理中的所有连接服务。
metrics svc -n serviceName
[-b hostName:port]
[-m metricType]
[-int interval]
[-msp numSamples]显示默认代理或指定主机和端口上的代理中指定服务的度量。
使用 -m 选项指定要显示的度量类型：
ttl 显示消息和包按指定服务方式流入和流出代理的度量。（默认度量类型）
rts 显示消息和包按指定连接服务方式流入和流出代理的速率（每秒）度量。
cxn 显示连接、虚拟内存堆和线程。
使用 -int 选项指定显示度量的时间间隔（以秒为单位）。默认值为 5 秒。
使用 -msp 选项指定在输出中显示的样例数量。默认值为无限数（无穷大）。
pause svc -n serviceName
[-b hostName:port]暂停运行在默认代理或指定主机和端口上的代理中的指定服务。不能暂停管理服务。
query svc -n serviceName
[-b hostName:port]显示运行在默认代理或指定主机和端口上的代理中的指定服务的信息。
resume svc -n serviceName
[-b hostName:port]恢复运行在默认代理或指定主机和端口上的代理中的指定服务。
update svc -n serviceName
[-b hostName:port]
-o attribute=value
[-o attribute=value1]…更新运行在默认代理或指定主机和端口上的代理中的指定服务的指定属性。有关服务属性的说明，请参见连接服务属性。
连接子命令
表 13-7 列出了应用于连接的 imqcmd 子命令。如果没有指定主机名和端口，则会假定为 localhost 和 7676。
表 13-7 用于管理连接服务的 imqcmd 子命令
子命令语法
说明
list cxn [-svn serviceName]
[-b hostName:port]列出默认代理或指定主机和端口上的代理中指定服务名称的所有连接。如果未指定服务名称，将列出所有连接。
query cxn -n connectionID
[-b hostName:port]显示默认代理或指定主机和端口上的代理中的指定连接的信息。
长期订阅子命令
表 13-8 概述了 imqcmd 长期订阅子命令。如果未指定主机名和端口，则会假定默认值 (localhost:7676)。
表 13-8 用于管理长期订阅的 imqcmd 子命令
子命令
说明
list dur -d destName
列出指定目标的所有长期订阅。
destroy dur -n subscrName
-c client_id销毁指定客户机标识符的指定长期订阅。
如果群集的主代理暂时不可用，则不能在群集中执行此操作。
purge dur -n subscrName
-c client_id清除指定客户机标识符的指定长期订阅的所有消息。
事务管理子命令
表 13-9 概述了 imqcmd 事务子命令。如果未指定主机名和端口，则会假定默认值 (localhost:7676)。
表 13-9 用于管理事务的 imqcmd 子命令
子命令
说明
list txn
列出代理跟踪的所有事务。
query txn -n transaction_id
列出指定事务的相关信息。
commit txn -n transaction_id
提交指定的事务。
rollback txn -n transaction_id
回滚指定的事务。
命令选项
表 13-10 列出了 imqcmd 命令的选项。
表 13-10 imqcmd 选项
选项
说明
-b hostName:port
指定代理的主机名及其端口号。默认值为 localhost:7676。
要仅指定端口，请使用：-b :7878
要仅指定主机名，请使用： -b somehost-c clientID
指定订阅某个主题的长期订户的 ID。请参见管理长期订阅。
-d destinationName
指定主题名。与 list dur 和 destroy dur 子命令一起使用。请参见管理长期订阅。
-f
执行操作，而无需用户确认。
-h
显示使用帮助。不执行命令行上的其他选项。
此选项不需要用户名和密码。
-H
显示使用帮助、属性列表和示例。不执行命令行上的其他选项。
此选项不需要用户名和密码。
-int interval
指定 metrics bkr、metrics dst 和 metrics svc 子命令显示度量输出的时间间隔，以秒为单位。
-javahome path
指定要使用的替代 Java 2 兼容运行时（默认情况下使用系统上的运行时或 Message Queue 附带的运行时）。
-m metricType
指定要显示的度量类型。将此选项与 metrics dst、metrics svc 或 metrics bkr 子命令一起使用。metricType 的值取决于为目标、服务还是代理生成度量。
-msp numSamples
指定 metrics bkr、metrics dst 和 metrics svc 子命令在其度量输出中显示的度量样例的数量。
-n argumentName
指定子命令参数的名称。根据子命令的不同，它可能是服务名称、物理目标、长期订阅、连接 ID 或事务 ID。
-o attribute=value
指定属性值。根据子命令参数的不同，它可能是代理属性（请参见使用 imqcmd 命令实用程序）、服务属性（请参见管理连接服务）或目标属性（请参见管理长期订阅）。
-p password
指定您（管理员）的密码。不赞成使用此选项，在今后的版本中不再对其提供支持。使用下列替代方法之一：
-passfile path
指定包含用户执行命令所需密码的文件的路径。有关详细信息，请参见使用密码文件。
-pst pauseType
指定在暂停目标时是暂停生产方、使用方，还是二者都暂停。请参见管理长期订阅。
-rtm timeout
指定 imqcmd 子命令的初始（重试）超时周期（以秒为单位）。超时是 imqcmd 子命令在向代理发出请求之后等待的时间长度。该子命令随后的每次重试将使用初始超时周期的倍数作为超时值。默认值： 10
-rtr numRetries
指定 imqcmd 子命令首次超时之后尝试重试的次数。默认值： 5
-s
静音模式。不显示任何输出。
-secure
使用 ssladmin 连接服务指定代理的安全管理连接（请参见步骤 4：配置并运行基于 SSL 的客户机）。如果省略此选项，连接将是不安全的。
-svn serviceName
指定列出其连接的服务。请参见获得有关连接的信息。
-t destType
指定目标类型：t（主题）或 q（队列）。请参见管理长期订阅。
-tmp
显示临时目标。请参见表 13-5。
-u userName
指定您（管理员）的名称。如果省略此值，系统会提示您输入。
-v
显示版本信息。不执行命令行上的其他选项。
此选项不需要用户名和密码。
另请参见
有关使用 imqcmd 及命令示例的详细信息，请参见第 5 章“管理代理”和第 6 章“管理物理目标”。
imqobjmgr对象管理器实用程序 imqobjmgr 创建和管理 Message Queue 受管理对象。
语法
imqobjmgr subcommand [options]
imqobjmgr -h|H
imqobjmgr -v子命令
对象管理器实用程序 (imqobjmgr) 包含表 13-3 中列出的子命令：
表 13-11 imqobjmgr 子命令
子命令
说明
add
在对象存储库中添加受管理对象。
delete
从对象存储库中删除受管理对象。
list
列出对象存储库中的受管理对象。
query
显示指定的受管理对象的相关信息。
update
修改对象存储库中的现有受管理对象。
命令选项
表 13-12 列出了 imqobjmgr 命令的选项。有关如何使用这些选项的论述，请参见基于任务的后续各节。
表 13-12 imqobjmgr 选项
选项
说明
-f
执行操作，而无需用户确认。
-h
显示使用帮助。不执行命令行上的其他选项。
-H
显示使用帮助、属性列表和示例。不执行命令行上的其他选项。
-i fileName
指定命令文件的名称，该文件包含所有或部分子命令子句，指定了对象类型、查找名称、对象属性、对象存储库属性或其他选项。通常用于重复性信息，例如对象存储库属性。
-j attribute=value
指定标识和访问 JNDI 对象存储库所需的属性。请参见关于对象存储库。
-javahome path
指定要使用的替代 Java 2 兼容运行时（默认情况下使用系统上的运行时或 Message Queue 附带的运行时）。
-l lookupName
指定受管理对象的 JNDI 查找名称。此名称在对象存储库的上下文中必须唯一。
-o attribute=value
指定受管理对象的属性。请参见第 16 章“受管理对象的属性参考”。
-pre
预览模式。指出在不执行命令的情况下将执行的操作。
-r read-only_state
指定某个受管理对象是否为只读对象。true 值表示受管理对象为只读对象。客户不能修改只读受管理对象的属性。默认情况下，只读状态设置为 false。
-s
静音模式。不显示任何输出。
-t objectType
指定 Message Queue 受管理对象的类型：
q = 队列
t = 主题
cf = 连接工厂
qf = 队列连接工厂
tf = 主题连接工厂
xcf = XA 连接工厂（分布式事务）
xqf = XA 队列连接工厂（分布式事务）
xtf = XA 主题连接工厂（分布式事务）
e = SOAP 端点（此受管理对象类型用于支持 SOAP 消息，如 Message Queue Developer's Guide for Java Clients 中所述。）
-v
显示版本信息。不执行命令行上的其他选项。
另请参见
有关 imqobjmgr 及命令示例的详细信息，请参见第 8 章“管理受管理对象”。
imqdbmgr数据库管理器实用程序 (imqdbmgr) 将会设置持久性所需的模式。也可以使用 imqdbmgr 命令来删除 Message Queue 已损坏的数据库表或更改数据存储库。
语法
imqdbmgr subcommand argument [options]
imqdbmgr -h|-help
imqdbmgr -v|-version子命令
表 13-13 列出了数据库管理器实用程序 (imqdbmgr) 包含的子命令：
表 13-13 imqdbmgr 子命令
子命令
和参数说明
create all
创建一个新的数据库和 Message Queue 持久性存储模式。此命令用于嵌入式数据库系统，使用时需指定 imq.persist.jdbc.createdburl 属性。
create tbl
在现有数据库系统中创建 Message Queue 持久性存储模式。此命令用于外部数据库系统。
delete tbl
删除当前持久性存储数据库中的现有 Message Queue 数据库表。
delete oldtbl
删除早期版本的持久性存储数据库中的所有 Message Queue 数据库表。将持久性存储自动迁移至 Message Queue 当前版本后使用。
recreate tbl
删除当前持久性存储数据库中的现有 Message Queue 数据库表，然后重新创建 Message Queue 持久性存储模式。
reset lck
对锁进行重置，以便其他进程可以使用该持久性存储数据库。
命令选项
表 13-14 列出了 imqdbmgr 命令的选项。
表 13-14
imqdbmgr 选项选项
说明
-Dproperty=value
将指定属性设置为指定值。
-b instanceName
指定代理实例名称并使用对应的实例配置文件。
-h
显示使用帮助。不执行命令行上的其他选项。
-p password
指定数据库密码。不赞成使用此选项，在今后的版本中不再对其提供支持。使用下列替代方法之一：
-passfile path
指定包含数据库密码的文件的路径。有关详细信息，请参见使用密码文件。
-u name
指定数据库用户名。
-v
显示版本信息。不执行命令行上的其他选项。
另请参见
有关设置持久性存储的详细信息，请参见设置持久性存储。
imqusermgr此用户管理器实用程序 (imqusermgr) 允许您编辑或填充平面文件用户系统信息库。使用 imqusermgr 之前，请谨记以下内容：
语法
imqusermgr subcommand [options]
imqusermgr -h
imqusermgr -v子命令
表 13-15 列出了 imqusermgr 子命令，本章中描述了其用法。
表 13-15 imqusermgr 子命令
子命令
说明
add [-i instanceName] -u userName -p passwd
[-g group] [-s]将用户和关联的密码添加到指定的（或默认的）代理实例系统信息库中，并有选择地指定用户所属的组。
delete [-i instanceName] -u userName [-s] [-f]
从指定的（或默认的）代理实例系统信息库中删除指定用户。
list [-i instanceName] [-u userName]
显示指定的（或默认的）代理实例系统信息库中有关指定用户或所有用户的信息。
update [-i instanceName] -u userName -p passwd
[-a state] [-s] [-f]update [-i instanceName] -u userName -a state
[-p passwd] [-s] [-f]更新指定的（或默认的）代理实例系统信息库中指定用户的密码和/或状态。
命令选项
表 13-16 列出了 imqusermgr 命令的选项。
表 13-16 imqusermgr 选项
选项
说明
-a active_state
指定用户是否处于活动状态 (true/false)。true 表示处于活动状态。这是默认值。
-f
执行操作，无需用户确认。
-h
显示使用帮助。不执行命令行上的其他选项。
-i instanceName
指定此命令要应用到的代理实例用户系统信息库。如果未指定，则假定为默认的实例名称 imqbroker。
-p passwd
指定用户密码。
-g group
指定用户组。有效值包括 admin、user 和 anonymous。
-s
设置静音模式。
-u userName
指定用户名。
-v
显示版本信息。不执行命令行上的其他选项。
另请参见
有关设值和管理平面文件用户系统信息库及 imqusermgr 命令示例的详细信息，请参见使用平面文件用户系统信息库。
imqsvcadmin服务管理 (imqsvcadmin) 实用程序将代理安装为 Windows 服务。
语法
imqsvcadmin subcommand [options]
imqsvcadmin -h
子命令
Message Queue 服务管理器实用程序 (imqsvcadmin) 包含表 13-17 中列出的子命令：
表 13-17 imqsvcadmin 子命令
子命令
说明
install
安装服务并特定启动选项。
query
显示 imqsvcadmin 命令的启动选项。启动选项包括服务的启动方式（手动或自动）、服务的位置、Java 运行时的位置以及启动时传递给代理的参数值。
remove
删除服务。
命令选项
表 13-18 列出了 imqsvcadmin 命令的选项。
表 13-18 imqsvcadmin 选项
选项
说明
-h
显示使用帮助。不执行命令行上的其他选项。
-javahome path
指定要使用的替代 Java 2 兼容运行时（默认使用系统上的运行时或 Message Queue 附带的运行时）的路径。
示例：imqsvcadmin -install -javahome d:\jdk1.4
-jrehome path
指定替代 Java 2 兼容 JRE 的路径。
示例：imqsvcadmin -install -jrehome d:\jre\1.4
-vmargs arg [[arg]…]
指定传递给正在运行代理服务的 Java VM 的其他参数。（也可以在 Windows 服务控制面板的“启动参数”字段中指定这些参数。）
示例：-vmargs "-Xms16m -Xmx128m"
-args arg [[arg]?]
指定传递给代理服务的其他命令行参数。有关 imqbrokerd 选项的说明，请参见 imqbrokerd。
（也可以在 Windows 服务控制面板的“启动参数”字段中指定这些参数。）例如，
imqsvcadmin -install
-args “-passfile d:\imqpassfile”
使用 -javahome、-vmargs 和 -args 选项指定的信息存储在 Window 注册表项 JREHome、JVMArgs 和 ServiceArgs 下，其路径位于：
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet
\Services\iMQ_Broker\Parameters另请参见
有关作为 Windows 服务运行 Message Queue 的详细信息，请参见在 Windows 中自动启动。
imqkeytool(imqusermgr 命令为代理生成自签名证书。可以对 ssljms、ssladmin 或 cluster 连接服务使用相同的证书。在 UNIX 系统中，您可能需要以超级用户 (root) 帐户来运行 imqkeytool。
语法
imqkeytool -broker
另请参见
有关设置安全连接的详细信息，请参见使用基于 SSL 的服务。