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 名 を使用し ます。