Compaq DEC Text Processing Utility AA-PWCBD-TE - Manual (Page 27)

Getting Started with DECTPU
2.4 Using Journal Files
2.4.1 Keystroke Journaling
In keystroke journaling, DECTPU keeps track of each keystroke made during
a session, regardless of which buffer is in use. If a system interruption occurs
during a session, you can reconstruct the work done during the session.
To determine the name of the keystroke journal file, use a statement similar to
the following:
filename := GET_INFO (SYSTEM, "journal_file");
For more information on using a keystroke journal file for recovery, see
Section 2.6.8 and the Extensible Versatile Editor Reference Manual.
Note
Compaq strongly recommends the use of buffer-change journaling rather
than keystroke journaling.
To reconstruct your work, use the /JOURNAL and /RECOVER qualifiers. The
following example shows system recovery on a file called JACKI.SDML:
$ EDIT/TPU JACKI.SDML /JOURNAL /RECOVER
2.4.2 Buffer-Change Journaling
Buffer-change journaling creates a separate journal file for each text buffer.
The application can use the enhanced SET (JOURNALING) built-in to direct
DECTPU to establish and maintain a separate journal file for any buffer or
buffers created during the session. The application programmer or user can also
use the SET (JOURNALING) built-in to turn journaling off or on for a given
buffer during a session.
In the buffer’s journal file, DECTPU keeps track of the following record attributes
(and any changes made to them):
• Left margin setting
• Modifiability or unmodifiability
• Display value
The journal file also tracks the following:
• Characters inserted in and deleted from a record (including the location
where the change took place)
• Records inserted in and deleted from a buffer (including the location where
the change took place)
To determine whether buffer-change journaling is turned on, use the following
statement:
status := GET_INFO (buffer_name, "journaling");
For more information on record attributes and display values, see the descriptions
of the SET (RECORD_ATTRIBUTE) and SET (DISPLAY_VALUE) built-in
procedures in the DEC Text Processing Utility Reference Manual.
Buffer-change journaling does not keep a record of all keystrokes performed while
editing a given buffer.
Getting Started with DECTPU 2–7