MQ 経路情報の表示 (DSPMQMRTE)

パラメーター

ターゲット・オブジェクト (QNAME)

トレース経路メッセージのターゲット・キューの名前、または (以前収集した情報を表示している場合) 情報を格納しているキューの名前を指定します。

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

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

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

*DFT

デフォルト・キュー・マネージャーを使用します。

message-queue-manager-name

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

相関 ID (CRRLID)

以前収集した情報の検索時に使用する相関 ID を指定します。 24 バイト相関 ID の形式は、48 文字 16 進数ストリングです。 トレース経路メッセージを生成しているのではなく、以前収集した情報を検索している場合には、相関 ID を指定する必要があります。

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

*NONE 値

相関 ID は提供されません。

相関 ID

24 バイトの相関 ID を表示する 48 文字 16 進数ストリング。

メッセージの持続性 (MSGPST)

トレース経路メッセージの持続性を指定します。

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

*NO

メッセージは MQPER_NOT_PERSISTENT を指定して書き込まれます。

*YES

メッセージは MQPER_PERSISTENT を指定して書き込まれます。

* キュー

メッセージは MQPER_PERSISTENCE_AS_Q_DEF を指定して書き込まれます。

メッセージ優先順位 (MSGPRTY)

トレース経路メッセージの優先順位を指定します。

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

* キュー

メッセージは MQPRI_PRIORITY_AS_Q_DEF を指定して書き込まれます。

message-priority

0 から 9 の範囲のメッセージ優先順位です。

レポート・オプション (OPTION)

トレース経路メッセージのレポート・オプションを指定します。 非トレース経路対応のキュー・マネージャーで生成されたレポートが配信されずにネットワークに残留する可能性があるため、ほとんどのレポート・オプションがデフォルトでは使用不可となります。 全データが戻されるように要求することによって、問題の結果として、メッセージに含まれるトレース経路情報を返すことができます。

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

*DFT

MQRO_ACTIVITY と MQRO_DISCARD_MSG をオンにします。

*NONE 値

レポート・オプションは設定されません。

*ACTIVITY

MQRO_ACTIVITY をオンにします。

*COA

MQRO_COA_WITH_FULL_DATA をオンにします。

*COD

MQRO_COD_WITH_FULL_DATA をオンにします。

*DISCARD

MQRO_DISCARD_MSG をオンにします。

*EXCEPTION

MQRO_EXCEPTION_WITH_FULL_DATA をオンにします。

*EXPIRATION

MQRO_EXPIRATION_WITH_FULL_DATA をオンにします。

応答キュー (RPLYQ)

応答とすべてのレポート・メッセージを送信する応答キューの名前を指定します。 RPLYMQM パラメーターも指定する場合を除いて、ローカル・キュー・マネージャーに既存の名前を指定する必要があります。 トレース経路メッセージが持続する場合は、応答キューは一時キューであってはなりません。

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

*DFT

SYSTEM.DEFAULT.MODEL.QUEUE が使用され、応答キューはデフォルトで一時動的キューになります。

reply-queue

使用する応答キューの名前。

応答キュー・マネージャー (RPLYMQM)

応答が送信されるキュー・マネージャーを指定します。

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

*DFT

応答はローカル・キュー・マネージャーに送信されます。

reply-queue-manager

キュー・マネージャーに対する応答の名前です。

メッセージ有効期限 (EXPIRY)

トレース経路メッセージの有効期限時刻 (秒数) を指定します。

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

*DFT

デフォルト有効期限時刻の 60 秒が使用されます。

expiry-time

0 から 999999999 の範囲のメッセージ有効期限時刻。

有効期限の受け渡し (EXPRPT)

トレース経路メッセージの有効期限をレポートまたは応答メッセージに渡すかどうかを指定します。 これは、実質的に、MQRO_PASS_DISCARD_AND_EXPIRY をオンおよびオフにします。 これにより、必要に応じてレポートを無期限に保持することも可能です。

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

*YES

有効期限がレポートまたは応答メッセージに渡されます。

*NO

有効期限がレポートまたは応答メッセージに渡されません。

経路の累積 (RTEINF)

経路情報がキュー・マネージャー・ネットワーク経由でフローするにつれて、トレース経路メッセージ内に経路情報が累積されるかどうかを指定します。

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

*NO

トレース経路メッセージ内に情報は累積されません。

*YES

トレース経路メッセージ内に情報が累積されます。

応答メッセージ (RPLYMSG)

トレース経路メッセージがその最終宛先に到着すると、すべての累積された情報を収めた応答メッセージがキューに対する応答に返されることを要求します (最終宛先キューをホストするキュー・マネージャーがこれを許可する場合)。

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

*NO

応答メッセージは戻されません。

*YES

キューに対する応答に応答メッセージが戻されます。

メッセージの配信 (DLVRMSG)

トレース経路メッセージが宛先キューに正常に到着した場合に、そのメッセージを取得アプリケーションに配信するかどうかを指定します。

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

*NO

トレース経路メッセージは、ターゲット・キューに正常に到着した際に取得アプリケーションに配信されません。

*YES

トレース経路メッセージは、ターゲット・キューに正常に到着した際に取得アプリケーションに配信されます。 このオプションを指定すると、キュー・マネージャーがトレース経路をサポートしているかどうかに関係なく、メッセージがそのキュー・マネージャーに到着することを効率的に許可することができます。

メッセージの転送 (FWDMSG)

トレース経路メッセージを経路の次のキュー・マネージャーに転送するかどうかを指定します。

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

*SUPPORT

トレース経路メッセージは、配信オプションを出すことができるキュー・マネージャーに対してのみ転送されます。

*ALL

トレース経路メッセージは、指定にかかわらず経路の次のキュー・マネージャーに転送されます。 このオプションを使用すると、配信オプションに従って処理できない場合であっても、トレース経路メッセージの受け入れを非トレース経路対応のキュー・マネージャーに強制できます。

最大アクティビティー (MAXACTS)

廃棄される前にトレース経路メッセージ上で実行できるアクティビティーの最大数を指定します。

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

*NOMAX

アクティビティーの最大数は、指定されません。

maximum-activities

1 から 999999999 の範囲のアクティビティーの最大数です。

経路詳細 (DETAIL)

要求される経路に関する詳細の程度を指定します。

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

*LOW

この詳細レベルでは、キュー・マネージャー・アクティビティーに関する情報は要求されません。 メッセージ上でどのようなユーザー・アクティビティーが行われているかを示す高水準ビューが得られます。

*MEDIUM

低レベルの詳細情報が、キュー・マネージャーにおけるメッセージの移動に関する情報と共に要求されます。 これには、MCA の作業が含まれます。

*HIGH

低レベルおよび中レベルの詳細が、メッセージがたどる経路に関するより詳細な情報と共に要求されます。 例えば、クラスター化においては、経路が選択された理由についての詳細が含まれることがあります。

参照のみ (BROWSE)

返されるメッセージが参照のみであるかどうかを指定します。 これは、以降の表示操作のために、情報がキューに残されることを意味します。

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

*NO

返されるメッセージは参照のみではありません。

*YES

返されるメッセージは参照のみです。

メッセージ表示 (DSPMSG)

トレース経路メッセージの生成時に、返される情報を表示するかどうかを指定します。

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

*YES

返される情報が表示されます。

*NO

返される情報は表示されません。 これにより、トレース経路メッセージがターゲット・キューに書き込まれるとすぐに DSPMQMRTE を終了できます。 終了時に、48 文字の 16 進数ストリングが出力されます。これは、生成されたトレース経路メッセージ上のメッセージ ID であり、以降の DSPMQMRTE 呼び出しに提供される CRRLID として使用できます。

ターゲット・キュー・マネージャー (TGTMQM)

トレース経路メッセージのターゲット・キュー・マネージャーを指定します。

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

*DFT

ターゲット・キュー・マネージャーは指定されません。 宛先キューがローカル・キューであるか、キューのローカル定義が存在するかのいずれかです。

target-queue-manager

トレース経路メッセージのターゲット・キュー・マネージャー。

情報の表示 (DSPINF)

収集した情報のうち、表示する情報の程度を指定します。

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

*ALL

使用可能なすべての情報が表示されます。

*SUMMARY

メッセージが経路として通過するキューのみを表示します。

*NONE 値

使用可能な情報を表示しません。

*ACTGRP

アクティビティー・グループ内のすべての非グループ・パラメーターを表示します。

* ID

パラメーター ID が MQBACF_MSG_ID または MQBACF_CORREL_ID である値を常に表示します。 これは、通常、メッセージ・グループの特定の値が表示されないようにする *MSGDELTA をオーバーライドします。

*MSGGRP

メッセージ・グループ内のすべての非グループ・パラメーターを表示します。

*MSGDELTA

*MSGGRP と同様ですが、最後のオペレーションが行われた後で変更されたメッセージ・グループ内の情報のみを表示する点が異なります。

*OPGRP

オペレーション・グループ内のすべての非グループ・パラメーターを表示します。

*TRGRP

TraceRoute グループ内のすべてのパラメーターを表示します。

待機時間 (WAIT)

応答キューに配信できる経路で生成されたすべての応答メッセージまたはすべてのレポート (指定されたオプションに応じる) が終了したと見なされるまでに、DSPMQMRTE が待機する時間 (秒数) を指定します。

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

*DFT

DSPMQMRTE は、トレース経路メッセージの有効期限時刻より 60 秒長く待機します。

wait-time

DSPMQMRTE が待機する必要のある時間。

バインド・オプション (BIND)

ターゲット・キューが特定の宛先に結合されるかどうかを指定します。

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

*OPEN

ターゲット・キューは特定の宛先に結合されます。 キューは、オプション MQOO_BIND_ON_OPEN によってオープンします。

*NOTFIXED

ターゲット・キューは特定の宛先に結合されません。 通常、このパラメーターは、トレース経路メッセージをクラスター経由で書き込む必要があるときに使用します。 キューは、オプション MQOO_BIND_NOT_FIXED によってオープンします。