hdstrcedit(稼働トレースファイルの編集)
機能
抽出側Datareplicator/反映側Datareplicatorの稼働中に出力されたトレースファイルを編集して,別ファイル(又は標準出力)に出力します。オプションの指定に従って,稼働トレースファイルの内容すべてを解析して出力します。
指定したオプションのエラーが複数あるときは,チェックできるだけのエラーメッセージがすべて出力されます。また,オプションの解析結果は,hdstrceditコマンドのローカルメモリに保持されます。
形式
hdstrcedit -f稼働トレースファイル名〔,稼働トレースファイル名〕 〔 -l{ glbl|perf1|perf2 }〕 〔 -pプロセスID〔 -pプロセスID 〕…〕|〔 -t 開始日時〔,終了日時〕〕 〔 -o出力先ファイル名〕〔 -O shortfmt 〕 |
オプション
トレースファイルの情報 | -lオプションの指定値 | ||
---|---|---|---|
glbl | perf1 | perf2 | |
| ○ | ○ | ○ |
| ○ | ○ | ○ |
| ○ | ○ | ○ |
| × | ○ | ○ |
| × | × | ○ |
| ○ | ○ | ○ |
規則
戻り値 | 終了状態 | 内容 |
---|---|---|
0 | 正常終了 | 入力したトレースファイルのすべてのデータを入力・編集し終わりました。 |
1 | 異常終了 |
|
不定 | 異常終了 | シグナルに割り込まれました(hdstrceditコマンドではシグナルをハンドリングしません)。 |
注意
出力形式
稼働トレースファイルで取得したレコードが正常のときは,編集されて出力されます。トレースファイルの編集結果の例を次に示します。
表7-17 プロセスコードの一覧
プロセスコード | プロセス名 |
---|---|
TRCR ※ | トレース情報収集プロセス |
MSTR | 抽出マスタプロセス,又は反映マスタプロセス |
NMST | 抽出ノードマスタプロセス |
SNDR | 送信プロセス |
SNDM | |
SNDC | |
CAPT | 抽出プロセス |
RCVT | 受信プロセス(TCP/IP通信) |
RCVO | 受信プロセス(OSI通信) |
DEFS | 反映定義サーバプロセス |
RFCT | 反映プロセス |
SQLE | 反映SQLプロセス |
UOCG | 反映UOCプロセス |
表7-18 プロセスコードと識別名の関係
プロセス コード | Cpnに表示される値 | トレース レベル | 意 味 | 同時に出力される付加情報 |
---|---|---|---|---|
TRCR | QRCVST | GL | 稼働トレース取得の開始 | メッセージキューのID |
MSTR | R_INIT | GL | INITENV(初期化)要求発行トレース取得 | 要求種別,要求対象 |
R_STRT | GL | START要求発行トレース取得 | 要求種別,要求対象 | |
R_STOP | GL | STOP要求発行トレース取得 | 要求種別,要求対象 | |
R_STTE | GL | STATE要求発行トレース取得 | 要求種別,要求対象 | |
R_WTCH | GL | WATCH(監視)要求発行トレース取得 | 要求種別,要求対象 | |
NMST | R_INIT | GL | INITENV(初期化)要求受付トレース取得 | - |
R_STRT | GL | START要求受付トレース取得 | 要求種別,要求対象 | |
R_STOP | GL | STOP要求受付トレース取得 | 要求種別,要求対象 | |
R_STTE | GL | STATE要求受付トレース取得 | 要求種別,要求対象 | |
R_WTCH | GL | WATCH(監視)要求受付トレース取得 | 要求種別,要求対象 | |
SNDR | SNDSTR | ST | 送信プロセスの開始 | 「hdesender start」を表示 |
SNDPPT | P1 | ポートチェック送信性能の取得 | 「Send performance: port check send」を表示 | |
SNDPDF | P1 | 抽出定義送信性能の取得 | 「Send performance: extract definition send」を表示 | |
SNDPTW | P2 | トランザクション管理性能の取得 | 「Send performance: transaction watch」を表示 | |
SNDPEX | P1 | 更新情報送信性能(送信間隔中の全送信)の取得 | 「Send performance: send interval」を表示 | |
SNDEND | ST | 送信プロセスの終了 | 「hdesender stop」を表示 | |
SNCPSD | P1 | 更新情報送信性能(1回分のデータ送信だけ)の取得 | 送信分割種別,送信トランザクション数,更新情報数,バイト数を表示 | |
SNCPAU | P2 | ADTコンストラクタ情報生成UOCの性能取得 | 「ADT UOC call」を表示 | |
SNCPLB | P2 | キューファイル格納形式の組み立て性能の取得 | 「EB Log」を表示 | |
SNCPLC | P2 | キューファイル格納形式の組み立て性能の取得 | 「EC Log」を表示 | |
SNCPUC | P2 | 送信判定UOCの性能取得 | UOCからの戻り値を表示 | |
SNCPCV | P2 | 送信データ編集の処理性能取得(繰返し列) | 「hde_edt_extcnv2() call」を表示 | |
SNCPCV | P2 | 送信データ編集の処理性能取得 | 「hde_edt_extcnv() call」を表示 | |
SNDLYT | P1 | 送信滞留時間の取得 | 滞留時間 | |
SNDM | SNMSTR | ST | 抽出ノードマスタプロセスの開始 | 「hdesenmst start」を表示 |
SNMEND | ST | 抽出ノードマスタプロセスの終了 | 「hdesenmst end」を表示 | |
SNDC | SNPSTR | ST | 送信プロセスの開始 | 「hdesndprc start」を表示 |
SNPPEX | P1 | 更新情報送信性能(送信間隔中の全送信)の取得 | 「Send performance: send interval」を表示 | |
SNPEND | ST | 送信プロセスの終了 | 「hdesndprc end」を表示 | |
SNPPPT | P1 | ポートチェック送信性能の取得 | 「Send performance: port check send」を表示 | |
SNPPDF | P1 | 抽出定義送信性能の取得 | 「Send performance: extract definition send」を表示 | |
SNDLYT | P1 | 送信滞留時間の取得 | 滞留時間 | |
CAPT | REDINI | ST | プロセス起動直後のREAD開始ポイントの取得 | READポイント情報(バイナリ形式) |
SYNCQU SYNCRD | LC | READ,WRITEポイント同期処理トレース | システムログREADポイント,キューファイルWRITEポイント | |
CMDTRC | LC | コマンド受付トレース | コマンド要求内容 | |
CPDLYT | P1 | 抽出滞留時間の取得 | 滞留時間 | |
RCVT | RCVDP1 | P1 | データの受信 | データ受信状態 |
TCPSOP | ER | socketオープンエラー | 関数リターン値,errno | |
TCPSOP | GL | socketオープン終了 | 関数リターン値 | |
TCPSBN | ER | bindエラー | 関数リターン値,errno | |
TCPSBN | GL | bind終了 | 関数リターン値 | |
TCPSLI | GL | listen結果 | 関数リターン値 | |
TCPSCP | GL | accept待ち | - | |
TCPSCP | GL | acceptリターン | 関数リターン値,errno | |
TCPFRK | GL | forkエラー | 関数リターン値,errno | |
RCVO | OSITOP | GL | t_open結果 | 関数リターン値,errno |
OSITBN | GL | t_bind終了 | 関数リターン値,errno | |
OSITAL | GL | t_alloc終了 | 関数リターン値,errno | |
OSITLI | GL | t_listen待ち | - | |
OSITLI | GL | t_listen結果 | 関数リターン値,errno | |
OSITOP | GL | t_open結果 | 関数リターン値,errno | |
OSITBN | GL | t_bind結果 | 関数リターン値,errno | |
OSITAC | GL | t_accept結果 | 関数リターン値,errno | |
OSIFRK | GL | fork結果 | 関数リターン値,errno | |
DEFS | DFINIT | ST | プロセス起動 | データ連動識別子 |
DFEXIT | ST | プロセス停止 | - | |
DEFMKP | LE | 子プロセス起動(INIT) | イベントコード,プロセスID | |
DEFMKP | LC | 子プロセス起動(NORMAL) | イベントコード,プロセスID | |
DEFMKP | LC | 子プロセス起動(RERUN) | イベントコード,プロセスID | |
DEFCOM | LC | コマンド入力検知 | コマンド名 | |
DEFMKP | LC | 子プロセス起動(イベント) | イベントコード,プロセスID | |
DEFMKP | LC | 子プロセス起動(hdsstop) | イベントコード,プロセスID | |
RFCT | RFINIT | ST | 反映プロセス開始 | Datareplicator識別子,データ連動識別子 |
EVSTOP | GL | 前回イベント停止による停止 | イベントID | |
IMSTOP | GL | 開始処理中Immediate停止 | - | |
RFSTRT | GL | 反映処理開始 | 開始モード,キューファイルオフセット | |
RFSIGS | LE | シグナルの受信 | 受信シグナル | |
RFQGET | P1 | キューファイルの終端を検知 | キューファイルオフセット | |
RFQGET | P1 | キューファイルデータを入力 | キューファイルオフセット,更新情報(先頭128バイト) | |
RFTRNC | P1 | 更新情報中のトランザクションエントリ表示 | トランザクションカウンタ,トランザクション内更新情報数 | |
EVENTC | LE | イベントの検知 | イベントID,プロセス状態コード1,2 | |
RFTERM | ST | 反映プロセスの停止 | 終了モード,キューファイルオフセット | |
RFPIPR | P2 | SQL実行結果の受信 | 送信先エントリ,readサイズ又はリターンコード | |
RFPIPW | P2 | SQL実行指示の反映SQLプロセス又はUOCプロセスへの送信 | 送信先エントリ,writeサイズ,SQL組み立て情報(先頭128バイト) | |
RFRCVR | P1 | リラン実行時のトランザクション回復実行結果(2相コミットだけ) | リターンコード | |
RFCOMT | P1 | COMMIT結果 | COMMIT発生要因,リターンコード | |
RFENDC | P1 | END/DISCONNECT結果 | 種別,リターンコード | |
RFEXIT | ST | 反映プロセスの停止 | 種別,リターンコード | |
RFDLYT | P1 | 反映滞留時間の取得 | 滞留時間 | |
SQLE | SQINIT | ST | プロセスの起動 | 開始モード(dsid,グループ名,分割番号) |
SQEXIT | ST | プロセスの停止 | 終了モード(NORMAL,FORCE,ERROR) | |
SQEREQ | GL | 停止要求の受付 | - | |
XARERN | LC | リカバリ実行(2相コミット方式) | リカバリ種別 | |
TRETRY | LC | トランザクションリトライ | - | |
CNCT_S | P2 | connect実行前 | - | |
CNCT_E | P2 | connect実行後 | SQLCODE | |
PINS_S | P2 | prepare(insert)実行前 | SQL文(最大127バイト) | |
PINS_E | P2 | prepare(insert)実行後 | SQLCODE | |
PUPD_S | P2 | prepare(update)実行前 | SQL文(最大127バイト) | |
PUPD_E | P2 | prepare(update)実行後 | SQLCODE | |
PDEL_S | P2 | prepare(delete)実行前 | SQL文(最大127バイト) | |
PDEL_E | P2 | prepare(delete)実行後 | SQLCODE | |
EINS_S | P2 | execute(insert)実行前 | 表名 | |
EINS_E | P2 | execute(insert)実行後 | SQLCODE | |
EUPD_S | P2 | execute(update)実行前 | 表名 | |
EUPD_E | P2 | execute(update)実行後 | SQLCODE | |
EDEL_S | P2 | execute(delete)実行前 | 表名 | |
EDEL_E | P2 | execute(delete)実行後 | SQLCODE | |
EXEI_S | P2 | execute immediate実行前 | SQL文(最大127バイト) | |
EXEI_E | P2 | execute immediate実行後 | SQLCODE | |
CMIT_S | P2 | commit実行前 | - | |
CMIT_E | P2 | commit実行後 | SQLCODE | |
RLBK_S | P2 | rollback実行前 | - | |
RLBK_E | P2 | rollback実行後 | SQLCODE | |
XAOP_S | P2 | xa_open()実行前 | - | |
XAOP_E | P2 | xa_open()実行後 | xa_open()戻り値 | |
XAPR_S | P2 | xa_prepare()実行前 | ||
XAPR_E | P2 | xa_prepare()実行後 | xa_prepare()戻り値 | |
XACM_S | P2 | xa_commit()実行前 | ||
XACM_E | P2 | xa_commit()実行後 | xa_commit()戻り値 | |
XARL_S | P2 | xa_rollback()実行前 | - | |
XARL_E | P2 | xa_rollback()実行後 | xa_rollback()戻り値 | |
DISC_S | P2 | disconnect実行前 | - | |
DISC_E | P2 | disconnect実行後 | SQLCODE | |
SQPIPR | P2 | 更新情報読み込み | 要求種別,readサイズ | |
PWRT_A | P2 | PRE-C結果送信 | 実行結果,writeサイズ | |
SQPIPW | P2 | COMMIT結果送信 | 実行結果,writeサイズ | |
CUOC_S | P2 | 列UOC実行前 | 列UOC関数種別 | |
CUOC_E | P2 | 列UOC実行後 | 列UOC関数種別,列UOC関数実行結果 | |
CUOC_S | P2 | 列UOC実行前 | 列UOC関数種別 | |
CUOC_E | P2 | 列UOC実行後 | 列UOC関数種別,列UOC関数実行結果 | |
SQPIPW | P2 | 更新(同期点まで)実行結果の送信 | 実行結果,writeサイズ | |
UOCG | UCINIT | ST | プロセスの開始 | 開始モード |
UCEXIT | ST | プロセスの停止 | 終了モード(NORMAL,FORCE,ERROR) | |
UBE1_S | GL | hds_ubegin()呼び出し | - | |
UEDT_S | GL | hds_uedit()呼び出し | - | |
UEND_S | GL | hds_uend()呼び出し | - | |
UCPIPR | P2 | SQL実行指示読み込み | - | |
UBE1_E | P2 | hds_ubegin()戻り | - | |
UEDT_E | P2 | hds_uedit()戻り | - | |
UEND_E | P2 | hds_uend()戻り | - | |
UCPIPW | P2 | 更新(同期点まで)実行結果送信 | - | |
UCEREQ | GL | 停止要求受付 | - |
出力例
反映側Datareplicatorで稼働トレースを取得した例を次に示します。ここで示す稼働トレースは,次に示す条件で取得したとします。
稼働トレース取得レベルに「p2」を指定して,hdstrceditコマンド実行時に-l perf2を指定すると,上記の情報に加えてSQL単位の発行・完了時刻が出力されます。