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

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

制御ステートメントは、ISPF/PDF 編集機能を使って作成することができます。 制御ステートメントを作成した後、それを順次データ・セットまたは区分データ・セットに 保管します。 ジョブの実行用の JCL を作成する場合、SYSIN DD ステートメントを使用して、 ユーティリティー制御ステートメントが入っているデータ・セットの名前を指定します。

構文図

>>-MERGECOPY---------------------------------------------------->

>--+-LIST--listdef-name--------------------------------------------------+-->
   |                                                  .-DSNUM--ALL-----. |   
   '-TABLESPACE--+----------------+-table-space-name--+----------------+-'   
                 '-database-name.-'                   '-DSNUM--integer-'     

              .-WORKDDN--SYSUT1-.   
>--+-------+--+-----------------+------------------------------->
   '-CLONE-'  '-WORKDDN -ddname-'   

     .-NEWCOPY--NO-.  .-COPYDDN--SYSCOPY-------------------.                                      
>--+-+-------------+--+------------------------------------+----------------------------------+-><
   |                  +-COPYDDN(ddname1-+----------+-)-----+                                  |   
   |                  |                 '-,ddname2-'       |                                  |   
   |                  +-COPYDDN(,ddname2)------------------+                                  |   
   |                  '-RECOVERYDDN(ddname3-+----------+-)-'                                  |   
   |                                        '-,ddname4-'                                      |   
   |               .-COPYDDN--SYSCOPY---------------.                                         |   
   '-NEWCOPY--YES--+--------------------------------+--+------------------------------------+-'   
                   +-COPYDDN(ddname1-+----------+-)-+  '-RECOVERYDDN(ddname3-+----------+-)-'     
                   |                 '-,ddname2-'   |                        '-,ddname4-'         
                   '-COPYDDN(,ddname2)--------------'                                             

オプションの説明

LIST listdef-name
前に定義された、表スペースのみを含む LISTDEF リスト名の名前を指定し ます。MERGECOPY 制御ステートメントごとに 1 つの LIST キーワードを指定することができ ます。LIST は、TABLESPACE キーワードと一緒には指定しないでくだ さい。MERGECOPY は、リストにあるそれぞれの表スペースごとに 1 回ずつ 起動されます。CLONE キーワードが指定されている場合、このユーティリティーはクローン・データのみを処理します。 LISTDEF ステートメントで CLONED YES を使用するのでは不十分です。

パーティションまたは パーティション範囲をリストに指定できます。

TABLESPACE database-name.table-space-name
コピーされる表スペースを指定し、オプションで、その表スペースが属しているデータベース を指定します。
database-name
表スペースが属するデータベースの名前。 デフォルト値は、DSNDB04 です。
table-space-name
増分イメージ・コピーをマージする表スペースの名前。

変更の始まりMERGECOPY ユーティリティーは、DSNDB01.DBD01、DSNDB01.SYSUTILX、 DSNDB06.SYSTSCPY、 または DSNDB01.SYSDBDXA 表スペースには実行できません。 その理由は、これらの表スペースの増分コピーは作成できないため です。MERGECOPY は、そのコピーをマージしようとする表スペースに直接アクセス しないため、その表スペースへの並行アクセスを妨げることはありません。変更の終わり

DSNUM
マージを行う表スペースまたはパーティション、あるいは表スペース内のデータ・セットを示します。DSNUM はオプションです。
ALL
表スペース全体をマージします。
整数
マージするパーティションまたはデータ・セットの番号です。 最大は 4096 です。

変更の始まりパーティション化表スペースの場合、整数はその物理パーティション番号です。変更の終わり

非パーティション化表スペースの場合、VSAM カタログにカタログされたデータ・セット名の終わりに ある整数です。データ・セット名の形式は次のとおりです。ここで、y は I または J、 z は 1 または 2、nnn はデータ・セット整数です。
catname.DSNDBx.dbname.tsname.y000z.Annn

同じ MERGECOPY 制御ステートメントで、DSNUM と LIST を指定することはできません。 代わりに、LISTDEF で PARTLEVEL を使用してください。 イメージ・コピーがデータ・セット別に (表スペース別ではなく) とられている場合、MERGECOPY はデータ・セット別のコピーを使用する必要があります。

CLONE
MERGECOPY がクローン・オブジェクトに対して作成されたイメージ・コピー・データ・セットのみを 処理することを指示します。CLONE キーワードが指定されている場合、このユーティリティーはクローン・データのみを処理します。 LISTDEF ステートメントで CLONED YES を使用するのでは不十分です。
WORKDDN ddname
中間マージ出力で使用する一時データ・セットまたはテンプレート用の DD ステートメント を指定します。 WORKDDN はオプションです。

ddname は DD 名です。 デフォルト値は SYSUT1 です。

MERGECOPY を実行できるだけの十分なデータ・セットを割り振ることができ ない場合は、WORKDDN オプションを使用します。 この場合は、中間出力を保持するために一時データ・セットを使用し ます。WORKDDN オプションを省略すると、一部のイメージ・コピー・データ・セットのみが マージされる場合があります。 MERGECOPY の終了時にメッセージが発行され、 存在するデータ・セット数とマージされたデータ・セット数が示され ます。マージを継続するには、新しい出力データ・セットで MERGECOPY を繰り返します。

NEWCOPY
増分イメージ・コピーをフル・イメージ・コピーとマージするかどうかを示し ます。NEWCOPY はオプションです。
NO
増分イメージ・コピーを単一の増分イメージ・コピーにマージしますが、 フル・イメージ・コピーとはマージしません。
YES
すべての増分イメージ・コピーをフル・イメージ・コピーにマージして、 新しいフル・イメージ・コピーを作ります。
COPYDDN (ddname1,ddname2)
ローカル・サイトの出力イメージ・コピー・データ・セット の DD ステートメントを指定します。ddname1 は 1 次出力イメージ・コピー・データ・セット、ddname2 は バックアップ出力イメージ・コピー・データ・セットです。COPYDDN はオプションです。

デフォルト値は COPYDDN(SYSCOPY) です。 ここで、SYSCOPY は 1 次データ・セットを示します。

COPYDDN キーワードには、DD 名または前の TEMPLATE 制御ステートメントにある TEMPLATE 名のいずれかを指定します。 ユーティリティー処理で、指定された名前が現行ジョブ・ステップ の DD 名と TEMPLATE 名の両方であることが検出された場合、 ユーティリティーは DD 名を使用します。

RECOVERYDDN (ddname3,ddname4)
リカバリー・サイトの出力イメージ・コピー・データ・セット の DD ステートメントを指定します。 最大 2 つの出力データ・セットを持つことができます。出力は同じ です。ddname3 は、1 次出力イメージ・コピー・データ・セットです。ddname4 は、バックアップ出力イメージ・コピー・データ・セットです。RECOVERYDDN はオプションです。RECOVERYDDN にはデフォルト値はありません。

RECOVERYDDN キーワードには、DD 名または前の TEMPLATE 制御ステートメントにある TEMPLATE 名のいずれかを指定します。 ユーティリティー処理で、指定された名前が現行ジョブ・ステップ の DD 名 と TEMPLATE 名の両方であることが検出された場合、 ユーティリティーは DD 名 を使用し ます。