下载或创建用于描述要连接到的队列管理器的 JSON CCDT 文件

您可以在队列管理器详细信息页面中，通过单击“连接信息”按钮，然后选择“JSON CCDT”格式来下载 JSON CCDT。 请注意，下载的 JSON CCDT 不包含与通道关联的密码规范，因此必须通过为每个通道添加一个 transmissionSecurity 定义来手动包含密码规范，如以下示例中所示。

或者，可以直接复制此处提供的示例模板，并更新 host、port、queueManager 和 channel 值以匹配您的队列管理器。

{
  "channel": [
  {
    "name": "CLOUD.ADMIN.SVRCONN",
    "clientConnection": {
      "connection": [
      {
      "host": "qm1-1234.qm.us-south.mq.appdomain.cloud",
      "port": 31500
      }
      ],
      "queueManager": "QM1"
    },
    "transmissionSecurity": {
      "cipherSpecification": "ANY_TLS12_OR_HIGHER"
    },
    "type": "clientConnection"
  }
  ]
}

以上 JSON CCDT 示例中的密码规范已指定为 ANY_TLS12_OR_HIGHER，这允许 runmqsc 客户机根据通道配置为允许的密码与 TLS v1.2 密码系列中的队列管理器协商允许的密码。 为了获得最大灵活性，还可以将队列管理器通道配置为 ANY_TLS12_OR_HIGHER ，这允许客户机与服务器之间进行协商。

为 runmqsc 环境配置必需的环境变量

我们将配置环境变量，以指示 runmqsc 客户机使用 JSON CCDT 来获取队列管理器连接详细信息，其中包含在上一步中定义的通道密码规范的名称。

1. 打开命令提示符窗口并浏览至安装的 MQ bin 目录。 此目录的位置取决于您的操作系统，例如：

   表 1. 不同操作系统的安装文件位置

   操作系统	文件位置
   Linux 完整 MQ 安装	/var/mqm/bin
   Windows	C:\Program Files\IBM\MQ\bin
   Linux/Mac ，使用客户机安装	~/mytoolkit/IBM-MQ-Toolkit-Mac-x64-9.1.2.0/bin

2. 设置 MQCCDTURL 环境变量以指示 runmqsc 客户机读取 JSON CCDT ， MQCCDTURL 变量是指向 JSON CCDT 文件的 URL。

   • MQCCCDTURL 是从系统根到 ccdt 文件的完整文件路径。

     # Linux/MacOS
     export MQCCDTURL=file:///Users/myuser/connection_info_ccdt.json    
     unset MQSERVER
     
     # Windows
     set MQCCDTURL=file:///c:/temp/connection_info_ccdt.json    
     set MQSERVER=        
     

     MUST NOT 设置了 MQSERVER 变量，否则将优先于 JSON CCDT 中的设置

   • 指定 CCDT 文件位置有两种不同的方法-如果 MQCCDTURL 不适用于您，请尝试设置 MQCHLTAB 和 MQCHLLIB ，如下所述。

     MQCHLLIB 是从系统根目录到保存 ccdt 文件的目录的完整路径。

     export MQCHLLIB=/path/to/ccdt
     set MQCHLLIB=c:\path\to\ccdt
     

     MQCHLTAB 是 ccdt 文件的文件名。

     export MQCHLTAB=connection_info_ccdt.json
     set MQCHLTAB=connection_info_ccdt.json
     

3. 设置 MQSSLKEYR 环境变量以允许 runmqsc 客户机信任队列管理器提供的 TLS 证书

   MQSSLKEYR 变量必须设置为从系统根目录到包含队列管理器提供的 TLS 证书的密钥库文件的完整路径。

   如果您还没有密钥库文件，那么可以按照创建密钥库主题中所述来创建密钥库文件，密钥库包含从服务控制台用户界面下载的队列管理器公用证书。

   请注意，文件的 .kdb 后缀不得包含在 MQSSLKEYR 值中，因此对于名为 key.kdb的密钥库，请仅指定 key。

   # Linux/MacOS
   export MQSSLKEYR=/Users/myuser/key
   
   # Windows
   set MQSSLKEYR=c:\temp\key
   

执行 runmqsc 命令以连接到队列管理器

现在，我们已设置了必要的环境，可以执行 runmqsc 命令来连接到队列管理器。

正常情况下，您将需要对 runmqsc 命令输入以下内容:

• MQ 管理员用户名和 API 密钥，可通过服务控制台获取，如收集必需的连接详细信息中所述。 请注意，这必须是管理员用户名和 API 密钥，而不是应用程序用户名和 API 密钥
• 队列管理器名称，必须与 JSON CCDT 文件中指定的名称相匹配，例如“QM1”

<Path to MQ/bin directory>/runmqsc -c -u mqusername QM1

此 runmqsc 上的所有操作现在都将在安全通道上运行。