QUIESCE command

The authorization for performing a quiesce is the same as that used for making a copy.

The BMC AMI Copy QUIESCE command can run concurrently with other BMC utilities that use SHRLEVEL S or blank, but cannot run concurrently with other BMC AMI Copy jobs against the same space. The QUIESCE command sets SHRLEVEL S and ORIG_STATUS as NULL.

Spaces to be quiesced can be in one of the following statuses:

• RW
• RO
• UT
• UTRW
• UTRO—If it is in UTRO, the space is sent to the Db2 QUIESCE utility, but might fail based on its rules for concurrency.
• UTUT—If it is in UTUT and you have specified UTRETRY=YES, BMC AMI Copy will wait and retry.

Using QUIESCE does not directly modify the status of the table space, although the QUIESCE utility acquires an S lock on the space and puts the space in UTRO status.

When using the BMC AMI Copy QUIESCE command, DB2WAIT and DB2NTRY, as set in the installation options or on the OPTIONS statement, are used to perform waits and retries on failures.

When using the BMC AMI Copy SOFT QUIESCE YES, DRAINWAIT, and DRAINDELAY are used along with DRAINRETRY.

BMC AMI Copy bypasses the table space if the VSAM data set does not exist due to the use of the DEFINE NO option in Db2.

Catalog and directory spaces can be quiesced but SYSUTILX cannot be quiesced in a group, so it must be specifically excluded.

The following figure shows the syntax for the QUIESCE command with default values underscored.

When you use the QUIESCE command in the utility job input, these rules apply:

• The first keyword you specify must be either TABLESPACE, RMGROUP, OBJECTSET, or APPLICATION.
• You can specify keywords shown in the Object Options in any order.
• You can specify keywords shown in the QUIESCE syntax in any order.
• A single data set of a multi-data-set, nonpartitioned space cannot be quiesced.
• If you do not specify an option that is required during processing, BMC AMI Copy uses the default value of that option.
• You cannot split a token, such as a keyword or identifier, across lines.
• 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 column 1 through 70 also makes the rest of the line a comment.
• TABLESPACE values follow the same rules used for COPY TABLESPACE. The TABLESPACE specification can include wildcards or it can be a list.

• A single QUIESCE command can be followed by multiple TABLESPACE specifications. This allows you to group and use a different value per TABLESPACE for the following options:

  • DSNUM (not applicable to RMGROUP or OBJECTSET)
  • EXCLUDE
  • PART

  When grouping, the options listed above apply to the most previous TABLESPACE. Only one set of the remaining options, which are referred to as global options (see below), can be specified for a group.

  You can use grouping without dynamic allocation by specifying different values for DSNUM ALL or DSNUM integer.

• The following options are global options for the QUIESCE command and you should specify them only once per QUIESCE command:
  • WRITE
  • ON ERROR BADSTATUS
  • GROUP 

QUIESCE command syntax