eemcpdump（MCPトレースの出力）

〈このページの構成〉

機能
コマンドの形式
オプションの説明
コマンド引数
出力形式
出力メッセージ
注意事項

機能

指定されたコアファイルまたはメモリダンプファイルからMCPトレース情報を編集し，標準出力またはCSV形式でファイルに出力します。

TP1/EEプロセスがダウンした場合や特定のスレッドがダウンした場合に，MCP通信での障害情報を特定のトランザクションまたはIPアドレスなどで編集し，障害を調査するために使用します。

コマンドの形式

eemcpdump 〔-r ランID〕
          〔-s usr｜lin〕
          〔-x 中央処理通番の下限値，中央処理通番の上限値〕
          〔-l 論理端末名〔,論理端末名…〕〕
          〔-i IPアドレス〔,IPアドレス…〕〕
          〔-c CSV出力ファイル名〔-ｎ ファイル出力行〕〕 ファイル名

ページの先頭へ

オプションの説明

●-r ランID

　: 指定されたランIDを持つトレース情報だけ編集，出力します。

●-s usr｜lin

　　〜《usr》

usr：ユーザトレース情報だけを編集，出力します。

lin：MCPトレース情報だけを編集，出力します。

●-x 中央処理通番の下限値，中央処理通番の上限値

　　〜〈1〜8文字の16進数〉((0〜ffffffff))

指定されたカレント中央処理通番の範囲内の情報だけを編集，出力します。

-xオプションを指定する場合，上限値および下限値を必ず指定してください。

中央処理通番を指定する場合，最大値（4294967295）を考慮して指定してください。

●-l 論理端末名

　　〜〈1〜8文字の識別子〉: 指定された論理端末名を持つ情報だけ編集，出力します。eemcple定義コマンドの-lオプションで指定した論理端末名を指定してください。論理端末名は，最大10個指定できます。

●-i IPアドレス

　　〜〈7〜15文字の数字〉: IPアドレスを指定する場合は，nnn.nnn.nnn.nnnの形式で指定します。nnnは，0〜255（10進数）で指定します。IPアドレスは，最大10個指定できます。

●-c CSV出力ファイル名

　　〜〈パス名〉

編集結果を指定したファイルにCSV形式で出力します。標準出力には出力しません。CSVファイルに出力する場合，コンマで区切って出力します。10進数以外の場合，引用符「"」で囲んで出力します。

-nオプションを指定した場合は，パス名中のファイル名は，245文字以下としてください。-nオプション指定時にファイル名が246文字以上の場合はオプションエラーで，このコマンドが異常終了します。

●-n ファイル出力行

　　((10000〜100000))

-cオプションに指定したcsvファイルを分割して出力する場合に1ファイルに出力する行数を指定します。見出し行を含めて-nオプションに指定した行数を出力したときに，出力するファイルを切り替えます。切り替えた先のファイルには見出し行から出力します。

分割したファイルには，10進数の文字列をファイル名の末尾に付与します。付与する文字列は1から9999ファイルまでは「0001」からの連番で左に0を埋めた4けたの文字列とします。10000ファイルを超えた場合は左に0埋めをしません。ファイル名に「.」を含む場合は，最後の「.」の前に付与します。

ファイル名に文字列を付与する例を示します。

＜例1＞-cにxxxと指定した場合

xxx0001
xxx0002
 ：

＜例2＞-cにxxx.csvと指定した場合

xxx0001.csv
xxx0002.csv
 ：

このオプションを省略した場合は，ファイルを分割しないで1ファイルに出力します。

ページの先頭へ

コマンド引数

●ファイル名

　　〜〈パス名〉

入力元のコアファイルまたはメモリダンプファイル名を指定します。

指定できるオプションの組み合わせを次の表に示します。

表6‒2　eemcpdumpコマンドのオプションの組み合わせ
オプション		-r	-s		-x	-l	-i	-c	-n	ファイル指定
オプション		-r	usr	lin	-x	-l	-i	-c	-n	ファイル指定
-r		−	○	○	○	○	○	○	○	○
-s	usr	○	−	×	○	○	×	○	○	○
-s	lin	○	×	−	×	×	○	○	○	○
-x		○	○	×	−	○	×	○	○	○
-l		○	○	×	○	−	×	○	○	○
-i		○	×	○	×	×	−	○	○	○
-c		○	○	○	○	○	○	−	○	○
-n		○	○	○	○	○	○	○	−	○
ファイル指定		○	○	○	○	○	○	○	○	−

（凡例）

○：指定できます。

×：指定できません。

−：該当しません。

ページの先頭へ

出力形式

コマンド実行時の出力形式について説明します。

■-sにlinを指定した場合
■-sにusrを指定した場合

出力形式中の，右端の数字の意味を次に示します。

1：改行キーを含まないで，1行で出力します。
2：レコード数分出力します。
3：複数行を改行して出力します。

出力形式中の，各変数の意味を次に示します。

変数	意味
a1-a1-a1	コマンドを実行したTP1/EEのバージョン
a2-a2-a2	コマンドを実行したMCPのバージョン
bb....bb	このコマンドの引数
cc....cc	入力ファイル名
e1-e1-e1	ファイルを作成したTP1/EEのバージョン
e2-e2-e2	ファイルを作成したMCPのバージョン
e3-e3-e3	ファイルを作成したTP1/FSPのバージョン TP1/FSPを使用した場合だけ出力します。
e3	MCPトレース情報取得タイプ
ff....ff	サービスグループ名（31文字以内）
gggggggg	TP1/EEのランID（16進数8けた）
hhhh/hh/hh hh:hh:hh hhh.hhh	MCPトレースを取得した時刻「年/月/日△時間：分：秒ミリ秒．マイクロ秒」の形式で表示します。
ii....ii	イベント名（15文字以内）イベントの前後で情報を取得するため，イベント名の後ろに,「前」または「後」が表示されます。また，ee_mcp_utrace_put関数，またはee_mcp_utrace_put_long関数で指定したIDを16進数で表示します。
jjjjjjjjjj	データ長（10進数10けた）
oooo/oo/oo oo:oo:oo ooo.ooo	実行時刻「年/月/日△時間：分：秒ミリ秒．マイクロ秒」の形式で表示します。
kkkkkkkk	該当レコードを取得した中央処理通番（16進数8けた）
kkkkkkkk1	該当レコードを取得した受信ID（16進数8けた）
lll	取得した機能種別（3文字） usr：ユーザトレースAPI，またはMCPで取得 lin：MCPで取得
mm....mm	論理端末名（1〜8文字の識別子）
nn....nn	コネクションID（1〜8文字の識別子）
ppp.ppp.ppp.ppp	受信/送信先のIPアドレス（10進数15けた以内）
qq....qq	受信/送信先のポート番号（10進数5けた以内）
rr....rr	サービス名（1〜31文字の識別子）
0xss....ss	送信ID（16進数16けた）
0xtt....tt	リターンコード（16進数4けた以内）
tt2....tt2	リターンコード（10進数5けた以内）
uu....uu	実際に送受信したデータ長
vv vv vv vv vv vv vv vv vv vv vv vv vv vv vv vv vvvvvvvvvvvvvvvv	次に示すデータです。 -sオプションにusrを指定した場合ユーザデータ，またはMCPで取得したデータ -sオプションにlinを指定した場合 MCPで取得したデータ
wwww/ww/ww ww:ww:ww www.www	MCPトレース情報の出力を再開した時刻「年/月/日△時間：分：秒ミリ秒．マイクロ秒」の形式で表示します。
yy....yy	すべての出力バッファが使用中となり，その間にMCPトレース情報出力要求が発生したため，破棄したレコード数
zzzz/zz/zz zz:zz:zz zzz.zzz	破棄を開始した時刻「年/月/日△時間：分：秒ミリ秒．マイクロ秒」の形式で表示します。
yy....yy2	破棄を開始したレコードを取得した中央処理通番該当しない場合は0を表示します。
yy....yy3	破棄を開始したレコードを取得した受信ID 該当しない場合は0を表示します。

■-nオプションを指定した場合の標準出力

日本語と英字共通

EARLIEST TIME               - LATEST TIME                 EARLIEST CPN - LATEST CPN FILE NAME
xxxx/xx/xx xx:xx:xx xxx.xxx - yyyy/yy/yy yy:yy:yy yyy.yyy     nnnnnnnn     mmmmmmmm zzz0001
xxxx/xx/xx xx:xx:xx xxx.xxx - yyyy/yy/yy yy:yy:yy yyy.yyy     nnnnnnnn     mmmmmmmm zzz0002
    :                                :                     :

項番	表示名称	出力形式
1	xxxx/xx/xx xx:xx:xx xxx.xxx	出力したMCPトレース情報の中でいちばん古い起動時刻出力対象のMCPトレース情報がない場合は「**// :: *.*」を出力します。
2	yyyy/yy/yy yy:yy:yy yyy.yyy	出力したMCPトレース情報の中でいちばん新しい起動時刻出力対象のMCPトレース情報がない場合は「**// :: *.*」を出力します。
3	nnnnnnnn	出力したMCPトレース情報の中でいちばん値の小さい中央処理通番。16進数8けた^※ 出力対象のMCPトレース情報がない場合は「******」を出力します。出力対象のMCPトレース情報の中央処理通番がすべて0x00000000の場合は「******」を出力します。
4	mmmmmmmm	出力したMCPトレース情報の中でいちばん値の大きい中央処理通番。16進数8けた^※ 出力対象のMCPトレース情報がない場合は「******」を出力します。出力対象のMCPトレース情報の中央処理通番がすべて0x00000000の場合は「******」を出力します。
5	zzz	-cオプションに指定した出力ファイル名

注※: 出力対象のMCPトレース情報の中央処理通番が0x00000000，0x00000001，0x00000002の三つの場合，nnnnnnnnに表示される値は0x00000001で，mmmmmmmmに表示される値は0x00000002となり，0x00000000がnnnnnnnn，mmmmmmmmに表示されることはありません。

ページの先頭へ

出力メッセージ

メッセージID	内容	出力先
KFSB91300-E	メモリを確保できません。	標準エラー出力
KFSB91301-E	コマンドの形式が不正です。	標準エラー出力
KFSB91302-E	コマンドのオプションが不正です。	標準エラー出力
KFSB91303-E	コマンドのオプションの組み合わせが不正です。	標準エラー出力
KFSB91308-E	編集できないファイルタイプです。	標準エラー出力
KFSB91310-E	ファイルのオープン処理で障害が発生しました。	標準エラー出力
KFSB91311-E	ファイルからのリード処理で障害が発生しました。	標準エラー出力
KFSB91312-E	ファイルへのライト処理で障害が発生しました。	標準エラー出力
KFSB91313-E	ファイルのクローズ処理で障害が発生しました。	標準エラー出力
KFSB91314-E	ファイルポインタの移動処理で障害が発生しました。	標準エラー出力
KFSB91315-Q	-cオプションに指定したファイルはすでに存在します。	標準出力
KFSB91316-E	指定したファイルに編集するデータがありません。	標準エラー出力
KFSB91317-E	データの編集途中でファイルの終わりに達しました。	標準エラー出力
KFSB91344-I	ヘルプメッセージ	標準出力
KFSB91357-Q	-cオプションに指定したファイルはすでに存在します。（-nオプション指定時）	標準出力

ページの先頭へ

注意事項

編集対象のレコードがない場合，ヘッダ情報だけを表示します。
サービス名，論理端末名およびコネクションIDを表示する場合，表示する内容がないときは，「*」を表示します。
該当MCPトレース情報がMCPトレースファイルに出力される以前のMCPトレース出力時刻の場合は，「*」を表示します。
MCPトレース情報に欠落があった場合，欠落したレコード数を表示します。欠落したレコード数が4294967295を超えた場合，4294967295と表示します。
CSVファイルに出力する場合，コンマで区切って出力します。10進数以外の場合，引用符「"」で囲んで出力します。
CSVファイルに出力する場合，標準出力に出力しません。
MCPトレース情報取得時に障害が発生した場合など，情報が取得できないときは，0を表示します。
ファイル名に指定できるコアファイルまたはメモリダンプファイルは，コマンド実行時の環境で作成されたファイルだけです。バージョン，および適用OSが異なる製品で作成したファイルは指定できません。
CSVファイルに出力する場合，ファイル作成バージョンは「ファイル作成バージョン：dd-dd-dd」の形式で出力されます。

ページの先頭へ