IBM MQ Console 配置远程队列管理器连接行为

使用 IBM® MQ Console时,可以创建与远程队列管理器的连接。 也就是说,您可以连接到与运行 IBM MQ Console 的mqweb服务器不在同一安装中的队列管理器。 您可以设置许多配置选项来控制远程队列管理器连接的行为。

开始之前

要完成此任务,您必须具有使用 dspmqwebsetmqweb 命令的特定权限:
  • [z/OS]z/OS® 上,您必须拥有运行 dspmqwebsetmqweb 命令的权限,以及写入 mqwebuser.xml 文件的权限。
  • [UNIX、Linux、Windows、IBM i]On all other operating systems, you must be a 特权用户.
  • [MQ 9.4.0 2024 年 6 月][Linux]如果 mqweb 服务器是独立 IBM MQ Web Server 安装的一部分,则必须拥有 IBM MQ Web Server 数据目录中 mqwebuser.xml 文件的写入权限。
注:

在你发布之前setmqweb或者dspmqweb命令z/OS,您必须设置 WLP_USER_DIR 环境变量,以便该变量指向您的 mqweb 服务器配置。

要设置 WLP_USER_DIR 环境变量,请发出以下命令:
export WLP_USER_DIR=WLP_user_directory
其中,WLP_user_directory 是传递到 crtmqweb 的目录的名称。 例如:
export WLP_USER_DIR=/var/mqm/web/installation1

有关更多信息,请参阅创建 mqweb 服务器

[MQ 9.4.0 2024 年 6 月][Linux]请注意:

在独立 IBM MQ Web Server 安装中发出 setmqwebdspmqweb 命令之前,必须将 MQ_OVERRIDE_DATA_PATH 环境变量设置为 IBM MQ Web Server 数据目录。

关于本任务

您可以设置以下配置选项:
  • 是否允许远程队列管理器连接。
  • 是可以使用 IBM MQ Console添加连接,还是只能使用命令行添加连接。
  • 当允许远程队列管理器连接时,是否在 IBM MQ Console 中显示本地队列管理器。
  • 是在启动 IBM MQ Console 时自动建立远程队列管理器连接,还是在发生连接故障时自动建立远程队列管理器连接。
  • 每次刷新 IBM MQ Console中显示的远程队列管理器列表之间的时间长度。

过程

  • 要查看当前远程队列管理器连接配置设置,请输入以下命令:

    dspmqweb properties -a

    • mqConsoleRemoteSupportEnabled 字段指示是否允许远程队列管理器连接。
    • mqConsoleRemoteUIAdmin 字段指示是否可以使用 IBM MQ Console添加远程队列管理器连接。
    • mqConsoleRemoteAllowLocal 字段指示是否显示本地队列管理器。
    • mqConsoleRemotePollTime 字段指示每次刷新远程队列管理器列表之间的秒数。
  • 要阻止或允许远程队列管理器与 IBM MQ Console连接,请输入以下命令:

    setmqweb properties -k mqConsoleRemoteSupportEnabled -v true or false

    其中 true 允许远程队列管理器连接,或者 false 阻止远程队列管理器连接。

    [MQ 9.4.0 2024 年 6 月][Linux]请注意: If the mqweb server runs in a stand-alone IBM MQ Web Server installation, the mqConsoleRemoteSupportEnabled property is not valid. 独立 IBM MQ Web Server 仅支持与远程队列管理器的连接。
  • 要阻止或允许使用 IBM MQ Console或仅通过命令行添加远程队列管理器连接,请输入以下命令:

    setmqweb properties -k mqConsoleRemoteUIAdmin -v true or false

    其中 true 允许使用 IBM MQ Console 和命令行添加远程队列管理器连接,或者 false 允许仅使用命令行上的 setmqweb remote 命令添加远程队列管理器连接。

  • 要在允许远程队列管理器连接时阻止或允许在 IBM MQ Console 中显示本地队列管理器,请输入以下命令:

    setmqweb properties -k mqConsoleRemoteAllowLocal -v true or false

    其中 true 允许显示本地队列管理器,或者 false 隐藏本地队列管理器。

    [MQ 9.4.0 2024 年 6 月][Linux]请注意: If the mqweb server runs in a stand-alone IBM MQ Web Server installation, the mqConsoleRemoteAllowLocal property is not valid. 独立 IBM MQ Web Server 仅支持与远程队列管理器的连接。
  • 要设置每次刷新 IBM MQ Console中显示的远程队列管理器列表之间的时间长度,请输入以下命令:

    setmqweb properties -k mqConsoleRemotePollTime -v seconds

    其中, seconds 设置为每次刷新远程队列管理器列表之间的秒数的整数值。