RECOVERY—Control Edit Recovery

RECOVERY sets edit recovery mode, which allows you to recover data after a system failure or power outage.

Syntax

Read syntax diagramSkip visual syntax diagramRECOVERYRECOVERRECOVRYRECVRYRECOVRECVRONSUSPOFFWARNNOWARN
ON
The system creates and updates a recovery data set for each change.
OFF
The system does not create and update a recovery data set.
WARN
This operand no longer has a practical function due to a software change. However, the primary command continues to accept the operand for compatibility reasons.
NOWARN
This operand no longer has a practical function due to a software change. However, the primary command continues to accept the operand for compatibility reasons.
SUSP
This operand functions the same as the ON operand.
Note: When SETUNDO is enabled during installation, both the RECOVERY primary command and edit macro command continue to accept the NOWARN and WARN keywords for compatibility reasons, but the value is ignored. NOWARN will always be in effect.

Description

You cannot edit data recursively while you are in recovery.

Attention:

If the data set to be recovered was edited by another user before edit recovery, the changes made by the other user will be lost if you save the recovered data.

See Undoing edit interactions for more information.

To turn on edit recovery mode:

  1. On the command line, type:
    RECOVERY ON

    RECOVERY can be abbreviated REC. This command can also ensure that your edit session is not lost due to a system failure.

  2. Press Enter. The editor begins recording an audit trail of your interactions. After a system failure, the editor uses that record to reestablish the edit session at the time of failure.
Note: For edit recovery to work properly, the data set to be recovered, the edit recovery data set, and the edit recovery table all must exist, be cataloged, and be intact. For example, with RECOVERY on, uncataloging a data set and then trying to recover it fails.

To turn off edit recovery mode:

  1. On the command line, type:
    RECOVERY OFF
  2. Press Enter. The editor stops recording your interactions. Edit recovery is not available following a system failure. When an edit session is recovered, the data is scrolled all the way to the left when the recovery edit session begins.

See Edit recovery for more information about edit recovery.