/sys$common/syshlp/EVE$HELP.HLB  —  RECOVER_BUFFER
  RECOVER BUFFER

  Recovers a text buffer after a system failure, by using the buffer-change
  journal file for the buffer.

  The recovery restores only your text---it does NOT restore settings, key
  definitions, or the contents of system buffers (such as the INSERT HERE
  buffer) before the system failure.

  Steps:

  1.  If a system failure interrupts your editing session, invoke EVE again.
      You need not use the /RECOVER qualifier and you need not specify a
      file.

  2.  Use the RECOVER BUFFER command and specify the name of the buffer or
      file you want to recover, or the name of the journal file for the
      buffer. For example, to recover the MAIN buffer, use the following
      command:

         Command: RECOVER BUFFER MAIN

  3.  If the journal file for that buffer is available, EVE shows the
      following information and asks whether to recover that buffer:

         *  Buffer name
         *  Original input file (if any) for the buffer
         *  Output file (if any) for the buffer
         *  Source file (if any) for recovery
         *  Starting date and time of the editing session
         *  Journal file creation date and time

      If you want to recover the buffer, simply press RETURN. (The recovery
      is usually quite fast.) Otherwise, type No, and press RETURN.

  Usage notes:

  o  You can recover buffers from different editing sessions. For a list of
     all the journal files available, specify the asterisk wildcard (*):

        Command: RECOVER BUFFER *

     EVE then lists the available journal files so you can choose the one
     you want (see help on Choices Buffer). Alternatively, to get a list of
     your buffer-change journal files, use the following command:

        Command: DCL DIRECTORY TPU$JOURNAL:*.TPU$JOURNAL;*

  o  The journal file name derives from the name of the buffer or file you
     were editing and the file type .TPU$JOURNAL. For example, if you edit a
     file named MEMO.TXT, its journal file is MEMO_TXT.TPU$JOURNAL. On VMS,
     buffer names and file names are not case-sensitive.

  o  To recover all your buffers---that is, each buffer for which there is a
     journal file---use RECOVER BUFFER ALL.

  o  If you specify a buffer that already exists---typically, the MAIN
     buffer---EVE first deletes the buffer (prompting you to confirm the
     deletion, if necessary) before doing the recovery.

  o  If there is more than one version of a buffer-change journal file---for
     example, there may be two or more MAIN.TPU$JOURNAL files from different
     editing sessions---RECOVER BUFFER uses the highest version number
     available.

  o  The recovery does not re-create deleted files or buffers. If you
     deleted or renamed the source file associated with a buffer-change
     journal file, 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.

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

  Related topics:

     Journal Files     RECOVER BUFFER ALL     SET JOURNALING
Close Help