Previous Topic: DCMT VARY AREA SyntaxNext Topic: DCMT VARY AREA Usage


DCMT VARY AREA Parameters

broadcast-parms

Indicates to execute the DCMT command on all or a list of data sharing group members.

Note: For more information about broadcasting and broadcast-parms syntax, see the section How to Broadcast System Tasks.

Area

Specifies an area to vary.

segment-name

The name of the segment containing the area.

area-name

The name of the area.

PERmanent

Specifies that the new area status is assigned permanently. The status remains in effect until it is changed by another DCMT VARY command or the journal files are formatted.

Note: An area under the effect of a PERMANENT parameter is identified inthe journals by its page group and low-page number. If an area's page group or low-page number is changed while one of these commands is in effect, the specified usage-mode is not located and for subsequent startups CA IDMS defaults to the usage-mode specified in the DMCL. The old entry for the area remains in the journals until the journals are formatted.

Quiesce

Brings the named area to an inactive state. New transactions receive an error condition if they try to access the area. Currently executing transactions are allowed to finish processing.

Active

Brings the named area to an active state. You use this command to reactivate an area after you have brought the area to an inactive state by using the DCMT VARY AREA QUIESCE command.

PUrge

Flushes the buffers associated with the area.

PRefetch ON/OFf

Enables or disables prefetch processing for the named area.

DATa SHaring

Specifies the sharability state of the named area. The change is made only if the area status is OFFLINE. Valid values are:

ON

Specifies that this system is eligible to share update access to the area with other members of the system's data sharing group.

OFF

Specifies that this system is no longer eligible to share update access to the area with other members of the system's data sharing group.

SHAred CAche

Specifies the name or status of shared cache for all files associated with the named area. Valid values are:

cache-name

Specifies that all files associated with the named area are to be assigned to the named cache structure. Cache-name must identify an XES cache structure defined to a coupling facility accessible to the CA IDMS system.

NO

Specifies that the files associated with the named area are no longer assigned to a cache structure.

area-status

Update/ONline

Allows transactions executing in this DC/UCF system to update data in the area.

LOCKED

For an area that is offline, specifies that the area is to be varied online with an update lock. This allows you to vary online an area that was varied offline while an update lock was placed on it.

Retrieval

Allows transactions executing in this DC/UCF system to retrieve, but not update, data in the area. Retrieval locks against records accessed in the area are maintained based on the setting of the RETRIEVAL LOCK/NOLOCK parameter on the SYSTEM statement of the SYSGEN.

Transient retrieval

Allows transactions executing in this DC/UCF system to retrieve, but not update, data in the area. Retrieval locks are never maintained for records accessed from an area in Transient Retrieval mode.

ID dcmt-id

Specifies the identifier that is to be assigned to this vary operation. Must be a 1 to 8 alphanumeric character string that is unique across all outstanding DCMT operations originating on this node.

If no dcmt-id is specified, the VARY operation is assigned an internally generated identifier.

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

IMMediate

Specifies that CA IDMS will cancel any tasks or user sessions that prevent the VARY from completing.

OFfline

Makes the area unavailable to transactions running under the DC/UCF system.

file-status

ALlocate

(z/OS and z/VM systems only) Dynamically allocates all files associated with the specified area or segment. The files are allocated using their currently assigned data set name.

Close

Closes all files associated with the area or segment. This option is valid only when all areas or segments associated with the files are currently offline.

DEallocate

(z/OS and z/VM systems only) Dynamically deallocates all files associated with the specified area or segment.

Open

Opens all files associated with the area or segment in read-only mode.

If the files are already opened in read/write mode, DC/UCF closes the files and reopens them in read-only mode.

Update

Opens all files associated with the area or segment in read/write mode.

If the files are already opened in read-only mode, DC/UCF closes the files and reopens them in read/write mode.

More Information