Skip to Content

OUTCOPY

OUTCOPY specifies how BMC AMI Recover creates image copies for partitioned objects. The OUTCOPY setting on the OPTIONS command statement for a recovery overrides the OUTCOPY setting in the installation options for that recovery.

Output copies are produced in the SYSTEMPAGES YES format when possible.

Related topics

OPTIONS option descriptions

OUTCOPY ASCODED

OUTCOPY specification

Option operands 

Operand

Description

BYPART

Copies each partition of a partitioned object to a separate image copy

ASCODED

Creates image copies as specified on the RECOVER TABLESPACE, RECOVER INDEX, or RECOVER INDEXSPACE command statement. When DSNUM ALL is specified, an image copy is created for the object as a whole. If the recover specification is for an individual data set (DSNUM n), a copy is made of that specific data set.

 

Ensure that processing is limited to RECOVER commands that include OUTCOPY ONLY to ensure that BMC AMI Recover takes no destructive actions

Creates an image copy from an INLINE copy by using RECOVER OUTCOPY ONLY. BMC AMI Recover must first restore the inline copy to a temporary data set.

To do this, BMC AMI Recover must first restore the inline copy to a temporary data set. The default model name for this temporary data set is identical to the Db2 name of the object recovered, but with BMCDBC substituted for DSNDBC in the CLUSTER portion of the VSAM data set: 

<vcat>.BMCDBC.<databaseName>.<objectName>.<nodeValue>.<znnn>

The variables are defined as follows: 

  • vcat is the ICF catalog name. 
  • databaseName.objectName is the name of the database and object containing the data set that is processed. 
  • nodeValue is the value that is used by Db2 for this node. 
  • znnn is the data set number. 

z represents the letter A, B, C, D, or E. These letters correspond to the first digit 0, 1, 2, 3, or 4 of the partition number and  nnn represents the rest of the partition number. So znnn represents the partitions numbers as follows: 

  • A001 through A999 for partitions 1 through 999 
  • B000 through B999 for partitions 1000 through 1999 
  • C000 through C999 for partitions 2000 through 2999 
  • D000 through D999 for partitions 3000 through 3999 
  • E000 through E096 for partitions 4000 through 4096 

If this data set name cannot be used, then you may use the MODEL option to specify the name of the CLUSTER portion of the VSAM data set that you want to use for this temporary data set. 

For example: 

OPTIONS
   OUTCOPY ONLY MODEL ABC.RESTOR.&DB.&TS.AS&LDSNUM

OUTPUT LOCALP
   DSNAME <dataSetName>

RECOVER TABLESPACE <tableSpaceName>
   OUTCOPY ONLY
   OUTCOPYDDN (LOCALP)

The data set name that you specify can optionally include symbolic variables. For more information, see Using symbolic variables.

 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Recover for Db2 13.1