RECOVER

Syntax

── RECOVER ─┬──────────────────────────────┬───────────────────────────┤
            ├─<recovery number>─┬──────────┤
            │                   └─ REPEAT ─┤
            ├─ : ── ALL ───────────────────┤
            └─ : ── BRIEF ─────────────────┘

Explanation

The RECOVER command processes a recovery file that, depending on the setting of the AUTORECOVER option of the USERDATAFILE file attribute, can recall the previous work file and restart the last task-type command such as RUN, UTILITY, COMPILE, and so on. The user can recover a desired recovery file by specifying a recovery number.

When a recovery file is recovered, the FAMILY, LANGUAGE, CONVENTION, and PRINTDEFAULTS file attributes are restored to those in effect at the time the work file was saved. The last command that was processed before the creation of the recovery file is restored as the current command. That is, the command is displayed in response to a ?SH command.

If the automatic recovery is enabled, the last task-type command that was processing but abnormally terminated is queued for execution after the recovery process is complete. If the automatic recovery is not enabled and the REPEAT option is specified, then the command (regardless of its type) is queued for execution after the recovery process is complete.

If a recovery number is not specified with the RECOVER command and the AUTORECOVER option is set to TRUE for the session, then CANDE lists the recovery file in the following format:

#RECOVERY DATA:
   <recovery number> <work file name>  ( <date> )
     [station name]
     [last command]

   (Additional recovery files are listed in this format) 

When RECOVER is specified with the:ALL option, the recovery files are listed in the same format in the previous example, regardless of the setting of the AUTORECOVER option.

If a recovery number is not specified with the RECOVER command and the AUTORECOVER option is reset to FALSE for the session, then CANDE lists the recovery file in the following format:

#RECOVERY DATA:

   <recovery number> <work file name>  ( <date> )

   (Additional recovery files are listed in this format) 

When RECOVER is specified with the :BRIEF option, the recovery files are listed in the same format in the previous example regardless of the setting of the AUTORECOVER option.

For more information on recovery numbers, refer to the discussion of recovery files in General Information.

Note: Be cautious when you use the RECOVER command if your system is running multiple copies of CANDE, and you are logged on with the same usercode to at least two copies of CANDE. Because recovery files on one copy of CANDE are visible to other copies of CANDE, it is possible to recover recovery files created under other copies of CANDE, unless the copies of CANDE are different versions. For more information about multiple copies of CANDE, refer to General Information.

Examples

REC:B
#RECOVERY DATA ON USERPACK
  100 PAYABLE (04/21/91)
#

recover 100
#WORKFILE PAYABLE: SEQ