prfget
形式
prfget 〔-a〕 〔-f {_tr|_nm|_xr|_pr|_mc|_fl|_jl|_lk}〕
機能
prfトレースファイルに格納されているトレース情報を取り出します。取り出す範囲は,前回取り出したトレース情報の次のトレース情報からコマンドが入力された時点までになります。
オプション
●-a
prfトレースファイルに格納されているすべてのトレース情報を取り出します。通常は,いちばん新しいランIDで,取り出されていないトレース情報だけが取り出されますが,このオプションを指定することで,古いランIDを持つトレース情報を取り出すことができます。
●-f {_tr|_nm|_xr|_pr|_mc|_fl|_jl|_lk}
イベントトレース情報を取得します。
_tr:TRNイベントトレース情報を取得します。
_nm:NAMイベントトレース情報を取得します。
_xr:XARイベントトレース情報を取得します。
_pr:プロセスサービスのイベントトレース情報を取得します。
_mc:MCF性能検証用トレース情報を取得します。
_fl:FILイベントトレース情報を取得します。
_jl:JNL性能検証用トレース情報を取得します。
_lk:LCK性能検証用トレース情報を取得します。
イベントトレース情報を取り出す場合以外は,このオプションを指定しないでください。また,このオプションには_tr,_nm,_xr,_pr,_mc,_fl,_jlまたは_lk以外は指定しないでください。イベントトレース情報の取り出し方法については,マニュアル「OpenTP1 解説」の,イベントトレースについての説明を参照してください。
出力メッセージ
メッセージID |
内容 |
出力先 |
---|---|---|
KFCA26750-E |
コマンドが実行できませんでした |
標準エラー出力 |
KFCA26751-E |
コマンドの形式が誤っています |
標準エラー出力 |
KFCA26760-E |
prfトレースファイルのオープンに失敗しました |
標準エラー出力 |
KFCA26761-E |
prfトレースファイルをアクセス中に障害が発生しました |
標準エラー出力 |
KFCA26762-E |
prfトレースファイルをアクセス中にデータ不正を検出しました |
標準エラー出力 |
KFCA26771-I |
ヘルプメッセージ |
標準出力 |
注意事項
-
このコマンドの使用は,TP1/Extension 1をインストールしていることが前提です。TP1/Extension 1をインストールしていない場合の動作は保証できませんので,ご了承ください。
-
前回取り出した情報の次の情報が失われている場合は,取り出していないいちばん古い情報からコマンドが入力された時点までが対象になります。
-
prfgetコマンドは,トレース情報の取り出しに成功すると,引き継ぎファイル※を作成することで最終位置を記憶します。そのため,引き継ぎファイルの作成に失敗すると,すでに取り出したトレース情報を取り出すことがあります。
-
prfgetコマンドが動作中に,並行してprfgetコマンドを動作させることはできません。
-
トレース情報を格納するバッファにファイル未出力のトレース情報が残っている場合,prfgetコマンドを実行するとトレース情報ファイルをスワップします。このとき,最も古い世代のトレース情報ファイルに上書きするため,トレース情報が失われます。必要に応じてprfgetコマンド実行前に最も古い世代のトレース情報ファイルを退避してください。
- 注※
-
引き継ぎファイルの内容は,最後に出力したprfファイルのファイルヘッダと同一の内容になっています。