The
RECOVERY macro command sets edit recovery mode, which allows you to
recover data after a system failure or power outage.
The RECOVERY
assignment statement either sets edit recovery mode, or retrieves
the edit recovery mode setting and places it in a variable.
Syntax
Macro command syntax
.-ON-.
>>-ISREDIT--RECOVERY--+-+----+--+------+-+---------------------><
| '-SUSP-' |
'-OFF--+--------+--'
+-WARN---+
'-NOWARN-'
- ON
- The system creates and updates a recovery data set for each change
thereafter.
- OFF
- The system does not create and update a recovery 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, when specified with the ON operand has no function.
It allows existing macros which save and restore the recovery state
to continue working. When SUSP is specified by itself, it functions
like the ON operand.
See Edit recovery for
more information about edit recovery.
Assignment statement syntax
>>-ISREDIT--(var1,var2)-- = --RECOVERY-------------------------><
Macro command syntax
.-ON-.
>>-ISREDIT--RECOVERY-- = --+-+----+--+------+-+----------------><
| '-SUSP-' |
'-OFF--+--------+--'
+-WARN---+
'-NOWARN-'
- var1
- The name of a variable to contain the setting of recovery mode,
either ON or OFF.
- var2
- The name of a variable that contains the warning setting, either
WARN, NOWARN (when RECOVERY is OFF), or blank or SUSP (when RECOVERY
is ON).
- ON
- The system creates and updates a recovery data set for each change
thereafter.
- OFF
- The system does not create and update a recovery 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 value indicates that recovery is ON, but that it is suspended
due to a previous error.
Return codes
- 0
- Normal completion
- 20
- Severe error
Examples
To save the value of recovery
mode in variable &RECOV:
ISREDIT (RECOV) = RECOVERY
To
set recovery mode OFF:
ISREDIT RECOVERY = OFF