Hitachi

OpenTP1 Version 7　分散トランザクション処理機能　TP1/Server Base Enterprise Option 使用の手引

eetrblineed

〈このページの構成〉

名称

回線トレース情報の編集出力

ページの先頭へ

形式

eetrblineed 〔-e 編集種別 〕〔-t 〔開始時刻〕〔,終了時刻〕〕
            〔-r ランID〕 〔-s ｛rpc｜trn｜rap｜dbq｜ora｜udp｜sdh｝〕
            〔-x 中央処理通番の下限値,中央処理通番の上限値〕
            〔-v サービス名〔,サービス名…〕〕
            〔-i IPアドレス〔,IPアドレス…〕〕
            〔-q DBキュー名〔,DBキュー名…〕〕
            〔-l ロット名〔,ロット名…〕〕
            〔-c CSV出力ファイル名 〔-n ファイル出力行〕〕
            〔-k 出力種別〕
            回線トレースファイル名 〔回線トレースファイル名…〕

ページの先頭へ

機能

回線トレース情報を編集し，標準出力，またはCSV形式でファイルに出力します。

ページの先頭へ

オプション

●-e　編集種別　　〜《f》

編集種別を指定します。

r

レコード単位で編集，出力します。

f

ファイル情報一覧を出力します。

-eオプションにfを指定した場合，その他のオプションを指定するとエラーになります。

●-t　開始時刻,終了時刻

指定された時刻内に，出力バッファに出力された回線トレース情報を編集，出力します。

開始時刻，および終了時刻は，1970年1月1日0時0分0秒から当年当月当日の現在時刻までの範囲で指定します。

開始時刻または終了時刻のどちらか一方を必ず指定してください。開始時刻の指定を省略すると，回線トレースファイルの先頭から指定した終了時刻までが出力範囲になります。終了時刻の指定を省略すると，指定した開始時刻から回線トレースファイルの最後までが出力範囲になります。

開始時刻，および終了時刻は，「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を持つ回線トレース情報だけ編集，出力します。

●-s　｛rpc｜trn｜rap｜dbq｜ora｜udp｜sdh｝　　〜《rpc》

rpc

RPC機能のトレース情報だけを編集，出力します。

trn

XAインタフェース，TP1/EE情報コード，およびee_trb_utrace_put関数で出力したトレース情報だけを編集，出力します。

rap

rap機能のトレース情報だけを編集，出力します。

dbq

DBキュー機能（TCP/IP通信）のトレース情報だけを編集，出力します。

ora

Oracleのエラー情報だけを編集，出力します。

udp

RPC機能（UDP通信）のトレース情報だけを編集，出力します。

sdh

SDBハンドラ機能のトレース情報だけを編集，出力します。

●-x　中央処理通番の下限値,中央処理通番の上限値　　〜〈1〜8文字の16進数〉((0〜ffffffff))

指定されたカレント中央処理通番の範囲内の情報だけ編集，出力します。-xオプションを指定する場合，上限値および下限値を必ず指定してください。

中央処理通番を指定する場合，最大値（4294967295）を考慮して指定してください。ラップした場合に4294967290から3まで出力したいときは，「-x FFFFFFFA,3」と指定します。

●-v　サービス名　　〜〈1〜31文字の識別子〉

指定されたサービス名を持つ情報だけ編集，出力します。サービス名は，最大10個指定できます。

●-i　IPアドレス　　〜〈7〜15文字の符号なし整数〉

IPアドレスを指定する場合は，xxx.xxx.xxx.xxxの形式で指定します。xxxは，0〜255（10進数）で指定します。IPアドレスは，最大10個指定できます。

●-q　DBキュー名　　〜〈1〜27文字の識別子〉

指定されたDBキュー名を持つ情報だけを編集，出力します。DBキュー名は，最大10個指定できます。-qオプションは，-sオプションにoraを指定した場合だけ指定できます。

●-l　ロット名　　〜〈1〜23文字の識別子〉

指定されたロット名を持つ情報だけを編集，出力します。ロット名は，最大10個指定できます。-lオプションは，-sオプションにoraを指定した場合だけ指定できます。

●-c　CSV出力ファイル名　　〜〈パス名〉

指定されたファイルに編集結果をCSV形式で出力します。

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

●-ｎ　ファイル出力行　　〜(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ファイルに出力します。

●-k　出力種別　〜((1))

1

受信IDを出力します。

ページの先頭へ

コマンド引数

●回線トレースファイル名　　〜〈パス名〉

編集するファイル名を指定します。-eオプションにfを指定した場合は，最大1024個回線トレースファイル名を指定できます。

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

図10‒4　eetrblineedコマンドのオプションの組み合わせ

[図データ]
（凡例）

○：指定できます。

×：指定できません。

−：該当しません。

ページの先頭へ

出力形式

●-eオプションにr，かつ-sオプションにtrnを指定した場合

日本語の出力形式を次に示します。

[図データ]

英語の出力形式を次に示します。

[図データ]

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

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

変数

意味

aa-aa-aa

eetrblineedコマンドを実行したTP1/EEのバージョン

bb....bb

eetrblineedコマンドの引数

cc....cc

入力ファイル名

dddd/dd/dd dd:dd:dd ddd.ddd

回線トレース情報のファイル出力を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

e2-e2-e2

ファイルを作成したXTCのバージョン

XTCを使用する場合にだけ表示します。

e3-e3-e3

ファイルを作成したTP1/FSPのバージョン

TP1/FSPを使用する場合にだけ表示します。

T1

回線トレース情報取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

hhhh/hh/hh hh:hh:hh hhh.hhh

回線トレース情報を取得した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

ii....ii

イベント名（15文字以内）

イベントの前後で回線トレース情報を取得するため，イベント名のあとに，イベントの前後を示す「前」または「後」を表示します。また，ee_trb_utrace_put関数で指定したID，およびTP1/EEがトラブルシュートで使用するコードを，16進数で表示します。

jjj

データ長（3けたの10進数）（単位：バイト）

oooo/oo/oo oo:oo:oo ooo.ooo

実行日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。XA関数呼び出し前のときに表示します。

kkkkkkkk

該当するレコードを取得したカレント中央処理通番（8けたの16進数）

ll....ll

サービス名（31文字以内）

表示する内容がない場合，「*」を表示します。

mm....mm.mmm

XA関数の呼び出し時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。4294967.295ミリ秒を超えた場合，「4294967.295」を表示します。XA関数呼び出し後のときに表示します。

nnnnnnnn

リターンコード（8けたの16進数）

XA関数呼び出し後のときに表示します。

n1....n1

リソースマネジャ名とリソースマネジャ拡張子

（trnstringの-nオプション指定値と-iオプション指定値をつなげた値）

yy

XAインタフェース

ssss/ss/ss ss:ss:ss sss.sss

トレース情報の出力を再開した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

tt....tt

すべての出力バッファを使用している間にトレース情報出力要求が発生したため，破棄したレコード数

vvvv/vv/vv vv:vv:vv vvv.vvv

破棄を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

wwwwwwww

破棄を開始したレコードを取得した中央処理通番

該当しない場合は0が表示されます。

xxxxxxxx

破棄を開始したレコードを取得した受信ID

該当しない場合は0が表示されます。

●-eオプションにr，かつ-sオプションにrpc，rap，dbq，またはudpを指定した場合

日本語の出力形式を次に示します。

[図データ]

英語の出力形式を次に示します。

[図データ]

注※

この範囲の出力形式の説明は，「●-eオプションにr，かつ-sオプションにtrnを指定した場合」を参照してください。

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

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

変数

意味

hhhh/hh/hh hh:hh:hh hhh.hhh

回線トレース情報を取得した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

ii....ii

イベント名（15文字以内）

イベントの前後で回線トレース情報を取得するため，イベント名のあとに，イベントの前後を示す「前」または「後」を表示します。また，ee_trb_utrace_put関数で指定したID，およびTP1/EEがトラブルシュートで使用するコードを，16進数で表示します。

jjj

データ長（3けたの10進数）（単位：バイト）

oooo/oo/oo oo:oo:oo ooo.ooo

実行日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

kkkkkkkk

該当するレコードを取得したカレント中央処理通番（8けたの16進数）

llllllll

該当するレコードを取得した受信ID（8けたの16進数）

-kオプションに1を指定した場合だけ出力します。

ppp

回線トレース情報を取得した機能種別（3文字）

  • rpc…RPC機能で取得

  • rap…rap機能で取得

  • dbq…DBキュー機能（TCP/IP通信）で取得

  • udp…RPC機能（UDP通信）で取得

qq....qq.qq....qq.qq....qq.qq....qq

受信元または送信先のIPアドレス（15けた以内の10進数）

rr....rr

受信元または送信先のポート番号（5けた以内の10進数）

nnnn

リターンコード（4けたの16進数）

uu....uu

実際に送受信したデータ長

トラブルシュート関連定義のtrb_trace_typeオペランドで1を指定した場合に表示します。

yy

メッセージ情報

ssss/ss/ss ss:ss:ss sss.sss

トレース情報の出力を再開した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

tt....tt

すべての出力バッファを使用している間にトレース情報出力要求が発生したため，破棄したレコード数

vvvv/vv/vv vv:vv:vv vvv.vvv

破棄を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

wwwwwwww

破棄を開始したレコードを取得した中央処理通番

該当しない場合は0が表示されます。

xxxxxxxx

破棄を開始したレコードを取得した受信ID

該当しない場合は0が表示されます。

●-eオプションにr，かつ-sオプションにsdhを指定した場合

日本語の出力形式を次に示します。

[図データ]

英語の出力形式を次に示します。

[図データ]

注※

この範囲の出力形式の説明は，「●-eオプションにr，かつ-sオプションにtrnを指定した場合」を参照してください。

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

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

変数

意味

hhhh/hh/hh hh:hh:hh hhh.hhh

回線トレース情報を取得した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

ii....ii

イベント名（15文字以内）

イベントの前後で回線トレース情報を取得するため，イベント名のあとに，イベントの前後を示す「前」または「後」を表示します。また，ee_trb_utrace_put関数で指定したID，およびTP1/EEがトラブルシュートで使用するコードを，16進数で表示します。

jjj

データ長（3けたの10進数）（単位：バイト）

oooo/oo/oo oo:oo:oo ooo.ooo

実行日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。DML関数呼び出し前のときに表示します。

kkkkkkkk

該当するレコードを取得したカレント中央処理通番（8けたの16進数）

ll....ll

サービス名（31文字以内）

表示する内容がない場合，「*」を表示します。

mm....mm.mmm

DML関数の呼び出し時間

「ミリ秒.マイクロ秒」（ミリ秒は最大7けた，マイクロ秒は3けた）の形式で出力します。4294967.295ミリ秒を超えた場合，「4294967.295」を表示します。DML関数呼び出し後のときに表示します。

nnnnnnnn

リターンコード（8けたの16進数）

DML関数呼び出し後のときに表示します。

yy

SDHインタフェース

ssss/ss/ss ss:ss:ss sss.sss

トレース情報の出力を再開した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

tt....tt

すべての出力バッファを使用している間にトレース情報出力要求が発生したため，破棄したレコード数

vvvv/vv/vv vv:vv:vv vvv.vvv

破棄を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

wwwwwwww

破棄を開始したレコードを取得した中央処理通番

該当しない場合は0が表示されます。

xxxxxxxx

破棄を開始したレコードを取得した受信ID

該当しない場合は0が表示されます。

zz....zz

SDBのエラー情報（280文字以内）

イベント名に「DBMSERR」が出力された場合にだけ表示します。

●-sオプションにoraを指定した場合

日本語の出力形式を次に示します。

[図データ]

英語の出力形式を次に示します。

[図データ]

注※

この範囲の出力形式の説明は，「●-eオプションにr，かつ-sオプションにtrnを指定した場合」を参照してください。

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

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

変数

意味

kkkkkkkk

該当するレコードを取得したカレント中央処理通番（8けたの16進数）

zz....zz

SQLCODE（10進数）

mm....mm

DBキュー名（27文字以内）

nn....nn

ロット名（23文字以内）

pp....pp

Oracleのエラー情報（512文字以内）

ssss/ss/ss ss:ss:ss sss.sss

トレース情報の出力を再開した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

tt....tt

すべての出力バッファを使用している間にトレース情報出力要求が発生したため，破棄したレコード数

vvvv/vv/vv vv:vv:vv vvv.vvv

破棄を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

wwwwwwww

破棄を開始したレコードを取得した中央処理通番

該当しない場合は0が表示されます。

xxxxxxxx

破棄を開始したレコードを取得した受信ID

該当しない場合は0が表示されます。

●-eオプションにfを指定した場合

日本語の出力形式を次に示します。

[図データ]

英語の出力形式を次に示します。

[図データ]

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

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

変数

意味

aa-aa-aa

eetrblineedコマンドを実行したTP1/EEのバージョン

bb....bb

eetrblineedコマンドの引数

cc....cc

入力ファイル名

dddd/dd/dd dd:dd:dd ddd.ddd

回線トレース情報のファイル出力を開始した日時

「年/月/日△時:分:秒△ミリ秒.マイクロ秒」の形式で出力します。

e1-e1-e1

ファイルを作成したTP1/EEのバージョン

e2-e2-e2

ファイルを作成したXTCのバージョン

XTCを使用する場合にだけ表示します。

T1

回線トレース情報取得タイプ

ff....ff

サービスグループ名（31文字以内）

gggggggg

TP1/EEのランID（8けたの16進数）

指定したファイルが回線トレースファイルではない場合，日本語では「回線トレースファイルではありません。」を，英語では「This is not a line trace file.」を表示します。

[図データ]

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

変数

意味

xxxx/xx/xx xx:xx:xx xxx.xxx

出力した回線トレース情報の中でいちばん古い起動時刻

出力対象の回線トレース情報がない場合は

「****/**/** **:**:** ***.***」

を出力します。

出力対象の回線トレース情報に時刻がない場合（xa関数実行後のトレースだけの場合など）は

「****/**/** **:**:** ***.***」

を出力します。

yyyy/yy/yy yy:yy:yy yyy.yyy

出力した回線トレース情報の中でいちばん新しい起動時刻

出力対象の回線トレース情報がない場合は

「****/**/** **:**:** ***.***」

を出力します。

出力対象の回線トレース情報に時刻がない場合（xa関数実行後のトレースだけの場合など）は

「****/**/** **:**:** ***.***」

を出力します。

nnnnnnnn

出力した回線トレース情報の中でいちばん値の小さい中央処理通番。16進数8けた※

出力対象の回線トレース情報がない場合は

「********」

を出力します。

出力対象の回線トレース情報の中央処理通番がすべて0x00000000の場合は

「********」

を出力します。

mmmmm

出力した回線トレース情報の中でいちばん値の大きい中央処理通番。16進数8けた※

中央処理通番が0x00000000の場合は比較対象外です。

出力対象の回線トレース情報がない場合は

「********」

を出力します。

出力対象の回線トレース情報の中央処理通番がすべて0x00000000の場合は

「********」

を出力します。

zzz

-cオプションに指定した出力ファイル名
注※

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

ページの先頭へ

出力メッセージ

メッセージID

内容

出力先

KFSB95400-E

メモリを確保できません。

標準エラー出力

KFSB95401-E

コマンドの形式が不正です。

標準エラー出力

KFSB95402-E

コマンドのオプションが不正です。

標準エラー出力

KFSB95403-E

コマンドのオプションの組み合わせが不正です。

標準エラー出力

KFSB95405-E

ファイルのヘッダ情報が不正です。

標準エラー出力

KFSB95406-E

データブロックが不正です。

標準エラー出力

KFSB95409-E

バージョンが不一致です。

標準エラー出力

KFSB95410-E

ファイルのオープン処理で障害が発生しました。

標準エラー出力

KFSB95411-E

ファイルからの読み出し処理で障害が発生しました。

標準エラー出力

KFSB95412-E

ファイルへの書き込み処理で障害が発生しました。

標準エラー出力

KFSB95413-E

ファイルのクローズ処理で障害が発生しました。

標準エラー出力

KFSB95415-Q

-cオプションに指定したファイルはすでに存在します。

標準出力

KFSB95431-I

ヘルプメッセージ

標準出力

KFSB95457-Q

上書き確認（-nオプション指定時）

標準出力

ページの先頭へ

注意事項

ページの先頭へ

商品名称に関する表示

All Rights Reserved. Copyright (C) 2008, 2019, Hitachi, Ltd.