[V9.0.1 2016 年 11 月]

dspmqweb (mqweb サーバー構成の表示)

mqweb サーバーのステータス、または mqweb サーバーの構成に関する情報を表示します。 mqweb サーバーは、 IBM® MQ Console および administrative REST APIをサポートするために使用されます。

[z/OS]

z/OS でのコマンドの使用

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 サーバー定義の作成 を参照してください。

目的 - dspmqweb status

mqweb サーバーの状況に関する情報を表示するには、dspmqweb コマンドを使用します。

IBM MQ Console または administrative REST APIを使用するには、 mqweb サーバーが稼働している必要があります。 サーバーが稼働している場合は、使用可能なルート・コンテキスト URL と、 IBM MQ Console および administrative REST API によって使用される関連ポートが、 dspmqweb コマンドによって表示されます。 あるいは、 IBM MQ 9.0.4から、 dspmqweb status コマンドを使用します。

[V9.0.4 2017 年 10 月]

目的 - dspmqweb properties

mqweb サーバーの構成の詳細情報を表示するには、dspmqweb properties コマンドを使用します。 mqweb サーバーが実行中である必要はありません。

以下のリストは、 IBM MQ Applianceを含むすべてのプラットフォームで使用可能な構成プロパティーの概要を示しています。

IBM MQ Applianceを含むすべてのプラットフォームで、 dspmqweb properties コマンドによって以下のプロパティーを返すことができます。
ltpaExpiration
この構成プロパティーを使用して、LTPA トークンの有効期限が切れるまでの時間を秒数で指定します。
このプロパティーの値は整数値です。
maxTraceFiles
この構成プロパティーを使用して、mqweb サーバーで生成されるトレース・ファイルの最大数を指定します。
このプロパティーの値は整数値です。
maxTraceFileSize
この構成プロパティーを使用して、各ログ・ファイルの最大サイズを MB で指定します。
このプロパティーの値は整数値です。
mqRestCorsAllowedOrigins
この構成プロパティーを使用して、 REST APIへのアクセスが許可される起点を指定します。 CORS について詳しくは、 REST API用の CORS の構成を参照してください。
このプロパティーの値はストリング値です。
mqRestCorsMaxAgeInSeconds
この構成プロパティーを使用して、Web ブラウザーが CORS プリフライト検査の結果をキャッシュできる時間を秒数で指定します。
このプロパティーの値は整数値です。
[V9.0.5 2018 年 3 月]mqRestCsrfExpirationInMinutes
この構成プロパティーは、 IBM MQ 9.0.5に存在しなくなりました。
IBM MQ 9.0.4 にのみ適用され、CSRF トークンの有効期限が切れるまでの時間を分単位で指定するために使用されます。
このプロパティーの値は整数値です。
mqRestCsrfValidation
この構成プロパティーを使用して、CSRF 妥当性検査のチェックを実行するかどうかを指定します。 値falseは、CSRF トークン検証チェックを除去します。
このプロパティーの値はブール値です。
mqRestGatewayEnabled
この構成プロパティーを使用して、 administrative REST API ゲートウェイを有効にするかどうかを指定します。
このプロパティーの値はブール値です。
mqRestGatewayQmgr
この構成プロパティーを使用して、ゲートウェイ・キュー・マネージャーとして使用するキュー・マネージャーの名前を指定します。 このキュー・マネージャーは、mqweb サーバーと同じインストール済み環境に配置する必要があります。 値がブランクの場合は、ゲートウェイ・キュー・マネージャーとして構成されるキュー・マネージャーがないことを示します。
このプロパティーの値はストリング値です。
mqRestMessagingEnabled
この構成プロパティーを使用して、 messaging REST API を有効にするかどうかを指定します。
このプロパティーの値はブール値です。
mqRestRequestTimeout
この構成プロパティーを使用して、REST 要求がタイムアウトになるまでの時間を秒数で指定します。
このプロパティーの値は整数値です。
traceSpec
この構成プロパティーを使用して、mqweb サーバーで生成されるトレースのレベルを指定します。 可能な値のリストについては、 IBM MQ Console および REST APIのロギングの構成を参照してください。
このプロパティーの値はストリング値です。
[Windows][z/OS][UNIX][Linux]
以下のプロパティーは、 z/OSUNIX, Linux®, and Windowsdspmqweb properties コマンドによって返される可能性がある追加プロパティーです。
httpHost
この構成プロパティーを使用して、 IBM MQ がインストールされているサーバーの IP アドレス、ドメイン・ネーム接尾部付きのドメイン・ネーム・サーバー (DNS) ホスト名、または DNS ホスト名として HTTP ホスト名を指定します。
アスタリスクを二重引用符で囲んで使用すると、使用可能なすべてのネットワーク・インターフェースを指定できます。
localhost の値を使用すると、ローカル接続のみ許可できます。
このプロパティーの値はストリング値です。
httpPort
この構成プロパティーを使用して、HTTP 接続に使用する HTTP ポート番号を指定します。
-1 の値を使用すると、ポートを使用不可に設定できます。
このプロパティーの値は整数値です。
httpsPort
この構成プロパティーを使用して、HTTPS 接続に使用する HTTPS ポート番号を指定します。
-1 の値を使用すると、ポートを使用不可に設定できます。
このプロパティーの値は整数値です。
mqConsoleAutostart
この構成プロパティーを使用して、mqweb サーバーの始動時に IBM MQ Console を自動的に開始するかどうかを指定します。
このプロパティーの値はブール値です。
mqRestAutostart
この構成プロパティーを使用して、mqweb サーバーの始動時に REST API を自動的に開始するかどうかを指定します。
このプロパティーの値はブール値です。

構文

構文図を読むビジュアル構文図をスキップ dspmqweb statusproperties-u-a-t-c -l

オプション・パラメーター

[V9.0.4 2017 年 10 月]状況
mqweb サーバーの状況に関する情報を表示します。 つまり、mqweb サーバーが稼働しているかどうかを示します。 mqweb サーバーが稼働している場合は、使用可能なルート・コンテキスト URL と、 IBM MQ Console および administrative REST API によって使用される関連ポートに関する情報が表示されます。
以下に例を示します。
Server mqweb is running.
URLs:
  https://localhost:9443/ibmmq/console/
  https://localhost:9443/ibmmq/rest/v1/
[V9.0.4 2017 年 10 月] プロパティー
mqweb サーバーの構成可能プロパティーに関する情報を表示します。 つまり、ユーザーが構成できるプロパティーや、変更済みのプロパティーを示します。 mqweb サーバーが実行中である必要はありません。
-u
ユーザーが変更した構成可能プロパティーのみ表示します。
-a
使用可能な構成可能プロパティー (ユーザーが変更したものを含む) をすべて表示します。
-t
出力の形式をテキストの名前と値のペアにします。
-c
出力の形式を、対応する setmqweb properties コマンドへの入力として使用できるコマンド・テキストにします。
-l
詳細ロギングを使用可能にします。 mqweb サーバーのログ・ファイルに診断情報が書き込まれます。

戻りコード

戻りコード 説明
0 コマンドが成功しました
>0 コマンドが成功しませんでした。
サーバー・コマンド出口コードの完全なリストについては、 WebSphere® Application Server 資料の「 Liberty: サーバー・コマンド・オプション 」を参照してください。

関連コマンド

コマンド 説明
strmqweb mqweb サーバーを開始します。
endmqweb mqweb サーバーを停止します。
[V9.0.4 2017 年 10 月] の setmqweb [V9.0.4 2017 年 10 月]mqweb サーバーを構成します。