HFZLANGP ユーティリティーを使用したサイド・ファイルのフォーマット

HFZLANGP ユーティリティーは、LANGX サイド・ファイル、SYSDEBUG サイド・ファイル、またはプログラム・オブジェクトの DWARF デバッグ情報から読み取り可能なリストを作成できます。このユーティリティーは、インストールでコンパイラー・リストではなくサイド・ファイルを保持することによって DASD スペースを維持する場合に便利です。ユーティリティーからの出力は元のコンパイラー・リストに類似しています。

HFZLANGP ユーティリティーは次の入力を形成します。

LANGX サイド・ファイル。
PL/I TEST(SEPARATE) コンパイラー・オプションで生成された SYSDEBUG サイド・ファイル (Enterprise PL/I)。
COBOL TEST(SEPARATE) オプションで生成された SYSDEBUG サイド・ファイル (バージョン 5 より前の Enterprise COBOL)。
TEST(SOURCE) または NOTEST(SOURCE) オプションで生成された DWARF デバッグ情報が入っているプログラム・オブジェクト (バージョン 5 以降の Enterprise COBOL)。
COBOL TEST(SEPARATE SOURCE) または NOTEST(SEPARATE SOURCE) オプションで生成された SYSDEBUG サイド・ファイル (Enterprise COBOL バージョン 6)。

ライン・コマンドとして HFZLANGP の呼び出し

次に対して HFZLANGP ユーティリティーを ISPF オプション 3.4 (データ・セット・リスト・ユーティリティー) ライン・コマンドとして呼び出すことができます。

順次 LANGX サイド・ファイル
COBOL または PL/I SYSDEBUG サイド・ファイル・データ・セット
区分データ・セットのメンバー

Enterprise COBOL バージョン 5 では、PDSE ロード・ライブラリーのプログラム・オブジェクト・メンバーに対して HFZLANGP を実行することができます。

COBOL または PL/I の SYSDEBUG サイド・ファイルの順次データ・セットが使用される場合、あるいは COBOL または PL/I の SYSDEBUG サイド・ファイルの区分データ・セットのメンバーが、そこに含まれる名前 (PROGRAM-ID) 付きプログラムのどれとも一致しない場合、HFZLANGP ユーティリティーによってプログラム名を指定できるプロンプトが表示されます。

COBOL バージョン 5 プログラム・オブジェクトに複数のコンパイル単位が含まれている場合、HFZLANGP ユーティリティーによって望ましいプログラムを選択するようプロンプトが出されます。

メンバー名と一致するかどうかに関係なく、順次データ・セットまたは区分データ・セット・メンバーに含まれている、すべての LANGX サイド・ファイルが表示されます。

出力は一時データ・セットに書き込まれ、ISPF EDIT を使用して表示されます。

ISPF インターフェースを介した HFZLANGP ユーティリティーの呼び出し

Z Abend Investigator ISPF インターフェースから HFZLANGP ユーティリティーを呼び出すことができます。サービスのメニュー・バーのプルダウン・メニューを使用して、「HFZLANGP サイド・ファイル・フォーマット・ユーティリティー」オプションを選択します。プロンプトで、形成するデータ・セットを指定します。出力は ISPF に表示されますが、COPY コマンドを使用してデータ・セットにコピーすることができます。

バッチ・ジョブとしての HFZLANGP ユーティリティーの呼び出し

次の例に類似する、HFZLANGP ユーティリティーをバッチ・ジョブとして呼び出すことができます。


//PRTLANGX JOB ...
//STEP1    EXEC PGM=HFZLANGP,PARM='parms'
//SYSPRINT DD   SYSOUT=*Copy

フォーマットされたリストは、SYSPRINT DD に書き込まれます。変数がブロックされたレコード・フォーマットや論理レコード長 137 などの通常のリスト・ファイル属性は、ほとんどの場合適切です。

HFZLANGP パラメーター

HFZLANGP に渡される PARM ストリングは、以下を含みます。

図 1. Syntax

data_set_name

LANGX サイド・ファイル、あるいは COBOL または PL/I の SYSDEBUG サイド・ファイルの順次データ・セットの名前。また、データ・セットが区分データ・セットの場合 (COBOL バージョン 5 プログラム・オブジェクトのケース)、括弧で囲まれたメンバー名付きのデータ・セット名。例:


MY.SYSDEBUG.SEQ.DS


MY.IPVLANGX.PDS.DS(MYPROG)

program_name

COBOL または PL/I の SYSDEBUG サイド・ファイル、あるいは COBOL バージョン 5 プログラム・オブジェクトの中に入っている、PROGRAM-ID で指定されたプログラムの名前。COBOL または PL/I の SYSDEBUG サイド・ファイル・データ・セットが順次データ・セットである場合、あるいは区分データ・セットのメンバー名が、そこに含まれるどのプログラム名とも一致しない場合、この名前を指定する必要があります。