SET GROUP

SET GROUP ステートメントは、共通モニター特性を持つキュー・マネージャーのグループを定義します。

グループ内のすべてのキュー・マネージャーのデフォルトのモニター・オプションを定義します。 SET MANAGER ステートメントを使用して、グループ内の既知のキュー・マネージャーに対するパラメーターの一部をオーバーライドすることができます。

少なくとも 1 つの SET GROUP ステートメントが必要です。

構文

SET GROUP NAME(group-name)
              [DEFAULT(YES|NO)]
              [AGGRHIST(aggregation-samples)]
              [COMMAND(YES|NO)]
              [EVENTS(REMOVE|BROWSE|NO)]
              [HLQ(high-level-qualifier)]
              [ICYCLE(interval-cycle)]
              [LIKE(like-group-name)]
              [ACTIONAUTHUSERS (user-name-mask-list)]
              [ACTIONACCOUNT (UIUSER|MQAGENT|USER=user-id)]
              [MSGACCESS(NONE|DESC|RETRY|DATA|DELETE|USEQACCESS)]
              [RETAINHIST(historical-retention-value)]
              [RQMODEL(reply-to-queue's-model-queue)]
              [MSGSITACCOUNT(MQAGENT|USER=user_id)]
              [MSGSITMON(YES|NO|STATONLY)]

パラメーター

NAME (グループ名)
1 から 48 文字のグループ名。 後続のコマンドは、グループおよびそのパラメーター設定をこの名前で参照します。 このパラメーターは必須です。
DEFAULT(YES|NO)
これがデフォルト・グループであるかどうかを指定します。 このパラメーターが yes に設定されている場合、このステートメントの設定は、 GROUP パラメーターを省略するすべての SET MANAGER ステートメントに適用されます。 デフォルト・グループには、DEFAULT という名前が付けられています。
AGGRHIST (集約-サンプル)
このグループのすべてのキュー・マネージャーについて、エージェント・ストレージで維持する最近のサンプルの数を指定します。 デフォルト値は 15です。 オブジェクトに関する行から「Recent」で始まる名前のワークスペースにリンクすることにより、特定のオブジェクトに関する最近のサンプル間隔ごとのデータを表示できます。
コマンド (yes|no )
Tivoli Enterprise Portal からキューマネージャに IBM MQ コマンドを渡すことができるかどうかを指定する。
有効な値は次のとおりです。
  • YES: MQ コマンド機能が使用可能になります。 その後、 Tivoli Enterprise Portal からキュー・マネージャに IBM MQ コマンドを渡すことができる。 これはデフォルト値です。
  • NO: MQ コマンド機能が使用不可になります。
EVENTS(REMOVE|BROWSE|NO)
システム・イベント・キューにアクセスする方法を指定します。
有効な値は次のとおりです。
  • REMOVE: システム・イベント・キューからメッセージを読み取って、除去します。 この設定は、最も正確なイベント・レポートを提供します。 インストールおよび構成プロセス中に自動的に構成される値は REMOVE です。 REMOVE が指定されると、エージェントは排他的アクセスのためにイベント・キューを開きます。

    複数のアプリケーションによるイベント・キューの読み出しをサポートするには、 SET EVENTQINと SET EVENTQOUTで説明されているように、 SET EVENTQIN と SET EVENTQOUT 。

  • BROWSE : システム・イベント・キューのメッセージを参照します (除去せずに読み取る)。 複数のアプリケーション（IBM MQ Monitoring Agent または別のアプリケーション）がイベント・キューを読み込む場合は、この値を指定する。 この場合、キューをクリーニングするために、EMPTY 機能を指定した CSQUTIL などの、別個のアプリケーションを実行する必要があります。
    注意： EVENTS(BROWSE) を指定し、他のアプリケーションがイベント・キューに対して破壊的な読み取りを行った場合、 IBM MQ Monitoring Agent は、一部またはすべてのイベント・メッセージを見逃す可能性がある。
  • NO: システム・イベント・キューをモニターしません。
HLQ (高位修飾子 (high-level-qualifier))
IBM MQ Monitoring Agent によって作成されるキュー名の上位修飾子を指定する。 デフォルト値は KMQ です。 このパラメーターの最大長は 8 文字です。
IBM MQ Monitoring Agent はこれらの名前を使っている：
hlq.COMMAND.REPLY
hlq.REPLY
ここで、 hlq は、 SET MANAGER または SET GROUP コマンドの HLQ パラメーターによって指定された値です。
お望みであれば、キュー・マネージャーでこれらの名前でキューを定義することもできる。 それらが事前に定義されていない場合，エージェントは， SET MANAGER または SET GROUP コマンドの RQMODEL パラメータによって指定されるモデルキューを使用して，動的なキューを作成します。

OA61473の後、上記の名前の事前定義キューまたは永続動的キューが既に存在する場合、エージェントは開始時にそれらのキューを再使用します。 デフォルトでは、エージェントは SYSTEM.COMMAND.REPLY.MODELという永続動的モデル・キューを使用します。 このように RQMODEL エージェント・パラメーターに永続動的モデル・キューを指定すると、エージェントは、エージェントの初回始動時にそれらの名前でキューを作成し、エージェントの再始動時にそれらのキューを再使用します。 RQMODEL で一時動的キューに別のモデル・キューが指定されている場合、エージェントは開始されるたびにそれらの名前で一時動的キューを作成します。

何らかの理由で同じキュー・マネージャーを複数のエージェントでモニターする場合は、この HLQ パラメーターが同じ LPAR 上のエージェント・ランタイムごとに固有であることを確認する必要があります。この場合は、RTE_STC_PREFIX に使用される 1 文字から 4 文字を「KMQ」に追加することをお勧めします。

ICYCLE (インターバル・サイクル (interval-cycle))
このパラメーターは、 z/OS® システムにのみ適用されます。
このオプション・パラメーターは、指定したキュー・マネージャーのパフォーマンス・データを収集するまでに待機する、サンプリング間隔サイクルの数を指定します。 デフォルト値は 1 分です。 特定のキュー・マネージャーまたはキュー・マネージャーのグループのサンプリング間隔を延長するには、このパラメーターを使用します。例えば、データ収集の重要性が低いため、データ収集の頻度を下げて実行できる場合などです。 例えば、キュー・マネージャーのサンプリング間隔 (SAMPINT) が 60、間隔サイクル (ICYCLE) が 5 に設定されている場合、このキュー・マネージャーの照会処理は 5 サイクルごと (1 分ごとではなく、5 分ごと) に実行されます。
ICYCLE パラメーターを指定しない場合、または前の SET GROUP ステートメントに指定されていない場合、デフォルト値は 1 です。つまり、キュー・マネージャー・データは、サンプリング間隔 (SAMPINT) ごとに収集されます。
LIKE (like-group-name)
以前に定義されたキュー・マネージャー・グループの名前。 類似した名前のパラメーター値は、指定されたグループ定義の値からコピーされます。
ACTIONAUTHUSERS (user-name-mask-list)
このパラメーターは、手動のアクション実行コマンドのみに適用することができます。
Take Actionコマンドを発行する前に、 Tivoli Enterprise Portal ユーザーIDがユーザー名マスクリストの1つと一致しなければならないことを指定する。
ACTIONAUTHUSERS パラメーター値として空 [()] が指定されている場合は、ACTIONAUTHUSERS がパラメーター・リストに定義されていないことを示します。 この ACTIONAUTHUSERS パラメーターは無視されます。
ACTIONAUTHUSERS パラメータ値がユーザー名マスクリストに設定されている場合、この IBM MQ Monitoring Agent に関連付けられているTake Actionコマンドを発行する権限を持つ Tivoli Enterprise Portal ユーザーを指定する。 このパラメーターに関連した複数のエントリーが存在する場合があります。 各項目はコンマ (,) で区切ります。 項目は、アスタリスク (*) と疑問符 (?) のワイルドカード文字を含むマスクにすることができます。 このリストのマスクと一致するIDを持つ Tivoli Enterprise Portal ユーザーは、Take Actionコマンドを発行する権限を持つ。 Tivoli Enterprise Portal ユーザーIDは Tivoli Enterprise Monitoring Server 内で定義され、 IBM MQ Monitoring Agent が実行されているノードに存在するとは限らない。
ACTIONACCOUNT (UIUSER | MQAGENT | USER=user-id)
このパラメータは、 IBM MQ Monitoring Agent で提供される Take Action コマンドにのみ適用される。

IBM MQ Monitoring Agent 、メッセージ操作のために IBM MQ とやりとりするための代替ユーザーIDとして、 ACTIONACCOUNT の値を使用することを指定する。 詳細は SET MANAGERの ACTIONACCOUNT パラメータの説明を参照。

有効な値は次のとおりです。
  • UIUSER : エージェントは IBM MQ とやりとりするために Tivoli Enterprise Portal ユーザ ID を使用する。
  • MQAGENT : エージェントは、 IBM MQ と対話するために、モニタリングエージェントアカウントを使用します。
  • USER=ユーザーID:エージェントは IBM MQ と対話するために、事前に定義されたアカウント(ユーザーID)を使用します。
msgaccess( none|desc|retry|data|delete|useqaccess )
指定したキュー・マネージャーの、キュー内のメッセージへのユーザー・アクセスのレベルを制御します。
有効な値は次のとおりです。
  • NONE: 指定されたキュー・マネージャーのメッセージ関数へのアクセスが許可されません。キュー上のメッセージをリストする機能やメッセージ統計を収集する機能についても同様です。
  • DESC:「メッセージ要約」ワークスペース、「メッセージ詳細」ワークスペース、または「メッセージ統計」ワークスペースおよびシチュエーションの、メッセージ記述子参照が許可されます。 これはデフォルトのレベルです。
  • RETRY: DLQ 再試行およびメッセージ記述子参照が許可されます。
  • DATA: メッセージ・データ (コンテンツ) 参照、メッセージ記述子参照、および DLQ 再試行が許可されます。
  • DELETE: メッセージおよび他のすべてのメッセージ関数の削除が許可されます。
  • USEQACCESS: メッセージ・アクセス権限を付与するために、現在のグループまたはキュー・マネージャーに属するすべてのキューを新しい SET QACCESS コマンドで定義する 必要がある ことを指定します。 現在のグループに属するキューおよび SET QACCESS コマンドで定義されていないキューのメッセージ・アクセス・レベルは NONE です。
RETAINHIST (historical-retention-value)
キュー・マネージャーで定義されなくなったキュー・マネージャー・オブジェクト (チャネルやキューなど) をエージェント・メモリーに保存し、そのオブジェクトに関するヒストリー・データへのリンクが容易になるようワークスペースに表示するために戻すのに費やす分数。 現在は定義されていないこれらのオブジェクトについて、メモリー内で保守するデータを減らす場合は、RETAINHIST 値を減らしてください。 デフォルト値は 120 (2 時間) です。 このパラメーターは、チャネルおよびローカル・キューに対してのみ 有効です。
RQMODEL (応答先キューのモデル・キュー (reply-to-queue 's-model-queue))
この製品の応答先キューのモデルとして使用するモデル・キューの名前を、1 文字から 48 文字で指定します。 このパラメーターを指定しない場合は、標準のシステム・デフォルト・モデルが使用されます。 詳細は SET MANAGERの RQMODEL パラメータの説明を参照。
MSGSITACCOUNT (MQAGENT | USER=user_id)
IBM MQ Monitoring Agent 、メッセージ監視の状況において、 IBM MQ とやりとりするための代替ユーザーIDとして、 MSGSITACCOUNT の値を使用することを指定する。
このパラメーターは、「メッセージ要約」属性グループに対して定義されているシチュエーションのみに適用できます。
このパラメーターは、MSGSITMON が YES に設定されている場合にのみ有効です。
有効な値は次のとおりです。
  • MQAGENT : エージェントは、 IBM MQ と対話するために、モニタリングエージェントアカウントを使用します。
  • USER=ユーザーID:エージェントは IBM MQ と対話するために、事前に定義されたアカウント(ユーザーID)を使用します。
msgsitmon ( yes|no|statonly )
「メッセージ要約」属性グループに対して定義されているシチュエーションをメッセージ・コンテンツおよびメッセージ・ヘッダーのモニターで有効にするかどうかを指定します。
有効な値は次のとおりです。
  • YES: メッセージ・モニターのためのシチュエーションを有効にします。 この値は、MSGSITACCOUNT パラメーターが指定された場合にのみ有効です。 それ以外の場合は、デフォルトで STATONLY になります。
  • NO: メッセージ・モニターのためのシチュエーションを使用不可にします。また、メッセージ統計モニターを使用不可にします。
  • STATONLY: これがデフォルト値です。 IBM MQ Monitoring Agent の動作に変更はない。 メッセージ・コンテンツとメッセージ・ヘッダーをモニターするために「メッセージ要約」属性グループに対してシチュエーションを定義することはできません。 これは、MSGSITMON パラメーターが指定されていない場合に使用する値です。

例

MYGROUP という名前のマネージャー・グループを、保持する最近のサンプルのカウントと、削除されたオブジェクトに関するデータを保持する分数の新しい値で定義するには、次のステートメントを指定します。

SET GROUP NAME(MYGROUP) LIKE(DEFAULT) -
AGGRHIST(20) RETAINHIST(2400)