QUIESCE global options

The Global QUIESCE global options apply to the entire QUIESCE statement and not to a specific TABLESPACE, RMGROUP, OBJECTSET, or APPLICATION.

QUIESCE global options can only be defined once for a single QUIESCE command. Keywords within to the QUIESCE global options can be used in any order.

QUIESCE global options

Option

Description

GROUP

Use the GROUP option to tell BMC AMI Copy whether the spaces specified in the Object List should be treated as a group and share a common quiesce point.

Values of GROUP

Value

Description

GROUP NO

(Default) GROUP NO indicates that the Object List should not be treated as a group.

GROUP YES

GROUP YES indicates that the Object List should be processed as a group and share a common quiesce point. GROUP YES is implied when a single QUIESCE command is followed by multiple TABLESPACE, RMGROUP, or OBJECTSET statements. Caching for all spaces in the group starts at BMC AMI Copy initialization for the group.

Important

When you use the QUIESCE command with more than 1165 objects, BMC AMI Copy breaks the quiesce up into multiple commands due to restrictions on the number of objects. This means that even if you specify GROUP YES, you will not obtain a common quiesce point for all objects. To obtain a common quiesce point, -ARCHIVE LOG MODE(QUIESCE) is one option.

ON ERROR BADSTATUS

The ON ERROR BADSTATUS option allows you to specify what action BMC AMI Copy is to take if a space or partition is in an unacceptable status or has a BMC or Db2 utility running against it.

Values of ON ERROR BADSTATUS

Value	Description
ON ERROR BADSTATUS END	(Default) ON ERROR BADSTATUS END indicates BMC AMI Copy is to terminate processing with a RC=12.
ON ERROR BADSTATUS SKIP	ON ERROR BADSTATUS SKIP causes BMC AMI Copy to issue a message, skip over the space, and continue processing other spaces specified in SYSIN. If a space is skipped because of ON ERROR BADSTATUS SKIP, the space will not be retried if the job abends and you retry the job with a NEW/RESTART. Warning Important You can use ON ERROR BADSTATUS SKIP to skip spaces in UTRO, UTRW, or UTUT status.

ON ERROR NOTSUPPORTED

The ON ERROR NOTSUPPORTED option allows you to specify what action BMC AMI Copy is to take if a space or partition is an unsupported type in BMC AMI Copy.

WRITE

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

Values of WRITE

Value	Description
WRITE YES	(Default) WRITE YES tells Db2 to establish a quiesce point and write the changes pages for the table space and index space to DASD.
WRITE NO	WRITE NO tells Db2 to establish a quiesce point and to not write the changed pages to DASD.

Values of ON ERROR NOTSUPPORTED

Value	Description
ON ERROR NOTSUPPORTED SKIP	ON ERROR NOTSUPPORTED SKIP causes BMC AMI Copy to issue a message, skip over the space, and continue processing other spaces specified in SYSIN.
ON ERROR NOTSUPPORTED END	ON ERROR NOSUPPORTED END, the default, indicates BMC AMI Copy is to terminate processing with a RC=12 if an unsupported type is encountered.