QUICKCOPY—Invoke CA Quick Copy

The QUICKCOPY keyword invokes CA Quick Copy to create backup image copies.
cafrdb219
The QUICKCOPY keyword creates backup image copies by invoking
CA Quick Copy for DB2 for z/OS
. This keyword defines the copy type and specifies image copy parameters such as the number of copies to make. This keyword also specifies whether to update SYSIBM.SYSCOPY, the ddname or template for the allocation, the name of an exit module, and the copy type. You can create up to eight backup copies at once. You can also specify whether the copy is for local or remote (recovery) sites and whether the copy is a primary or backup copy. Repeat the parameters for each copy. If you do not specify the parameters and ddname for the backup image copy in the syntax, the image copy is allocated dynamically using the PQC parmlib settings.
When you include QUICKCOPY in a job, the object whose name most recently precedes the QUICKCOPY option is copied. To recover and copy multiple objects in one step, specify QUICKCOPY after each object clause (TABLESPACE
tsname
or INDEXSPACE
isname
).
QUICKCOPY is not valid with the REBUILD control statement.
This keyword has the following format:
QUICKCOPY [COPY
nn
][([
Y
|N][,
ddname
|
templatename
][,
exitname
][,
icbackup
][,
devtype
])]
  • COPY
    nn
    Specifies the copy number.
    Limits:
    01 - 08
    Example:
    Specify COPY01 to make copy #1, specify COPY02 to make copy #2, and so on.
  • Y|N
    Specifies whether to register the copy in the SYSIBM.SYSCOPY.
    Default:
    Y
  • ddname
    |
    templatename
    Specifies the ddname to use for the image copy data sets. A ddname is required when more than one image copy data set is generated for the given object.
    If you are using TEMPLATE control statements, this parameter specifies the template that contains the dynamic allocation parameters for the data sets.
    If you do not specify the ddname in the syntax, the image copy is allocated dynamically using the settings in the PQC parmlib member.
    Default:
    SYSCP
    n
    01 (
    n
    identifies the copy number)
    Example:
    SYSCP101 is the DD name that is referenced by the first task for the first copy (COPY01).
  • exitname
    Specifies the user exit.
  • icbackup
    Specifies the copy type. You can specify whether the copy is for local or remote (recovery) sites and whether the copy is a primary or backup copy. The type of image copy is stored in the ICBACKUP column of SYSIBM.SYSCOPY.
    The following options are valid only for sites where the LOCALSITE option of Db2 is installed:
    • LP—Local primary (This option is the default for COPY01.)
    • LB—Local backup (This option is the default for all copies except COPY01.)
    The following options are valid only for sites where the RECOVERYSITE option of Db2 is installed:
    • RP—Recovery primary
    • RB—Recovery backup
  • devtype
    Specifies the device type. This value updates the DEVTYPE column of the SYSIBM.SYSCOPY row for the image copy. If you do not define a device type, DEVTYPE is updated with a generic volume ID, such as 3420.
The default for QUICKCOPY is COPY01(Y,SYSCOPY) for a single copy and COPY01(Y,SYSCP101) for multiple copies.
Examples: QUICKCOPY
  • This example recovers two tablespaces and takes a backup image copy of each tablespace:
    //SYSIN DD * RECOVER TABLESPACE TDKATR.TSDEPT QUICKCOPY COPY01(Y,SYSCP101,,LP) TABLESPACE TDKATR.TSEMP93 QUICKCOPY COPY01(Y,EMPCP101,,LP)
  • This example recovers two tablespaces, but it copies only tablespace TSEMP93:
    //SYSIN DD * RECOVER TABLESPACE TDKATR.TSDEPT TABLESPACE TDKATR.TSEMP93 QUICKCOPY COPY01(Y,EMPCP101,,LP)
  • This example recovers a tablespace and an indexspace. A backup image copy of each object is taken and allocated dynamically using the PQC parmlib member settings:
    //SYSIN DD * RECOVER TABLESPACE TDKATR.TSDEPT QUICKCOPY INDEXSPACE TDKATR.XSDEPT93 QUICKCOPY
  • This example recovers a tablespace and takes a backup image copy using the dynamic allocation settings in the PQC parmlib member:
    //SYSIN DD * RECOVER TABLESPACE TDKATR.TSDEPT QUICKCOPY COPY01(Y,,,LP)
Use of QUICKCOPY with Dynamically Allocated Data Sets
You can specify QUICKCOPY to take an image copy while recovering multiple objects by using the following commands with dynamically allocated data sets:
  • RECOVER LIST
  • RECOVER OBJ-LIST
    RECOVER LIST and RECOVER OBJ-LIST are valid only with dynamic allocation.
  • RECOVER TABLESPACE
  • RECOVER INDEX
  • RECOVER INDEXSPACE
  • RECOVER DATABASE
You can use either of the following methods to allocate the image copy data sets dynamically:
  • TEMPLATE
    -- Is specified in the SYSIN, or in a data set whose ddname is specified in the OPTIONS control statement. For more information about TEMPLATE control statements, see the
    CA Quick Copy for DB2 for z/OS
    documentation and the IBM
    Db2 Reference Guide
    .
  • PQC Model
    -- Exists in the PQC parmlib member. For more information about using models, see the
    CA Quick Copy for DB2 for z/OS
    documentation.
CA Quick Copy for DB2 for z/OS
uses all templates or all PQC models for dynamic allocation. You cannot use templates and PQC models together in the same job step.
CA Quick Copy for DB2 for z/OS
determines which method to use by checking whether a template has been specified for a job step. If any templates have been specified and are available to a job step,
CA Quick Copy for DB2 for z/OS
uses templates. In this case, a template must exist for each name that is referenced in the COPY
nn
parameter of the QUICKCOPY keyword. If a template does not exist, the recover terminates with an error message.
Examples: Use Templates to Allocate Image Copy Data Sets Dynamically
  • The following example uses a list to identify the objects to recover. Templates are used to dynamically allocate the image copy data sets. The templates are defined in the SYSIN and are available to QUICKCOPY:
    TEMPLATE TMPACT01 DSN 'PQC.RCVRL32.&DB..&TS..&LR.&PB.&PA..P&TIME.' UNIT SYSDA TEMPLATE TMPACT02 DSN 'PQC.RCVRL32.&DB..&TS..&LR.&PB.&PA..B&TIME.' UNIT SYSDA LISTDEF LIST32ALL INCLUDE TABLESPACES DATABASE PQCDB32 RECOVER LIST LIST32ALL QUICKCOPY COPY01(Y,TMPACT01,,LP) COPY02(Y,TMPACT02,,LB) INLINE-COPY YES SORTLOG YES ALLMSGS
  • The following example uses templates to recover two tablespaces and make a backup image copy of each tablespace. Templates are used to dynamically allocate the image copy data sets:
    //SYSIN DD * TEMPLATE ICTEMPLT DSN 'TSDUMP.&DB..&TS..&LR.&PB.&PA.(+1)' RECOVER TABLESPACE TDKATR.TSDEPT QUICKCOPY COPY01(Y,ICTEMPLT,,LP) TABLESPACE TDKATR.TSEMP93 QUICKCOPY COPY01(Y,ICTEMPLT,,LP)