接続先のキュー・マネージャーが記述された JSON CCDT ファイルをダウンロードまたは作成します。

キュー・マネージャーの詳細ページで「接続情報」ボタンをクリックし、「JSON CCDT」形式を選択して、JSON CCDT をダウンロードすることができます。 ダウンロードした JSON CCDT にはチャネルに関連付けた暗号仕様が含まれていない点に注意してください。下記の例に示すように、チャネルごとに transmissionSecurity 定義を追加することによって、暗号仕様を手動で含める必要があります。

別の方法として、ここに用意されているサンプル・テンプレートをコピーして、ホスト、ポート、queueManager、およびチャネルの値を、ご使用のキュー・マネージャーと一致するように更新することもできます。

{
  "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=        
     

     MQSERVER 変数を設定してはなりません。設定した場合、JSON CCDT の設定よりも優先されます。

   • CCDT ファイルの場所を指定する方法は 2 つあります。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 環境変数を設定して、キュー・マネージャーによって提示される TLS 証明書を runmqsc クライアントが信頼できるようにします。

   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 でのすべての操作が、保護されたチャネルで実行されるようになります。