4.2.23 xnftraceトレースを採取する

<この項の構成>
(1) 形式
(2) 機能
(3) 実行者
(4) オプション
(5) 注意事項
(6) 使用例

(1) 形式

/etc/xnftrace〔-s|-e〕 〔-x キーワード 〔-a 内部名称〕|-n 名称〕
            〔-f ファイル名称〔-w ラップアラウンド長〕〕 〔-H〕
            〔-O トレースオプション〕 〔-l 回線トレースデータ長〕

(2) 機能

トレースを採取して,ファイルに出力します。

複数のリソースのトレースを同時に採取することもできます。このとき,出力先のファイルには,複数のリソースのトレース情報が出力されます。同時に複数の出力ファイルを設定することはできません。

(3) 実行者

スーパユーザ

(4) オプション

(a) -s

トレースの採取を開始します。

-eオプションと同時には指定できません。

(b) -e

トレースの採取を終了します。

-x,および-nオプションを指定しない場合,すべてのトレースを終了します。-sオプションと同時には指定できません。

(c) -x キーワード

特定のキーワードに対応する,トレース採取を開始または終了するときに指定します。

-nオプションと同時には指定できません。

-xオプションで指定できるキーワードを次に示します。

hsc:
回線アダプタに接続されたHSC1およびHSC2手順回線のAPIトレース
ncsb:
回線アダプタに接続されたNCSB手順回線のAPIトレース
hdlc:
HDLCパススルーのAPIトレース
nli:
X.25パススルーのAPIトレース
osas:
OSI通信機能のAPIトレース
hna1:
HNA1次局のAPIトレース
hna1log:
HNA1次局の内部トレース
ncam:
HNA2次局のNCAM APIトレース
slus:
HNA2次局のSLUS APIトレース
layerw:
各通信機能のレイヤ・マネージャートレース
osiex:
OSI拡張機能のソケットトレース
(d) -a 内部名称

このオプションは,-xオプションに,ncsb,hsc,またはhna1logを指定した場合だけ指定できます。

ncsb,またはhscの場合,回線を特定してトレース採取するときに使用し,内部名称には内部AP名称(回線名称)を指定します。

hna1logの場合,PUを特定してトレース採取するときに使用し,内部名称にはPU名称を指定します。

-xオプションでhscまたはncsbを指定した場合,このオプションは省略できません。

-xオプションでhna1logと指定し,-aオプションを省略すると,HNA1次局内の全内部トレースを取得します。

(e) -n 名称

特定のリソース名称を指定して,トレース採取を開始または終了するときに指定します。

-xオプションと同時には指定できません。

リソース名称に指定できるリソース種別を次に示します。

(f) -f ファイル名称

トレースを出力するファイル名称を指定します。

このオプションは,最初のトレース開始時に必ず指定してください。トレース採取中に,異なるリソースのトレース採取を開始する場合は,このオプションは省略してください。-eオプションと同時には指定できません。

指定したファイルがない場合,ファイルが新規に作成されます。すでにある場合には上書きされます。

トレース採取中に,トレース出力ファイルを切り替えることができます。切り替え方法を次に示します。

ファイル切り替え時,-fオプションで現在使用している出力ファイルと同じファイルを指定すると,ファイルの切り替えはしません。また,ラップアラウンド長の変更もできません。

(g) -w ラップアラウンド長

トレースファイルのラップアラウンド長を指定します。-fオプションを指定した場合,指定できます。ラップアラウンド長は,480KBを1単位とする整数値で,指定範囲は1~255です(例えば2を指定すると,480KB×2=960KBがファイル容量になります)。

このオプションを省略した場合,1が仮定されます。なお,1KB=1024バイトの計算値です。

(h) -H

回線アダプタが採取する,回線のハードウェアトレースを開始および終了する場合に指定します。

このオプションを指定しない場合,XNF/ASが採取するトレース(ソフトウェアトレース)が対象となります。

-Hオプションは,-nで回線アダプタに接続された回線名称を指定したときだけ有効となります。

(i) -O トレースオプション

採取するトレースを変更するために使用します。トレース採取対象によって機能が異なります。

トレース採取対象と-Oオプション指定値の組み合わせによって,次のトレースを採取できます。

0,1以外の値を指定した場合,0を指定したときと同じ扱いとなります。また,上記以外で-Oオプションを指定した場合は無視されます。

(j) -l 回線トレースデータ長

採取するソフトウェアトレースの回線トレースデータ長の最大値を指定します。回線トレースデータ長の指定範囲は3~1015(バイト)です。このオプションを省略した場合,1015が仮定されます。

-sオプションと-nオプションで,ハイレベル手順用の回線アダプタに接続された回線名称を指定した場合,有効になります。

-Hオプションまたは-Oオプションを指定した場合,指定した値は無効になります。

(5) 注意事項

  1. 採取したデータトレースは,xnfeditコマンドで編集して参照できます。ただし,xnfeditコマンドで編集する場合,トレース採取中のファイルは指定できません。必ず,xnftraceコマンドに-eオプションを指定してトレースの採取を停止したファイルを編集してください。
  2. 回線アダプタが採取する回線のハードウェアトレースは,回線アダプタ1台につき,4回線まで採取できます。
  3. オプションを何も指定しなかった場合,トレース採取中のリソースの名称,キーワード,ファイル名称,およびラップアラウンド長を表示します。
  4. トレースファイルの切り替えをしたときは,KANC309-Iメッセージが表示されます。
  5. -xオプションでhna1logを指定し,-aオプションでPU名を指定して取得したトレースは,xnfeditコマンドで-xオプションにhna1logだけを指定した場合でも編集されます。
  6. ゲートウェイシステムでOSI拡張機能を使用する構成の場合,OSI拡張機能のソケットトレースを取得(-xオプションでキーワードにosiexを指定)するには,configuration文のmax_TPTCP_connectionオペランドの指定が必要です。

(6) 使用例

(例1)
回線アダプタに接続された回線(LINE01),トレース(ソフトウェアトレースとハードウェアトレース),およびHDLCパススルーのAPIトレースを採取します。トレースファイルはfile1を使用します。

/etc/xnftrace -s -n LINE01 -f file1   ... LINE01のソフトウェアトレース採取,
                                         -fオプション必要
/etc/xnftrace -s -n LINE01 -H    ........ LINE01のハードウェアトレース採取,
                                         -f指定不要
/etc/xnftrace -s -x hdlc   .............. HDLCパススルーのAPIトレース採取,
                                         -f指定不要
<トレース採取>
     :
/etc/xnftrace -e -x hdlc    .......... HDLCパススルーのAPIトレース採取停止
/etc/xnftrace -e -n LINE01 -H   ...... LINE01のハードウェアトレース採取停止
/etc/xnftrace -e -n LINE01   ......... LINE01のソフトウェアトレース採取停止

(例2)
OSI通信機能のAPIトレースおよびX.25パススルーのAPIトレースを採取します。トレースファイルはfile1を使用します。

/etc/xnftrace -s -x osas -f file1   ... OSI通信機能のAPIトレース採取,
                                       -fオプション必要
/etc/xnftrace -s -x nli     ........... X.25パススルーのAPIトレース採取
<トレース採取>
     :
/etc/xnftrace -e -x osas    ........... OSI通信機能のAPIトレース採取停止
/etc/xnftrace -e -x nli    ............ X.25パススルーのAPIトレース採取停止

(例3)
トレース採取中に,トレースファイルを切り替えます。また,全トレースを一括して停止させます。

/etc/xnftrace -s -n LA01 -f file1   .......... file1にトレース採取
/etc/xnftrace -s -n LINE01
/etc/xnftrace -s -n LINE02 -f file2 -w 5   ... file2に切り替え,ファイル容量も変
                                              更します。これ以降LA01,LINE01,
                                              およびLINE02のトレースはfile2に
                                              出力します。
<トレース採取>
    :

/etc/xnftrace -e   ........................... 全トレースを一括して停止
                                              (LA01,LINE01,およびLINE02の全
                                              トレースが停止)

(例4)
トレース採取中のリソース名称,キーワード,ファイル名称,およびラップアラウンド長を表示します。
入力形式:

/etc/xnftrace

出力形式:

+------------------------------------------------------+
リソース名称(H)※1                リソース名称(H)※1
      :                                :
+------------------------------------------------------+
キーワード※2
+------------------------------------------------------+
キーワード(内部名称)※3           キーワード(内部名称)※3
+------------------------------------------------------+
*** trace file name(wraparound size) ***
トレースファイル名称(ラップアラウンド長)

注※1
(H)は,回線アダプタに接続された回線のハードウェアトレースを採取している場合に表示されます。
注※2
xnftraceコマンドで-xオプションを指定したキーワードを表示します。
注※3
HSC1,HSC2,NCSB手順回線,およびHNA1次局で内部AP名称を指定して,トレースを採取している場合に表示されます。
出力例:

/etc/xnftrace

+----------------------------------------------------------+
LA01                                    line101
line101(H)                              bline01
bline02(H)
+----------------------------------------------------------+
osas
+----------------------------------------------------------+
ncsb (bline01)                           ncsb (bline02)
+----------------------------------------------------------+
*** trace file name(wraparound size) ***
/trace/file01(1)

(例5)
HNA2次局のNCAM APIのトレースおよびSLUS APIのトレースを採取します。トレースファイルはfile1を使用します。

/etc/xnftrace -s -x ncam -f file1   ... NCAM APIのトレース採取
/etc/xnftrace -s -x slus    ........... SLUS APIのトレース採取
<トレース採取>
     :
/etc/xnftrace -e -x ncam    ........... NCAM APIのトレース採取停止
/etc/xnftrace -e -x slus   ............ SLUS APIのトレース採取停止

(例6)
HNA1次局のAPIのトレース,HNA1次局PU(PU1)の内部トレース,またはHNA1次局の全PUの内部トレースを採取します。トレースファイルはfile1を使用します。

/etc/xnftrace -s -x hna1 -f file1   .... HNA1次局のAPIのトレース採取
/etc/xnftrace -s -x hna1log -a PU1   ... PU(PU1)の内部トレース採取
      または
/etc/xnftrace -s -x hna1log    ......... HNA1次局の全PUの内部トレース採取
<トレース採取>
     :
     :
/etc/xnftrace -e -x hna1log    ......... 全PUの内部トレース採取停止
      または
/etc/xnftrace -e -x hna1log -a PU1   ... PU(PU1)の内部トレース採取停止
/etc/xnftrace -e -x hna1   ............. HNA1次局のAPIトレース採取停止

(例7)
回線アダプタに接続された回線(LINE01)のトレース(ソフトウェアトレース)を採取します。採取するトレースデータ長は500バイトで,トレースファイルはfile1を使用します。

/etc/xnftrace -s -n LINE01 -f file1 -l 500   .... LINE01のソフトウェアトレース採取,
                                                 -f,-lオプション必要
<トレース採取>
     :
     :
/etc/xnftrace -e -n LINE01   .................... LINE01のソフトウェアトレース採取
                                                 停止