13 /section – Compaq DEC Text Processing Utility AA-PWCBD-TE User Manual
Page 39
Getting Started with DECTPU
2.6 Using OpenVMS EDIT/TPU Command Qualifiers
$ EDIT/TPU/RECOVER/JOURNAL=save.TJL letter.dat
In EVE, you can use /RECOVER to recover either an editing session from a
keystroke journal file or a single buffer from a buffer-change journal file. If you
specify /JOURNAL=filename, EVE recovers from the specified keystroke journal
file. Otherwise, EVE recovers from a buffer-change journal file that corresponds
to the input parameter (or the buffer specified on the command line if no input
parameter is specified).
For more information on journaling and recovery in EVE, see the Extensible
Versatile Editor Reference Manual.
2.6.13 /SECTION
/SECTION[[=filespec]]
/NOSECTION
/SECTION=TPU$SECTION (default)
The /SECTION qualifier determines whether DECTPU loads a section file. A
section file is a startup file that contains key definitions and compiled procedures
in binary form.
The default section file is TPU$SECTION. When DECTPU tries to locate the
section file, DECTPU supplies a default directory of SYS$SHARE and a default
file type of .TPU$SECTION. OpenVMS systems define the systemwide logical
name TPU$SECTION as EVE$SECTION, so the default section file is the file
that implements the EVE editor. To override the OpenVMS default, redefine
TPU$SECTION.
You can specify a different section file. The preferred method is to define the
logical name TPU$SECTION to point to a section file other than the default
file. You can also supply a full file specification for the /SECTION qualifier.
For example, if your device is called DISK$USER and your directory is called
[SMITH], the following command causes DECTPU to read a section file called
VT100INI.TPU$SECTION:
$ EDIT/TPU/SECTION=disk$user:[smith]vt100ini
If you omit the device and directory in the file specification, DECTPU assumes
the file is in SYS$SHARE. The section file must be located on the same node on
which you are running DECTPU.
To determine whether /SECTION was specified on the DCL command line, use
the following call in the application:
x := GET_INFO (COMMAND_LINE, "section");
The preceding call returns 1 if /SECTION was specified, 0 otherwise. To fetch the
name of the section file specified on the command line, use the following call:
x := GET_INFO (COMMAND_LINE, "section_file");
For more information on GET_INFO, see the DEC Text Processing Utility
Reference Manual.
You must compile the file used as the value for the /SECTION qualifier. To do so,
run the source code version of the file through DECTPU and then use the built-in
procedure SAVE. This process converts the file to the proper binary form.
For more information on creating and using section files, see Chapter 5.
Getting Started with DECTPU 2–19