QUIESCE BEFORE and QUIESCE AFTER

You can use the QUIESCE BEFORE and QUIESCE AFTER options to establish a quiesce point for a target space or partition during the copy process:

  • QUIESCE BEFORE causes the target space or partition to be quiesced during the UTILINIT phase before the COPY phase begins.
  • QUIESCE AFTER causes the target space or partition to be quiesced during the UTILTERM phase after the COPY phase completes.

Related topic

Global-COPY-options


Important

If a QUIESCE is needed for the index space, the table space that the index is associated with must be quiesced because the index space cannot be quiesced directly. (STARTRO on an index space and QUIESCE on its table space is used to establish consistency during initialization.) If the table space is COPY-pending status, it will not be quiesced unless it is being copied in the same group.

 QUIESCE BEFORE and QUIESCE AFTER syntax diagram
GUID-3F9AE062-121A-4970-ACB0-BE9EA6B431ED-low.png

These options are especially useful when you specify SHRLEVEL CHANGE. Quiescing within BMC AMI Copy execution includes wait and retry logic for the Db2 QUIESCE utility, which results in the less manual intervention than retrying a failed Db2 QUIESCE job step. You can also use the WRITE option when specifying QUIESCE AFTER.

BMC AMI Copy automatically issues a QUIESCE at the beginning of a SHRLEVEL REFERENCE or CONCURRENT copy, unless the space is in COPY-pending status, regardless of whether you otherwise specify a QUIESCE option. The quiesce operation must complete successfully for the COPY phase to begin. For more information, see Db2-commands-issued-by-BMC-AMI-Copy-for-read-and-write-databases.

For more information, see Using-the-SHRLEVEL-option. Also, Db2-commands-issued-by-BMC-AMI-Copy-for-read-and-write-databases describe table space status changes made by BMC AMI Copy for various scenarios involving the use of the SHRLEVEL option.

Important

When you use the QUIESCE BEFORE option and the space or partition cannot be quiesced, BMC AMI Copy issues the warning message BMC30127, continues with the copy processing, and issues a return code 4 if no other issues occur. However, if BMC AMI Copy needs to issue a quiesce, and the space or partition cannot be quiesced, BMC AMI Copy issues a return code 12. In cases where BMC AMI Copy needs to issue a QUIESCE and the space is in COPY-pending status, BMC AMI Copy first resets COPY-pending status, then issues the QUIESCE.

Option

Description

WRITE

The WRITE option tells Db2 whether to, in addition to establishing a quiesce point, write the changed pages to DASD.

Value

Description

WRITE YES

WRITE YES is the default and tells Db2 to establish a quiesce point and write the changes pages for the table space and index space to DASD.

WRITE NO

Specify WRITE NO to tell Db2 to establish a quiesce point and to not write the changed pages to DASD.

Important

If QUIESCE BEFORE WRITE NO is coded, it is ignored, BMC47320I is issued, and BMC AMI Copy does a QUIESCE BEFORE WRITE YES.


 

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