Previous Topic: DCMT VARY SEGMENT SyntaxNext Topic: DCMT VARY SEGMENT Usage

DCMT VARY Commands › DCMT VARY SEGMENT › DCMT VARY SEGMENT Parameters

DCMT VARY SEGMENT 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.

segment-name

Specifies the name of the segment.

DATa SHaring

Specifies the sharability state of all areas in the named segment. The change is only made to areas whose status is OFFLINE. Valid values are:

ON

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

OFf

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

SHAred CAche

Specifies the name or status of shared cache for all files in the named segment. Valid values are:

cache-name

Specifies that all files associated with the named segment 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 segment are no longer assigned to a cache structure.

area-status

For a description of the options, see the area-status.

file-status

For a description of the options, see the file-status.

dcmt-id

Specifies the identifier that is to be assigned to this vary operation. Must be a 1 - 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 cancels any tasks or user sessions that prevent the VARY from completing.

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.

More Information