mqtedMQTトレースファイルの編集出力

形式

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トレースファイルにこのオプションを指定した場合は共通情報だけが出力されます。

出力形式

YYYY/MM/DD HH:MM:SS
編集出力の実行時刻(年/月/日 時:分:秒)
NNNNNN
トレース通番(6けたの10進数)
999999の次は000000に戻ります。
yyyy/mm/dd
トレースを取得した日付(年月日)
hh:mm:ss(mmmmmm)
トレースを取得した時刻(時:分:秒(マイクロ秒))
Windowsの場合はマイクロ秒ではなくミリ秒で出力されます。
aa...aa:bbb
チャネル名(1~20文字の文字列):チャネルタイプ
snd:センダ
rcv:レシーバ
srv:サーバ
req:リクエスタ
csn:クラスタセンダ
crc:クラスタレシーバ
cc...cc
イベント情報(1~17文字の文字列)
出力されるイベント情報と意味について,次の表に示します。

表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)送達確認(成功)送信
dd...dd
相手キューマネジャ名(1~48文字のMQ文字列)
表示する情報がない場合はピリオド(.)が48文字出力されます。
ee...ee
相手システムのIPアドレス(1~15文字の文字列)
ff...ff
相手システムのポート番号(1~5けたの10進数)
gg...gg
クラスタ名(1~48文字のMQ文字列)
表示する情報がない場合はピリオド(.)が48文字出力されます。
a1...a1
メッセージシーケンス番号(1~9けたの16進数)
b1...b1
メッセージ総サイズ(1~8けたの10進数)
プロトコルヘッダ,および転送キューヘッダ(MQXQH構造体)の長さは含まれません。
c1...c1
セグメント番号(1~9けたの16進数)
d1...d1
セグメントサイズ(1~8けたの10進数)
プロトコルヘッダの長さは含まれません。転送キューヘッダ(MQXQH構造体)の長さは含まれます。
e1...e1
リモートキュー名(1~48文字の文字列)
配布リストメッセージを送受信する場合は,何も出力しません。
f1...f1
リモートキューマネジャ名(1~48文字の文字列)
配布リストメッセージを送受信する場合は,何も出力しません。
g1...g1
構造体識別子(文字列)
h1...h1
構造体バージョン番号(10進数)
i1...i1
報告オプション(16進数)
j1...j1
メッセージタイプ(16進数)
k1...k1
メッセージ保持時間(10進数)
l1...l1
報告メッセージ返答コード(16進数)
m1...m1
マシンコード形式(16進数)
n1...n1
文字セット識別子(16進数)
o1...o1
フォーマット名(文字列)
p1...p1
メッセージ優先度(10進数)
q1...q1
メッセージ永続性
MQPER_PERSISTENT:永続メッセージ
MQPER_NOT_PERSISTENT:非永続メッセージ
r1...r1
メッセージ識別子(文字列)
s1...s1
メッセージ識別子(16進数)
t1...t1
相関識別子(文字列)
u1...u1
相関識別子(16進数)
v1...v1
ロールバック回数(10進数)
w1...w1
応答キュー名(文字列)
x1...x1
応答キューマネジャ名(文字列)
y1...y1
ユーザ識別子(文字列)
z1...z1
ユーザ識別子(16進数)
a2...a2
課金トークン(文字列)
b2...b2
課金トークン(16進数)
c2...c2
アプリケーション識別データ(文字列)
d2...d2
アプリケーション識別データ(16進数)
e2...e2
登録アプリケーションタイプ(16進数)
f2...f2
登録アプリケーション名(文字列)
g2...g2
登録日付(文字列)
h2...h2
登録時刻(文字列)
i2...i2
登録元データ(文字列)
j2...j2
最初に取得したMQTトレースのトレース取得日時情報
yyyy/mm/dd hh:mm:ss(mmmmmm)の形式で出力されます。
k2...k2
最後に取得したMQTトレースのトレース取得日時情報
yyyy/mm/dd hh:mm:ss(mmmmmm)の形式で出力されます。

注意事項

バージョンおよびOSが異なるTP1/Message Queueによって出力されたMQTトレースファイルを指定した場合の動作は保証されません。

出力メッセージ

出力メッセージID内容出力先
KFCA16363-W入力形式に誤りがあります。標準エラー出力
KFCA16364-W引数の指定に誤りがあります。標準エラー出力
KFCA16390-Eローカルメモリ不足が発生しました。標準エラー出力
KFCA16392-E論理矛盾が発生しました。標準エラー出力
KFCA16393-E障害が発生しました。標準エラー出力
KFCA18383-EMQTトレース編集に必要なローカルメモリが確保できません。標準エラー出力
KFCA18393-EMQTトレースファイルの入出力中に障害が発生しました。標準エラー出力
KFCA31949-Imqtedコマンドの入力形式の表示標準出力