MQ エクスプローラーおよび runmqsc コマンド・ラインを使用したキュー・マネージャーの管理
このガイドでは、MQ エクスプローラー・アプリケーションおよび runmqsc コマンド・ライン・インターフェースを使用して IBM MQ on Cloud キュー・マネージャーを管理する方法について説明します。
MQ エクスプローラー:
MQ エクスプローラーは、IBM MQ を管理するための Eclipse ベースのツールです。任意のマシンにインストールでき、クライアント接続を使用して 1 つ以上のキュー・マネージャーにリモート接続します。 Windows および Linux 64 ビット環境用のネイティブ・インストーラーが用意されており、以下の前提条件で説明されているように、Mac OS では Docker コンテナーを介して実行できます。
本書の作成時点では、Mac OS 上の MQ エクスプローラー用の Eclipse プラグインは、TLS 接続をサポートしていません。 バージョン 9.2.1 リビジョン 1 より新しい MQ on Cloud キュー・マネージャーの管理チャネルでは、TLS が有効になります。 これらは、Linux または Windows から管理する必要があります。
runmqsc
「MQ クライアント」バンドルに含まれるコマンド・ライン・インターフェース (CLI) ツールの runqmsc を使用すると、コマンド・ラインまたはスクリプト・ファイルで一連の事前定義ステップを実行することにより、MQ キュー・マネージャーの構成を自動的に行うことができます。 これは、Windows および Linux を含むさまざまなオペレーティング・システムでサポートされます (ただし、Mac OS では現在サポートされていません)。
MQ クライアントから MQ エクスプローラーまたは runmqsc を使用して、多くのアクションを実行できます。 以下の操作が可能です。
- キュー・マネージャーに接続します。
- 新規キューの作成
- キューへのメッセージの書き込み
- キューの削除
これに加えて、MQ エクスプローラーでは、以下のことを行うことができます。 browse a queue to view messages
runmqsc コマンド行で、以下の操作を行うこともできます。 get messages from a queue
開始前に
- 既存のキュー・マネージャー (詳しくは、キュー・マネージャーの作成のガイドに従ってください)。
- IBM MQ サービス・インスタンス内のキュー・マネージャーにアクセスする権限がある (詳しくは、キュー・マネージャーの管理者権限の構成のガイドを参照してください)。
- 管理方法に応じて、以下のいずれかが必要です。
- IBM MQ エクスプローラーの既存のインストール済み環境。 Windows 版および Linux 版のダウンロードとインストールの手順は、ここから入手できます。Mac OS 版はここから入手できます。 または
- ご使用のマシンに IBM MQ Client の既存のインストール済み環境がある。
- クライアントのダウンロードは、ここから行うことができます。
- CD クライアントの使用可能な最新バージョンの横にある HTTP リンクをクリックすると、Fix Central に移動します。 そこから、ご使用のオペレーティング・システム・プラットフォームに適した Redist (再配布可能) クライアント・バンドルを検索して選択できます。 これには、サンプル・アプリケーションと runmqsc が含まれます。
- ダウンロードしたら、任意の場所にバンドルを解凍します。
bin
ディレクトリーの絶対パスをメモします。この場所は、バンドルを解凍する場所によって異なります。 このタスクの残りの部分では、このパスを<PATH_TO_BIN_DIR>
として示します。- サンプル・アプリケーションを含むディレクトリーの絶対パスをメモします。 このタスクの残りの部分では、このパスを
<PATH_TO_SAMPLE_BIN_DIR>
として示します。- Windows の場合、これは前のステップで解凍した
bin
ディレクトリーになります。この場所は、バンドルを解凍する場所によって異なります。 - Linux の場合、これは前のステップで解凍した
samp/bin
ディレクトリーになります。この場所は、バンドルを解凍する場所によって異なります。
- Windows の場合、これは前のステップで解凍した
必要な接続の詳細の収集
-
IBM Cloud コンソールにログインします。
-
「ハンバーガー・メニュー」をクリックします。
-
**「ダッシュボード」**をクリックします。
- **「リソース・グループ」が「すべてのリソース」**に設定されていることを確認します。
-
「サービス」見出しの下にある IBM MQ サービス・インスタンスを見つけてクリックします。
-
キュー・マネージャーのリストから、管理するキュー・マネージャーをクリックします。
-
キュー・マネージャー名、ホスト名、およびポートの値を、後続のステップで使用するためにメモしておきます。
-
MQ ユーザー名と IBM Cloud API キーが既に分かっている場合は、このタスクの次のセクションにスキップできます。 そうでない場合は、**「管理」**タブをクリックします。
-
将来使用するために、MQ ユーザー名をメモしておきます。
- MQ ユーザー名は、既存のユーザーまたはアプリケーションの MQ ユーザー名の編集または削除のガイドに従って、いつでも編集できます。
-
既存の IBM Cloud API キーがない場合:
- **「IBM Cloud API キーの作成」**をクリックします。
- **「表示」をクリックして API キーを表示し、後で使用するためにコピーして保存するか、「ダウンロード」**をクリックして API キーをファイルに保管します。
- これらのステップで生成される API キーは、それを作成したユーザーとして IBM Cloud で認証を行うために使用されるということに注意してください。 したがって、API キーは、他のユーザーと共有せず、安全に保管してください。
- IBM MQ サービスを介して作成された API キーは、キュー・マネージャーの**「管理」**タブからリセットできます。
- **「閉じる」**をクリックします。
キュー・マネージャーへの接続
MQ エクスプローラーを使用する場合:
-
IBM MQ エクスプローラーを開始します。
-
「MQ Explorer -ナビゲーター」パネルで、**「IBM MQ」**を展開します。
-
**「キュー・マネージャー」**を右クリックします。
-
**「リモート・キュー・マネージャーの追加... (Add Remote Queue Manager...)」**をクリックします。
-
管理するキュー・マネージャーの名前を入力します。
-
**「次へ」**をクリックします。
-
ステップ 2 でメモしたホスト名を入力します。
-
ポート番号を、ステップ 2 でメモしたポート番号で上書きします。
-
サーバー接続チャネル名を CLOUD.ADMIN.SVRCONN で上書きします。
-
**「次へ」**をクリックします。
-
**「次へ」**をクリックします。
-
「ユーザー ID を使用可能にする」のチェック・ボックスにチェック・マークを付けます。
-
「ユーザー ID の互換モード」のチェック・ボックスのチェック・マークを外します。
-
ユーザー ID として MQ ユーザー名を入力します。
- **「完了 (Finish)」**をクリックします。
- プラットフォーム API キーを「パスワード」テキスト・ボックスに貼り付けます。
- **「OK」**をクリックします。
「MQ Explorer -ナビゲーター」パネルの**「キュー・マネージャー」**フォルダーの下に、設定したキュー・マネージャー接続が表示されます。
runmqsc の使用
- 後続のステップで使用するコマンド・シェルを開きます。
- 「MQSERVER」変数をエクスポートします。
- Linux:
export MQSERVER="CLOUD.ADMIN.SVRCONN/TCP/<Hostname>(<Port>)"
- Windows (コマンド・プロンプト):
set MQSERVER=CLOUD.ADMIN.SVRCONN/TCP/<Hostname>(<Port>)
- Windows (PowerShell):
$env:MQSERVER="CLOUD.ADMIN.SVRCONN/TCP/<Hostname>(<Port>)"
- Linux:
- 実行
<PATH_TO_BIN_DIR>/runmqsc -c -u <your MQ username> -w60 <QUEUE_MANAGER_NAME>
- パスワードの入力を求めるプロンプトが出されたら、プラットフォーム API キーを入力します。
「DEV.TEST.1」という新規テスト・キューを作成します。
MQ エクスプローラーを使用する場合:
「MQ Explorer -ナビゲーター」>「IBM MQ」>「キュー・マネージャー」ビューで、以下のようにします。
- キュー・マネージャーの項目を展開します。
- **「キュー」**を右クリックします。
- Select 'New' >「ローカル・キュー...」
- 「名前」テキスト・ボックスに「DEV.TEST.1」と入力します。
- **「完了 (Finish)」**をクリックします。
- **「OK」**をクリックします。
新しいキューがキューのリストに表示されます。
runmqsc の使用
キュー名は DEV.* で始まる (例: DEV.myQueue) 必要があります。アプリケーション・ユーザーはこの接頭部へのアクセス権のみを持つように構成されているためです。
前のステップで使用したのと同じシェル内で、以下を行います。
- 実行
DEFINE QLOCAL(DEV.TEST.1)
- 実行
DISPLAY QLOCAL(DEV.TEST.1)
- キュー「DEV.TEST.1」の詳細が表示されます。
- 実行
end
- runmqsc セッションがクローズされます。
- プロンプトは、後続のステップで使用するため、開いたままにしておきます。
テスト・キューへのメッセージの書き込み
MQ エクスプローラーを使用する場合:
- キュー「DEV.TEST.1」を右クリックします。
- 「テスト・メッセージの書き込み...」をクリックします。
- 「メッセージ・データ」テキスト・ボックスにテスト・メッセージを入力します。
- **「メッセージの書き込み」**をクリックします。
- **「閉じる」**をクリックします。
- 「キュー」パネルで**「更新」**をクリックします。
「DEV.TEST.1」の「現行キュー項目数」が 1 になったことがわかります。
runmqsc を使用する場合:
amqsputc
サンプル・プログラムを使用して、テスト・キューへのメッセージの書き込みを支援します。 前のステップで使用したのと同じシェル内で、以下を行います。
- 「MQSAMP_USER_ID」変数をエクスポートします。
- Linux:
export MQSAMP_USER_ID="<your MQ username>"
- Windows (コマンド・プロンプト):
set MQSAMP_USER_ID=<your MQ username>
- Windows (PowerShell):
$env:MQSAMP_USER_ID="<your MQ username>"
- Linux:
- 実行
<PATH_TO_SAMPLE_BIN_DIR>/amqsputc DEV.TEST.1 <your QMGR name>
- パスワードの入力を求めるプロンプトが出されたら、プラットフォーム API キーを入力します。
- テスト・メッセージを入力します。
Enter
を 2 回押して amqsputc サンプルを終了します。
テスト・キュー上のメッセージの参照
このステップは MQ エクスプローラーに固有であり、コマンド・ラインを使用して実行することはできません。
- キュー「DEV.TEST.1」を右クリックします。
- 「メッセージの参照...」をクリックします。
- テスト・メッセージが表示されることを確認し、**「閉じる」**をクリックします。
amqsgetc サンプル・プログラムを使用したメッセージの取得
このステップは runmqsc に固有であり、MQ エクスプローラーでは実行できません。
前のステップで使用したのと同じシェル内で、以下を行います。
- 実行
<PATH_TO_SAMPLE_BIN_DIR>/amqsgetc DEV.TEST.1 <your QMGR name>
- パスワードの入力を求めるプロンプトが出されたら、プラットフォーム API キーを入力します。
テスト・メッセージが表示されます。
しばらくしてメッセージがなくなると、amqsputc サンプル・プログラムは終了します。
テスト・キューの削除
MQ エクスプローラーの使用
- キュー「DEV.TEST.1」を右クリックします。
- 「削除」をクリックします。
- 「削除」をクリックします。
- 「キューからすべてのメッセージを消去する」ボックスにチェック・マークを付けます。
- **「削除」**をクリックします。
- **「OK」**をクリックします。
キュー「DEV.TEST.1」がキューのリストから除去されたことがわかります。
runmqsc の使用
前のステップで使用したのと同じシェル内で、以下を行います。
- 実行
<PATH_TO_BIN_DIR>/runmqsc -c -u <your MQ username> -w60 <QUEUE_MANAGER_NAME>
- パスワードの入力を求めるプロンプトが出されたら、プラットフォーム API キーを入力します。
- 実行
DELETE QLOCAL(DEV.TEST.1)
- キューが削除されたことを示すメッセージが表示されます。
DISPLAY QLOCAL(DEV.TEST.1)
を実行して、キューが削除されたことを確認します。- キューが見つからなかったことを示すメッセージが表示されます。
- 実行
end
- runmqsc セッションがクローズされます。
結論
以下の処理が正常に完了しました。
- MQ エクスプローラーまたは
runmqsc
のいずれかを使用してキュー・マネージャーに接続し、新規テスト・キューを作成する - テスト・メッセージをテスト・キューに書き込む
- テスト・キューを参照してテスト・メッセージを表示する、または
amqsgetc
を使用してテスト・メッセージを表示する - テスト・キューをクリアおよび削除してクリーンアップする
次のステップ
これで、MQ エクスプローラーおよび runmqsc を使用してキュー・マネージャーを管理する方法の学習が終了しました。以下を試してください。