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

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

DSN1COPY 構文図

>>-DSN1COPY--+-------+--+---------------------+--+----------+--->
             '-CHECK-'  +-32K-----------------+  +-FULLCOPY-+   
                        '-PAGESIZE(-+-4K--+-)-'  +-INCRCOPY-+   
                                    +-8K--+      +-SEGMENT -+   
                                    +-16K-+      '-INLCOPY--'   
                                    '-32K-'                     

>--+-------+--+------------------------+------------------------>
   +-LARGE-+  '-DSSIZE--(-integer--G-)-'   
   '-LOB---'                               

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

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

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

>--+-------+---------------------------------------------------><
   '-RESET-'   

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

オプションの説明

呼び出しパラメーターを使用して DSN1COPY を実行するには、EXEC ステートメントで以下のパラメーターを 1 つ以上指定します。複数のパラメーターを指定する場合は、それぞれのパラメーターをコンマで区切ります。 パラメーターは、任意の順序で指定することができます。

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

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

CHECK
SYSUT1 データ・セットの各ページの妥当性をチェックします。妥当性検査は、一度に 1 ページずつ行われ、ページをまたがる検査は行われません。 エラーが検出されると、エラーのタイプを記述した メッセージが出され、ページのダンプが SYSPRINT データ・セットに送られます。予期しない ページ番号が検出された場合、妥当性検査は最後まで継続し、 すべての予期しないページ番号を示す報告書が印刷されます。メッセージがない場合は、エラーが検出されなかったと いうことです。1 つのページに複数のエラーが存在しても、チェックで識別されるのは最初のエラーだけです。ただし、ページ全体がダンプされます。 DSN1COPY は、システム・ページの妥当性は検査しません。

BUSINESS TIME WITHOUT OVERLAPS のキーに追加される BUSINESS_TIME 期間列を持つ索引は、正常なキーに関する検査をバイパスします。

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

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

FULLCOPY
データ・セットの Db2 フル・イメージ・コピー (DFSMSdss 並行コピー ではなく) を入力として使用することを指定します。このデータがパーティション化されている場合は、NUMPARTS を でパーティションの合計数を指定してください。NUMPARTS を指定せずに FULLCOPY を指定すると、DSN1COPY は、可能な場合、ヘッダー・ページから NUMPARTS 値を判別します。それ以外の場合、DSN1COPY は、入力ファイルがパーティション化されていないと想定します。

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

入力として FlashCopy® イメージ・コピー・データ・セットを使用する場合、FULLCOPY は指定しないでください。

FULLCOPY パラメーターを使用する場合 は、SYSUT2 (出力データ・セット) が Db2 VSAM データ・セットか DUMMY の いずれかでなければなりません。

INCRCOPY
データの増分イメージ・コピーを入力として使用することを指定します。 INCRCOPY パラメーターを指定した DSN1COPY は、既存のデータ・セットを更新しますが、 それらの既存データ・セットの再定義は行いません。INCRCOPY を指定する場合、出力データ・セット (SYSUT2) は Db2 VSAM データ・セットでなければなりません。

データ・セットに増分イメージ・コピーを適用する場合は、その前にまず FULLCOPY パラメーター を用いてデータ・セットにフル・イメージ・コピーを適用する必要があり ます。FULLCOPY と INCRCOPY の両方のパラメーターを同じステップで指定するとエラー・メッセージを 受け取るため、フル・イメージ・コピーの適用は、必ず、別の実行ステップで行うようにしてください。 この場合、最も古い増分イメージ・コピーから始めて、別々のステップでそれぞれの 増分イメージ・コピーを適用します。

FULLCOPY も INCRCOPY も指定しないことは、入力がイメージ・コピー・データ・セットではない ことを意味します。したがって、使用される出力データ・セットは 1 つだけです。

SEGMENT
セグメント表スペースを DSN1COPY への入力として使用することを指定します。 表スペース内のすべてゼロのページはコピーされますが、エラー・メッセージ は発行されません。SEGMENT を指定した場合は、FULLCOPY または INCRCOPY は指定できません。

OBIDXLAT を指定した DSN1COPY を使用して Db2 データ・セットを 別の Db2 データ・セットにコピーする場合、 ソース表スペースとターゲット表スペースの SEGSIZE 属性は同じでなければなりません。

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

INLCOPY
入力データがインライン・コピー・データ・セットであることを指定します。INLCOPY パラメーターが 指定されている場合、SYSUT2 (出力データ・セット) は VSAM データ・セットか DUMMY データ・セットのいずれかで なければなりません。

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

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

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

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

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

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

LOB
SYSUT1 データ・セットが LOB 表スペースであることを指定します。表スペース内の空ページはコピーされますが、エラー・メッセージ は発行されません。SEGMENT および INLCOPY オプションを LOB パラメーターと 一緒に指定することはできません。

DSN1COPY は、その入力データ・セットが LOB データ・セットであるかどうかを判別しようとします。LOB オプションを指定したデータ・セットが LOB データ・セットではないことが明確である場合、あるいは LOB オプションを省略したデータ・セットが LOB データ・セットであることが明確である場合は、DSN1COPY がエラー・メッセージを出して終了します。 それ以外で、LOB オプションが正しく指定または省略されていない 場合の DSN1COPY の結果は予測不能です。

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

NUMPARTS(integer)
入力データ・セットに関連付けられたパーティションの数を指定します。 有効な指定範囲は、1 から 4096 までです。NUMPARTS を省略するか、NUMPARTS を 0 として指定する と、DSN1COPY は入力ファイルが区分化されていないと見なします。 64 より大きい数が指定されていると、DSN1COPY は、 LARGE キーワードが指定されていなくても、データ・セットは LARGE オプションで定義されたパーティション化表スペース用のデータ・セットであると 見なされます。

DSN1COPY が NUMPARTS パラメーターを必ず妥当性検査できるとは限りません。 このパラメーターの指定が間違った場合は、DSN1COPY が予測不能の結果をもたらす恐れがあります。

DSN1COPY は、複数のパーティションが入っているイメージ・コピーを検出すると、終了し、 メッセージ DSN1946I を出します。先頭パーティションについては圧縮の報告書が出されます。

ターゲット表スペースがユニバーサル表スペースの場合、このパラメーターは使用されません。代わりに DSSIZE が使用されます。

このパラメーターは非推奨になりました。

PRINT(hexadecimal-constant,hexadecimal-constant)
SYSUT1 データ・セットが SYSPRINT データ・セットに 16 進形式で印刷されます。 PRINT パラメーターは、ページ範囲 (hexadecimal-constant,hexadecimal-constant) ありでも、 なしでも指定できます。 範囲を指定しない場合は、SYSUT1 のすべてのページが印刷されます。 印刷するページの範囲を限定する場合は、開始と終了のページを指示し ます。1 ページを印刷する場合は、そのページ番号だけを指定します。いずれの場合も、範囲の指定は長さ 1 ~ 8 桁の 16 進文字で行う必要があります。

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

PRINT(2F0,35C)

CHECK および RESET のオプションとコピー機能は、PRINT 範囲とは独立に実行されるため、 これらのオプションは、印刷されるページ範囲には関係なく、入力ファイル全体に適用されます。

EBCDIC、ASCII、または UNICODE を指定することによって、PRINT 出力での行データの形式を 示すことができます。

EBCDIC
PRINT 出力の行データは、EBCDIC で出力することを示します。 入力データ・セットの先頭ページがヘッダー・ページではない場合 は、デフォルト値は EBCDIC です。

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

ASCII
PRINT 出力の行データは、ASCII で出力することを示し ます。ASCII データを含んでいる表スペースを印刷する場合は、ASCII を指定します。
UNICODE
PRINT 出力の行データは、ユニコードで出力することを示します。 ユニコードのデータを含んでいる表スペースを印刷する場合は、UNICODE を指定します。
PIECESIZ(integer)
パーティション化されていない索引の最大の断片サイズ (データ・セット・サイズ) を指定します。 指定される値は、非パーティション索引が作成または変更されたときに指定された値と 一致している必要があります。PIECESIZ のデフォルトは、非 LARGE 表スペースを基にしている索引の場合は 2G (2 GB)、 LARGE オプションで定義された表スペースを基にしている索引の場合は 4G (4 GB) です。ピース・サイズが これらのデフォルト値のどちらでもない場合は、このオプションは必須です。PIECESIZ が省略されていて、 LARGE オプションで定義された表スペースを基にしている索引である場合、DSN1COPY に 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
VALUE
入力データ・セット SYSUT1 のそれぞれのページをスキャンして、VALUE パラメーターに続く 括弧内で指定された文字ストリングを探します。 この文字ストリングが入っているすべてのページが SYSPRINT データ・セットに印刷され ます。VALUE パラメーターは、他の任意の DSN1COPY パラメーターと組み合わせて指定できます。

string は、1 文字から 20 文字までの英数字で構成されます。

hexadecimal-constant は、2 文字から 40 文字までの 16 進文字で構成され ます。16 進文字ストリングの前後には、2 つのアポストロフィ文字を 指定してください。

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

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

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

//STEP1 EXEC PGM=DSN1COPY,PARM='VALUE(''3132333435'')'
OBIDXLAT
Db2 データ・セットをコピーする前に、OBID 変換を行う必要があることを指定します。 OBID 変換は、ソースとターゲットの OBID が一致しない場合に必要になります。

このパラメーターには、DD ステートメントを用いて SYSXLAT ファイルからの追加の入力が必要 です。DSN1COPY は、10000 レコードまでの OBID しか変換できません。

OBIDXLAT を指定すると、 CHECK オプションの指定の有無に関わらず、CHECK 処理が実行されます。

RESET
これによって、各索引ページまたはデータ・ページ内のログ RBA と、ヘッダー・ページ内の 高フォーマット設定ページ番号が 0 にリセットされます。 このオプションを指定すると、CHECK オプションの指定の有無に関係なく CHECK 処理が行われます。

ソース・サブシステムとは異なるリカバリー・ログを使って Db2 サブシステムで処理される Db2 表スペースを作成するために出力ファイルが使われる場合には、RESET を使用してください。 このような場合に RESET を指定しないと、後続の更新アクティビティーの際に異常終了を 生じる恐れがあります。 異常終了理由コード 00C200C1 は、指定の RBA 値がリカバリー・ログの有効範囲外にあることを示します。 条件コードが 0 の場合は、正常終了を示します。

グループ・バッファー・プール RECOVER (GRECP) 状況のページ・セットに対しては RESET パラメーター を指定しないでください。

圧縮された表スペースの場合、DSN1COPY は、 インライン・イメージ・コピーのディクショナリー・バージョンのリセット、 または、SYSTEMPAGES=YES COPY ユーティリティー・オプションを指定して作成された増分イメージ・コピーのディクショナリー・バージョン のリセットは行いません。

表スペースをある Db2 システムから別のシステムにコピーする際に RESET を 指定しないと、その表スペースがアクセスされたときに、ダウン・レベルの ID チェックによって、 異常終了の理由コード 00C2010D が出される場合があります。