使用 imqcmd 实用程序

imqcmd 实用程序用于管理代理及其服务。

有关 imqcmd 命令的语法、子命令和选项的参考信息，请参见第 13 章，命令行参考。在单独的第 15 章，物理目的地属性参考中，介绍了管理物理目的地时可使用的参考信息。

显示帮助

要显示有关 imqcmd 实用程序的帮助，请使用 -h 或 -H 选项，而不要使用子命令。您无法获取有关特定子命令的帮助。

例如，以下命令显示有关 imqcmd 的帮助：

imqcmd -H

如果输入的命令行除了包含 -h 或 -H 选项外，还包含子命令或其他选项，则 imqcmd 实用程序只处理 -h 或 -H 选项。命令行中的其他所有项均被忽略。

显示产品版本

要显示 Message Queue 产品版本，请使用 -v 选项。例如：

imqcmd -v

如果输入的命令行除了包含 -v 选项外，还包含子命令或其他选项，则 imqcmd 实用程序只处理 -v 选项。命令行中的其他所有项均被忽略。

指定用户名和密码

因为将对照用户系统信息库验证每个 imqcmd 子命令，所以每个子命令都要求提供用户名和密码。唯一的例外是使用 -h 或 -H 选项来显示帮助的命令以及使用 -v 选项来显示产品版本的命令。

指定用户名

使用 -u 选项可指定管理用户名。如果省略了用户名，该命令会提示您输入它。例如，以下命令显示有关默认代理的信息：

imqcmd query bkr -u admin

为使本章中的示例便于阅读，我们将默认用户名 admin 显示为 -u 选项的参数。在生产环境中，应该使用自定义的用户名。

指定密码

使用以下方法之一指定密码：

• 创建密码文件 (passfile) 并在该文件中输入密码。在命令行中，使用 -passfile 选项提供密码文件的名称。

• 让命令提示您输入密码。

在 Message Queue 的以前版本中，可以使用 -p 选项在 imqcmd 命令行中指定密码。不赞成使用此选项，在今后的版本中会将其删除。

指定代理名和端口

imqcmd 的默认代理是本地主机上运行的代理，默认端口是 7676。

如果对在远程主机上运行的代理或监听非默认端口的代理执行命令，则必须使用 -b 选项指定代理的主机和端口。

示例

本节中的示例说明了 imqcmd 的用法。

第一个示例列出了在 localhost 端口 7676 上运行的代理的属性，因此不需要使用 -b 选项。该命令使用默认管理用户名 (admin ) 并省略了密码，因此命令会提示您输入密码。

imqcmd query bkr -u admin

以下示例列出了在主机 myserver 端口 1564 上运行的代理的属性。用户名是 aladdin。（要使该命令起作用，需要更新用户系统信息库，将用户名 aladdin 添加到 admin 组中。）

imqcmd query bkr -b myserver:1564 -u aladdin

以下示例列出了在 localhost 端口 7676 上运行的代理的属性。命令的初始超时时间限制设置为 20 秒，超时后的重试次数设置为 7。用户密码在名为 myPassfile 的密码文件中，该文件位于调用命令时的当前目录中。

imqcmd query bkr -u admin -passfile myPassfile -rtm 20 -rtr 7

对于安全的代理连接，这些示例可能会包括 -secure 选项。-secure 选项使 imqcmd 使用 ssladmin 服务（如果已配置并启动了该服务）。