/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.

Just before breaking database on shadowed disks, it is important to freeze updates and then flush all regions. Failure to do so will result in a database with integrity errors on the shadowed copy. If you are doing this to backup your database without bringing down your application, Fidelity reccomends MUPIP BACKUP/ONLINE as the preferred alternative.

/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.

This causes all processes currently accessing the databases specified by the current Global Directory to terminate with an error.

	Caution
	Such action may cause database damages when used while concurrent updates are in progress.

/[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 operations such as breaking a shadow.

/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.