Command_Qualifiers

/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.


/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.


/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.


/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.



/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.


/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.)


/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.


/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.


/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.


/LANGUAGE
 /LANGUAGE=language

 Sets the language for the current input file, overriding  the  language
 indicated by the input file's file type.


/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.


/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.


/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.


/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.


/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.


/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)


/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.


/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.


/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.