COPY IMAGECOPY command


The COPY IMAGECOPY command allows you to make local and recovery site image copies after making and registering a primary copy in:

  • The SYSIBM.SYSCOPY table for table spaces and for indexes defined with COPY YES
  • The BMCXCOPY table for data set level copies of nonpartitioning indexes as well as for indexes with the COPY NO attribute
  • The SYSCOPY table for Instant Snapshots registered as Flash Copies, which are made by specifying DSSNAP YES or DSSNAP AUTO on the OUTPUT statement (see DSSNAP)

    The COPY IMAGECOPY command can make a standard copy from an Instant Snapshot. In order to make a standard Db2 copy from an Instant Snapshot primary copy of a single data set of a multi-data-set, nonpartitioned table space, BMC AMI Copy might require Instant Snapshot primary copies of the other data sets of the space. These Instant Snapshot copies must all be registered in SYSCOPY at the same RBA (LRSN).

The primary copy can be a full image copy or an incremental image copy for table spaces and indexes. For Instant Snapshots, the image copy is always a full image copy.

You can also use the COPY IMAGE COPY command to copy large format data sets.

Important

We recommend that you make both local site copies (LP and LB) using the COPY command (in case one fails) and then make recovery site copies (RP and RB) using the COPY IMAGECOPY command.

You can either specify dynamic allocation of the copy data sets or allocate them in the JCL, regardless of how the original primary copy was specified. BMC AMI Copy registers the new copies in the SYSIBM.SYSCOPY table or in the BMCXCOPY table with the same RBA (or LRSN) value and the same SHRLEVEL, ICTYPE, TIMESTAMP, ICTIME, and ICDATE values as the original copy.

If COPY IMAGECOPY makes a backup copy of a primary copy that is an Instant Snapshot, the backup copy is registered in BMCXCOPY. If COPY IMAGECOPY is used to make a new RP or LP copy of an existing primary copy that is an Instant Snapshot, the new copy will be registered in SYSCOPY. For more information, see Registration-of-Instant-Snapshots.

You can use COPY IMAGECOPY to make copies of online consistent copies that are made by the Recovery Management for Db2 solution. For information, see COPY-IMAGECOPY-support-for-online-consistent-copies.

You should also use COPY IMAGECOPY to make copies of cabinet copies. BMC AMI Copy saves the volume information about cabinet copies in BMCXCOPY. This information is required to process a cabinet copy. If you copy a cabinet copy with a z/OS utility, the volume information is not available and BMC AMI Recover cannot use copy. For more information about cabinet copies, see Making-cabinet-copies.

The COPY IMAGECOPY command is invalid in the following conditions:

You cannot make a second copy of a type already registered. The type is recorded in the ICBACKUP column of the SYSIBM.SYSCOPY or BMCXCOPY table where:

  • Blank is for local primary copies
  • FC is for FlashCopy
  • LB is for local backup copies
  • RP is for RECOVERYSITE primary copies
  • RB is for RECOVERYSITE backup copies

See Using-COPY-IMAGECOPY-to-make-duplicate-image-copies.

The following figure shows the syntax for the COPY IMAGECOPY command with defaults underscored.

When you use the COPY IMAGECOPY command in the SYSIN data set, the following rules apply:

  • The first option you specify must be TABLESPACE, INDEXSPACE, INDEX, RMGROUP, RMGROUPIX, OBJECTSET, or APPLICATION.
  • You can specify the other options in any order. However, if you specify COPYDSN or RECOVERYDSN, you must specify them after the corresponding COPYDDN or RECOVERYDDN options.
  • The table space name, index space name, RMGROUP name, RMGROUPIX name, OBJECTSET name, or APPLICATION is required (explicitly or by wildcard).
  • An asterisk in column 1 in the SYSIN data set specifies that the line is a comment that will not be echoed in the SYSPRINT output. A double hyphen (--) coded in columns 1 through 70 also makes the rest of the line a comment.
  • You can specify the start RBA value of the image copy to be copied using either ATRBA or ATLOGPOINT. (These keywords are synonymous.) 

COPY IMAGECOPY syntax diagrams

COPY IMAGECOPY command syntax 

3_COPY IMAGECOPY command syntax1.png


 COPY IMAGECOPY command syntax

GUID-4295CD5F-808F-4884-B382-6E698E73CE9F-low.png

 COPY IMAGECOPY command syntax
GUID-2D74B17E-F3FA-4AD2-8FDD-9497699229B2-low.png

 COPY IMAGECOPY object list syntax diagram
GUID-FF063AE4-9FAA-41C5-86CB-D54B0E21EF53-low.png

This section contains the following topic:

 

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