DSN1PRNT 制御ステートメントの構文とオプション

DSN1PRNT ユーティリティー制御ステートメントは、複数のオプションを使用して、 ユーティリティー・ジョブが実行する機能を定義します。

DSN1PRNT 構文図

>>-+-------------------------+--+----------+--+-------+--------->
   +-32K---------------------+  +-FULLCOPY-+  +-LARGE-+   
   '-PAGESIZE--(--+-4K--+--)-'  +-INCRCOPY-+  '-LOB---'   
                  +-8K--+       '-INLCOPY--'              
                  +-16K-+                                 
                  '-32K-'                                 

>--+------------------------+--+--------------------------+----->
   '-DSSIZE--(-integer--G-)-'  '-PIECESIZ(integer-+-K-+-)-'   
                                                  +-M-+       
                                                  '-G-'       

>--+-------------------+---------------------------------------->
   '-NUMPARTS(integer)-'   

                   (1)                                                          
   .-PRINT--EBCDIC----------------------------------------------------------.   
>--+------------------------------------------------------------------------+-->
   |                                                                  (1)   |   
   |                                                         .-EBCDIC-----. |   
   '-PRINT--+---------------------------------------------+--+------------+-'   
            '-(hexadecimal-constant,hexadecimal-constant)-'  +-ASCII------+     
                                                             '-UNICODE----'     

>--+-----------------------------------+------------------------>
   '-VALUE(-+-string---------------+-)-'   
            '-hexadecimal-constant-'       

>--+----------------------------------+------------------------><
   '-FORMAT--+--------+--+----------+-'   
             '-EXPAND-'  +-NODATA---+     
                         '-NODATPGS-'     

注:
  1. 入力データ・セットの先頭ページがヘッダー・ページの場合は、EBCDIC は必ずしも デフォルトではありません。 先頭ページがヘッダー・ページの場合、DSN1PRNT はヘッダー・ページのフォーマット情報を デフォルト・フォーマットとして使用します。

オプションの説明

呼び出しパラメーターを使用して DSN1PRNT を実行する必要がある場合、EXEC ステートメントで以下のオプションを 1 つ以上指定します。

重要: 複数のパラメーターを指定する場合は、次のようにします。
  • パラメーターをコンマで区切る (ブランクなしで)。
  • パラメーターを任意の順序で指定する。

DSN1PRNT オプションのデフォルト設定は、入力データ・セットのヘッダー・ページから取得されます。DSN1PRNT を実行する場合、このデフォルト処理が推奨されています。これは、誤ったパラメーター設定により、予測不要の結果が発生する場合があるためです。

デフォルト以外のユーザー値が指定されると、DSN1PRNT は、可能な場合は常に、入力データ・セットのヘッダー・ページ設定とユーザー指定値を比較します。不一致が検出されると、メッセージ DSN1930I が発行されます。処理は、ユーザー指定値を使用して実行されます。

32K
SYSUT1 データ・セットのページ・サイズが 32 KB であることを指定します。このオプションが指定されていて、SYSUT1 データ・セットの ページ・サイズが 32 KB でない場合、DSN1COPY は予測不能の結果になる可能性があります。
PAGESIZE
SYSUT1 によって定義されている入力データ・セットのページ・サイズを指定します。有効な ページ・サイズは 4K、8K、16K、または 32K です。 誤ったページ・サイズを指定した場合は、DSN1PRNT は予測できない結果をもたらす恐れがあります。

ページ・サイズを指定しないと、入力データ・セットの先頭ページがヘッダー・ページ であれば、DSN1PRNT はその入力データ・セットからページ・サイズを判別し ます。DSN1PRNT が入力ページ・サイズを判別することができなかった場合 は、Db2® はエラー・メッセージを出します。これが起きる可能性があるのは、入力データ・セットの中にヘッダー・ページが含まれていない場合、またはヘッダー・ページ内のページ・サイズ・フィールドに無効なページ・サイズが入っている場合です。

FULLCOPY
データ・セットの Db2 フル・イメージ・コピー (DFSMSdss 並行コピー ではなく) を入力として使用することを指定します。このデータがパーティション化されている場合は、パーティション 数と長さを示すために、NUMPARTS パラメーターも指定する必要があり ます。NUMPARTS を指定せずに FULLCOPY を指定すると、DSN1PRNT は入力ファイルがパーティション化 されていないと見なします。

イメージ・コピーを DSN1PRNT への入力として使用する場合は、FULLCOPY パラメーターを 指定する必要があります。このパラメーターを省略すると、エラー・メッセージが出たり、予期せぬ結果になることがあります。

入力イメージ・コピーが FlashCopy® イメージ・コピー・データ・セットの場合、FULLCOPY は指定しないでください。

INCRCOPY
データの増分イメージ・コピーを入力として使用することを指定します。 このデータがパーティション化されている場合は、NUMPARTS も指定して、パーティション 数と長さを示します。NUMPARTS を指定せずに INCRCOPY を指定する と、DSN1PRNT は入力ファイルがパーティション化されていないと見なします。

増分イメージ・コピーを DSN1PRNT への入力として使用する場合は、INCRCOPY パラメーターを 指定する必要があります。 このパラメーターを省略すると、エラー・メッセージが出たり、予期せぬ結果になることがあります。

INLCOPY
入力データがインライン・コピー・データ・セットであることを指定します。

LOAD または REORG によって生成されたインライン・コピーからページまたはページ範囲を印刷するために DSN1PRNT を使用した場合、DSN1PRNT はページのすべてのインスタンス印刷します。 印刷されたページ (1 つ以上) の最後のインスタンス が、このユーティリティーによって作成された最後のインスタンスです。

DSN1PRNT への入力としてインライン・イメージ・コピーが使用される場合、INLCOPY パラメーターを指定する必要があります。 INLCOPY パラメーターを省略すると、エラー・メッセージが出たり、予期せぬ結果になることがあります。

LARGE
入力データ・セットが LARGE オプションで定義された表スペースであるか、 または、そのような表スペースの索引であることを指定します。LARGE を指定すると、Db2 は、そのデータ・セットの境界は 4 GB 境界であると見なし ます。LARGE オプションで定義された 表スペースを指定する方法として推奨されるのは、DSSIZE(4G) です。

LARGE または DSSIZE(4G) オプションが必要であるのに省略 されている場合、または、LARGE で定義されていない表スペースに対して LARGE が指定されている場合、 DSN1PRNT の結果は予測不能です。

LARGE を指定する場合は、LOB も DSSIZE も指定できません。

LOB
SYSUT1 データ・セットが LOB 表スペースであることを指定します。

INLCOPY オプションを LOB パラメーターと一緒に指定することはできません。

LOB を指定するときは、LARGE を指定できません。

Db2 は、 入力データ・セットが LOB データ・セットかどうかの判別を試みます。LOB データ・セットではないデータ・セットに対して LOB オプションが 指定されているか、LOB データ・セットに対して LOB オプションが省略されている場合、 Db2 はエラー・メッセージ を発行し、DSN1PRNT は終了します。

DSSIZE(integer G)
入力データ・セットのデータ・セット・サイズをギガバイト単位で指定し ます。DSSIZE を省略した場合、Db2 はデータ・セット・ヘッダー・ページからデータ・セット・サイズを取得します。

DSSIZE を指定する場合、integer は、表スペースの定義時に指定された DSSIZE 値と一致する必要があります。

PIECESIZ(integer)
パーティション化されていない索引の最大の断片サイズ (データ・セット・サイズ) を指定します。 指定される値は、副次索引が作成または変更されたときに指定された値と 一致している必要があります。

PIECESIZ のデフォルトは、非 LARGE 表スペースを基にしている索引の場合は 2G (2 GB)、 LARGE オプションで定義された表スペースを基にしている索引の場合は 4G (4 GB) です。このオプションは、印刷範囲が指定されていて、ピース・サイズがどちらのデフォルト値 でもない場合は必須です。PIECESIZ が省略されていて、 LARGE オプションで定義された表スペースを基にしている索引である場合、DSN1PRNT に LARGE キーワードを 指定する必要があります。

後続のキーワード K、M、または G は、integer で指定した値の単位を示します。

K
integer の値に 1 KB を掛けるとバイト単位の最大ピース・サイズになることを指定します。 integer は 256 または 512 のいずれかでなければなりません。
M
integer の値に 1 MB を掛けるとバイト単位の最大ピース・サイズになることを指定します。 integer は 1 から 512 の範囲内の 2 の累乗でなければなりません。
G
integer の値に 1 GB を掛けるとバイト単位の最大ピース・サイズになることを指定します。 integer は 1 から 256 の範囲内の 2 の累乗でなければなりません。

以下に、断片サイズとして有効な値を示します。

  • 1 MB または 1 GB
  • 2 MB または 2 GB
  • 4 MB または 4 GB
  • 8 MB または 8 GB
  • 16 MB または 16 GB
  • 32 MB または 32 GB
  • 64 MB または 64 FB
  • 128 MB または 128 GB
  • 256 KB、256 MB、または 256 GB
  • 512 KB または 512 MB
NUMPARTS(integer)
ターゲット表スペースがユニバーサル表スペースの場合、このパラメーターは使用されません。代わりに DSSIZE が使用されます。
PRINT(hexadecimal-constant,hexadecimal-constant)
SYSUT1 データ・セットが SYSPRINT データ・セットに 16 進形式で印刷されます。 このオプションは DSN1PRNT のデフォルトです。

PRINT パラメーターを指定する際には、ページ範囲の指定はあってもなくても構いません。 範囲を指定しない場合は、SYSUT1 のすべてのページが印刷されます。 印刷するページの範囲を限定する場合は、PRINT パラメーターで開始と終了のページを指定することが できます。1 ページだけを印刷する場合は、先頭ページのみを指定します。 いずれの場合も、範囲の指定は長さ 1 ~ 8 桁の 16 進文字で行う必要があります。

次の例は、印刷をページ X'2F0' で開始し、ページ X'35C' で停止させる場合の PRINT パラメーター の指定方法を示しています。

PRINT(2F0,35C)

ページ・サイズと、4 GB データ・セット内のページ数との 関係は、以下の表のとおりです。

表 1. ページ・サイズと 4 GB データ・セットのページ数との関係
ページ・サイズ ページ数
4 KB X'100000'
8 KB X'80000'
16 KB X'40000'
32 KB X'20000'

例えば、PAGESIZE が 4 KB の場合、3 番目のデータ・セットの先頭ページのページ番号は 2*X'100000' = X'200000' です。

非パーティション化表スペースのヘッダー・ページのみを 印刷する場合は、PRINT(0) を指定します。

EBCDIC、ASCII、または UNICODE を指定することによって、PRINT 出力での行データの形式を 示すことができます。 次の図で太字で示されている箇所が、これらのオプションによって 影響を受ける出力部分です。

図 1. EBCDIC、ASCII、および UNICODE オプションによって影響を受ける DSN1PRNT FORMAT 出力の部分
RECORD:  XOFFSET='0014'X  PGSFLAGS='00'X  PGSLTH=65  PGSLTH='0041'X  PGSOBD='0003'X  PGSBID='01'X
C5C5F0F6 C1404040 40404040 F1F34040 40C1E2D6 F1F3F5E7 40404040 40404040   EE06A       13   ASO135X
C1C6F3F1 C587C6F0 01800000 14199002 01174522 00000080 000000              AF31E.F0...................

RECORD:  XOFFSET='0055'X  PGSFLAGS='00'X  PGSLTH=65  PGSLTH='0041'X  PGSOBD='0003'X  PGSBID='02'X
C5C5F0F6 C1404040 40404040 F1F34040 40C1E2D6 F1F3F5E7 40404040 40404040   EE06A       13   ASO135X
C1C6F5F2 D487C5F0 09800000 78199002 01174522 00000080 000000              AF52M.E0...................
EBCDIC
PRINT 出力の行データは、EBCDIC で出力することを示します。

入力データ・セットの先頭ページがヘッダー・ページではない場合 は、デフォルト値は EBCDIC です。

先頭ページがヘッダー・ページの場合、DSN1PRNT はヘッダー・ページのフォーマット情報を デフォルト・フォーマットとして使用します。 ただし、EBCDIC、ASCII、または UNICODE を指定した場合は、その形式がヘッダー・ページの 形式情報をオーバーライドします。 不定形式のヘッダー・ページ・ダンプは、大部分のフィールドが EBCDIC であるため、 常に EBCDIC で表示されます。

ASCII
PRINT 出力の行データは、ASCII で出力することを示し ます。ASCII データを含んでいる表スペースを印刷する場合は、ASCII を指定します。
UNICODE
PRINT 出力の行データは、ユニコードで出力することを示します。 ユニコードのデータを含んでいる表スペースを印刷する場合は、UNICODE を指定します。
VALUE
入力データ・セット SYSUT1 のそれぞれのページをスキャンして、VALUE パラメーターに続く 括弧内で指定された文字ストリングを探します。 この文字ストリングが入っている各ページが、SYSPRINT に印刷され ます。VALUE パラメーターは、他の DSN1PRNT パラメーターのいずれとも組み合わせて指定できます。
(string)
1 から 20 の英数字の EBCDIC 文字から構成することができます。 EBCDIC 以外の文字の場合は、16 進文字を使用します。
(hexadecimal-constant)
2 文字から 40 文字までの 16 進文字から構成されます。16 進文字ストリングの前後には、2 つのアポストロフィ文字を 指定する必要があります。

例えば、入力ファイルを検索してストリング「12345」を 探す場合の JCL は、以下の JCL に似たものになります。

//STEP1 EXEC PGM=DSN1PRNT,PARM='VALUE(12345)'

また、同等の 16 進文字ストリングを検索することが必要になる場合もあります。Unicode または ASCII 入力ファイルを処理する場合、16 進数でストリングを指定する必要があります。JCL は、次の JCL のようになります。

//STEP1 EXEC PGM=DSN1PRNT,PARM='VALUE(''3132333435'')'
FORMAT
印刷出力がフォーマット設定されます。ページ制御フィールドが示され、個々のレコードが印刷されます。空のフィールドは表示されません。
EXPAND
データが圧縮されていることを指定します。DSN1PRNT はフォーマット設定の前にそのデータを 解凍します。このオプションは、IBM® ソフトウェア・サポートの指示があった場合にのみ使用してください。

FORMAT EXPAND オプションを使って DSN1PRNT を実行する場合、入力データ・セットがフル・イメージ・コピーを構成するならば、すべてのディクショナリー・ページを含む、元の表スペースのすべてのページが入力データ・セットに含まれる必要があります。

INCRCOPY または INLCOPY オプションが指定される場合には、FORMAT EXPAND を指定することができません。

NODATA
表の行データの印刷を抑制します。行見出しはフォーマット設定され、印刷されます。 行の内容が重要ではない場合は、NODATA を指定すると、出力のボリュームを削減できます。
NODATPGS
表スペースのすべてのデータ・ページを抑制します。 特定のページ・タイプ (例えば、LOB スペース・マップ・ページ) のみに関心がある場合、NODATPGS を 指定すると、非データ・ページのみをフォーマット設定し、印刷して、出力量を削減できます。 別の方法としては、NODHDR を指定することもできます。
DSN1PRNT は、変更された列を伴うキーが含まれた索引ページ・セットの リーフ・ページまたはノンリーフ・ページをフォーマット設定することはできません。 このような状態を検出した場合は、DSN1PRNT は、次のメッセージを出します。
*KEY WITH ALTERED COLUMN HAS BEEN DETECTED-UNABLE TO FORMAT PAGE*
DSN1PRNT は、そのページについては不定形式の出力を生成します。

FORMAT は、損傷ページのフォーマット設定 を試み、フォーマットされていない形式のページをフォーマットされたページの後にダンプ します。