PLIDUMP の使用

この節では、PLIDUMP を呼び出すのに使用するダンプ オプションと構文について説明します。また、プログラムをデバッグする際に役立つ、ダンプに含まれる PL/I 固有の情報についても説明します。

次に、PLIDUMP を呼び出して、プログラム環境ダンプを生成する PL/I ルーチンの例を示します。この例では、メイン ルーチンの PLIDMP が PLIDMPA を呼び出し、その後 PLIDMPA が PLIDMPB を呼び出します。PLIDUMP の呼び出しは、ルーチン PLIDMPB で作成されます。

%PROCESS MAP GOSTMT SOURCE STG LIST OFFSET LC(101);
PLIDMP:PROC OPTIONS(MAIN) ;

Declare   (H,I) Fixed bin(31) Auto;
Declare   Names Char(17) Static init('Bob Teri Bo Jason');
H = 5;   I = 9;
Put skip list('PLIDMP Starting');
Call PLIDMPA;

PLIDMPA:PROC;
Declare (a,b) Fixed bin(31) Auto;
a = 1;   b = 3;
Put skip list('PLIDMPA Starting');
Call PLIDMPB;

PLIDMPB:PROC;
Declare  1 Name auto,
2 First   Char(12) Varying,
2 Last    Char(12) Varying;
First = 'John';
Last = 'Thompson';
Put skip list('PLIDMPB Starting');
Call PLIDUMP('TBFC','PLIDUMP called from procedure PLIDMPB');
Put Data;
End PLIDMPB;
End PLIDMPA;
End PLIDMP;

この節では、全体を通して上記の例を参照します。

PLIDUMP を使用する場合は、次の点を考慮してください。

• 1 つのルーチン内で PLIDUMP を複数回呼び出す場合は、それぞれの PLIDUMP 呼び出しに一意のユーザー識別子を使用してください。こうすることで、各ダンプの開始を容易に識別できるようになります。
• ddname PLIDUMP の DD 文を使用して、ダンプのデータ セットを定義することができます。このような DD 文によって定義されたデータ セットは、300/304 以上の論理レコード長 (LRECL) を指定して、ダンプ レコードのラッピングを回避してください。このような DD のターゲットとして SYSOUT を使用する場合は、MSGFILE(SYSOUT,FBA,300,0) または MSGFILE(SYSOUT,VBA,304,0) を指定して、行のラッピングを回避してください。
• ダンプ トレースバック テーブルに、プログラム ユニット名、プログラム ユニット アドレス、およびプログラム ユニット オフセットを正しくリストするには、-debug オプションを使用して PL/I プログラムをコンパイルする必要があります。-debug オプションは、-opt または -opt3 オプションと併用できます。
• 生成される .stb ファイルは、.exe、.dll、または .so ファイルと同じ場所か、あるいは環境変数 CODEWATCH_STBPATH で指定されている場所に格納されます。それ以外の場合、PLIDUMP によって生成されたダンプには、役に立つ情報は含まれません。

PLIDUMP を使用して PL/I ルーチンのダンプを生成することは、システム プラットフォーム間の移植性の確保に役立ちます。