设置要与 messaging REST API 配合使用的远程队列管理器

您可以使用 messaging REST API 来连接到远程队列管理器以进行消息传递。 必须先设置远程队列管理器配置，然后才能连接到远程队列管理器。 然后，可以使用配置信息中定义的唯一名称来连接到远程队列管理器。

1. 在远程队列管理器上，创建服务器连接通道以允许与队列管理器的远程连接。 您可以在命令行上使用 DEFINE CHANNEL MQSC 命令来创建服务器连接通道。
   例如，要为队列管理器 QM1创建服务器连接通道 QM1.SVRCONN ，请输入以下命令:

   DEFINE CHANNEL(QM1.SVRCONN) CHLTYPE(SVRCONN) TRPTYPE(TCP)

   有关 DEFINE CHANNEL 和可用选项的更多信息，请参阅 DEFINE CHANNEL。
2. 确保相应用户有权访问队列管理器。 此用户还必须有权访问用于消息传递的任何队列或主题。 用户需要队列管理器上的 connect， inquire， alternate user和 set context 权限。 在 UNIX, Linux®, and Windows 上，在命令行上使用 setmqaut 控制命令。 在 z/OS®上，定义 RACF 概要文件以授予授权用户对队列管理器的访问权。
   例如，在 UNIX, Linux, and Windows上，要授权用户 exampleUser访问队列管理器 QM1，请输入以下命令:

   setmqaut -m QM1 -t qmgr -p exampleUser +connect +inq +altusr +setall

   有关需要授权的用户的更多信息，请参阅 确定消息传递 REST API 所使用的安全主体。
3. 如果远程队列管理器上不存在侦听器，请在命令行上使用 DEFINE LISTENER MQSC 命令创建侦听器以接受入局网络连接。
   例如，要在端口 1414 上为远程队列管理器 QM1创建侦听器 REMOTE.LISTENER ，请输入以下命令:

   runmqsc QM1
   DEFINE LISTENER(REMOTE.LISTENER) TRPTYPE(TCP) PORT(1414)
   end

4. 通过在命令行上使用 START LISTENER MQSC 命令来确保侦听器正在运行:
   例如，在 AIX®, Linux, and Windows 上，要启动队列管理器 QM1的侦听器 REMOTE.LISTENER ，请输入以下命令:

   runmqsc QM1
   START LISTENER(REMOTE.LISTENER)
   end

   例如，在 z/OS上，要启动侦听器，请输入以下命令:

   runmqsc QM1
   START LISTENER TRPTYPE(TCP) PORT(1414)
   end

   必须先启动通道启动程序地址空间，然后才能在 z/OS上启动侦听器。
5. 在运行 messaging REST API 所在的 mqweb 服务器的系统上，创建或更新包含队列管理器连接信息的 JSON CCDT 文件。

   CCDT 文件必须包含 name， clientConnection和 type 信息。 您可以选择包含其他信息，例如 transmissionSecurity 信息。 有关所有 CCDT 通道属性定义的更多信息，请参阅 CCDT 通道属性定义的完整列表。

   以下示例显示了用于远程队列管理器连接的基本 JSON CCDT 文件。 它将通道的名称设置为与步骤 1中创建的示例服务器连接通道的名称相同。 连接端口设置为与侦听器所使用的端口相同的值。 连接主机设置为运行远程队列管理器 QM1的系统的主机名。

   {
     "channel": [{
         "name": "QM1.SVRCONN",
         "clientConnection": {
           "connection": [{
               "host": "example.com",
               "port": 1414
             }],
           "queueManager": "QM1"
         },
         "type": "clientConnection"
       }]
   }

6. 从正在运行托管 messaging REST API的 mqweb 服务器的安装中，使用 setmqweb remote 命令将远程队列管理器信息添加到 mqweb 服务器配置。
   必须至少指定以下参数:

   • -qmgrName，在其中指定队列管理器的名称。
   • -ccdtURL，其中指定队列管理器的 URL。
   • -uniqueName，其中指定队列管理器的唯一名称。 唯一名称用于区分可能具有相同名称的远程队列管理器，因此不能存在用于标识另一个队列管理器的远程队列管理器。

   您可以指定其他一些选项，例如用于远程队列管理器连接的用户名和密码，或者信任库和密钥库的详细信息。 有关可以使用 setmqweb remote 命令指定的参数的完整列表，请参阅 setmqweb remote。

   例如，要使用示例 CCDT 文件添加远程队列管理器 QM1，请输入以下命令:

   setmqweb remote add -uniqueName "RemoteQM1" -qmgrName "QM1" -ccdtURL "c:\myccdts\ccdt.json"