dspmqweb (mqweb サーバー構成の表示)
mqweb サーバーのステータス、または mqweb サーバーの構成に関する情報を表示します。 mqweb サーバーは、 IBM® MQ Console および administrative REST APIをサポートするために使用されます。
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 コマンドを使用します。
目的 - 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 プリフライト検査の結果をキャッシュできる時間を秒数で指定します。
- mqRestCsrfExpirationInMinutes
- この構成プロパティーは、 IBM MQ 9.0.5に存在しなくなりました。
- mqRestCsrfValidation
- この構成プロパティーを使用して、CSRF 妥当性検査のチェックを実行するかどうかを指定します。 値
false
は、CSRF トークン検証チェックを除去します。 - mqRestGatewayEnabled
- この構成プロパティーを使用して、 administrative REST API ゲートウェイを有効にするかどうかを指定します。
- mqRestGatewayQmgr
- この構成プロパティーを使用して、ゲートウェイ・キュー・マネージャーとして使用するキュー・マネージャーの名前を指定します。 このキュー・マネージャーは、mqweb サーバーと同じインストール済み環境に配置する必要があります。 値がブランクの場合は、ゲートウェイ・キュー・マネージャーとして構成されるキュー・マネージャーがないことを示します。
- mqRestMessagingEnabled
- この構成プロパティーを使用して、 messaging REST API を有効にするかどうかを指定します。
- mqRestRequestTimeout
- この構成プロパティーを使用して、REST 要求がタイムアウトになるまでの時間を秒数で指定します。
- traceSpec
- この構成プロパティーを使用して、mqweb サーバーで生成されるトレースのレベルを指定します。 可能な値のリストについては、 IBM MQ Console および REST APIのロギングの構成を参照してください。
- 以下のプロパティーは、 z/OS、 UNIX, Linux®, and Windowsで dspmqweb properties コマンドによって返される可能性がある追加プロパティーです。
- httpHost
- この構成プロパティーを使用して、 IBM MQ がインストールされているサーバーの IP アドレス、ドメイン・ネーム接尾部付きのドメイン・ネーム・サーバー (DNS) ホスト名、または DNS ホスト名として HTTP ホスト名を指定します。
- httpPort
- この構成プロパティーを使用して、HTTP 接続に使用する HTTP ポート番号を指定します。
- httpsPort
- この構成プロパティーを使用して、HTTPS 接続に使用する HTTPS ポート番号を指定します。
- mqConsoleAutostart
- この構成プロパティーを使用して、mqweb サーバーの始動時に IBM MQ Console を自動的に開始するかどうかを指定します。
- mqRestAutostart
- この構成プロパティーを使用して、mqweb サーバーの始動時に REST API を自動的に開始するかどうかを指定します。
構文
オプション・パラメーター
- 状況
- mqweb サーバーの状況に関する情報を表示します。 つまり、mqweb サーバーが稼働しているかどうかを示します。 mqweb サーバーが稼働している場合は、使用可能なルート・コンテキスト URL と、 IBM MQ Console および administrative REST API によって使用される関連ポートに関する情報が表示されます。
- プロパティー
- mqweb サーバーの構成可能プロパティーに関する情報を表示します。 つまり、ユーザーが構成できるプロパティーや、変更済みのプロパティーを示します。 mqweb サーバーが実行中である必要はありません。
- -l
- 詳細ロギングを使用可能にします。 mqweb サーバーのログ・ファイルに診断情報が書き込まれます。
戻りコード
戻りコード | 説明 |
---|---|
0 | コマンドが成功しました |
>0 | コマンドが成功しませんでした。 |
関連コマンド
コマンド | 説明 |
---|---|
strmqweb | mqweb サーバーを開始します。 |
endmqweb | mqweb サーバーを停止します。 |
の setmqweb | mqweb サーバーを構成します。 |