mqted(MQTトレースファイルの編集出力)
形式
mqted -i MQTトレースファイル名
〔{-k 出力情報種別〔,出力情報種別〕…|-p}〕
〔-t 開始日時〔,終了日時〕〕
〔-n チャネル名〔,チャネル名〕…〕
〔-q 相手キューマネジャ名〔,相手キューマネジャ名〕…〕
〔-c クラスタ名〔,クラスタ名〕…〕
機能
MQTトレースファイルを入力にして,編集結果を標準出力に出力します。
オプション
● -i MQTトレースファイル名
~<1~64バイトのパス名>
MQTトレースファイルのパス名を指定します。ファイル名だけを指定した場合,カレントディレクトリのMQTトレースファイルが編集されます。絶対パス名で指定した場合,指定したディレクトリのMQTトレースファイルが編集されます。
● -k 出力情報種別
~<文字列>
出力情報の種別を指定します。次に示す種別を一つ以上指定できます。
複数指定する場合は,種別と種別との間をコンマ(,)で区切ります。複数を指定する場合の指定順序はありませんが,同一種別は重複して指定できません。
なお,mgr,ip,portおよびclusを同時に指定した場合は,キューマネジャ名,IPアドレス,ポート番号およびクラスタ名の順序で出力されます。
● -p
トレース取得日時情報の出力を指定します。
-kオプションと同時には指定できません。-t,-n,-qまたは-cオプションと同時に指定した場合,条件に一致するMQTトレース情報のトレース取得日時情報が出力されます。
条件に一致するMQTトレース情報がない場合は,****/**/** **:**:**(******)が出力されます。
● -t 開始日時〔,終了日時〕
~<文字列>《00000001011970,23595912319999》
出力対象の日時を指定します。開始日時および終了日時は次に示す形式で指定します。
hhmmss〔MMDD〔YYYY〕〕
開始日時と終了日時を指定する場合は,開始日時≦終了日時である必要があります。このオプションを省略した場合,または終了日時を省略した場合は,次に示すとおりに設定されます。
● -n チャネル名
~<1~20文字のMQ文字列>《すべてのチャネル名》
出力対象となる,チャネルの名称を指定します。
チャネル名を指定しない場合は,すべてのチャネル名の情報を出力対象とします。
複数指定する場合は,チャネル名とチャネル名との間をコンマ(,)で区切ります。また,複数指定する場合の文字列は256文字以内(コンマを含む)で指定してください。
● -q 相手キューマネジャ名
~<1~48文字のMQ文字列>《すべての相手キューマネジャ名》
出力対象となる,チャネルの相手キューマネジャ名を指定します。
相手キューマネジャ名を指定しない場合は,すべての相手キューマネジャ名の情報を出力対象とします。
複数指定する場合は,相手キューマネジャ名と相手キューマネジャ名との間をコンマ(,)で区切ります。また,複数指定する場合の文字列は256文字以内(コンマを含む)で指定してください。
● -c クラスタ名
~<1~48文字のMQ文字列>《すべてのクラスタ名》
出力対象となる,チャネルのクラスタ名を指定します。
クラスタ名を指定しない場合は,すべてのクラスタ名の情報を出力対象とします。
複数指定する場合は,クラスタ名とクラスタ名との間をコンマ(,)で区切ります。また,複数指定する場合の文字列は256文字以内(コンマを含む)で指定してください。
クラスタプロセスではないMQTプロセスが出力したMQTトレースファイルにこのオプションを指定した場合は共通情報だけが出力されます。
出力形式
表6-4 出力されるイベント情報と意味
イベント | 意味 | |
---|---|---|
種類 | 情報 | |
チャネルの確立・解放 | Connect | チャネル確立 |
DisConnect | チャネル解放 | |
バッチ処理 | Commit | バッチ処理成功 |
Rollback | バッチ処理失敗 | |
送信チャネル | Recv(ERR) | 送達確認(失敗)受信 |
Recv(OK) | 送達確認(成功)受信 | |
Send(C) | 送達確認要求送信 | |
Send(F) | 先頭セグメント送信 | |
Send(F+L) | 単一セグメント送信 | |
Send(F+L+C) | 単一セグメント+送達確認要求送信 | |
Send(L) | 最終セグメント送信 | |
Send(L+C) | 最終セグメント+送達確認要求送信 | |
Send(M) | 中間セグメント送信 | |
受信チャネル | Recv(C) | 送達確認要求受信 |
Recv(F) | 先頭セグメント受信 | |
Recv(F+L) | 単一セグメント受信 | |
Recv(F+L+C) | 単一セグメント+送達確認要求受信 | |
Recv(L) | 最終セグメント受信 | |
Recv(L+C) | 最終セグメント+送達確認要求受信 | |
Recv(M) | 中間セグメント受信 | |
Send(ERR) | 送達確認(失敗)送信 | |
Send(OK) | 送達確認(成功)送信 |
注意事項
バージョンおよびOSが異なるTP1/Message Queueによって出力されたMQTトレースファイルを指定した場合の動作は保証されません。
出力メッセージ
出力メッセージID | 内容 | 出力先 |
---|---|---|
KFCA16363-W | 入力形式に誤りがあります。 | 標準エラー出力 |
KFCA16364-W | 引数の指定に誤りがあります。 | 標準エラー出力 |
KFCA16390-E | ローカルメモリ不足が発生しました。 | 標準エラー出力 |
KFCA16392-E | 論理矛盾が発生しました。 | 標準エラー出力 |
KFCA16393-E | 障害が発生しました。 | 標準エラー出力 |
KFCA18383-E | MQTトレース編集に必要なローカルメモリが確保できません。 | 標準エラー出力 |
KFCA18393-E | MQTトレースファイルの入出力中に障害が発生しました。 | 標準エラー出力 |
KFCA31949-I | mqtedコマンドの入力形式の表示 | 標準出力 |