MQ リスナーの処理 (WRKMQMLSR)

実行可能な場所: すべての環境 (*ALL)
スレッド・セーフ: はい

MQ リスナー・オブジェクトの処理 (WRKMQMLSR) コマンドによって、ローカル・キュー・マネージャーで定義されているリスナー・オブジェクトを処理できます。

これにより、リスナー・オブジェクトの変更、コピー、作成、削除、開始、停止、および表示が可能になり、また MQ リスナー・オブジェクトの権限の表示と変更が可能になります。

このコマンドではまた、現行システムで実行中のすべてのリスナーの現在の状況を表示することもできます。

パラメーター

キーワード	説明	選択	注
OPTION	オプション	STATUS、OBJECT	オプション、定位置 1
「LSRNAME」	リスナー名	`文字値`、*ALL	オプション、定位置 2
MQMNAME	メッセージ・キュー・マネージャー名	`文字値`、*DFT	オプショナル, 定位置 3
WHERE	フィルター・コマンド	単一値: *NONE 値その他の値: `エレメント・リスト`	オプショナル, 定位置 4
	エレメント 1: フィルター・キーワード	ALTDATE、ALTTIME、BACKLOG、CONTROL、IPADDR、PORT、*TEXT
	エレメント 2: フィルター演算子	GT、LT、EQ、NE、GE、LE、LK、NL、CT、EX、CTG、EXG
	エレメント 3: フィルター値	文字値

オプション (OPTION)

このオプションでは、リスナー状況またはリスナー・オブジェクト定義のどちらに関する情報を表示するかを選択できます。

指定できる値は以下のとおりです。

* 状況: リスナー状況情報が表示されます。
パラメーター LSRNAME および WHERE は無視されます。 MQMNAME が指定されると、指定されたキュー・マネージャー上で実行されるリスナーの状況のみが表示されます。
*OBJECT (* オブジェクト): リスナー・オブジェクト情報が表示されます。

リスナー名 (LSRNAME)

リスナー・オブジェクトの 1 つ以上の名前です。

指定できる値は以下のとおりです。

*ALL または *

すべてのリスナー・オブジェクトが選択されます。

generic-listener-name

リスナー・オブジェクトの総称名です。総称名とは、例えば、ABC* のようにアスタリスク (*) が後に続く文字ストリングのことで、その文字ストリングで始まる名前を持つすべてのリスナー・オブジェクトが選択されます。

必要な名前を引用符で囲んで指定することをお勧めします。この形式を使用すれば、選択内容を確実に、入力した内容に一致させることができます。

すべての名前を要求しない限り、総称名の大文字および小文字バージョンのすべてを単一パネルで選択することはできません。

listener-name

1 つのリスナー・オブジェクトの名前を指定します。

メッセージ・キュー・マネージャー名 (MQMNAME)

キュー・マネージャーの名前を指定します。

指定できる値は以下のとおりです。

*DFT: デフォルト・キュー・マネージャーを使用します。
キュー・マネージャー名: メッセージ・キュー・マネージャーの名前です。

フィルター・コマンド (WHERE)

このパラメーターは、特定のリスナー属性を持つリスナー・オブジェクトのみを選択して表示するために使用できます。

パラメーターには、キーワード、演算子、および値の 3 つの引数を使用します。

値が名前である場合は、総称ストリングが使用可能です。

演算子には、次のいずれかの値を使用できます。

*GT: より大きい。
整数および非総称ストリング値に適用できます。
*LT: より小さい。
整数および非総称ストリング値に適用できます。
*EQ: 等しい。
整数および非総称ストリング値に適用できます。
*NE: 等しくない。
整数および非総称ストリング値に適用できます。
*GE: 以上。
整数および非総称ストリング値に適用できます。
*LE: 以下。
整数および非総称ストリング値に適用できます。
*LK: 類似している。
総称ストリング値に適用できます。
*NL: 類似していない。
総称ストリング値に適用できます。
*CT: 含む。
非総称リスト値に適用できます。
*EX: 除く。
非総称リスト値に適用できます。
*CTG: 総称を含む。
総称リスト値に適用できます。
*EXG: 総称を除外。
総称リスト値に適用できます。

キーワードには、以下のいずれかの値を使用できます。

*ALTDATE

定義または情報が最後に変更された日付。

フィルター値は、YYYY-MM-DD形式の日付です。

*ALTTIME

定義または情報が最後に変更された時刻。

フィルター値は、hh:mm:ss 形式の時刻です。

*BACKLOG

サポートされる同時接続要求の数です。

フィルター値は整数のバックログ値です。

* 制御

リスナーの開始と停止をキュー・マネージャーと一緒に行うかどうか。

フィルター値は次のいずれかです。

*MANUAL: リスナーは自動的に開始されることも、停止されることもありません。
*QMGR: キュー・マネージャーが開始するとリスナーも開始され、キュー・マネージャーが停止するとリスナーも停止されます。
*STARTONLY: キュー・マネージャーが開始するとリスナーも開始されますが、キュー・マネージャーの停止時にリスナーの停止は要求されません。

*IPADDR

リスナーが使用するローカル IP アドレス。

フィルター値は IP アドレスです。

*PORT (ポート)

リスナーが使用するポート番号です。

フィルター値は整数のポート値です。

*TEXT

記述コメント。

フィルター値はリスナーのテキスト記述です。