-BUFFER_FLUSH

Flushes to disk the file header and all cache buffers for all regions specified by the current Global Directory. The -BUFFER_FLUSH qualifier is incompatible with the -RENEW qualifier.

-C[RITINIT]

Initializes critical sections for all regions specified by the current Global Directory. The -CRITINIT qualifier is incompatible with the -RENEW, -RELEASE, and -SEIZE qualifiers.

-[NO]F[REEZE]

Allows a user to freeze, or prevent updates to, GDS regions specified by the current Global Directory. The -FREEZE qualifier freezes all such GDS regions except those previously frozen by another user. Regions frozen by a particular user are associated with that user. A frozen region may be updated in one of two ways: The user who froze the region may unfreeze it with the -NOFREEZE qualifier; or another user may override the freeze in conjunction with the -OVERRIDE qualifier.

For information about a preferred method of manipulating FREEZE, refer to the MUPIP FREEZE section of the "MUPIP" chapter.

By default, the -NOFREEZE qualifier unfreezes only those GDS regions that were previously frozen by the user the process. Once a region is unfrozen, it may be updated by any user. To unfreeze all GDS regions of the Global Directory, use the -OVERRIDE qualifier.

The -FREEZE qualifier is incompatible with the -RENEW qualifier.

DSE releases -FREEZE when it EXITs. To hold all databases, enter ALL FREEZE and then SPAWN to perform other operations

-O[VERRIDE]

The -OVERRIDE qualifier is meaningful only with the -FREEZE or -NOFREEZE qualifiers. When used with -NOFREEZE it unfreezes all GDS regions, including those frozen by other users. When used with -FREEZE, the -OVERRIDE qualifier freezes all GDS regions, including those frozen by other users, associating all such freezes with the current user. The current user must then use the /NOFREEZE qualifier to unfreeze the database; any other user attempting a -NOFREEZE would also have to include the -OVERRIDE qualifier.

-REF[ERENCE]

Resets reference counts to 1 for all regions specified by the current Global Directory. The -REFERENCE qualifier is incompatible with the -RENEW qualifier.

-REL[EASE]

Releases critical sections for all regions specified by the current Global Directory. The -RELEASE qualifier is incompatible with the -CRITINIT, -RENEW, and -SEIZE qualifiers.

-REN[EW]

Reinitializes critical sections (-CRITICAL) and buffers (-WCINIT), resets reference counts (-REFERENCE_COUNT) to 1, and clears freeze flags for all regions specified by the current Global Directory (-NOFREEZE). -RENEW requires confirmation. The -RENEW qualifier is incompatible with all other qualifiers.

-S[EIZE]

Seizes the critical section for all regions specified by the current Global Directory. The -SEIZE qualifier is incompatible with the -CRITINIT, -RELEASE, and -RENEW qualifiers.

The -SEIZE qualifier can be useful when you encounter a DSEBLKRDFAIL error, generated when DSE is unable to read a block from the database.

-W[CINIT]

Reinitializes buffers for all regions specified by the current Global Directory. -WCINIT requires confirmation. The -WCINIT qualifier is incompatible with the -RENEW qualifier.