Previous Topic: DCMT VARY JOURNAL SyntaxNext Topic: DCMT VARY JOURNAL Usage


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

Fragment number

Specifies a fragment interval to reduce warmstart processing time.

fragment-number-interval

An integer between zero and the highest relative block number (RBN).

A value of zero turns off the journal fragment interval.

TRANSACTION level

Specifies a journal transaction level.

transaction-level

An integer in the range 0 to 9999.

SWAp

Directs CA IDMS to switch the active journal file from one file to another.

FILe journal-file-name

Specifies the name of the disk journal to be varied.

OFfline

Makes the specified disk journal file inaccessible to the system.

PERmanent Specifies that the OFFLINE status of the journal file is permanent. The status remains in effect until it is changed by another DCMT VARY command or the SYSTRK files are formatted.

The ability to record a status as permanent requires that change tracking be active. If change tracking is not active, the OFFLINE status is not made permanent and a warning message is issued.

dcmt-id Specifies the identifier that is assigned to this vary operation. It must be a 1- to 8-alphanumeric character string that is unique across all outstanding DCMT operations originating on this DC/UCF system.

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 using DCMT DISPLAY ID and DCMT VARY ID commands.

ONline

Makes the specified disk journal file accessible to the system.

ACtive

Enables access to the journal file and clears its status.

Varying the file active allows suspended transactions that are waiting on the journal file to resume execution.

Inactive

Disables access to the journal file and sets its status to 9999. No new journal images are written to the file, but it can still be read for recovery purposes.

The ability to vary journal files inactive is provided to simulate I/O errors for the purpose of testing recovery procedures.

ALlocate

Dynamically allocates the journal file using its currently assigned data set name.

DEallocate

Dynamically closes and deallocates the named file.

Force

Directs DC/UCF to mark the file as deallocated and closed, even though these actions were not taken. This option is useful for certain types of error conditions for which a close cannot be completed.

DSname new-dataset-name

Changes the DSname temporarily in the runtime DMCL to new-dataset-name. If the file has previously been opened, the DDname is cleared to blanks.

To change the DSname of a disk journal, it must be offline.

More Information