MFT 启用 REST API

必须先启用 REST API for MFT,然后才能使用 REST API for MFT。 您可以使用 setmqweb 命令来配置是否启用 REST API for MFT 。 缺省情况下,未启用 REST API for MFT

开始之前

[MQ 9.4.0 2024 年 6 月][Linux]注意:如果 mqweb 服务器在独立 IBM® MQ Web Server 安装中运行,则此任务不适用。 您不能使用 REST API 来发送 MFT ,因为它是独立存在的 IBM MQ Web Server
要完成此任务,您必须具有使用 dspmqwebsetmqweb 命令的特定权限:
  • [z/OS]z/OS® 上,您必须拥有运行 dspmqwebsetmqweb 命令的权限,以及写入 mqwebuser.xml 文件的权限。
  • [UNIX、Linux、Windows、IBM i] 在所有其他操作系统上,您必须是 特权用户
注:

z/OS上发出 setmqwebdspmqweb 命令之前,必须设置 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 服务器

过程

  1. 使用以下命令查看 REST API for MFT 的当前配置:
    dspmqweb properties -a
    mqRestMftEnabled 字段显示是否已启用 REST API for MFT 。 如果启用了 REST API for MFT ,那么值为 True ,否则为 False
  2. 使用下列其中一个命令来启用或禁用 REST API for MFT :
    • 使用以下命令启用 REST API for MFT :
      setmqweb properties -k mqRestMftEnabled -v true
    • 使用以下命令禁用 REST API for MFT :
      setmqweb properties -k mqRestMftEnabled -v false
  3. 通过输入以下命令重新启动 mqweb 服务器:
    endmqweb
    strmqweb

后续操作

如果已启用 REST API for MFT,那么必须先设置协调队列管理器名称,然后才能使用 REST API for MFT。 有关如何设置协调队列管理器的更多信息,请参阅 为 MFT 的 REST API 配置协调队列管理器