HELPLIB.HLB  —  EDIT  /TPU  /JOURNAL
  /JOURNAL[=journal-file] (default)
  /NOJOURNAL

  Determines the type of journaling, if any.  Journaling records your
  edits so that if a system failure interrupts your editing session,
  you can recover your work.  Processing this qualifier depends on the
  TPU application you are using.

  Normally, journal files are deleted when you exit or quit.  If a
  system failure occurs during your editing session, such as a break in
  communications between your terminal and computer, the journal files
  are saved.  For information about recovering your work, see help on
  /RECOVER.

  +--------------------------  NOTE  --------------------------+
  | Journal files record information about the text you edit.  |
  | Therefore, if you are editing confidential data, make sure |
  | the journal files, as well as the text files, are secure.  |
  +------------------------------------------------------------+

  There are two types of journaling, as follows:

  o  Buffer-change journaling creates a journal file for each text
     buffer.  This is the EVE default.  Buffer-change journaling works
     on DECwindows or character-cell terminals.  The journal file name
     derives from the name of the file or buffer being edited and the
     file type .TPU$JOURNAL---for example:

        Text buffers          Buffer-change journal files
        -------------------------------------------------
        MAIN                  MAIN.TPU$JOURNAL
        JABBER.TXT            JABBER_TXT.TPU$JOURNAL
        GUMBO_RECIPE.RNO      GUMBO_RECIPE_RNO.TPU$JOURNAL
        NEW TEST DATA         NEW_TEST_DATA.TPU$JOURNAL
        * TEMP *              __TEMP__.TPU$JOURNAL

     Buffer-change journal files are created in the directory defined
     by the TPU$JOURNAL logical name.  Default is SYS$SCRATCH, which is
     usually your top-level, login directory.  Because buffer-change
     journal files may be quite large---even larger than the files you
     edit---you may want to define TPU$JOURNAL as a different disk and
     directory.

     Some editing operations may be slower because of buffer-change
     journaling, depending on the type or extent of changes, such as
     cutting a large box, or pasting a large amount of text from the
     DECwindows clipboard.

  o  Keystroke journaling creates a single journal file for the editing
     session, regardless of the number of buffers you create.  The
     journal file records every keystroke in the editing session,
     whether text or commands.  To enable keystroke journaling, use
     /JOURNAL= and specify the journal file you want created.  You
     cannot use wildcards to specify the keystroke journal file.
     Default file type is .TJL.

     For example, the following command invokes TPU creating a
     keystroke journal file named MYJOURNAL.TJL in your current,
     default directory:

        $ EDIT/TPU /JOURNAL=myjournal

     Keystroke journaling does NOT work on DECwindows and has other
     restrictions affecting recovery (see help on /RECOVER).  Keystroke
     journaling is useful to reproduce a problem (for example, if you
     want to submit an SPR) or to journal an editing session in which
     you create LEARN sequences and define keys interactively.

  If you use keystroke journaling, EVE also creates a buffer-change
  journal file for each text buffer.  This double journaling may slow
  performance, depending on the kind of edits you make.  To disable
  buffer-change journaling for a particular buffer or for all your
  buffers, use SET NOJOURNALING commands during your editing session.

  If you do not want any journaling, use /NOJOURNAL, which disables
  both keystroke journaling and buffer-change journaling.  This may
  make startup and some editing operations faster but risks losing your
  work if a system failure occurs during the editing session.
  Typically you use /NOJOURNAL if you are also using /NOMODIFY,
  /NOOUTPUT, /READ_ONLY, or /NOWRITE to view a file without making any
  changes.  If you invoke EVE with /NOJOURNAL, you can enable buffer-
  change journaling during your editing session by using SET JOURNALING
  commands.

  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.  |
  +-------------------------------------------------------------------+
Close Help