PBK (コピーブックの印刷)

目的
以下にあるフィールド定義を示す報告書を印刷します。
  • コピーブック
  • コピーブックに基づいたテンプレート (Db2® テンプレートではない)
  • 動的テンプレート
  • IMS™ ビュー
  • IMS™ 基準セット
使用上の注意
コピーブックを参照するときには、コピーブックが、区分データ・セット・メンバー、CA-Panvalet ライブラリー・メンバー、または Library Management System Exit を使用してアクセスされるライブラリーに保管されている必要があります。その他のすべてのソース・タイプは、順次データ・セット、区分データ・セット・メンバー、CA-Panvalet ライブラリー・メンバー、または Library Management System Exit を使用してアクセスされるライブラリーに保管できます。
オプション
なし。
関連機能
なし。
図 1. Syntax
(1)
Copybook processing

1! LANG=AUTO
1 LANG=
2.1 COBOL
2.1 PLI
2.1 HLASM
1  %COBOL options
1  %PL/I options
1  %HLASM options
COBOL options

1! DBCS=NO
1 DBCS=YES
1! CDPC=NO
1 CDPC=YES
1! CAE=NO
1 CAE=YES
1 +  RFROMn=operand1 RTOn=operand21
5? CBLADDOP=options
PL/I options

1! BIN63=NO
1 BIN63=YES
1! DEC31=NO
1 DEC31=YES
1! GRAPHIC=NO
1 GRAPHIC=YES
1! UNALIGNED=NO
1 UNALIGNED=YES
1! PLIMAXRC=4
1 PLIMAXRC=num
1 PLILIBS=(+  dsname)
7? PLIADDOP=options
注:
  • 1 n= 1 から 5。
HLASM options

1! DBCS=NO
1 DBCS=YES
1! NOALIGN=NO
1 NOALIGN=YES
1! ASMMAXRC=4
1 ASMMAXRC=num
1 ASMLIBS=(+  dsname)
5? ASMADDOP=options
INPUT=ddname
入力データ・セットの DD ステートメントまたは TSO ALLOC ステートメントに対する参照を定義します。デフォルトは、DDIN です。

連結 DD を指定した場合は、メンバー名 (member) を指定する必要があります。

DSNIN=dsname
コピーブック、テンプレート、IMS™ ビュー、または IMS™ 基準セットが含まれているデータ・セットの名前を指定します。名前に、小括弧で囲んだメンバー名を含めることができます。ここでメンバーを指定する場合は、関連する Member パラメーターを空にする必要があります。
MEMBER=member
dsname が区分データ・セット、CA-Panvalet ライブラリー、 または Library Management System Exit を使用してアクセスされるライブラリーである場合は、メンバー名を指定します。複数のメンバーを印刷するために、パターンを指定できます。入力データ・セットが区分データ・セットの場合に MEMBER パラメーターを省略すると、すべてのメンバーが印刷されます。
ARRAY=YES
配列エレメントのすべての出現箇所を印刷します。
ARRAY=NO
配列エレメントのすべての出現箇所を印刷しません。
HEXLOC=YES
開始値および終了値を 16 進オフセットとして印刷します。
HEXLOC=NO
開始値および終了値を 10 進オフセットとして印刷します。
HEXLEN=YES
長さの値を 16 進数で印刷します。
HEXLEN=NO
長さの値を 10 進数で印刷します。
CRITERIA=YES
テンプレート・レイアウトおよびテンプレート基準情報の両方が報告されます。
CRITERIA=NO
テンプレート・レイアウト情報のみが報告されます (テンプレート基準情報は報告されません)。
MEMLIST
メンバー名のリストを指定できます。
member_n
処理されるメンバーの名前。総称名マスクは使用できます。
INPUT=DDIN
注: 連結 DD を指定した場合は、メンバー名 (member) を指定する必要があります。
Copybook 処理
コピーブックを (既存のテンプレートの代わりに) 指定すると、File Manager はこれらの処理オプションを使用してコピーブックをテンプレートにコンパイルします。
LANG
File Manager が、コピーブックの言語を自動的に検出するか、言語を COBOL、PL/I、または HLASM として解釈するかを決定します。
注: FMN0POPT の COMPLANG 設定は、バッチ関数の LANG パラメーターと同等です。
  • COMPLANG が設定されている場合、オンライン・コンパイルおよびバッチ・コンパイルのインストール・デフォルト言語が決まります。
  • COMPLANG が指定されていない場合、COBOL がオンライン・コンパイルのインストール・デフォルトとなり、AUTO がバッチ・コンパイルのデフォルトとなります。
  • COBOL、HLASM、PL/1、AUTO の値が指定されている場合 (Compiler Language Selection パネルまたはバッチ・ジョブの LANG パラメーターで)、デフォルトの言語よりも優先されます。
AUTO
コピーブックの言語が COBOL であるか、PL/I であるかを自動検出し、該当のコンパイラーを起動します。コンパイルの戻りコードが 4 を超えた場合は、もう一方の言語のコンパイラーを起動します。2 番目のコンパイルでも戻りコードが 4 を超えた場合は、最初のコンパイラーを再試行し、コンパイル・エラーを報告します。File Manager が (コンパイル・エラーがあっても) 正常にテンプレートを作成する場合は、そのテンプレートで処理を続行します。
COBOL
COBOL コンパイラーを起動して、コピーブックからテンプレートを作成します。(COBOL のコンパイルでエラーが発生しても、PL/I コンパイラーは起動しません)。
PLI
PL/I コンパイラーを起動して、コピーブックからテンプレートを作成します。(PL/I のコンパイルでエラーが発生しても、COBOL コンパイラーは起動しません)。
HLASM
HLASM コンパイラーを起動して、コピーブックからテンプレートを作成します。
DSINFO

DSP、DSM、DSC、FCH の各コマンドのバッチ・レポートに入力ソースおよび出力ソースの追加のデータ・セット情報を生成するかどうかを指定します。

NO
追加のデータ・セット情報は生成されません。
YES
DSORG、RECFM、LRECL、BLKSIZE、VSAM の各属性のデータ・セット情報を生成します。具体的には、入力および出力データ・セットの平均レコード長、最大レコード長、キー・オフセット、キー長、再使用などです (該当する場合)。
COBOL オプション
次のオプションは、COBOL コピーブックをテンプレートにコンパイルするために使用します。
DBCS=YES
DBCS コンパイラー・オプションを使用します。
DBCS=NO
NODBCS コンパイラー・オプションを使用します。

DBCS および NODBCS コンパイラー・オプションの効果の詳細については、IBM COBOL Programming Guide for OS/390 & VM を参照してください。

CDPC=NO
COBOL SPECIAL-NAMES パラグラフ「Decimal-point is comma (小数点はコンマ)」を使用しません。
CDPC = YES
COBOL SPECIAL-NAMES パラグラフ「Decimal-point is comma (小数点はコンマ)」を使用します。
CAE=NO
COBOL コンパイル・オプション ARITH(EXTEND) を使用しません。
CAE = YES
COBOL コンパイル・オプション ARITH(EXTEND) を使用します。
MIXED = NO
フィールド名は大文字でテンプレートに保管されます。
MIXED = YES
フィールド名は COBOL コピーブックでコーディングされているとおりに、元の大/小文字でテンプレートに保管されます。
RFROM1 RTO1 … RFROM5 RTO5
COBOL REPLACE コンパイラー指示ステートメントの「From (検索)」および「To (置換)」疑似テキスト文字ストリングの最大 5 つの対。

COBOL コピーブックをテンプレートにコンパイルする前に、COBOL コピーブックに除去する文字または他の文字と置き換えたい文字が含まれている場合には、この置換オプションを使用します。

例えば、コピーブックに、コンパイル前に除去したいコロン文字 (:) が含まれている場合は、「'==:=='」を operand1 として、さらに「'====='」を operand2 として指定してください。

COBOL REPLACE の「From (検索)」および「To (置換)」のストリングの指定について詳しくは、IBM COBOL Language Reference を参照してください。

CBLMAXRC
コピーブックをコンパイルするために、許容できる最大の戻りコードを設定します。指定したレベルを超える戻りコードによって機能は停止します。デフォルトは、4 です。
注: COMPMAXRC パラメーターは引き続きサポートされますが、代わりに CBLMAXRC パラメーターを使用することが推奨されています。COMPMAXRC パラメーターを指定すると、それが言語の MAXRC よりも優先されます。
CBLLIBS
SYSLIB 連結リスト内で指定されるデータ・セット名 (10 個まで) のリストを指定できます。これらのデータ・セットは、コンパイル用に COPY または INCLUDE メンバーに指定された順序で検索されます。
dsname
処理されるデータ・セット名の名前。総称名マスクは使用できません。
CBLADDOP
COBOL コピーブックのコンパイル時に CBL ステートメントに組み込まれる追加の COBOL コンパイラー・オプション。
PL/I オプション
以下のオプションを使用して、PL/I コピーブックをテンプレートにコンパイルします。
BIN63=YES
LIMITS(FIXEDBIN(63)) コンパイラー・オプションを使用します。
BIN63=NO
LIMITS(FIXEDBIN(31)) コンパイラー・オプションを使用します。
DEC31=YES
LIMITS(FIXEDDEC(31)) コンパイラー・オプションを使用します。
DEC31=NO
LIMITS(FIXEDDEC(15)) コンパイラー・オプションを使用します。
GRAPHIC=YES
GRAPHIC コンパイラー・オプションを使用します。
GRAPHIC=NO
NOGRAPHIC コンパイラー・オプションを使用します。
UNALIGNED=YES
DEFAULT RANGE (*) UNALIGNED 言語ステートメントを使用して、デフォルトの位置合わせを変更します。
UNALIGNED=NO
PL/I のデフォルトを使用します。
PLIMAXRC
コピーブックをコンパイルするために、許容できる最大の戻りコードを設定します。指定したレベルを超える戻りコードによって機能は停止します。デフォルトは、4 です。
注: COMPMAXRC パラメーターは引き続きサポートされますが、代わりに PLIMAXRC パラメーターを使用することが推奨されています。COMPMAXRC パラメーターを指定すると、それが言語の MAXRC よりも優先されます。
PLILIBS
SYSLIB 連結リスト内で指定されるデータ・セット名 (10 個まで) のリストを指定できます。これらのデータ・セットは、コンパイル用に COPY または INCLUDE メンバーに指定された順序で検索されます。
dsname
処理されるデータ・セット名の名前。総称名マスクは使用できません。
PLIADDOP
PL/I コピーブックのコンパイル時に *PROCESS ステートメントに組み込まれる追加の PL/I コンパイラー・オプション。

これらのコンパイラー・オプションの効果について詳しくは、IBM VisualAge PL/I for OS/390 Programming Guide を参照してください。

HLASM オプション
次のオプションは、HLASM コピーブックをテンプレートにコンパイルするために使用します。
DBCS=YES
DBCS コンパイラー・オプションを使用します。
DBCS=NO
NODBCS コンパイラー・オプションを使用します。
NOALIGN=YES
NOALIGN コンパイラー・オプションを使用します。
NOALIGN=NO
ALIGN コンパイラー・オプションを使用します。
ASMMAXRC
コピーブックをコンパイルするために、許容できる最大の戻りコードを設定します。指定したレベルを超える戻りコードによって機能は停止します。デフォルトは、4 です。
注: COMPMAXRC パラメーターは引き続きサポートされますが、代わりに ASMMAXRC パラメーターを使用することが推奨されています。COMPMAXRC パラメーターを指定すると、それが言語の MAXRC よりも優先されます。
ASMLIBS
SYSLIB 連結リスト内で指定されるデータ・セット名 (10 個まで) のリストを指定できます。これらのデータ・セットは、コンパイル用に COPY または INCLUDE メンバーに指定された順序で検索されます。
dsname
処理されるデータ・セット名の名前。総称名マスクは使用できません。
ASMADDOP
COPY メンバーおよび MACRO メンバーのコンパイル時に *PROCESS ステートメントに組み込まれる追加の HLASM コンパイラー・オプション。

これらのコンパイラー・オプションの効果について詳しくは、HLASM V1R6 Programmer's Guide を参照してください。

$$FILEM PBK DSNIN=FMNUSER.TEMPLATE,
$$FILEM MEMBER=DITTST1