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-'
- 入力データ・セットの先頭ページがヘッダー・ページの場合は、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 は、次のメッセージを出します。
DSN1PRNT は、そのページについては不定形式の出力を生成します。*KEY WITH ALTERED COLUMN HAS BEEN DETECTED-UNABLE TO FORMAT PAGE*FORMAT は、損傷ページのフォーマット設定 を試み、フォーマットされていない形式のページをフォーマットされたページの後にダンプ します。