DEBug サブコマンド - 汎用トレース・オプションの設定

目的

DEBug サブコマンドは、汎用内部トレースを使用可能あるいは使用不可にするために使用します。

パラメーター

次のオプションのうちの 1 つ以上を指定できます。

?

トレースの状況を表示します。

ACC

ACC トレースは、ログイン・プロセスの詳細を示します。

ALL

このパラメーターは、トレース・ポイントのすべてを設定するために使用します。

注: ALL パラメーターが処理されると、FSC トレースと SOC トレースが両方ともレベル 1 に 設定されます。

BAS

このパラメーターは、トレースの一部の詳細情報を伴わない 最善総合デバッグ・データを提供する、トレースの選択グループを設定する場合に使用します。 このパラメーターの指定は、DEBUG CMD INT FSC SOC と同じことです。

CMD

CMD トレースは、それぞれのコマンド、およびコマンドのパラメーターの構文解析を示します。

FLO

FLO トレースは、FTP 内の制御のフローを示します。FTP 要求に対して使用される FTP の サービスを示す場合に有用です。

FSC(n)

FSC トレースは、ファイル・サービス・サブコマンド APpend、PUt、Get、 MGet、および MPut の処理の詳細を表示します。このトレースでは、非常に詳細な情報が生成できるので、トレース・ポイントに関して詳細のレベルを指定できます。

FSC または FSC(1) と入力することで指定されるレベル 1 トレースは、追加のデータ が TCP/IP サービス・グループによって要求されない限り、通常使用される レベルです。レベル (n) には、1 から 8 の数値が使用できます。

INT

INT トレースは、サーバーとの FTP セッションの初期化と終了の詳細を示します。

NONE

このパラメーターは、トレースのすべてをオフにするのに使用します。

PAR

PAR トレースは、FTP コマンド構文解析プログラムの詳細を示します。コマンド・パラメーター の処理での問題のデバッグに役立ちます。

SEC

SEC トレースは、TLS および GSSAPI ネゴシエーションなどのセキュリティー機能の処理を示します。

SOC(n)

SOC トレースは、FTP アプリケーションとネットワークの間のインターフェースの セットアップ中の処理の詳細を、処理されるデータの実際量の詳細と共に示します。

このトレースでは、非常に詳細な情報が生成できるので、トレース・ポイントに関して詳細のレベルを指定できます。レベル (n) には、1 から 8 の数値が使用できます。

SQL

SQL トレースは、SQL 要求 (例えば、LOCSIte FILETYPE=SQL が有効であるときの要求) に関する 処理の詳細を示します。

TIMestamps

これは、それぞれのトレース・エントリーごとに、そのエントリーが記入された時刻を示す タイム・スタンプを要求する場合に使用される特殊パラメーターです。これが有用なのは、長い実行ファイル転送時であり、転送の所要時間を追跡し、クライアント・トレースを、やはりタイム・スタンプがあるサーバー・トレースに突き合わせる場合です。

UTL

UTL トレースは、LCd および LOCSIte などのユーティリティー機能の処理を示します。

Xyyy

この構文は、yyy によって命名されるトレースをオフにする (リセットする) のに使用します。 例えば、DEBUG XPAR XACC は、PAR トレースおよび ACC トレースをオフにします。

使用法

• トレースは、以前の製品リリースで使用されている DEBug パラメーター 1 および 2 をサポートします。DEBug BAS を指定すると、パラメーター 1 が以前に提供していたものと同じトレースが提供されます。パラメーター 2 が以前に提供していた 拡張トレースは、現在は、DUMP サブコマンドで得られるようになっています。
• トレース・ポイントの状態は、DEBug サブコマンドに対する応答として 表示されます。変更を加えないで状態を確認する場合は、DEBUG ? と入力します。
• トレースの設定は、次に示されているように付加的です。

          DEBUG NONE CMD 
          EZA2851I Active traces: CMD
          DEBUG PAR
          EZA2851I Active traces: CMD PAR

• パラメーターを指定しないで DEBug と入力すると、トレースのオン / オフが切り替わります。トレース がオフに切り替えられたときのトレースの状態が記憶されて、トレースをオンに切り替えると、直前のトレース設定が復元されます。直前にアクティブのトレースがなかった場合は、切り替えによって BAS トレース・ポイントがアクティブにされます。

         DEBUG NONE CMD                      
         EZA2851I Active traces: CMD         
         DEB                                 
         EZA2851I Active traces:  NONE       
         DEB                                 
         EZA2851I Active traces: CMD
         DEB FSC                             
         EZA2851I Active traces: CMD FSC(1)           
         DEB                                         
         EZA2851I Active traces:  NONE               
         DEB                                         
         EZA2851I Active traces: CMD FSC(1)           
         DEB NONE                                    
         EZA2851I Active traces:  NONE               
         DEB                                         
         EZA2851I Active traces: CMD INT FSC(1) SOC(1)

• タイム・スタンプ・オプションを次の例に示します。

         deb fsc(1)                                    
         PC0304 parseCmd: subcommand:  deb            
         PC0307 parseCmd: parameter 1: fsc(1)          
         Active traces: CMD FSC(1)                     
         Command:                                     
         deb time                                     
         PC0304 parseCmd: subcommand:  deb            
         PC0307 parseCmd: parameter 1: time           
         Active traces: CMD FSC(1)                     
         Command:                                     
         deb soc(1)                                    
         11:39:37 PC0304 parseCmd: subcommand:  deb   
         11:39:37 PC0307 parseCmd: parameter 1: soc(1) 
         Active traces: CMD FSC(1) SOC(1)               
         Command: 

• FSC および SOC トレース・オプションの場合は、いずれの時点でも、定義できるトレースのレベル は 1 つだけです。ただし、レベル 2 が定義されていると、レベル 1 および 2 がアクティブです。レベル 3 が定義されていると、レベル 1、2、および 3 がアクティブです。レベル 4 および 5 について も、これと同じことが該当します。

         deb fsc(2) soc(1)              
         Active traces: FSC(2) SOC(1) 
         Command:                     
         deb fsc(1) soc(2)             
         Active traces: FSC(1) SOC(2)  
         Command:                     

FTP クライアント・トレースについて詳しくは、「z/OS Communications Server: IP Diagnosis Guide」の『Diagnosing FTP client problems with tracing』を参照してください。