Previous Topic: DCMT QUIESCE Command SyntaxNext Topic: DCMT QUIESCE Command Usage


DCMT QUIESCE Command Parameters

ARea

Indicates that one or more areas are to be quiesced. Valid values are:

segment-name.area-name

Specifies the name of the area to be quiesced.

area-star-name

Specifies that all areas whose name begins with the specified alphanumeric characters are quiesced. Area-star-name is a character string whose last character is an asterisk (*) that denotes a wild card character.

In this example, CA IDMS quiesces all areas whose segment name begins with PROD:

dcmt q area prod*

SEGment segment-name

Specifies that all areas associated with the named segment are to be quiesced.

DBName dbname

Specifies that all areas associated with segments that are included in the named dbname are to be quiesced.

q-options

Specifies the options that are to be used for this quiesce operation.

WAIt

Specifies that the quiesce operation waits for conflicting tasks or user sessions to relinquish update control of the area. This is the default behavior if neither WAIT nor IMMEDIATE is specified.

wait-interval

Specifies the amount of time, in real-time seconds, the quiesce operation waits for conflicting tasks or user sessions to relinquish update control of the area. If a wait interval is not specified, the quiesce operation waits indefinitely.

END

Specifies that if the areas cannot be quiesced within the specified wait interval, the quiesce operation terminates. This is the default behavior if END or FORCE is not specified.

FORce

Specifies that if the areas cannot be quiesced within the specified wait interval, conflicting tasks and user sessions are cancelled in order to reach a quiesce point.

IMMediate

Specifies that the quiesce operation immediately cancels any tasks or user sessions that are accessing a target area in an update mode.

NOHold

Specifies that once the quiesce point has been established, the quiesce operation automatically terminates. This is the default if neither HOLD nor NOHOLD is specified.

HOLd

Specifies that once the quiesce point has been established, the quiesce operation continues until explicitly terminated by a DCMT VARY ID command.

NOSwap

Specifies that no journal swap should be initiated automatically once the quiesce point has been established. This is the default if neither SWAP nor NOSWAP is specified.

SWAp

Specifies that once the quiesce point has been established, a journal swap is initiated.

dcmt-id

Specifies the identifier that is to be assigned to this quiesce operation. Dcmt-id must be a 1 - 8 alphanumeric character string that is unique across all outstanding DCMT operations originating on this node.

The identifier can subsequently be used to monitor or terminate the quiesce operation using DCMT DISPLAY ID and DCMT VARY ID commands.