パネル・トレース・コマンド (ISPDPTRC)

ISPDPTRC コマンドは、 現行 ISPF セッションの画面内で実行されるダイアログ・マネージャーのパネル処理をトレースします。 ユーザーは、パネル・サービス呼び出し (DISPLAY、TBDISPL、および TBQUERY) の実行、および、 ダイアログ・マネージャーのパネル・コード内で実行される処理 (パネルの )ABCINIT、)ABCPROC、)INIT、)REINIT、および )PROC セクション内のステートメントの処理を含む) の両方をトレースできます。

トレースの結果の出力は、 動的に割り振られる VB (可変ブロック化) データ・セット (レコード長は 255) に書き込まれます。 DD 名 ISPDPTRC が事前割り振りされる場合、この DD 名が 255 以上のレコード長を持つ順次 VB データ・セットを参照していれば、このデータ・セットが使用されます。

ISPDPTRC コマンドは、トレースが実行されていない場合、これを開始します。 トレースがすでにアクティブな場合は、 ユーザーは ISPDPTRC を使用してトレースを停止し、さらにオプションでトレース出力を表示または編集できます。 ISPDPTRC は、ISPF がアクティブな間に実行する必要があります。

コマンドの構文は、次のとおりです。

>>-ISPDPTRC--+-----+--+------+--+------+--+-------+------------->
             '-END-'  '-VIEW-'  '-LIST-'  '-QUIET-'   

>--+-------------------------+---------------------------------->
   +-DSP---------------------+   
   |             .-Both-.    |   
   '-DISPLAY--(--+-None-+--)-'   
                 +-In---+        
                 '-Out--'        

>--+-----------------------------+--+-------------------+--)---->
   +-PNL-------------------------+  |       .-Summary-. |      
   |           .-*----------.    |  '-READ(-+-None----+-'      
   '-PANEL--(--+-panel_name-+--)-'          '-Detail--'        
               '-panel_mask-'                                  

>--+-----------------------------+------------------------------>
   +-SCR-------------------------+   
   |            .-0---------.    |   
   '-SCREEN--(--+-*---------+--)-'   
                '-screen_id-'        

>--+---------------------------------------------------------------+-->
   +-SECT----------------------------------------------------------+   
   |             .-*----.                                          |   
   '-SECTION--(--+-All--+--+--------+--+----------+--+--------+--)-'   
                 '-None-'  +-Init---+  +-Reinit---+  +-Proc---+        
                           '-NOInit-'  '-NOReinit-'  '-NOProc-'        

>--+---------------------------+-------------------------------><
   +-SVC-----------------------+   
   |             .-Detail-.    |   
   '-SERVICE--(--+-None---+--)-'   

ここで、

END

トレースがアクティブな場合に強制終了します。 トレース・データ・セットの編集または表示は行われません。

VIEW

トレースがアクティブな場合は強制終了し、トレース・データ・セットを表示します。 DD ISPDPTRC に対する割り振りがある場合は、このデータ・セットが表示されます。 SYSOUT データ・セットはサポートされていません。

VIEW では、トレース・データ・セットが見つからなかった場合、LIST 処理を実行して、パネル・トレース・データ・セットのリストを表示します。

LIST

このパネル・トレース・コマンドは、データ・セット・リスト・ユーティリティーを起動して、パネル・トレース・データ・セットを表示します。

ユーザーの接頭部がブランクでない場合、表示されるデータ・セット・リストは次の形式のデータ・セットです。

prefix.**.ISPPNL.TRACE

ブランクの場合、表示されるデータ・セット・リストは次の形式のデータ・セットです。

userid.**.ISPPNL.TRACE

QUIET

トレースの初期設定と終了メッセージの表示が行われないようにします。 エラー・メッセージは引き続き画面に表示されます。

DISPLAY

端末に表示されるパネルに類似したトレース・レコードの生成を制御します。 パネルがメモリーの中に読み取られるときのアクティブ画面のパネルだけが表示されます。

なし

トレース・レコードは、パネル表示の処理中に作成されません。

In

パネルを表示するトレース・レコードを生成します。 これには、ユーザーが Enter キーまたはファンクション・キーを押した後に入力されたデータも含まれます。

Out

画面に表示されているパネルを表示するトレース・レコードを生成します。 また、属性バイトも画面表示に表示されます。

Both

In および Out の両方の表示トレースを生成します。 これはデフォルトです。

PANEL

トレース・レコードの生成をパネル名に基づいて制御します。

*

すべてのパネルのトレース・レコードを生成します。 これはデフォルトです。

panel_name

指定されたパネル名のトレース・レコードのみを生成します。

panel_mask

panel_mask に一致するパネルのトレース・レコードを生成します。 マスクには、単一文字を表す % および任意の数の文字を表す * を入れることができます。

注: パネル・サービス呼び出し (DISPLAY、TBDISPL、 および TBQUERY) は、panel_name または panel_mask のどちらのパラメーターを指定したかに関係なく、 すべてのパネルについて引き続きトレースされます。

READ

パネルがメモリーの中に読み取られるときのトレース・レコードの生成を制御します。

なし

読み取り処理中にトレース・レコードは作成されません。

Summary

要約情報を生成します。これには、 パネルがロードされた元 (ISPPLIB データ・セットまたは LIBDEF データ・セット)、 および、)END ステートメントが検出されるまでに読み取られたレコード数が含まれます。 これはデフォルト設定です。

Detail

要約トレースの場合と同じ情報を生成しますが、パネルのソースが含まれます。 また、パネル入力出口によって挿入、変更、および削除された戻りコードおよびパネル・ソース・レコードを表示します。プリプロセス・パネルは表示できません。

SCREEN

トレース・レコードの生成を画面 ID に基づいて制御します。

0

すべての論理画面のトレース・レコードを生成します。 これはデフォルトです。

*

現行画面 ID のトレース・レコードを生成します。

screen_id

指定された論理画面 ID のトレース・レコードのみを生成します。 画面 ID は 1-9、A-W の範囲の単一文字です。

SECTION

さまざまなパネルのロジック・セクションのトレース・レコードの生成を制御します。 デフォルトはすべてのセクションです。

* | All

すべてのセクションのトレース・レコードを生成します。 このパラメーターは、 どちらの形式も単独でのみ指定できますが、その他の SECTION パラメーター値と一緒に指定できません。

なし

パネル処理ロジック・セクションのいずれに対してもトレース・レコードを生成しません。 このパラメーターは単独でのみ指定でき、その他の SECTION パラメーター値と一緒に指定できません。

Init

)ABCINIT セクションおよび )INIT セクションのトレース・レコードを生成します。

Reinit

)REINIT セクションのトレース・レコードを生成します。

Proc

)ABCPROC セクションおよび )PROC セクションのトレース・レコードを生成します。

NOInit

)ABCINIT セクションおよび )INIT セクションのトレース・レコードの生成をオフにします。

NOReinit

)REINIT セクションのトレース・レコードの生成をオフにします。

NOProc

)ABCPROC セクションおよび )PROC セクションのトレース・レコードの生成をオフにします。

SERVICE

パネル処理サービス呼び出し、 すなわち DISPLAY、TBDISPL および TBQUERY のトレース・レコードの生成を制御します。

なし

サービス呼び出し処理中にトレース・レコードは作成されません。

Detail

DISPLAY、TBDISPL、および TBQUERY サービス呼び出しのトレース・レコードを生成し、 すべてのパラメーターを表示します。 トレース・レコードが呼び出し処理の前および後に作成され、 ポスト・レコードがサービスからの戻りコードを表示します。 これはデフォルト設定です。