Previous Topic: DCMT VARY FILE SyntaxNext Topic: DCMT VARY FILE Usage


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

File

Identifies a specific file.

segment-name

The segment associated with the file.

file-name

The name of the file.

SYSTRK-file-name

The name of the SYSTRK file.

OPen

Opens the file in read-only mode.

If the file is open in read/write mode, DC/UCF closes the file and reopens it in read-only mode.

Note: SYSTRK files are always opened in read-write mode.

OPen Update

Opens the file in read/write mode.

If the file is open in read-only mode, DC/UCF closes the file and reopens it in read/write mode.

Close

Closes the file.

ACtive

Enables access to the file and clears its status. If the file is not open, it is opened the next time it is accessed. Varying the file active allows suspended transactions that are waiting on the file to resume execution.

If this is a SYSTRK file, its mirror status is changed to active or activating. Before an activating mirror becomes active, its contents are brought up-to-date.

Inactive

Disables access to the file and sets its status to 9999 if this is a database file. The ability to vary database files inactive is provided to simulate I/O errors for the purpose of testing recovery procedures.

If this is a SYSTRK file, its mirror status is changed to inactive. If this is the last active mirror, change tracking is inactivated.

ALlocate

(z/OS and z/VM systems only) Allocates the file dynamically, using its currently assigned data set name and other options specified on its definition.

DEallocate

(z/OS and z/VM systems only) Dynamically deallocates the named file making it unavailable to CA IDMS.

Force

Directs DC/UCF to set the status of the file as deallocated and closed, even though it has not been closed.

DAtaspace No/Yes

Closes the file, then switches to either a data space file (Yes) or to a non-data space file (No), and then re-opens it.

Note: This VARY type is not supported for SYSTRK files.

DSname new-dataset-name

Changes the data set name of a database file in the runtime DMCL to new-dataset-name. If the file has not been opened, then only the DSname is changed. If the file has previously been opened, then the DSname is changed, and the DDname is cleared to blanks.

Data set names of SYSTRK files cannot be changed.

DISp Old/Shr

Changes the disposition in the FCB (DMCL) for the file.

Note: This VARY type is not supported for SYSTRK files.

PRefetch ON/OFF

Enables or disables prefetch processing for the named file.

Note: This VARY type is not supported for SYSTRK files.

MEMORY CACHE

Specifies whether to cache the file in memory.

NO

Specifies to not cache the file in memory.

Note: This is the default for SYSTRK files and cannot be changed.

YES

Specifies to cache the file in memory.

SHAred CAche

Specifies the name or status of shared cache to which the file is assigned. The valid values are the following:

cache-name

Specifies the name of a shared cache to which the file is assigned.

NO

Specifies that the file is not to participate in a shared cache, even if another CV has the shared cache option enabled for this file. NO is the default.

Note: This is the default for SYSTRK files and cannot be changed.

More Information