PLIDEBUG.DAT でのデバッグ設定の定義

注: PLIDEBUG.DAT の使用は、現在 Windows プラットフォームでのみサポートされています。

CodeWatch では、PLIDEBUG.DAT という制御ファイルで個々のプログラムのデバッグ初期設定を指定できます。このファイルは、プログラムがEnterprise Server で初期化されると必ず PL/I ランタイムによって使用されます。そのファイルが Enterprise Server Administrator の [PL/I] タブにある [PL/I Configuration Directory] 設定によりポイントされる場所に存在しない場合は自動的に作成されます。このファイルは Enterprise Developer から編集して、プログラム名、および CodeWatch の起動方法および初期化方法を定義できます。

Enterprise Server で PLIDEBUG.DAT を使用するとき、デバッグ対象のプログラムごとにレコードは 1 つだけです。

重要: 制御レコードは列の影響を受けやすいので、プログラム用のレコードを作成するときは注意してください。対応するレイアウトファイル (PLIDEBUG.STR) が、PL/I の列/データの配置を支援するための Enterprise Server デモにあります。

例：

 --- 0---|--- 10---|--- 20---|--- 30---|--- 40---|--- 50---|--- 60---|--- 70---|--- 80---|--- 90---|
123456789|123456789|123456789|123456789|123456789|123456789|123456789|123456789|123456789|123456789|
TESTPGM1            N 0 SHLIB TESTPGM1.DLL;ENV TESTPGM;BR %ENTRY;BR %EXIT [DET;Q];C

重要: これがデフォルトであるため、開始列は 0 と見なされます。[Data Tools Options] から 1 に変更できます。

この表は、PLIDEBUG.DAT の各レコードに必要な値の概要を示しています。

列	値	説明
0 から 7	`<プログラム名>`	ユーザープログラム名 (ファイル拡張子なし)次に例を示します。TESTPGM1
20	Y/N (はい/いいえ)	プログラムの実行時にデバッガーを起動するかを指定します。デバッガの接続をスキップするには、N を指定します。
22	0/1	エントリのデバッグに使用されるデバッガーの種類。値は次のとおりです。 0 = CodeWatch コマンドラインデバッガーを使用します。 1 = CodeWatch GUI デバッガーを使用します。
24 から nn	`<テキスト文字列>`	制御がユーザーに渡される前に、起動中に CodeWatch によって発行されるデバッガーコマンドの初期セット。

次に例を示します。

TESTPGM1            N 0 SHLIB TESTPGM1.DLL;ENV TESTPGM;BR %ENTRY;BR %EXIT [DET;Q];C 
                       
TESTPGM2            N 1 SHLIB TESTPGM2.DLL;ENV TESTPGM;BR %ENTRY;BR %EXIT [DET;Q];C

Editing PLIDEBUG.DAT

デバッグ設定ファイルを開いて編集するには、次の手順を実行します。

JCL ジョブを実行して PLIDEBUG.DAT ファイルを作成した後、ソリューションエクスプローラーでファイルを右クリックして [Open File in Data Tools] を選択します。Micro Focus Data Tools アプリケーションが起動します。
注: ファイルへの編集がすぐに適用されることを示すメッセージボックスが表示されることがあります。このメッセージが表示されないようにするには、[Do not show this message again] チェックボックスをオンにします。[OK] をクリックします。
PLIDEBUG.DATのレコードエディタを右クリックし、[Insert Indexed Record] を選択します。[Insert Indexed Record] ダイアログボックスが表示されます。
ファイル拡張子を付けずにユーザープログラム名の値を入力します。これはレコードの一意のキーです。[OK] をクリックします。レコードエディタに一意のキーを示す行が表示されます。
新しいレコードの行で 20 桁目をクリックし、プログラムの実行時にデバッガーを開始するかどうかを指定するために Y または N を入力します。
注: 最初の Y が 20 桁目にあることを確認してください。現在の行番号と列番号は、ウィンドウ下部の情報バーに表示されます。これがデフォルトであるため、開始列は 0 と見なされることに注意してください。[Data Tools Options] から 1 に変更できます。開始点が 1 の場合は、最初の Y が 21 桁目にあることを確認してください。
22 桁目をクリックし、0 または 1 を入力して、使用するデバッガーを指定します。
列 24 をクリックして、初期化テキスト文字列の残りの値を入力します。初期化テキスト文字列で使用できるコマンドの詳細については、「CodeWatch コマンド」セクションを参照してください。
注:
データツールのステータスバーには、カーソルの現在の列の位置が表示されます。変更はすぐにファイルに保存されます。

レコードの残りの値を入力し始めると、レコードを編集するかどうかを確認するメッセージボックスが表示されます。[OK] をクリックします。メッセージボックスでファイルの更新警告をオフにすることもできます。