Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

/ACL

/EDT

/FDL

/TPU

Parameters

Command Qualifiers

Examples

/JOURNAL

/KEEP

/MODE

/OBJECT

/RECOVER

Parameters

Command Qualifiers

Examples

/COMMAND

/CREATE

/JOURNAL

/OUTPUT

/READ_ONLY

/RECOVER

Parameters

Command Qualifiers

Examples

/ANALYSIS

/CREATE

/DISPLAY

/EMPHASIS

/GRANULARITY

/NOINTERACTIVE

/NUMBER_KEYS

/OUTPUT

/PROMPTING

/RESPONSES

/SCRIPT

Parameters

Command Qualifiers

Examples

/COMMAND

/CREATE

/DISPLAY

/JOURNAL

/OUTPUT

/READ_ONLY

/RECOVER

/SECTION

HELP EDIT — VMS 4.6

  The EDIT commands perform the following functions:

  o  Invoke the Access Control List Editor  to  create  or  modify  an
     access control list for an object (see /ACL).

  o  Invoke the EDT screen-oriented editor (see /EDT).

  o  Invoke the FDL  editor  to  create  and  modify  File  Definition
     Language files (see /FDL).

  o  Invoke the SUMSLP batch-oriented editor to update a single  input
     file with multiple files of edit commands (see /SUM).

  o  Invoke the TPU editor (see /TPU).

Additional information available:

/ACL/EDT/FDL/TPU

/ACL

  Invokes the Access Control List (ACL) Editor to create or modify  an
  access  control  list  for  a  specified  object.   For  a  complete
  description of the VAX/VMS Access  Control  List  Editor,  including
  information  about  the EDIT/ACL command and its qualifiers, see the
  VAX/VMS Access Control List Editor Reference Manual.

  The /ACL qualifier is required.

  Format:


    EDIT/ACL  file-spec

Additional information available:

ParametersCommand QualifiersExamples

Parameters

 object-spec

  Specifies the object whose access control list is to be  created  or
  edited  using  the  ACL editor.  If the access control list does not
  exist, it is created.

  If the object is a file, the ACL editor does not provide  a  default
  file  type.   If  you omit the file type, it is presumed to be null.
  The specified file must be a disk file on a Files-11 Structure Level
  2  formatted  volume.   If the object is a directory, specify a file
  specification with the file type of DIR.  If the object type is  not
  a  file,  you  must  specify  the  object type with the /OBJECT=type
  qualifer.

  No wildcard characters are allowed in the object specification.

Command Qualifiers

Additional information available:

/JOURNAL/KEEP/MODE/OBJECT/RECOVER

/JOURNAL

 /JOURNAL[=file-spec]
 /NOJOURNAL

  Controls whether a journal file is created for the editing  session.
  By default, the ACL editor keeps a journal file that contains a copy
  of the ACL editor keypad actions made during  the  editing  session.
  The  /JOURNAL  qualifier controls the creation of a journal file for
  the editing session.  If you specify /NOJOURNAL, no journal file  is
  generated.  If you omit the qualifier or specify /JOURNAL, a journal
  file is created.  If you omit  the  journal  file-specification,  by
  default, the journal file is named input-file-spec.JOU.

  No  wildcard  characters   are   allowed   in   the   journal   file
  specification.

  If your editing session ends abnormally,  you  can  invoke  the  ACL
  editor again and recover the changes made during the aborted session
  by simply specifying  the  /RECOVER  qualifier  and,  if  necessary,
  providing  the  name  of the journal file, should it differ from the
  default name.

/KEEP

 /KEEP=(option[,...])

 Controls whether or  not  the  session's  journal  file  or  recovery
  journal file will be deleted.  By default the session's journal file
  is deleted once an ACL editing session ends  normally;  by  default,
  the recovery journal file is deleted once the ACL editing session is
  successfully restored.  The  /KEEP  qualifier  allows  you  to  save
  either  the  journal  or the recovery journal file.  You can specify
  one or both of the following options:

  JOURNAL       Specifies that the journal file for  this  session  is
                not  to be deleted when the editing session terminates
                normally.

  RECOVER       Specifies that the journal file used for  recovery  is
                not  to  be  deleted when the editing session has been
                successfully restored.

/MODE

 /MODE=option

 Specifies the level of  prompting  to  be  used  during  the  editing
  session.   By  default,  the  ACL editor selects the prompting mode.
  Use the /MODE qualifier to specify one of these prompt options:

  PROMPT        Specifies  that  where  possible  the  selected  field
                within the ACE is initially filled with the first of a
                list of items that may apply to the field.

  NOPROMPT      Specifies that no prompting is used by the ACL editor.

/OBJECT

 /OBJECT=type
 /OBJECT=FILE

  Specifies the type of the object whose  ACL  is  being  edited.   By
  default,  the  ACL editor assumes that the object whose ACL is being
  edited is a file.  If the object is not a file, you must specify the
  object  type with the /OBJECT qualifier.  The following keywords may
  be specified with /OBJECT:

  FILE                   Specifies that the object type is a file or a
                         directory file.

  DEVICE                 Specifies that the object type is a device.

  SYSTEM_GLOBAL_SECTION  Specifies that the object type  is  a  system
                         global section.

  GROUP_GLOBAL_SECTION   Specifies that the object  type  is  a  group
                         global section.

  LOGICAL_NAME_TABLE     Specifies that the object type  is  a  system
                         logical name table.

/RECOVER

 /RECOVER[=file-spec]
 /NORECOVER

  Determines whether or not the ACL editor  restores  the  file's  ACL
  from  a  journal  file  prior  to starting the editing session.  The
  /RECOVER qualifier specifies that the ACL editor should restore  the
  ACL  from  the  journal file specified by input-file-spec.JOU.  This
  operation restores the ACL to the state it was in  when  a  previous
  ACL editing session ended abnormally.

  If the journal file has a file name other than  input-file-spec.JOU,
  specify it with the /RECOVER qualifier.

Examples

  1.   $ EDIT/ACL/JOURNAL=SAVEACL MYFILE.DAT
          .
          .
          .
       User creates ACL until system crashes
          .
          .
          .
       $ EDIT/ACL/JOURNAL=SAVEACL/RECOVER=SAVEACL MYFILE.DAT
          .
          .
          .
       ACL is restored and user proceeds with editing until done
          .
          .
          .
         ^Z
       $

  The user initiates the ACL editing session by  specifying  that  the
  journal  file  SAVEACL.JOU  be saved if the session ends abnormally.
  The session proceeds until aborted by a system  crash.   To  recover
  from  the  aborted  editing  session,  and  continue with additional
  edits, the user issues the second EDIT/ACL  command.   This  session
  begins  by restoring the session with the journal SAVEACL.JOU.  Once
  the editing session proceeds to a normal completion (with a CTRL/Z),
  the journal file SAVEACL.JOU is deleted.

  2.   $ EDIT/ACL MYFILE.DAT
       (IDENTIFIER=[360,7],ACCESS=NONE)
       (IDENTIFIER=[360,*],ACCESS=READ+WRITE)
          .
          .
          .
       User edits the ACL.
          .
          .
          .
         ^Z
       $

  In this example the owner of the file MYFILE.DAT wants to modify the
  file's  access  control  list.   A journal file called MYFILE.JOU is
  automatically created to record the  ACL.   By  default  the  editor
  enters  prompt  mode.   The system displays the two existing ACEs in
  this ACL.

  The user wants to change the UIC from [360,7]  to  [360,17].   After
  the user makes the correction, presses ENTER on the keypad, and then
  exits with CTRL/Z.  Since this is a normal exit,  the  journal  file
  MYFILE.JOU is automatically deleted.

/EDT

  Invokes the VAX EDT interactive text editor.  The /EDT qualifier  is
  not required, because EDT is the VAX/VMS default editor.

  Format:


    EDIT  file-spec

Additional information available:

ParametersCommand QualifiersExamples

Parameters

 file-spec

  Specifies the file to be created or edited using the EDT editor.  If
  the file does not exist, it is created by EDT.

  The EDT editor does not provide a default file  type  when  creating
  files; if you do not include a file type, it is null.  The file must
  be a disk file on a Files-11 formatted volume.

  No wildcard characters are allowed in the file specification.

Command Qualifiers

Additional information available:

/COMMAND/CREATE/JOURNAL/OUTPUT/READ_ONLY
/RECOVER

/COMMAND

 /COMMAND[=file-spec]
 /NOCOMMAND

  Determines whether or not EDT uses  a  startup  command  file.   The
  /COMMAND  file qualifier should be followed by an equal sign and the
  specification of the  command  file.   The  default  file  type  for
  command files is EDT.

  The following command line invokes EDT to edit a file named MEMO.DAT
  and specifies that EDT use a startup command file named XEDTINI.EDT:
       $ EDIT/COMMAND=XEDTINI.EDT MEMO.DAT

  If you do not include the /COMMAND=command file qualifier, EDT looks
  for  the  EDTSYS logical name assignment.  If EDTSYS is not defined,
  EDT    processes    the    systemwide    startup    command     file
  SYS$LIBRARY:EDTSYS.EDT.   If this file does not exist, EDT looks for
  the EDTINI logical name assignment.  If EDTINI is not  defined,  EDT
  looks  for  the file named EDTINI.EDT in your default directory.  If
  none of these files exists, EDT begins your editing session  in  the
  default state.

  To prevent EDT from processing either the systemwide startup command
  file  or  the  EDTINI.EDT  file  in  your default directory, use the
  /NOCOMMAND qualifier as follows:
       $ EDIT/NOCOMMAND MEMO.DAT

  No wildcard characters are allowed in the file specification.

/CREATE

 /CREATE (default)
 /NOCREATE

  Controls whether EDT creates a new file  when  the  specified  input
  file  is  not  found.  Normally, EDT creates a new file to match the
  input file specification if it cannot find the requested  file  name
  in  the  specified  directory.   When  you  use /NOCREATE in the EDT
  command line and type a specification  for  a  file  that  does  not
  exist,  EDT  prints  an  error  message  and  returns you to the DCL
  command level as follows:
       $ EDIT/NOCREATE NEWFILE.DAT
       Input file does not exist
       $

/JOURNAL

 /JOURNAL[=journal-file]
 /NOJOURNAL

  Determines whether EDT keeps a  journal  file  during  your  editing
  session.   The default file name for the journal file is the same as
  the input file name.  The default file type is  JOU.   The  /JOURNAL
  qualifier  enables you to use a different file specification for the
  journal file.

  The following command line invokes EDT to edit a file named MEMO.DAT
  and specifies the name SAVE.JOU for the journal file:
       $ EDIT/JOURNAL=SAVE MEMO.DAT

  If you are editing a  file  from  another  directory  and  want  the
  journal  file  to  be  located  in  that directory, you must use the
  /JOURNAL qualifier with  a  file  specification  that  includes  the
  directory  name.   Otherwise,  EDT  creates  the journal file in the
  default directory.

  The directory that is to contain the  journal  file  should  not  be
  write protected.

  To prevent EDT from keeping a record of your  editing  session,  use
  the /NOJOURNAL qualifier in the EDT command line as follows:
       $ EDIT/NOJOURNAL MEMO.DAT

  Once you have created a journal file, use the /RECOVER qualifier  to
  have EDT process the commands contained in the journal file.

  No wildcard characters are allowed in the file specification.

/OUTPUT

 /OUTPUT=output-file
 /NOOUTPUT

  Determines whether EDT creates an output file at  the  end  of  your
  editing  session.  The default file specification for both the input
  file and the output file is the same.  Use the /OUTPUT qualifier  to
  give  the  output file a different file specification from the input
  file.

  The following command line invokes EDT to edit a file named MEMO.DAT
  and gives the resulting output file the name OUTMEM.DAT:
       $ EDIT/OUTPUT=OUTMEM.DAT MEMO.DAT

  You can include directory information as part of  your  output  file
  specification to send output to another directory as follows:
       $ EDIT/OUTPUT=[BARRETT.MAIL]MEMO.DAT MEMO.DAT

  The /NOOUTPUT qualifier suppresses the creation of an  output  file,
  but  not  the  creation  of a journal file.  If you are testing some
  edits and are not  sure  you  want  an  output  file,  you  can  use
  /NOOUTPUT as follows:
       $ EDIT/NOOUTPUT MEMO.DAT

  A system interruption will not  prevent  you  from  recreating  your
  editing  session  because  a journal file is still being maintained.
  If you decide you want to save your editing session, you can do  so,
  even  though you specified /NOOUTPUT, by using the line mode command
  WRITE to put the text  in  an  external  file  before  you  end  the
  session.

  No wildcard characters are allowed in the file specification.

/READ_ONLY

 /READ_ONLY
 /NOREAD_ONLY (default)

  Determines whether EDT keeps a journal file and  creates  an  output
  file.  With the default /NOREAD_ONLY, EDT maintains the journal file
  and creates an output file when it processes the line  mode  command
  EXIT.   Using  the  /READ_ONLY  qualifier  is  like  using  both the
  /NOJOURNAL and /NOOUTPUT qualifiers.

  The following  command  line  invokes  EDT  to  edit  a  file  named
  CALENDAR.DAT, but does not create a journal file or an output file:
       $ EDIT/READ_ONLY CALENDAR.DAT

  Use /READ_ONLY when you are searching a file.  If you then  want  to
  modify  the  file,  use  the  line  mode  command WRITE to save your
  changes.  Remember, however, that you have no journal file.

/RECOVER

 /RECOVER
 /NORECOVER (default)

  Determines whether or not EDT reads a journal file at the  start  of
  the editing session.

  When you use the  /RECOVER  qualifier,  EDT  reads  the  appropriate
  journal  file  and  processes  whatever  commands  it contains.  The
  appropriate syntax follows:
       $ EDIT/RECOVER MEMO.DAT

  If the journal file type is not JOU or the file name is not the same
  as the input file name, you must include both the /JOURNAL qualifier
  and the /RECOVER qualifier as follows:
       $ EDIT/RECOVER/JOURNAL=SAVE.XXX MEMO.DAT

  Because /NORECOVER is the default  for  EDT,  you  do  not  need  to
  specify it in a command line.

Examples

  1.   $ EDIT/OUTPUT=NEWFILE.TXT OLDFILE.TXT
           1       This is the first line of the file OLDFILE.TXT.
       *

  This  EDIT  command  invokes  the  EDT  editor  to  edit  the   file
  OLDFILE.TXT.   EDT looks for the EDTSYS logical name assignment.  If
  EDTSYS is not defined, EDT processes the systemwide startup  command
  file SYS$LIBRARY:EDTSYS.EDT.  If this file does not exist, EDT looks
  for the EDTINI logical name assignment.  If EDTINI is  not  defined,
  EDT  looks  for the file named EDTINI.EDT in your default directory.
  If none of these files exists, EDT begins your  editing  session  in
  the  default  state.  When the session ends, the edited file has the
  name NEWFILE.TXT.

  2.   $ EDIT/RECOVER OLDFILE.TXT

  This EDIT command invokes the EDT editor to recover from an abnormal
  exit  during  a  previous  editing  session.   EDT  opens  the  file
  OLDFILE.TXT, and then processes the journal file OLDFILE.JOU.   Once
  the  journal  file  has  been  processed, you can resume interactive
  editing.

/FDL

  Invokes the VAX/VMS FDL Editor (EDIT/FDL) to create and modify  File
  Definition  Language  (FDL)  files.  The /FDL qualifier is required.
  For a complete  description  of  the  FDL  Utility,  including  more
  information  about  the EDIT/FDL command and its qualifiers, see the
  FDL Facility  in  the  VAX/VMS  File  Definition  Language  Facility
  Reference Manual.

  Format:


    EDIT/FDL  file-spec

Additional information available:

ParametersCommand QualifiersExamples

Parameters

 file-spec

  Specifies the FDL file to be created, modified, or optimized by  the
  editing session.  The default file type is FDL.

Command Qualifiers

Additional information available:

/ANALYSIS/CREATE/DISPLAY/EMPHASIS/GRANULARITY/NOINTERACTIVE
/NUMBER_KEYS/OUTPUT/PROMPTING/RESPONSES
/SCRIPT

/ANALYSIS

 /ANALYSIS=fdl-file-spec

 Specifies the FDL file (generated by the Analyze/RMS_File Utility) to
  be used in the optimize script.

/CREATE

 /CREATE

 Allows you to create an output FDL file that does not  exist  without
  receiving  a  message  from  EDIT/FDL  stating that the file will be
  created.

/DISPLAY

 /DISPLAY=graph-option

 Specifies the type of graph you want displayed.  Legal graph  options
  are:

  LINE    Produces a graph of bucket size  versus  index  depth  as  a
          two-dimensional plot.

  FILL    Produces a graph of bucket size  versus  load  fill  percent
          versus index depth.

  KEY     Produces a graph of bucket size  versus  key  length  versus
          index depth.

  RECORD  Produces a graph of bucket size versus  record  size  versus
          index depth.

  INIT    Produces a graph of bucket size versus initial  load  record
          count versus index depth.

  ADD     Produces a graph of bucket  size  versus  additional  record
          count versus index depth.

  LINE is the default.

/EMPHASIS

 /EMPHASIS=tuning-bias

 Allows you to choose  between  smaller  buffers  and  flatter  files.
  Legal options for the tuning-bias parameter are:

  FLATTER_FILES    Generally increases bucket size.  The bucket  size,
                   in turn, controls the number of levels in the index
                   structure.  If a larger bucket size eliminates  one
                   level,  then  you  should use this option.  At some
                   point, however, the benefit of having fewer  levels
                   will  be offset by the cost of scanning through the
                   larger buckets.

  SMALLER_BUFFERS  Generally decreases the amount of memory  you  have
                   to  use.  Sequential files usually require only two
                   buffers.

  FLATTER_FILES is the default.

/GRANULARITY

 /GRANULARITY=n

 Allows you to divide an indexed  file  into  a  specified  number  of
  areas.  The default is three areas.

/NOINTERACTIVE

 /NOINTERACTIVE

 Causes EDIT/FDL to execute the Optimize  script  without  a  terminal
  dialog.   You  must  have previously issued the ANALYZE/RMS_FILE/FDL
  command, specifying your existing RMS data file as the target  file.
  If data is missing, EDIT/FDL uses the defaults.

/NUMBER_KEYS

 /NUMBER_KEYS=n

 Allows you to specify the number of keys in your indexed  file.   You
  can define up to 255 keys.  The default is one key.

/OUTPUT

 /OUTPUT=fdl-file-spec

 Identifies an output file for storing the  results  of  the  EDIT/FDL
  session.   If  you  omit  the /OUTPUT qualifier, the output FDL file
  will have the same name and file type  as  the  input  file  with  a
  version  number  one higher than the highest existing version of the
  file.

  The default file type is FDL.

/PROMPTING

 /PROMPTING=prompt-option

 Specifies the level of menu prompting to be used during the  terminal
  session.  The valid prompt options are:

  BRIEF  Selects a terse level of prompting.

  FULL   Provides more detailed information about each menu question.

  By  default,  EDIT/FDL  chooses  either  BRIEF  or  FULL   prompting
  depending  on  the  terminal class and line speed.  High-speed video
  terminals will get FULL,  while  nonscope  terminals  and  terminals
  operating at less than 2400 baud get BRIEF.

/RESPONSES

 /RESPONSES=response-option

 Allows you to select how you want to  respond  to  script  questions.
  Legal options include:

  AUTOMATIC  Indicates that you automatically want all script  default
             responses to be used.  If you select this option, you can
             use the /NOINTERACTIVE qualifier to cause EDIT/FDL to  be
             executed automatically.

  MANUAL     Indicates that you want to provide all script  responses.
             No default responses are automatically used.

  The default is AUTOMATIC.

/SCRIPT

 /SCRIPT=script-title
 /NOSCRIPT

  Controls whether to select a logically grouped sequence of questions
  for EDIT/FDL to ask.  Valid script titles are:

  ADD_KEY     Allows you to model or add to the attributes  of  a  new
              index.

  DELETE_KEY  Allows you to remove attributes from the  highest  index
              of your file.

  INDEXED     Begins  a  dialog  in  which  you   are   prompted   for
              information  about  the  indexed data file to be created
              from the FDL file.  EDIT/FDL supplies values for certain
              attributes.

  OPTIMIZE    Requires that you use the analysis information  from  an
              FDL  file  that  was  created  with the Analyze/RMS_File
              Utility.  The FDL file itself is one of  the  inputs  to
              the  Edit/FDL Utility.  In other words, you may tune the
              parameters of all your indexes using the file statistics
              from ANALYZE/RMS_FILE.

  RELATIVE    Begins  a  dialog  in  which  you   are   prompted   for
              information  about  the relative data file to be created
              from the FDL file.  EDIT/FDL supplies values for certain
              attributes.

  SEQUENTIAL  Begins  a  dialog  in  which  you   are   prompted   for
              information about the sequential data file to be created
              from the FDL file.  EDIT/FDL supplies values for certain
              attributes.

  TOUCHUP     Begins  a  dialog  in  which  you   are   prompted   for
              information  about  the  changes  you wish to make to an
              existing index.

  The default is /NOSCRIPT.

Examples

  1.   $ EDIT/FDL INDEX

  This command creates or modifies an FDL file named INDEX.FDL.

  2.   $ EDIT/FDL/OUTPUT=NEWINDEX INDEX

  This command begins a session in which the contents of INDEX.FDL are
  read  into  the  FDL  editor and can then be modified.  A file named
  NEWINDEX.FDL is created, and INDEX.FDL is not changed.

/TPU

  Invokes the VAX Text Processing Utility (VAXTPU).  By  default,  the
  Extensible VAX Editor (EVE) is used as the interface for VAXTPU.  To
  invoke VAXTPU with the EDT Keypad  Emulator  interface,  define  the
  logical TPUSECINI to point to the section file for that interface as
  follows:
       $ DEFINE TPUSECINI EDTSECINI

  Format:


    EDIT/TPU  [file-spec]

Additional information available:

ParametersCommand QualifiersExamples

Parameters

 file-spec

  Specifies the file to be created or edited using one of  the  VAXTPU
  editing  interfaces.   If  the  file you specify does not exist, the
  VAXTPU interfaces provide a buffer in which to create the file.   If
  you  write  out the contents of the buffer (either with the built-in
  procedure WRITE_FILE or by exiting from the editor), VAXTPU  creates
  the file in the appropriate directory.

  If you do not provide a file specification as a parameter  when  you
  invoke  VAXTPU,  when  you try to leave the editor, you are prompted
  for a file name for any buffer that you modified.

  VAXTPU does not provide a default file type when creating files.  If
  you  do  not  specify  a file type, the file type is null.  The file
  must be a disk file on a Files-11 formatted volume.

  Whether or not VAXTPU recognizes wildcard characters as  a  part  of
  the input file specification depends on the interface you are using.
  EVE handles wildcard characters if there is a single match  for  the
  wildcard  character.   Otherwise,  EVE prompts within the editor for
  possible file names.  EVE treats multiple files in a search list  in
  the same way as multiple files in a wildcard specification.  The EDT
  Keypad Emulator does not recognize wildcard characters.

Command Qualifiers

Additional information available:

/COMMAND/CREATE/DISPLAY/JOURNAL/OUTPUT/READ_ONLY
/RECOVER/SECTION

/COMMAND

 /COMMAND[=command-file] (default)
 /NOCOMMAND

  Determines whether VAXTPU reads  a  user-written  command  file  for
  initialization purposes.  The default file type for command files is
  TPU.  By default, VAXTPU tries to read a file called TPUINI.TPU from
  your default directory.  You can use a full file specification after
  the qualifier /COMMAND or define the logical name TPUINI to point to
  a command file other than the default one.

  To prevent VAXTPU from processing a command file, use the  qualifier
  /NOCOMMAND.   Using /NOCOMMAND when you do not want to use a command
  file decreases startup time by eliminating the search for a  command
  file.

/CREATE

 /CREATE (default)
 /NOCREATE

  Controls whether VAXTPU creates a new file when the specified  input
  file  is  not  found.   The  interface  that is layered on VAXTPU is
  responsible for processing this qualifier.  The  interface  can  get
  information  on  whether the qualifier was specified when VAXTPU was
  invoked by using the built-in procedure GET_INFO, for example, x  :=
  GET_INFO (COMMAND_LINE, "create").  For information on GET_INFO, see
  Section 4 of the VAX Text Processing Utility Reference Manual.

  By default, the VAXTPU interfaces  provide  a  buffer  in  which  to
  create  a file.  If you write out the contents of the buffer (either
  with the built-in  procedure  WRITE_FILE  or  by  exiting  from  the
  editor), VAXTPU creates a new file for the input file specification.
  When you use the qualifier /NOCREATE and enter a file  specification
  that  does  not  exist,  EVE  and  the EDT Keypad Emulator clear the
  screen, display an error message, and return you to the DCL  command
  level as follows:

       $ EDIT/TPU/NOCREATE NEWFILE.DAT
         Input file does not exist: DISK$:[USER]NEWFILE.DAT;
       $

/DISPLAY

 /DISPLAY[=file-spec] (default)
 /NODISPLAY

  Determines whether a VAXTPU session is run from a supported terminal
  and  uses  terminal  functions  such  as  the screen display and the
  keyboard.  By default your VAXTPU session is  run  with  the  screen
  management  file, TPU$CCTSHR.EXE, for terminals that respond to ANSI
  control functions and that operate in ANSI mode.

  VAXTPU expects sessions to be run from a supported  terminal  unless
  you specify /NODISPLAY.  If an unsupported input device is used when
  /DISPLAY is active, VAXTPU returns an error message and the  session
  is  terminated.   (See Appendix B of the VAX Text Processing Utility
  Reference Manual for information on terminals supported by VAXTPU.)

  The qualifier /NODISPLAY causes VAXTPU  to  run  without  using  the
  screen  display  and  the keyboard functions of a terminal.  Use the
  qualifier /NODISPLAY under the following conditions:

  o  When running VAXTPU procedures in a batch job

  o  When using VAXTPU on an unsupported terminal

  If you use /NODISPLAY, window and screen manipulation  commands  and
  key  definitions  cause  errors.   Initialization files that contain
  screen manipulation commands (ADJUST_WINDOW, CREATE_WINDOW, MAP) and
  key  definitions  can  run  when  the  /NODISPLAY feature is active.
  However, the commands are meaningless  and  may  even  return  error
  messages  in  the  batch  log file or on your screen.  Use a special
  initialization file (either a section file or a  command  file)  for
  sessions  in  which  you  use  the  qualifier /NODISPLAY.  This file
  should not include key definitions or screen  manipulation  commands
  (except  for  READ_LINE, MESSAGE, and LAST_KEY, which work with some
  restrictions).  See the descriptions of READ_LINE  and  LAST_KEY  in
  Section  4 of the VAX Text Processing Utility Reference Manual for a
  list of the restrictions.  The file  should  be  a  complete  VAXTPU
  session; it should end with the command EXIT or the command QUIT.

/JOURNAL

 /JOURNAL[=journal-file] (default)
 /NOJOURNAL

  Determines whether VAXTPU keeps  a  journal  file  of  your  editing
  session  so  that  you can recover from an interrupted session.  The
  interface that is layered on VAXTPU is  responsible  for  processing
  this  qualifier.   The  interface can get information on whether the
  qualifier was  specified  when  VAXTPU  was  invoked  by  using  the
  built-in   procedure   GET_INFO,   for   example,   x   :=  GET_INFO
  (COMMAND_LINE, "journal").  For information on GET_INFO, see Section
  4 of the VAX Text Processing Utility Reference Manual.

  By default, the VAXTPU interfaces maintain a journal file  that  has
  the  same  name  as  the  input  file and the file type TJL.  If you
  invoke VAXTPU without a file specification, the default name for the
  journal  file  is  TPU.TJL.   Use a full file specification with the
  qualifier /JOURNAL to specify a different name for the journal file.

  If you edit a file from another directory and you want  the  journal
  file  to  be  located  in that directory, you must use the qualifier
  /JOURNAL with a file specification that includes the directory name.
  Otherwise,  the  VAXTPU  interfaces  create  the journal file in the
  default directory.

  Once you create a journal file, invoke  VAXTPU  with  the  qualifier
  /RECOVER to cause VAXTPU to process the journal file.

  To prevent VAXTPU from keeping  a  journal  file  for  your  editing
  session, use the qualifier /NOJOURNAL.

/OUTPUT

 /OUTPUT=output-file (default)
 /NOOUTPUT

  Determines whether VAXTPU creates an output file at the end of  your
  editing  session.   The  interface  that  is  layered  on  VAXTPU is
  responsible for processing this qualifier.  The  interface  can  get
  information  on  whether the qualifier was specified when VAXTPU was
  invoked with the built-in procedure  GET_INFO,  for  example,  x  :=
  GET_INFO (COMMAND_LINE, "output").  For information on GET_INFO, see
  Section 4 of the VAX Text Processing Utility Reference Manual.

  By default, the VAXTPU interfaces use the  same  file  specification
  for  both the input file and the output file.  The output file has a
  version number one higher than the highest existing version  of  the
  input  file.  Use a file specification with the qualifier /OUTPUT to
  specify a file name that is different from the input file.  You  can
  include   directory   information   as  part  of  your  output  file
  specification to send output to another directory.

  The qualifier /NOOUTPUT suppresses the creation of an  output  file,
  but  not  the creation of a journal file.  If you invoke VAXTPU with
  /NOOUTPUT and then decide you want an output file, use  the  command
  WRITE  FILE  in EVE, or the built-in procedure WRITE_FILE in the EDT
  Keypad Emulator interface before you  end  the  editing  session  to
  write out the contents of a buffer.

/READ_ONLY

 /READ_ONLY
 /NOREAD_ONLY (default)

  Determines whether VAXTPU keeps a journal file and creates an output
  file  from  the  contents  of  the  main buffer.  With /NOREAD_ONLY,
  VAXTPU maintains a journal file and creates an output file from  the
  contents of the main buffer if you modified it.

  Using  the  qualifier  /READ_ONLY  is  like  using   the   qualifier
  /NOJOURNAL  for  the editing session and the qualifier /NOOUTPUT for
  the main buffer.  When  you  specify  /READ_ONLY,  VAXTPU  does  not
  maintain  a  journal file for your editing session, and the NO_WRITE
  attribute is set for the main buffer.   When  a  buffer  is  set  to
  NO_WRITE,  the  contents  of the buffer are not written out when you
  leave VAXTPU.  Both the built-in procedures EXIT and  QUIT  end  the
  editing session without creating a new file from the contents of the
  main buffer (even if you modified it).

  Use  the  qualifier  /READ_ONLY  when  you  are  merely  reading  or
  searching  a  file.   If  you  change your mind and want to save any
  edits you make to the file, use the command WRITE FILE  in  EVE,  or
  the  built-in  procedure  WRITE_FILE  in  the EDT Keypad Emulator to
  write the modified buffer to an external file.   Remember,  however,
  that you do not have a journal file.

/RECOVER

 /RECOVER
 /NORECOVER (default)

  Determines whether VAXTPU reads a journal file at the  start  of  an
  editing session.

  When you use the qualifier /RECOVER, VAXTPU  reads  the  appropriate
  journal  file  and  processes whatever commands it contains.  If the
  journal file type is not TJL, or if the file name is not the same as
  the   input   file   name,  you  must  include  both  the  qualifier
  /JOURNAL=journal-file and the qualifier /RECOVER.

  When you recover a session, all files must be in the same  state  as
  they  were at the start of the editing session being recovered.  All
  terminal characteristics must also be in the same state as they were
  at  the  start  of  the  editing  session  being  recovered.   Check
  especially the following terminal characteristics:

       Device_Type
       Edit_mode
       Eightbit
       Page
       Width

/SECTION

 /SECTION[=file-spec] (default)
 /NOSECTION

  Determines whether VAXTPU reads a special initialization  file  that
  is  stored  in binary form.  The default file type for section files
  is  TPU$SECTION.   By  default,  VAXTPU  tries  to  read  the   file
  SYS$LIBRARY:TPUSECINI.TPU$SECTION, the section file that creates the
  EVE editing  interface.   You  can  specify  a  different  file  for
  initialization  purposes  by  defining the logical name TPUSECINI to
  point to a section file other than the default  one.   This  is  the
  preferred  method.   However,  you  can  also  supply  a  full  file
  specification for the qualifier /SECTION.

  The file  used  as  the  value  for  /SECTION=section-file  must  be
  compiled  by  running the source code version of your initialization
  file through VAXTPU and then  using  the  built-in  procedure  SAVE.
  This process converts the file to the proper binary form.

  If  you  specify  /NOSECTION,  VAXTPU  does  not   read   a   binary
  initialization  file.   If  no  section file is read, and no command
  file is read, VAXTPU will not have a user interface and no keys will
  be  defined.   In this state, the only way to exit from VAXTPU is by
  pressing CTRL/Y.

Examples

  1.   $ EDIT/TPU/OUTPUT=NEWFILE.TXT OLDFILE.TXT

  Invokes VAXTPU to edit the file  OLDFILE.TXT.   By  default,  VAXTPU
  uses the section file SYS$LIBRARY:TPUSECINI.TPU$SECTION that creates
  the EVE editing interface.  VAXTPU then tries to  read  the  command
  file TPUINI.TPU in your default directory.  If you do not define the
  logical name TPUINI to point to a user-written command file, and  if
  you  do  not have a file named TPUINI.TPU in your default directory,
  VAXTPU does not read a command file.  If you modify the main  buffer
  and  then use the command EXIT to end the session, the modified file
  is named NEWFILE.TXT.

  2.   $ EDIT/TPU/SECTION=EDTSECINI OLDFILE.TXT

  Invokes VAXTPU with  the  EDT  Keypad  Emulator  editing  interface.
  VAXTPU  makes  a copy of the file OLDFILE.TXT available for editing.
  If you modify the main buffer, when you  use  the  command  EXIT  to
  leave  the editing session, VAXTPU creates a new version of the file
  with a version number one higher than the highest  existing  version
  number for that file.

  3.   $ EDIT/TPU/SECTION=DISK$USER:[SMITH]VT100INI

  Causes VAXTPU to read the section file VT100INI.TPU$SECTION.

  4.   $ EDIT/TPU/RECOVER OLDFILE.TXT

  Invokes VAXTPU with the EVE editing interface  to  recover  from  an
  abnormal  exit  during a previous editing session.  VAXTPU opens the
  file OLDFILE.TXT and then processes the  journal  file  OLDFILE.TJL.
  Once the journal file has been processed, you can resume interactive
  editing.

  5.   $ EDIT/TPU/RECOVER/JOURNAL=SAVE.XXX MEMO.DAT

  Invokes VAXTPU with the EVE editing interface  to  recover  from  an
  abnormal  exit  during  a  previous  session.  VAXTPU opens the file
  MEMO.DAT and then processes the journal file SAVE.XXX.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026