eetrbuated
形式
eetrbuated 〔-e 編集種別 〕〔-t 〔開始時刻〕〔,終了時刻〕〕
〔-r ランID〕 〔-x 中央処理通番の下限値,中央処理通番の上限値〕
〔-v サービス名〔,サービス名…〕〕
UAPトレースファイル名 〔UAPトレースファイル名…〕
機能
UAPトレース情報を編集し，標準出力に出力します。
オプション
●-e 編集種別 〜《f》
編集種別を指定します。
- r
-
UAPトレース情報をレコード単位で編集，出力します。
- f
-
ファイル情報一覧を出力します。
-eオプションにfを指定した場合，その他のオプションを指定するとエラーになります。
●-t 開始時刻,終了時刻
指定された時刻内に，出力バッファに出力されたUAPトレース情報を編集，出力します。
開始時刻，および終了時刻は，1970年1月1日0時0分0秒から当年当月当日の現在時刻までの範囲で指定します。
開始時刻または終了時刻のどちらか一方を必ず指定してください。開始時刻の指定を省略すると，UAPトレースファイルの先頭から指定した終了時刻までが出力範囲になります。終了時刻の指定を省略すると，指定した開始時刻からUAPトレースファイルの最後までが出力範囲になります。
開始時刻，および終了時刻は，「hhmmss〔MMDD〔YYYY〕〕」の形式で指定します。
- hh：時（00≦hh≦23）
-
指定を省略できません。
- mm：分（00≦mm≦59）
-
指定を省略できません。
- ss：秒（00≦ss≦59）
-
指定を省略できません。
- MM：月（01≦MM≦12）
-
指定を省略できます。※
- DD：日（01≦DD≦31）
-
指定を省略できます。※
- YYYY：年（西暦）（1970≦YYYY≦9999）
-
指定を省略できます。※
- 注※
-
開始時刻，または終了時刻の「年」の指定を省略した場合は，当年の指定月日時刻と見なされます。「年，月，日」の指定を省略した場合，当年当月当日の指定時刻と見なされます。「月，日」，「月」，または「日」だけを省略することはできません。省略した場合はオプションエラーになります。「月」または「日」を省略したい場合は，「年」，「月」，「日」のすべてを省略してください。
-tオプションの指定を省略すると，指定したファイル内のすべての情報を編集，出力します。
●-r ランID 〜〈8文字の16進数〉
指定されたランIDを持つUAPトレース情報だけ編集，出力します。
●-x 中央処理通番の下限値,中央処理通番の上限値 〜〈1〜8文字の16進数〉((0〜ffffffff))
指定されたカレント中央処理通番の範囲内の情報だけ編集，出力します。-xオプションを指定する場合，上限値および下限値を必ず指定してください。
中央処理通番を指定するときは，最大値（4294967295）を考慮してください。ラップした場合に4294967290から3まで出力したいときは，「-x FFFFFFFA,3」と指定します。
●-v サービス名 〜〈1〜31文字の識別子〉
指定されたサービス名を持つ情報だけ編集，出力します。サービス名は，最大10個指定できます。
コマンド引数
●UAPトレースファイル名 〜〈パス名〉
編集するファイル名を指定します。-eオプションにfを指定した場合は，最大1024個UAPトレースファイル名を指定できます。
指定できるオプションの組み合わせを次の表に示します。
|
オプション |
-e |
-t |
-r |
-x |
-v |
UAPトレースファイル名 |
|||
|---|---|---|---|---|---|---|---|---|---|
|
r |
f |
単一 |
複数 |
||||||
|
-e |
r |
− |
× |
○ |
○ |
○ |
○ |
○ |
× |
|
f |
× |
− |
× |
× |
× |
× |
○ |
○ |
|
|
-t |
○ |
× |
− |
○ |
○ |
○ |
○ |
× |
|
|
-r |
○ |
× |
○ |
− |
○ |
○ |
○ |
× |
|
|
-x |
○ |
× |
○ |
○ |
− |
○ |
○ |
× |
|
|
-v |
○ |
× |
○ |
○ |
○ |
− |
○ |
× |
|
|
UAPトレースファイル名 |
単一 |
○ |
○ |
○ |
○ |
○ |
○ |
− |
− |
|
複数 |
× |
○ |
× |
× |
× |
× |
− |
− |
|
- （凡例）
-
○：指定できます。
×：指定できません。
−：該当しません。
出力形式
●-eオプションにrを指定した場合
日本語の出力形式を次に示します。
![[図データ]](GRAPHICS/ZU101520.GIF)
英語の出力形式を次に示します。
![[図データ]](GRAPHICS/ZU1E1520.GIF)
- 注※
-
出力する内容は，発行したTP1/EEのライブラリ関数によって異なります。
出力形式中の，右端の数字の意味を次に示します。
-
1：改行を含まないで1行で表示します。
出力形式中の，各変数の意味を次に示します。
|
変数 |
意味 |
|---|---|
|
aa-aa-aa |
eetrbuatedコマンドを実行したTP1/EEのバージョン |
|
bb....bb |
eetrbuatedコマンドの引数 |
|
cc....cc |
入力ファイル名 |
|
dddd/dd/dd dd:dd:dd ddd.ddd |
UAPトレース情報のファイル出力を開始した日時 「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。 |
|
e1-e1-e1 |
ファイルを作成したTP1/EEのバージョン |
|
e2-e2-e2 |
ファイルを作成したXTCのバージョン※ |
|
e3-e3-e3 |
ファイルを作成したMCPのバージョン※ |
|
e4-e4-e4 |
ファイルを作成したXDBのバージョン※ |
|
e5-e5-e5 |
ファイルを作成したTP1/FSPのバージョン※ |
|
T1 |
UAPトレース取得タイプ |
|
ff....ff |
サービスグループ名（31文字以内） |
|
gggggggg |
TP1/EEのランID（8けたの16進数） |
|
zzzz/zz/zz zz:zz:zzz zzz.zzz |
取得時刻 「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。 |
|
hh....hh |
呼び出した関数名（COBOL言語） |
|
ii....ii |
呼び出した関数名（C言語） |
|
jj |
入口または出口のコール種別 |
|
kkkk/kk/kk kk:kk:kk kkk.kkk |
UAPトレース情報の取得開始日時と取得終了日時 「年/月/日△時:分:秒 ミリ秒.マイクロ秒」の形式で出力します。サービス関数の場合は，取得日時だけを表示します。サービス関数以外の場合は，取得開始日時と取得終了日時の2種類を表示します。 |
|
k1....k1.k1....k1 |
APIの実行時間。ミリ秒.マイクロ秒で表示します。 |
|
llllllll |
カレント中央処理通番（8けたの16進数） |
|
xx....xx |
トレース取得通番（スレッドごとに取得する通番） |
|
mm....mm |
サービス名（31文字以内） |
|
nn....nn，oo....oo，pp，qq，およびy |
TP1/EEの関数の情報 出力する内容は，呼び出したTP1/EEの関数によって異なります。 1行前に出力した行と同一の場合，「TO NEXT LINE LOCATION SAME AS ABOVE」を表示します。複数行で同一の場合は，「TO NEXT LINE LOCATION SAME AS ABOVE」を一度だけ表示します。最後の2行が同一の場合は，「TO NEXT LINE LOCATION SAME AS ABOVE」を表示しません。 |
|
rr....rr |
オプション（COBOL言語） 呼び出したライブラリ関数のデータ領域にオプションがある場合だけ表示します。 |
|
ss....ss |
オプション（C言語） 呼び出した関数の引数にオプションがある場合だけ表示します。不正なコードの場合は，「????」を表示します。 |
|
tt....tt |
リターンコード（COBOL言語） サービス関数を呼び出したときは，表示しません。 |
|
uu....uu |
リターンコード（C言語） サービス関数を呼び出したときは，表示しません。 COBOL言語特有のリターンコードの場合は，「NOTHING」を表示します。また，不正なコードの場合は，「????」を表示します。 |
|
vvvv/vv/vv vv:vv:vv vvv.vvv |
UAPトレース情報の出力を再開した日時 「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。 |
|
ww....ww |
すべての出力バッファを使用している間にトレース情報出力要求が発生したため，破棄したレコード数 |
- 注※
-
それぞれのプログラムプロダクトを使用する場合にだけ表示します。
●-eオプションにfを指定した場合
日本語の出力形式を次に示します。
![[図データ]](GRAPHICS/ZU101530.GIF)
英語の出力形式を次に示します。
![[図データ]](GRAPHICS/ZU1E1530.GIF)
出力形式中の，右端の数字の意味を次に示します。
-
1：ファイル数分出力します。
出力形式中の，各変数の意味を次に示します。
|
変数 |
意味 |
|---|---|
|
aa-aa-aa |
eetrbuatedコマンドを実行したTP1/EEのバージョン |
|
bb....bb |
eetrbuatedコマンドの引数 |
|
cc....cc |
入力ファイル名 |
|
dddd/dd/dd dd:dd:dd ddd.ddd |
UAPトレース情報のファイル出力を開始した日時 「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。 |
|
e1-e1-e1 |
ファイルを作成したTP1/EEのバージョン |
|
e2-e2-e2 |
ファイルを作成したXTCのバージョン※ |
|
e3-e3-e3 |
ファイルを作成したMCPのバージョン※ |
|
e4-e4-e4 |
ファイルを作成したXDBのバージョン※ |
|
e5-e5-e5 |
ファイルを作成したTP1/FSPのバージョン※ |
|
T1 |
UAPトレース取得タイプ |
|
ff....ff |
サービスグループ名（31文字以内） |
|
gggggggg |
TP1/EEのランID（8けたの16進数） |
- 注※
-
それぞれのプログラムプロダクトを使用する場合にだけ表示します。
指定したファイルがUAPトレースファイルではない合，日本語では「ＵＡＰトレースファイルではありません。」を，英語では「This is not a UAP trace file.」を表示します。
出力メッセージ
|
メッセージID |
内容 |
出力先 |
|---|---|---|
|
KFSB95400-E |
メモリを確保できません。 |
標準エラー出力 |
|
KFSB95401-E |
コマンドの形式が不正です。 |
標準エラー出力 |
|
KFSB95402-E |
コマンドのオプションが不正です。 |
標準エラー出力 |
|
KFSB95403-E |
コマンドのオプションの組み合わせが不正です。 |
標準エラー出力 |
|
KFSB95405-E |
ファイルのヘッダ情報が不正です。 |
標準エラー出力 |
|
KFSB95406-E |
データブロックが不正です。 |
標準エラー出力 |
|
KFSB95409-E |
バージョンが不一致です。 |
標準エラー出力 |
|
KFSB95410-E |
ファイルのオープン処理で障害が発生しました。 |
標準エラー出力 |
|
KFSB95411-E |
ファイルからの読み出し処理で障害が発生しました。 |
標準エラー出力 |
|
KFSB95413-E |
ファイルのクローズ処理で障害が発生しました。 |
標準エラー出力 |
|
KFSB95446-I |
ヘルプメッセージ |
標準出力 |
注意事項
-
-eオプションにrを指定した場合で，編集対象のレコードがないときは，-eオプションにfを指定した場合と同様に，UAPトレース情報を表示します。
-
サービス関数の開始時のトランザクション情報には，情報長，サービスグループ名長，サービスグループ名，サービス名長，サービス名を表示しません。
-
入力および出力メッセージ長が60バイトを超える場合は，60バイトまで表示します。60バイト未満の場合は，メッセージ長で表示します。メッセージ長の表示は，実際に送受信したメッセージ長を表示します。