OUTCOPY specification
The syntax diagram for the OUTCOPY specification is in RECOVER TABLESPACE, RECOVER INDEX, and RECOVER INDEXSPACE syntax.
You can specify OUTCOPY to make copies of the object or object data set being recovered. For each object or data set that you process, you can request up to four image copies. The default is no copies. If you are recovering to the real Db2 data sets and you request image copies, you can choose which copies, if any, to register in the SYSIBM.SYSCOPY table (or BMCXCOPY table for indexes). However, if you are using the INDEPENDENT OUTSPACE option to recover to non Db2 data sets and you request image copies, you cannot register those copies.
Output copies are produced in the new SYSTEMPAGES YES format when possible.
When you use the OUTCOPY ONLY facility, you can register the copies if you do not use OBIDXLAT or INCOPY or specify DROPRECOVERY.
If the output copies that you want to make are allocated in the JCL, the OUTCOPYDDN and RECOVERYDDN options specify the DD names for those data sets. If the output copies are dynamically allocated, the OUTCOPYDDN and RECOVERYDDN options refer to the appropriate OUTPUT descriptor names. For more information, see OUTCOPYDDN specification and RECOVERYDDN specification. The copies that you want to register are specified by the REGISTER option (INCOPY specification).
When you create an OUTCOPY and want to force the copy to the cylinder-managed space of an extended address volume (EAV), specify the SPACE keyword.
Important
You can use BMC AMI Recover to automatically size the OUTCOPY files generated by BMC AMI Recover. For more information, see Automatic sizing of output copies dynamically allocated on DASD.
How the copies are made depends on whether the object is partitioned or nonpartitioned.
If the object is partitioned, and OUTCOPY BYPART is specified or a specific DSNUM is coded in the object specification, a separate output copy is made for each partition. If you specified OUTCOPY ASCODED and DSNUM ALL with the RECOVER command, a single output copy is made for the object as a whole.
For more information about using OPTIONS OUTCOPY BYPART, see OUTCOPY.
If the object is nonpartitioned and you are recovering multiple data sets by specifying DSNUM ALL, each output copy is for all of the data sets. If you are recovering multiple data sets by specifying each one individually with DSNUM integer, a separate output copy is made for each data set.
OUTCOPY NO | OUTCOPY NO is the default and specifies that no output copies are required. | ||||||||
OUTCOPY YES | OUTCOPY YES specifies that you want image copies or DSN1COPY-type copies of the table space or index (or data set) being recovered. You can make up to four image copies or up to four DSN1COPY-type copies. A DD statement or an OUTPUT command statement must exist for each copy. The ddnames for the copy DD statements are specified by the OUTCOPYDDN and RECOVERYDDN options. Important You cannot use the OUTCOPY YES option to produce Instant Snapshot copies. | ||||||||
OUTCOPY ONLY | OUTCOPY ONLY does not affect the table space, index, or data set named in the RECOVER command statement and enables you to build copies without stopping the object for access and without actually reading the space, thereby avoiding DASD contention. You can use this option to build copies for a shadow version of the object, to build a migration image, or to build a registered copy for the named object’s recovery. Important If you use OUTCOPY ONLY to register a copy of a space at a point in time that is prior to existing incremental copies, the full copy will have a later TIMESTAMP, but a lower START_RBA than the associated incremental copies. Subsequent use of the IBM MODIFY utility to do an age-based DELETE from SYSCOPY may delete some of the incremental copies without deleting the associated full copy that was created by BMC AMI Recover. The resulting gap in the incremental copies can cause errors in a subsequent recovery that uses the remaining incremental copies. We recommend using the BMC AMI Copy MODIFY command to ensure that a consistent set of recovery resources is maintained in this situation. The following restrictions apply to the OUTCOPY ONLY option:
You can combine this option with an R+/CHANGE ACCUM product ACCUM command statement involving the same object, but only if the recovery does not include TORBA, TOLOGPOINT, or TOCOPY options. For more information about the ACCUM command statement, see the R+/CHANGE ACCUM documentation . If copies are registered, they are registered as SHRLEVEL REFERENCE if any one of the following options is specified:
For all other cases, copies are registered as SHRLEVEL CHANGE.
| ||||||||
REGISTER | Use this option to indicate how many, if any, copies you want to register in the SYSIBM.SYSCOPY table. Index copies are registered in the BMCXCOPY table. You can make and register up to four copies, all with the same log point and the same SYSIBM.SYSCOPY time stamp. The first copy specified by ddname with the OUTCOPYDDN option is registered as the local site primary copy. Similarly, the second copy is registered as the local site backup copy. Third and fourth copies specified with RECOVERYDDN are registered as recovery site primary and backup copies. Important You cannot make a backup copy without a primary copy. You can, however, make and register a recovery site copy without making a local site copy.
| ||||||||
RESETRTS | Use RESETRTS to have BMC AMI Recover reset the copy Db2 real-time statistics (RTS) if the copy is registered when you specify OUTCOPY YES or OUTCOPY ONLY. Warning You should specify RESETRTS only if the OUTCOPY you are making is a copy that approximately represents the current state of the space. If you specify RESETRTS for a copy corresponding to a different point in time, the RTS may give misleading information about the time of the last copy and the changes made since the copy. Several examples of how you might use RESETRTS follow:
| ||||||||
TAG tagName | Specify TAG to tag copies with a name that can be used for selecting objects for use with the BMC AMI Copy EXPORT command. Only image copies for table spaces are tagged. Tag names are presented as 1 to 32 characters, followed by a generation number in parentheses. The generation number can be (0), (+1), or (-n). Generation numbers are used as follows:
Spaces and punctuation marks are not allowed in the tag name. Specify the generation number as in the following example: WEEKLY_EXPORT(+1). | ||||||||
SPACE (primary, secondary) allocation unit | Specify SPACE to set the output allocation parameters for the named descriptor in OUTCOPYDDN. This use of SPACE overrides the SPACE specification in the corresponding OUTPUT descriptor. Specify SPACE TRK to allocate the output in tracks. Specify SPACE CYL to allocate the output in cylinders. The default value for this option is CYL. Specify the values in parentheses, as in the following example: SPACE (200,100) CYL. If no SPACE specification is provided, the default is (5,5) CYL. |
Comments
Log in or register to comment.