The Compaq Language-Sensitive Editor (LSE) is a multi-language advanced
text editor specifically designed for software development. The
command line has the following form:
LSEDIT [/qualifiers] [file-spec]
1 – Parameter
file-spec
specifies the file to be edited (use only OpenVMS file
specifications).
If no file specification is entered, LSE defaults
to the last file edited by an LSEDIT command.
If the file exists, LSE reads the file into the main buffer; and the
main buffer takes for its name the name and type of the file
specification on the command line. The file type determines the
default language that will be used. (For example, .FOR for FORTRAN,
.PLI for PL/I, or .PAS for PASCAL.)
If the specified file exists, it is opened. If the file does not
exist, it is created when you leave LSE with an EXIT command. If you
leave LSE with a QUIT command a file will not be created and,
therefore, a specified file will not be saved.
2 – Command Qualifiers
2.1 /COMMAND
/COMMAND=file-spec /NOCOMMAND (D) Specifies a file containing a Text Processing Utility (TPU) program to be executed as part of LSE initialization. By default, LSE does not try to read a local initialization file. If you specify /NOCOMMAND, LSE does not use a Text Processing Utility (TPU) initialization command file. The logical name LSE$COMMAND can be defined to point to a file containing Text Processing Utility statements. If neither /COMMAND nor /NOCOMMAND appears on the command line, LSE attempts to translate the logical name LSE$COMMAND. If that name is translated, its value is used in the same way as the /COMMAND qualifier value. See the Text Processing Utility Language Reference Manual for details.
2.2 /CREATE
/CREATE (D) /NOCREATE Controls whether LSE creates a new file when the specified input file is not found. By default, LSE provides a buffer in which to create the file. When you exit from LSE or write out the contents of the buffer with the WRITE or COMPILE commands, LSE will create a new file with the input file specification in the appropriate directory. When you specify /NOCREATE on the LSE command line and type a file specification for a file that does not exist, LSE prints an error message and returns you to DCL level.
2.3 /CURRENT_FILE
/CURRENT_FILE (D) /NOCURRENT_FILE If no input file is specified on the command line, /CURRENT_FILE specifies that the name and type of the current file be used as the input file. If an incomplete file specification is specified on the command line (that is, only a file name or a file type), /CURRENT_FILE specifies that the name or the type of the current file be used to complete the file specification. If /NOCURRENT_FILE is specified, LSE will not use the current file to resolve an input file specification. /CURRENT_FILE is the default.
2.4 /DEBUG
/DEBUG[=debug-filespec]
/NODEBUG (D)
Determines whether you run a TPU debugger. This is useful in testing
TPU procedures for an application you are creating. LSE reads,
compiles, and executes the debug file -- before executing
TPU$INIT_PROCEDURE.
The default debug file specification is SYS$SHARE:LSE$DEBUG.TPU. You
can override this default on the command line to specify a debug file
of your own. For example, the following command invokes LSE, using a
debug file called SYS$SHARE:MYDEBUG.TPU:
$ LSEDIT/DEBUG=mydebug
You can define the logical name LSE$DEBUG to specify a debug file of
your own. This is useful if you want to keep the debug file in a
directory other than SYS$SHARE. You cannot use wildcards in the debug
file specification.
The TPU debugger provides commands to manipulate variables and control
program execution. To start editing the code in the file you are
debugging, use the debugger command GO. For more information about the
TPU debugger, read the comments in the source file in SYS$SHARE:
LSE$DEBUG.TPU or see the Text Processing Utility Manual.
2.5 /DISPLAY
/DISPLAY=CHARACTER_CELL (D) /DISPLAY=DECWINDOWS /DISPLAY=display-filespec /NODISPLAY Specifies which screen manager you want to run. The /DISPLAY command qualifier is optional. By default, LSE uses the character-cell screen manager. As an alternative to the /DISPLAY qualifier, you can define a logical name LSE$DISPLAY_MANAGER as DECWINDOWS, CHARACTER_CELL, or as a screen manager file specification. If you specify /DISPLAY=CHARACTER_CELL, LSE uses the character-cell screen manager, which runs in a DECterm (or VWS) terminal emulator or on a physical ANSI terminal. If you specify /DISPLAY=DECWINDOWS, LSE uses the DECwindows screen manager, which create a DECwindows window in which to run LSE. In order to use LSE from a unsupported input device, such as an non-ANSI CRT or from a batch file, the /NODISPLAY qualifier must be specified. This is useful for executing a script of LSE commands or TPU statements specified by the /INITIALIZATION or /COMMAND qualifiers. You cannot use the /NODISPLAY qualifier if the logical name LSE$DISPLAY_MANAGER specifies the DECwindows window manager.
2.6 /ENVIRONMENT
/ENVIRONMENT=file-spec-list /NOENVIRONMENT (D) Specifies the name of one or more binary environment files containing LSE language, token, placeholder, or alias definitions. LSE reads these definitions as part of LSE startup. If you specify more than one file, you must enclose the files in parentheses and separate them with commas. If definitions or deletions of items appear in more than one file, the definition that appeared in the first listed file takes precedence. SYS$LIBRARY is the default device, and the default file type is .ENV. The logical name LSE$ENVIRONMENT is an alternative to the /ENVIRONMENT qualifier. If /ENVIRONMENT or /NOENVIRONMENT is not used, LSE will attempt to translate the logical name LSE$ENVIRONMENT. If the logical name has translations, the values are used in the same way as the /ENVIRONMENT qualifier values. LSE translates the first ten indices of the logical name LSE$ENVIRONMENT. (Refer also to the SAVE ENVIRONMENT command description in the Language-Sensitive Editor User's Guide.)
2.7 /INITIALIZATION
/INITIALIZATION=file-spec /NOINITIALIZATION (D) Specifies the name of a file containing a sequence of LSE commands to be executed as part of LSE startup. This file usually contains occurrences of the DEFINE KEY and DEFINE commands. The logical name LSE$INITIALIZATION is an alternative to the /INITIALIZATION qualifier. If /INITIALIZATION or /NOINITIALIZATION is not used, LSE will attempt to translate the logical name LSE$INITIALIZATION. If the logical name has a translation, that value is used in the same way as the /INITIALIZATION qualifier value. If the initialization file specified does not contain a file type, the file type applied depends upon the system-defined default command language. If the default command language is VMSLSE, ".LSE" is applied as always; if the default command language is Portable, ".PLSE" is applied.
2.8 /INTERFACE
/INTERFACE=CHARACTER_CELL (D) /INTERFACE=DECWINDOWS /INTERFACE=display-filespec Specifies which screen manager you want to run. The /INTERFACE command qualifier is optional. By default, LSE uses the character-cell screen manager. As an alternative to the /INTERFACE qualifier, you can define the logical name LSE$DISPLAY_MANAGER as DECWINDOWS, CHARACTER_CELL, or as a screen-manager file specification. If you specify /INTERFACE=CHARACTER_CELL, LSE uses the character-cell screen manager, which runs in a workstation terminal emulator window or on a physical terminal. If you specify /INTERFACE=DECWINDOWS, LSE uses the DECwindows screen manager, which creates a DECwindows window in which to run LSE.
2.9 /JOURNAL
/JOURNAL (D) /JOURNAL[=file-name] /NOJOURNAL Enables journaling for the editing session. The /JOURNAL qualifier without any value enables buffer change journaling only. One buffer change journal file is created for each editing buffer. The name of each buffer change journal file corresponds to the name of the buffer that it is journaling. The default file type for buffer change journal files is .TPU$JOURNAL. If a file name is supplied as the value to the /JOURNAL qualifier, then keystroke journaling is also performed. The name of the keystroke journal file is taken from the value supplied to the /JOURNAL qualifier. There is one keystroke journal file for the editing session. The default file type for keystroke journal files is .TJL. To perform a recovery using a buffer change journal file, use the RECOVER BUFFER command after the editor has been started. Use the /RECOVER command line qualifier only when attempting to recover using a keystroke journal file. If a recovery operation is performed using a keystroke journal file, care must be taken to restore the editing environment to the state that it was in when the journaled editing session began. If you do not want to create a journal file of either type, use the /NOJOURNAL qualifier.
2.10 /LANGUAGE
/LANGUAGE=language Sets the language for the current input file, overriding the language indicated by the input file's file type.
2.11 /MODIFY
/MODIFY /NOMODIFY Specifies whether the buffer created for the input file is modifiable or unmodifiable. If you specify the /MODIFY qualifier, the LSEDIT command creates a modifiable buffer. If you specify the /NOMODIFY qualifier, the LSEDIT command creates an unmodifiable buffer. If you do not specify either qualifier, LSE determines the buffer's modifiable status from the read-only/write setting. By default, a read-only buffer is unmodifiable and a write buffer is modifiable.
2.12 /OUTPUT
/OUTPUT[=file-spec] (D) /NOOUTPUT Specifies the file name that LSE will create from the input file upon exit. Specifying a file specification on the /OUTPUT qualifier causes LSE to ignore the current file information. By default, LSE creates a new version of the input file. Missing components of the file specification in the /OUTPUT qualifier take their values from the corresponding fields of the input file specification. Upon exiting, and if the buffer contents have been modified during the editing session, LSE writes other buffers to their associated files. /NOOUTPUT prevents the writing back of the main buffer on exit.
2.13 /READ_ONLY
/READ_ONLY /NOREAD_ONLY Specifies that LSE will create an unmodifiable, read_only buffer for the input file. LSE will not create a new output file for the input file. Any changes to the file will be lost upon exiting. If other buffers were modified during the editing session, this qualifier will not affect their being written back to their associated files.
2.14 /RECOVER
/RECOVER /NORECOVER (D) Directs LSE to use the latest version of the file specified as the value to the /JOURNAL qualifier to recover changes that may have been lost due to a previous abnormal LSE termination. Care must be taken to restore the editing environment to the state that it was in when the journaled editing session began. /RECOVER should be used only when attempting to recover using a keystroke journal file. If you wish to recover using a buffer change journal file, use the RECOVER BUFFER command in LSE after the editor has been started.
2.15 /SECTION
/SECTION=file-spec /SECTION=LSE$SECTION (D) /NOSECTION Specifies whether LSE is to map a section file containing DECTPU procedures, key definitions, and variables. By default, LSE maps section file LSE$SECTION. If you specify another file specification, LSE applies the default "SYS$LIBRARY:.TPU$SECTION" when it opens the file. If you specify /NOSECTION, LSE does not use a section file.
2.16 /START_POSITION
/START_POSITION=(Line,Character) /START_POSITION=(1,1) (D) Specifies the starting line and character in the file. If a file specification is not specified, the last specification invoked by LSE is used. The cursor is positioned at the place corresponding to the cursor's location at the time the last LSE invoked file was left. (Refer also to the DECTPU GET_INFO built-in description in the Language-Sensitive Editor User's Guide)
2.17 /SYSTEM_ENVIRONMENT
/SYSTEM_ENVIRONMENT=file-spec /SYSTEM_ENVIRONMENT=LSE$SYSTEM_ENVIRONMENT /NOSYSTEM_ENVIRONMENT (D) Specifies the name of a system environment file. The difference between files specified by this qualifier and those specified by a /ENVIRONMENT qualifier is: Definitions derived from this qualifier cannot be saved by a SAVE ENVIRONMENT command. The default device is SYS$LIBRARY: and the default type is .ENV.
2.18 /WRITE
/WRITE /NOWRITE Specifies that the file on the LSEDIT command line be put into a writeable modifiable buffer. The /NOWRITE qualifier specifies that the file on the LSEDIT command line be put into a read_only unmodifiable buffer.
2.19 /WORK
/WORK=file-spec /WORK=LSE$WORK (D) /NOWORK Specifies the name of the file to be used as a work file for the editor. When LSE attempts to allocate memory and is unsuccessful, the editor begins to transfer the contents of user buffers to the work file and releases the memory previously occupied by the data. When an attempt to reference this data is made, the editor restores the data to the correct buffer from the work file. The logical name LSE$WORK can be defined to point to a directory where the work file should be created.
3 – Release Notes
Release notes for LSE are contained in the file:
SYS$HELP:LSEvvu.RELEASE_NOTES
The product name is followed by the version number (vvu). For
example, the following is the release notes file for Version 4.6 of
LSE.
SYS$HELP:LSE046.RELEASE_NOTES