[V9.0.4 2017 年 10 月]

administrative REST API ゲートウェイの構成

デフォルトでは、 administrative REST API ゲートウェイは有効になっています。 administrative REST API ゲートウェイが有効になっている場合は、ゲートウェイ・キュー・マネージャーを使用して、 REST API でリモート管理を実行できます。 デフォルトのゲートウェイ・キュー・マネージャーとして使用されるキュー・マネージャーを構成することも、 setmqweb properties コマンドを使用して administrative REST API ゲートウェイを無効にすることでリモート管理を防止することもできます。

本タスクについて

この手順を実行するには、 特権ユーザー でなければなりません。

以下のコマンドを使用して、 administrative REST API ゲートウェイの現在の構成を表示できます。
dspmqweb properties -a
mqRestGatewayEnabled フィールドにゲートウェイが有効かどうかが表示され、mqRestGatewayQmgr フィールドにデフォルトのゲートウェイ・キュー・マネージャーの名前が表示されます。 詳しくは、 dspmqwebを参照してください。
デフォルトのゲートウェイ・キュー・マネージャーは、以下の両方の記述が当てはまる場合に使用されます。
  • REST 要求の ibm-mq-rest-gateway-qmgr ヘッダーでキュー・マネージャーが指定されていない。
  • REST API リソース URL に指定されているキュー・マネージャーは、ローカル・キュー・マネージャーではありません。

REST APIを使用したリモート管理について詳しくは、 REST APIを使用したリモート管理を参照してください。

[z/OS][V9.0.4 2017 年 10 月]重要:

z/OS®で setmqweb コマンドまたは dspmqweb コマンドを発行する前に、WLP_USER_DIR 環境変数が mqweb サーバー構成を指すように設定する必要があります。

そのためには、以下のコマンドを実行します。
export WLP_USER_DIR=WLP_user_directory
ここで、WLP_user_directoryは、crtmqweb.shに渡されるディレクトリーの名前です。 以下に例を示します。
export WLP_USER_DIR=/var/mqm/web/installation1

詳しくは、 Liberty サーバー定義の作成を参照してください。

手順

  • 次のコマンドを使用して、 administrative REST API ゲートウェイを有効にするかどうかを構成します。

    setmqweb properties -k mqRestGatewayEnabled -v enabled

    ここで、 enabled は、値 true ( administrative REST API ゲートウェイを有効にする場合) または false (それ以外の場合) です。

  • どのキュー・マネージャーがデフォルトのゲートウェイ・キュー・マネージャーとして使用されるかを構成します。
    • 以下のコマンドを使用して、デフォルトのゲートウェイ・キュー・マネージャーを設定します。

      setmqweb properties -k mqRestGatewayQmgr -v qmgrName

      ここで、qmgrName は mqweb サーバーと同じインストールのキュー・マネージャーの名前です。

    • 以下のコマンドを使用して、デフォルトのゲートウェイ・キュー・マネージャーを設定解除します。

      setmqweb properties -k mqRestGatewayQmgr -d