HELPLIB.HLB  —  LSEDIT
  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
Close Help