INCOPY specification

The syntax diagram for the INCOPY specification is in RECOVER-TABLESPACE-RECOVER-INDEX-and-RECOVER-INDEXSPACE-syntax.

Option

Description

DSNAME dataSetName

DSNAME dataSetName is the data set name of the copy used during recover.

For an Instant Snapshot copy or an IBM FlashCopy, this name should be the VSAM data component name or the cluster component name. The VSAM data component name is printed in the output from the BMC AMI Copy for Db2 job that created the Instant Snapshot. For a FlashCopy, the cluster component name is printed in the output from the IBM Db2 COPY utility. In reporting, BMC AMI Recover displays the name that was supplied with this parameter.

If you specify a generation data group (GDG) name, you can either specify the relative GDG name or the fully qualified data set name.

If you specify a relative GDG name for an existing data set, use either (0) or (-n) for the relative generation. Do not refer to it as the (+1) generation. The most recent data set is the (0) generation, even if it was created in a previous step in the same job.

MODEL dataSetName

MODEL dataSetName allows you to construct the copy data set by using symbolic variables. This is useful when used with OBJECTSET processing.

Important

dataSetName must include a node for the data set number represented by A&LDSNUM. This node can appear anywhere within dataSetName.

You can construct dataSetName by using the symbolic variables in Using symbolic variables.

DSSIZE (integerG);">)

DSSIZE is used to specify the data set size of the source table space. In most cases, the default value should be sufficient.

Important

DSSIZE is a part of the High-speed Structure Change process.

DSSIZE is used to specify the data set size of the source table space. In most cases, the default value should be sufficient.

Valid values are 0, 1G, 2G, 4G, 8G, 16G, 32G, 64G, 128G, and 256G. If the table space is not partitioned, the default is 2G. If the table space is partitioned and not a LARGE table space (has a 4-byte RID), the DSSIZE is calculated based on the number of partitions. If the table space is a LARGE type, the data set size is read from the header page. If the DSSIZE is not stored in the header page, you must specify DSSIZE in the SYSIN.

For more information, see the Recovery Management for Db2 documentation.

;">PIECESIZE (...)

Use PIECESIZE with TRANSFORM to specify the data set size of the source nonpartitioning index space. In most cases, the default value should be sufficient.

Important

PIECESIZE is a part of the High-speed Structure Change process.

RBA X'logPoint' or LOGPOINT X'logPoint'

RBA X'logPoint' or LOGPOINT X'logPoint' indicates the log point of the copy. The keywords RBA and LOGPOINT are interchangeable regardless of the version of Db2 used.

To recover to the current point or to a quiesce point, you must code a log point value on the last copy specified so that BMC AMI Recover knows at what point in the log to start obtaining log records for the table space or index.

If no log point is specified on the last copy, you must recover TOCOPY and no log is processed.

SHRLEVEL REFERENCE

SHRLEVEL REFERENCE indicates that the share level of the copy is REFERENCE. If you do not specify a value for SHRLEVEL, the default is REFERENCE.

SHRLEVEL CHANGE

SHRLEVEL CHANGE indicates that the share level of the copy is CHANGE.

ENCRYPTED

Use the ENCRYPTED option to specify that the specified copy is an encrypted image copy made by BMC AMI Copy. For more information about using encrypted copies, see Recovery-of-encrypted-copies.

Important

Encryption is a feature of the Recovery Management for Db2 solution and requires a valid Recovery Management for Db2 solution password.

TIMESTAMP timestamp

The TIMESTAMP option specifies the timestamp when the encrypted copy was registered in BMCXCOPY. The timestamp value determines which key from the key data set (specified by the KEYDSNAM installation option described on KEYDSNAM-keyDataSetName) BMC AMI Recover uses to decode the copy. The timestamp value uses either of the following formats:

yyyy-mm-dd-hh.mm.ss

yyyy-mm-dd-hh.mm.ss.nnnnnn

You can omit leading zeros from the month, day, or hour parts of the timestamp; you can omit trailing zeros from the microseconds part of the timestamp.

COMPRESSED

Use the COMPRESSED option to indicate that the specified image copy is a compressed copy of a compressed index made by DSN1COPY or BMC AMI Copy. For more information about BMC AMI Copy compressed copies of compressed indexes, see Copying compressed indexes in the BMC AMI Copy documentation.

INVOLUME

The INVOLUME specification gives the volume information for the copy indicated in the INCOPY specification.

INVOLUME CATALOG

INVOLUME CATALOG is the default and identifies the image copy data set as a cataloged data set. It specifies that the volume serial number should be obtained from the operating system catalog.

INVOLUME volSerialNumberList

INVOLUME volSerialNumberList identifies the image copy data set as uncataloged where volSerialNumberList provides the serial numbers of the volumes containing the image copy data set. Include all volume serials in the order needed. volSerialNumberList specifies a list of one or more volume serial numbers, separated by commas.

INDEVT deviceType

The deviceType parameter for INDEVT identifies the device on which the copy resides. It is required for uncataloged data sets.

INSEQNO integer

The integer parameter for INSEQNO is the sequence number of the data set containing the image copy data set on the tape volumes. If you specify INCOPY and INVOLUME volumeSerialNumber (to indicate an uncataloged data set) but do not specify INSEQNO, BMC AMI Recover assumes file sequence number one.

SLBPOOL copypool

Use the SLBPOOL option to specify the copypool of the system-level backup (SLB) to be used for recovery.

Example

SLBPOOL DJT

SLBVERSION(version)

Use the SLBVERSION option to specify the version of the system-level backup (SLB) to be used for recovery.

Example

SLBVERSION(50)

INCOPY specification

On this page