Copyright Digital Equipment Corp. All rights reserved.

/RECOVER

 /RECOVER
 /NORECOVER (default)

 Determines whether TPU recovers your edits by reading the journal
 file from the interrupted editing session.  (See help on /JOURNAL.)

 There are two ways to recover your edits, depending on the type of
 journaling you used:

 o  If you used buffer-change journaling, which is the EVE default,
    you can recover one or more buffers at a time and you can recover
    buffers from different editing sessions.  For example, the
    following command invokes EVE to recover the text of a file named
    JABBER.TXT:

       $ EDIT/TPU jabber.txt /RECOVER

    This is the same as invoking EVE and using the following command:

       Command:  RECOVER BUFFER jabber.txt

    If there is more than one buffer-change journal file with the same
    name---for example, you may have two or more MAIN.TPU$JOURNAL
    files from different editing sessions---the recovery uses the
    highest version number available.  To recover several text
    buffers, one after another, use the RECOVER BUFFER ALL command.

    Recovery with a buffer-change journal file restores only your text
    ---it does not restore settings, key definitions, and other
    customizations and it does not restore the contents of the Insert
    Here buffer or other system buffers.  The recovery is usually
    quite fast.  New text or other changes are then journaled.

    The recovery does not re-create deleted files.  If you deleted or
    renamed the source file associated with a buffer-change journal,
    the recovery fails.  The source file is either the file initially
    read into the buffer (if any), or the last version of the file
    written from the buffer before the system failure.

    If you specify multiple input files on the EDIT/TPU command line,
    EVE tries to recover each file.

 o  If you used keystroke journaling, you recover your editing session
    by reissuing the same command for the original, aborted editing
    session---including all qualifiers---and adding /RECOVER.  EVE
    then recovers your editing session in a "player piano" fashion.
    For example, the following commands invoke TPU creating a
    keystroke journal file, and then, after a system failure, recover
    the editing session:

       $ EDIT/TPU /JOURNAL=myjournal.tjl
                  .
                  .
       ***  system failure  ***
                  .
                  .
       $ EDIT/TPU /JOURNAL=myjournal.tjl /RECOVER

    Typically, after the recovery, you exit to save your edits.

 Keystroke journaling does not work on DECwindows and has other
 restrictions, as follows.  These restrictions do NOT apply to buffer-
 change journaling.

 o  To recover your edits with a keystroke journal file, all relevant
    files must be in the same state as at the start of the session
    being recovered---including any files you wrote out (saved) before
    the system failure.  Therefore, before doing the recovery, you
    should rename the saved versions or move them to a different
    directory, to ensure that the recovery uses the original versions
    of the files.  You must specify multiple input files in the same
    order as in the original command line.

 o  Check that any logical names for your section file, command file,
    and initialization file are defined as for the original editing
    session, and that the recovery will use the correct version of
    these files.

 o  Check that the following terminal settings are the same as when
    you began the original editing session, because they may affect
    how your keystrokes are replayed:

       Device_Type
       Edit_mode
       Eightbit
       Page
       Width

 o  Recovery with a keystroke journal file may fail or may not work
    properly if you used CTRL/C during the original editing session.
    CTRL/C is not recorded in the keystroke journal file.  Therefore,
    during recovery, an operation that was canceled with CTRL/C is
    replayed without interruption; this is likely to affect how the
    remaining keystrokes are replayed.

 o  If you used EVE in a subprocess (as a "kept" editor), the
    keystroke journal file records ATTACH, DCL, and SPAWN commands in
    EVE, but does not record operations done in the other process or
    subprocess.  If these other operations affected any files used in
    the original editing session---for example, if you spawned a
    subprocess from EVE and then purged, renamed, deleted, or modified
    any relevant files---the recovery may fail or may not work
    properly.

 o  If you used the EVE command DCL, the recovery with a keystroke
    journal file may fail or may not work properly, particularly if
    you cut a file name from a directory list in the DCL buffer, and
    pasted it into an EVE command line.  The keystroke recovery
    replays the operations, but the directory list or the file name
    may not be the same as in the original session.

 For more information about journaling and recovery, see the
 Extensible Versatile Editor Reference Manual or use the online help
 in EVE and read the topic called Journal Files.

 +-----------------------------  NOTE  ------------------------------+
 | Although journaling and recovery are quite reliable, the last few |
 | edits before a system failure may be lost.  The safest way to     |
 | protect your work against a system failure is to write out your   |
 | edits frequently---particularly during all-day editing sessions.  |
 +-------------------------------------------------------------------+