INDIRECT COMMAND

                        FILE PROCESSING

                         FOR RT-11 V4.0
         Indirect Command File Processing
         For RT-11 V4.0




                                TABLE OF CONTENTS


         1.0  Introduction . . . . . . . . . . . . . . . . . . . . . .  1
         2.0  Patching the System  . . . . . . . . . . . . . . . . . .  2
              2.1  Patching IND  . . . . . . . . . . . . . . . . . . .  2
              2.2  Patching the Keyboard Monitor . . . . . . . . . . .  3
         3.0  Operating Instructions . . . . . . . . . . . . . . . . .  5
              3.1  Using IND . . . . . . . . . . . . . . . . . . . . .  5
                   3.1.1  /T Switch  . . . . . . . . . . . . . . . . .  5
                   3.1.2  /D Switch  . . . . . . . . . . . . . . . . .  5
                   3.1.3  /N Switch  . . . . . . . . . . . . . . . . .  5
              3.2  The IND Command . . . . . . . . . . . . . . . . . .  5
         4.0  Symbol and Processing Protocols  . . . . . . . . . . . .  7
              4.1  Special Symbols . . . . . . . . . . . . . . . . . .  7
              4.2  Numeric and String Symbols  . . . . . . . . . . . .  9
                   4.2.1  Numeric Symbols and Expressions  . . . . . .  9
                   4.2.2  String Symbols, Substrings, and Expressions  10
              4.3  Symbol Value Substitution . . . . . . . . . . . . . 10
              4.4  Multi-level Indirect Files  . . . . . . . . . . . . 11
              4.5  Parameter Passing . . . . . . . . . . . . . . . . . 11
         5.0  Indirect Command File Directives . . . . . . . . . . . . 12
              5.1  Defining Labels . . . . . . . . . . . . . . . . . . 12
              5.2  Requesting Data from the Terminal . . . . . . . . . 13
                   5.2.1  .ASK Directive . . . . . . . . . . . . . . . 13
                   5.2.2  .ASKN Directive  . . . . . . . . . . . . . . 13
                   5.2.3  .ASKS Directive  . . . . . . . . . . . . . . 14
              5.3  Symbol Data Manipulation Directives . . . . . . . . 15
                   5.3.1  .DEC/.INC Directives . . . . . . . . . . . . 15
                   5.3.2  .ERASE Directive . . . . . . . . . . . . . . 15
                   5.3.3  .PARSE Directive . . . . . . . . . . . . . . 15
                   5.3.4  .SETT/.SETF Directives . . . . . . . . . . . 16
                   5.3.5  .SETN Directive  . . . . . . . . . . . . . . 16
                   5.3.6  .SETS Directive  . . . . . . . . . . . . . . 17
              5.4  Logical Control Directives  . . . . . . . . . . . . 17
                   5.4.1  .BEGIN Directive . . . . . . . . . . . . . . 17
                   5.4.2  .END Directive . . . . . . . . . . . . . . . 18
                   5.4.3  .EXIT Directive  . . . . . . . . . . . . . . 18
                   5.4.4  .GOSUB Directive . . . . . . . . . . . . . . 18
                   5.4.5  .GOTO Directive  . . . . . . . . . . . . . . 19
                   5.4.6  .ONERR Directive . . . . . . . . . . . . . . 19
                   5.4.7  .RETURN Directive  . . . . . . . . . . . . . 20
                   5.4.8  .STOP Directive  . . . . . . . . . . . . . . 21
                   5.4.9  / Logical End-Of-File Directive  . . . . . . 21
              5.5  Logical Test Directives . . . . . . . . . . . . . . 21
                   5.5.1  .IF Directive  . . . . . . . . . . . . . . . 21
                   5.5.2  .IFDF/.IFNDF Directives  . . . . . . . . . . 22
                   5.5.3  .IFT/.IFF Directives . . . . . . . . . . . . 22
                   5.5.4  .TEST Directive  . . . . . . . . . . . . . . 22
                   5.5.5  Compound Tests . . . . . . . . . . . . . . . 23
              5.6  File Access Directives  . . . . . . . . . . . . . . 23
                   5.6.1  .CHAIN Directive . . . . . . . . . . . . . . 23

                                        i  
         Indirect Command File Processing
         For RT-11 V4.0


                   5.6.2  .CLOSE Directive . . . . . . . . . . . . . . 23
                   5.6.3  .DATA Directive  . . . . . . . . . . . . . . 24
                   5.6.4  .OPEN Directive  . . . . . . . . . . . . . . 24
                   5.6.5  .OPENA Directive . . . . . . . . . . . . . . 25
                   5.6.6  .OPENR Directive . . . . . . . . . . . . . . 25
                   5.6.7  .READ Directive  . . . . . . . . . . . . . . 25
                   5.6.8  .TESTFILE Directive  . . . . . . . . . . . . 26
              5.7  Enabling and Disabling Operating Modes  . . . . . . 26
                   5.7.1  LOWERCASE Mode . . . . . . . . . . . . . . . 27
                   5.7.2  DATA Mode  . . . . . . . . . . . . . . . . . 27
                   5.7.3  GLOBAL Mode  . . . . . . . . . . . . . . . . 28
                   5.7.4  SUBSTITUTION Mode  . . . . . . . . . . . . . 28
                   5.7.5  ESCAPE Mode  . . . . . . . . . . . . . . . . 28
                   5.7.6  QUIET Mode . . . . . . . . . . . . . . . . . 28
         Appendix A:  Alphabetic Directive Listing . . . . . . . . . . 29








































                                        ii 
         Indirect Command File Processing                   Page 1
         For RT-11 V4.0                             February 2, 1983


         1.0  Introduction

         The RT-11 AUTOPATCH function uses a  program  called  IND  to
         emulate  the  RSX  Indirect Command Processor.  Some interest
         was expressed at the U.S. DECUS Symposium in using this  pro-
         gram   under  RT-11  to  do  fancy  indirect  command  files.
         However, in trying to do so, users have discovered  that  IND
         does not work apart from RT-11 AUTOPATCH.

         In the February, 1982 MINI-TASKER (the RT-11  SIG  Newsletter
         from DECUS), John M. Crowell, of CROW4ELL, Ltd.,  published a
         set of patches that unlock IND  from  AUTOPATCH  Revision  D.
         This  document  gives  the  instructions  for  applying those
         patches, and also details the  use  of  IND  in  the  patched
         system.

         The patches detailed in Section 2.0 will create a version  of
         IND  that works under RT-11, and a version of RT-11 that will
         support a CCL IND command.  These patches are  effective  for
         the  SJ  (with timer support), FB, and XM RT-11 monitors, and
         allow the use of all RSX command file directives except those
         that are RSX specific.  The patched IND program does not work
         under TSX or TSX-Plus.

         No guarantee is made by Plessey Peripheral Systems, DECUS, or
         CROW4ELL,  Ltd.,  as to the functionality of IND or the accu-
         racy of the  statements  contained  in  this  document.    No
         support  of  the  products described is implied by this docu-
         ment, and no support will be given.

         Indirect Command File Processing                   Page 2
         For RT-11 V4.0                             February 2, 1983


         2.0  Patching the System

         2.1  Patching IND

         IND is locked to AUTOPATCH Revision D in two ways.  The first
         is  straightforward  and  rather  obvious:  IND automatically
         looks for the file SY:AUTOP.COM.  The  second  lock  is  more
         subtle:  IND checks for a double carriage return in the copy-
         right and disclaimer notice that heads up the AUTOP.COM file.
         This  double  carriage  return would be invisible in any lis-
         tings of the file, but if this aberration is not present, IND
         refuses to process the file.

         The following command file disables the routine  that  checks
         for a double carriage return, and enables the subroutine that
         asks for input (a command file name and a  switch)  from  the
         terminal.

                   R SIPP
                   IND.SAV/A/C
                   0
                   14512
                   45104
                   41515
                   53040
                   30460
                   33456
                   ^Z
                   15324
                   3310
                   ^Z
                   15346
                   3266
                   ^Z
                   21044
                   207
                   ^Z
                   25004
                   1142
                   ^Z
                   26250
                   427
                   ^Z
                   27266
                   165354
                   ^Y
                   14533
                   ^C

         Once IND has been patched,  an  operator  may  enter  command
         files at the terminal in the following form:

         R IND
                   filspec[/switch] [par1 par2 par3 . . . parn]
         Indirect Command File Processing                   Page 3
         For RT-11 V4.0                             February 2, 1983


                   (brackets not part of syntax)

         where

                   filspec   is the indirect command file to be  proc-
                             essed, with a default extension of .COM.

                   switch    is  one  of  the   valid   IND   switches
                             described in Section 3.1.

                   par1...   are parameters to be passed to the  indi-
                             rect command file in the manner described
                             in Section 4.5

         It is also possible to use IND in a one line command, without
         parameters, thus:

                   RUN IND filspec/switch

         If these two command forms are enough, the user may not  want
         to  apply the patch to the keyboard monitor which will enable
         the CCL command IND.

         Please Note:  This patch is designed for the IND program that
         ___________
         is  supplied  with AUTOPATCH Revision D.  It does not work on
         other versions of IND.

         2.2  Patching the Keyboard Monitor

         If the user wishes to use IND as a CCL  command,  this  patch
         for the RT-11 keyboard monitor will enable it.  Before apply-
         ing the  patch,  RT-11  should  be  patched  by  the  current
         revision  of  AUTOPATCH.    The patch consists of a series of
         commands  to  the  TECO  editor  which  alter  KMON.MAC   and
         KMOVLY.MAC so that the IND command is enabled.

         CAUTION:  This patch will alter KMON.MAC  and  KMOVLY.MAC  in
         _______
         such  a  way  that  DEC supplied SLP patches to them will not
         work.  SAVE THE ORIGINAL FILES!!!  When DEC  supplies  a  new
                __________________________
         patch or a new version of AUTOPATCH, use it with the original
         files and re-apply these commands to the newly patched files.

         Edit the following into a file, IND.TXT:

                   @EB/SRC:KMON.MAC/
                   @N/DEFALT       COPY/@N/BF/
                   0L@I/DEFALT     IND$$   U$TIL
                   /@N/PROG        APL/
                   L@I/.IIF NE     IND$$ PROG      IND
                   /@N/CMDTBL      FOCAL/
                   L@I/.IIF NE     IND$$ CMDTBL    IND
                   /@N/FLGTXT      <FOC_AL>/
                   L@I/.IIF NE     IND$$ FLGTXT    <IND>
                   /@EC
                   @EB/SRC:KMOVLY.MAC/
                   @N/SYNTAX       FORMAT/ZJ12@I//
         Indirect Command File Processing                   Page 4
         For RT-11 V4.0                             February 2, 1983


                   @I/.IF NE       IND$$
                   .SBTTL  IND COMMAND
                           SYNTAX  IND
                           PROMPT  $FILEE
                           SCALL   GSWIT,<1>
                           REQBLNK
                           SCALL   RINSPC,<1>
                           EOLSEQ  IND
                           END
                           SWITS   IND
                   SWIT    DELETE          1       IND             - D
                   SWIT    TRACE           1       IND             - T
                   SWIT    NOEXEC          1       IND             - N
                           ENDNO
                           NOS
                           ENDS
                           OVCMD   IND
                           ITBLE   1
                           OJSR    PC,INITIT
                           OJMP    CMDEXE
                   .ENDC
                   /@N/BOOT$$/L
                   @I/.SBTTL       BOOT COMMAND
                   /@N/SWTDEF/@S/.EVEN/0L
                   @I/     SWTDEF  <DELETE>
                           FLGTXT          <D_ELETE>
                           SWTDEF  <TRACE>
                           FLGTXT          <T_RACE>
                           SWTDEF  <NOEXEC>
                           FLGTXT          <N_OEXEC>
                   /@EX

         Once this text file has been  created,  enter  the  following
         commands at the console:

                   ASS ddu SRC
                   R TECO
                   ERIND.TXT<esc>AJ44XD<esc>HKMD<esc><esc>

         Where ddu is the name of the device on which the source files
               ___
         KMON.MAC and KMOVLY.MAC reside and <esc> represents an escape
                                            _____
         (ASCII 27 decimal) character.  After this command has  execu-
         ted,  a SYSGEN should be performed.  Once the SYSGEN has been
         performed and a new monitor created, RT-11 will recognize  an
         IND command of the form

                   IND filspec/switch

         Indirect Command File Processing                   Page 5
         For RT-11 V4.0                             February 2, 1983


         3.0  Operating Instructions

         3.1  Using IND

         The use of IND is much like the use of any other RT-11 utili-
         ty.    The user runs the program, and then enters the file to
         be processed, with one of the three optional switches.    The
         format of this mode of operation is

                   R IND
                   filspec[/switch] [par1 par2 . . . parn]

                   (brackets not part of syntax)

         where  filspec  is  a  file   specification   of   the   form
                _______
         dev:filename.ext,  switch is an optional switch, and par1 . .
                            ______                            ________
         . are parameters to be passed to the  indirect  command  file
         _
         specified.

         Sections 3.1.1 through 3.1.3 describe the  valid  values  for
         switch.
         ______

         3.1.1  /T Switch

         Using this switch causes each command line to be  printed  at
         the  terminal  as a comment before execution.  This switch is
         useful as a debugging tool, as IND  normally  operates  in  a
         quiet mode, with no display of commands.

         3.1.2  /D Switch

         This switch causes the command file to be deleted  after  ex-
         ecution.   THIS SWITCH IS DANGEROUS!!!  Don't use this switch
                    ___________________________
         unless absolutely sure that the command file will work and is
                __________
         the  function that is desired.  A failure will be untraceable
         as the user will not know what commands were executed.

         3.1.3  /N Switch

         This switch is possibly the most valuable debugging  tool  of
         all.  When used, each command is printed at the terminal as a
         comment, and no execution takes place.  It can thus  be  used
                      ________________________
         to  show the flow of a command file before actually executing
         it, pointing out errors in chaining  or  jumping  that  might
         otherwise destroy data.

         3.2  The IND Command

         If the patch described in Section 2.2 is applied to the  key-
         board  monitor,  IND may be invoked as a CCL (Concise Command
         Language) command.  This command is of the form

                   IND filspec/switch

         where filspec has the same value as described in Section 3.1.
               _______
         The  switch,  as  in  Section 3.1, has three possible values.
              ______
         Indirect Command File Processing                   Page 6
         For RT-11 V4.0                             February 2, 1983


         These switches are /TRACE, /DELETE, and /NOEXEC, and  corres-
                            ______  _______      _______
         pond,  respectively,  to  the  switches described in Sections
         3.1.1 through 3.1.3.  Each of these switches may be  abbrevi-
         ated by their first letter.  The parameter passing feature of
         IND may not be used in this command.
         Indirect Command File Processing                   Page 7
         For RT-11 V4.0                             February 2, 1983


         4.0  Symbol and Processing Protocols

         IND enables the user to define symbols.   These  symbols  can
         then  be tested and compared in order to control flow through
         the command file.  They may also  be  substituted  for  RT-11
         commands,  data records for data files, indirect command file
         directives, or comments to be displayed on the terminal.

         Symbol names are ASCII strings from one to six characters  in
         length.    They  must start with a letter (A - Z) or a dollar
         sign ($).  The remaining characters may be alphanumeric or  a
         dollar sign.

         There are three symbol types:  logical, string, and  numeric.
         A  logical symbol has either a true or false value.  A string
         symbol has as its value a string of ASCII characters  with  a
         length  between  zero and eighty characters inclusive.  A nu-
         meric symbol can have a numeric value in the range  of  0  to
         65535  inclusive.  The symbol can be defined to have either a
         decimal or octal value.  The base of the value (octal or dec-
         imal) is relevant only when the symbol is substituted.

         A symbol's type is defined by the first assignment  directive
         that  assigns  a value to the symbol.  Subsequent assignments
         may assign a different value, but cannot redefine the  symbol
         type.

         4.1  Special Symbols

         IND automatically defines special symbols dependent upon spe-
         cific  system  characteristics  and  the  replies  to queries
         presented during command  file  execution.    As  with  user-
         defined  symbols, special symbols can be compared, tested, or
         substituted and have three  types:    logical,  numeric,  and
         string.    All  special  symbols have a common format;  angle
         brackets (<>) enclose their names, with the exception of  the
         "passed parameter" symbols COMMAN and P0 through P9.

             Symbol    Value
             ______    _____

             <ALPHAN>  Set to true if the last string entered  in  re-
                       sponse  to  an .ASKS directive or tested with a
                       .TEST  directive  contained  only  alphanumeric
                       characters.  An empty string also sets <ALPHAN>
                       true.   Lower  case  letters  set  <ALPNAN>  to
                       false.

             COMMAN    Contains the entire command line passed by  the
                       keyboard monitor to IND.

             <DATE>    Assigned the current date in the format dd-mmm-
                                                               _______
                       yy.
                       __

             <DEFAUL>  Set to true if the answer to the  last  numeric
                       query  (.ASKN)  was  the default (a single car-
                       riage return was entered).
         Indirect Command File Processing                   Page 8
         For RT-11 V4.0                             February 2, 1983


             <EOF>     Set  to  true  if  the  last  .READ   directive
                       encountered an end-of-file.

             <ESCAPE>  Set to true if  the  last  .ASK  directive  was
                       answered with an <esc> character (ASCII decimal
                       27, escape).

             <EXSTAT>  Assigned the value of 0, 1, 2, or  4  depending
                       on  the exit status from the last RT-11 command
                       executed.  This symbol is modified to  a  value
                       dependent on how the command completed:

                            0    Warning
                            1    Success
                            2    Error
                            4    Severe error

             <FILSPC>  Assigned the fully qualified file specification
                       of  the  file  last referred to by a .TESTFILE,
                       .OPEN, .OPENA, .OPENR, .READ, .DATA or  .ENABLE
                       DATA directive.

             <FILERR>  Assigned a value depending on the completion of
                       the last I/O operation:

                            1    Operation successful
                            244  Invalid file specification
                            346  File not found
                            366  End-of-file encountered

             <MAPPED>  Set to true if the system on which IND is  run-
                       ning is mapped, false if system is unmapped.

             P0        Contains the indirect file name portion of  the
                       command  line passed by the keyboard monitor to
                       IND.

             P1 - P8   These eight symbols contain the values  of  the
                       first   eight  parameters  (including  explicit
                       nulls) passed to IND by the keyboard monitor.

             P9        Contains the  remainder  of  the  command  line
                       beyond  the  eighth  parameter passed to IND by
                       the keyboard monitor.

             <RAD50>   Set to true if the last string entered  in  re-
                       sponse  to  an .ASKS directive or tested with a
                       .TEST directive contained only Radix-50 charac-
                       ters.   An empty string also sets <RAD50> true.
                       Note that blanks are not RAD50 characters.

             <SPACE>   Assigned the number, in octal, of free bytes in
                       the internal symbol table of IND.

             <STRLEN>  Assigned the length of the  string  entered  in
                       response  to  the  last  .ASKS directive or the
         Indirect Command File Processing                   Page 9
         For RT-11 V4.0                             February 2, 1983


                       string tested by the last .TEST directive.

             <SYDISK>  Assigned the device mnemonic (two  letters)  of
                       the user's system device (SY:).

             <SYSTEM>  Assigned an octal number to represent the oper-
                       ating  system  on  which  IND  is running.  The
                       value 7 is for the RT-11 Single Job system.

             <SYUNIT>  Assigned the unit number of the  user's  system
                       device.

             <TIME>    Assigned  the  current  time  in   the   format
                       hh:mm:ss.
                       ________

         4.2  Numeric and String Symbols

         IND assigns a value, either numeric or  string,  to  symbols.
         This  assignment define the symbol as either a numeric symbol
         or a string symbol.

         4.2.1  Numeric Symbols and Expressions

         A numeric symbol is a string of digits representing  a  value
         in the range of 0-177777 octal (0-65535 decimal if immediate-
         ly followed by a period).  If an arithmetic operation  yields
         a  result outside of this range, a fatal error occurs and IND
         displays a NUMERIC UNDER- OR OVERFLOW message.

         When a numeric symbol is substituted into a string, the  type
         (octal or decimal) is determined by the value assigned by the
         .ASKN or .SETN directive that defined the symbol.  A  numeric
         symbol  or  constant  may  be  combined  with another numeric
         symbol or constant by a logical  or  arithmetic  operator  to
         form  a numeric expression.  Arithmetic operators are used to
         add (+), subtract (-), multiply (*), and divide (/).  Logical
         operators  are  the inclusive OR (!) and logical AND (&).  No
         embedded blanks or tabs are permitted between operators.

         Numeric expressions are evaluated from left to  right  unless
         parentheses  are  used to form subexpressions that are evalu-
         ated first.  For instance, the directive line

                   .SETN N1 2+3*4

         assigns to N1 the value 24(8), whereas the directive

                   .SETN N1 2+(3*4)

         assigns the value 16(8) to N1.

         The type of an expression is octal if all  the  operands  are
         octal;  otherwise  the  type is decimal.  Numeric expressions
         (as opposed to symbols) are permitted as second  operands  in
         numeric .IF and .SETN directives.  They are also permitted as
         range and default arguments in .ASKN  and  .ASKS  directives.
         Indirect Command File Processing                   Page 10
         For RT-11 V4.0                             February 2, 1983


         The directives .EXIT and .STOP permit numeric expressions  to
         represent exit status.

         4.2.2  String Symbols, Substrings, and Expressions

         A string constant is a string of any printable characters en-
         closed by quotes (" ").  Empty or null strings are permitted,
         and are represented by two consecutive quotes ("").   Strings
         cannot be more than eighty characters long.

         String symbols may have a value of any string constant.   The
         value is assigned by a .SETS or .ASKS directive.

         A substring facilitates the extraction of a segment from  the
         value  of  a  string  symbol.  Substrings may be used only as
         second operands in .SETS and .IF directives.    For  example,
         the directive lines

                   .SETS S1 "ABCDEF"
                   .SETS S2 S1[2:3]

         assigns string symbol S2 the value of  S1  beginning  at  the
         second  character  and  ending with the third character (that
         is, "BC").

         String constants, symbols, or substrings may be  concatenated
         by the use of the concatenation operator (+) to form a string
         expression, which is permitted as the second operand in .SETS
         or .IF directive.  For example, the directive lines

                   .SETS S1 "A"
                   .SETS S2 "CDEF"
                   .SETS S3 S1+"B"+S2[1:3]

         assign string symbol S3 with the value "ABCDE".

         4.3  Symbol Value Substitution

         Substitution can occur in any line of a command file.   RT-11
         commands  can  use  the  values assigned to logical, numeric,
         string, or special symbols by replacing  a  normal  parameter
         (for  example,  a device unit) or the command itself with the
         symbol name enclosed in single quotes.  When a  previous  di-
         rective has enabled substitution mode (.ENABLE SUBSTITUTION),
         IND replaces the symbol name enclosed in single  quotes  with
         the value assigned to the symbol.

         For example, the indirect command file

                   .ASKS DEV FORMAT DEVICE?
                   .ENABLE SUBSTITUTION
                   FORMAT 'DEV'

         results in the following dialogue on the terminal
         Indirect Command File Processing                   Page 11
         For RT-11 V4.0                             February 2, 1983


                   * FORMAT DEVICE? [S]: RK2:
                                         ____
                   FORMAT RK2:
                   RK2:/FORMAT-Are you sure? (Y/N) Y
                                                   _
                   RK2:/Formatting complete

         If the user desires to include  a  single  quote  in  comment
         text,  it is necessary to enter two contiguous quotes ('') to
         represent each single quote.

         4.4  Multi-level Indirect Files

         Indirect command files may be nested to four levels.  The use
         of the .ENABLE GLOBAL directive allows the definition of some
         symbols as global to all indirect file  levels.    Otherwise,
         each time IND enters a deeper level, it masks all symbols de-
         fined by the previous level out of the symbol table, so  that
         only  symbols  defined  in  the  current level are available.
         These symbols are local only to the level of command file  in
         which  they  are defined.  When control returns to a previous
         level, the symbols defined in that level become available and
         the ones from the lower level are lost.

         4.5  Parameter Passing

         When running IND  directly  from  the  terminal  rather  than
         through the CCL command, it is possible to pass parameters to
         the indirect command file.  This is done by running IND, then
         entering  the  command  file name followed by space-delimited
         parameters:

                   R IND
                   filnam arg1 arg2 arg3 . . . argn

         where:

                   filnam   is the name of the command file

                   arg1...  are the parameters to be passed.

         The entire command line will appear  in  the  special  symbol
         COMMAN.  filnam is placed into the special symbol P0, and the
                  ______
         first eight parameters appear in P1 through P8.   Any  infor-
         mation  left  over  is  placed  into P9.  The total number of
         parameters, including the file name, is placed into <STRLEN>

         Note:  If this function is going to be  used,  it  should  be
         ____
         used at the very beginning of indirect processing.  If param-
         eters are passed, they should be moved from P0 through P9 and
         COMMAN at the start of the command file.  Waiting until later
         in processing can cause unpredictable results.

         For information on performing alternative command  parses  as
         well  as  additional  parses on the arguments, see the .PARSE
         directive.
         Indirect Command File Processing                   Page 12
         For RT-11 V4.0                             February 2, 1983


         5.0  Indirect Command File Directives

         The Indirect Command File  Processor  IND  processes  command
         files  with special directives in them.  These directives are
         commands to the indirect command file processor, IND, and are
         distinguished  by a period (.) as the first non-blank charac-
         ter of the line.  The directives form a procedural  language,
         which  allows  the  user to define labels and symbols, create
         and access data files, perform logical tests, enable or  dis-
         able any of six operating modes, and increment or decrement a
         decimal symbol.

         Two directives (.BEGIN and .END) permit modular, block struc-
         tured  command  files  and  isolated  local  symbol and label
         definitions.  The command file  can  also  include  comments,
         which  are  lines  beginning  with  a  semicolon (;), and are
         printed on the terminal.

         Directives must be separated from their arguments by at least
         one  space.    Any number of blanks and tab characters may be
         inserted at the start of the command line,  immediately  fol-
         lowing  the  colon (:) of a label, or at the end of a command
         line.  This allows "structured"  formatting  of  the  command
         files for readability.

         The only exception to this rule is  in  between  the  .ENABLE
         DATA  and .DISABLE DATA directives.  Between these two direc-
         tives, all tabs and blanks are processed as part of the  data
         to be output.

         5.1  Defining Labels

         Labels always appear at the beginning of the line.  They  may
         be  on  lines  with additional directives, RT-11 commands, or
         comments, or they may appear on a line by themselves.    Com-
         mands  or  directives  do  not  have to be separated from the
         label by space or tab characters.   Labels  are  one  to  six
         characters  long,  and  must  be preceded by a period (.) and
         terminated by a colon (:), and can only contain  alphanumeric
         characters and the dollar sign ($).

         Format:

                   .label:

         where label is the label name being defined.
               _____

         It is also possible to define a  label  as  a  direct  access
         label.   Once the label is found, its position in the command
         file is saved.  This allows subsequent  jumps  to  frequently
         called  labels  or  subroutines  to be effected very quickly.
         The first statement processed after a jump to a direct access
         label  is  the  one  on  the next line.  You can define up to
         twenty direct access labels within an indirect command  file.
         If more than twenty are defined, old labels are replaced on a
         first in/first out basis.
         Indirect Command File Processing                   Page 13
         For RT-11 V4.0                             February 2, 1983


         To declare a label as direct access, leave the line following
         the colon blank.

         5.2  Requesting Data from the Terminal

         5.2.1  .ASK Directive

         The .ASK directive prints text on the terminal, waits  for  a
         reply,  and  sets  a specified logical symbol to the value of
         true or false, depending on the reply.  If the symbol has not
         already been defined, an entry is made into the symbol table.
         If the symbol was previously defined as a string  or  numeric
         symbol, IND exits with a fatal error.

         Format:

                   .ASK symbol text

         where:

                   symbol   is a one to six character symbol  name  to
                            be assigned a true/false value.

                   text     is any ASCII string, preceded by at  least
                            one  blank,  and  no  longer  than seventy
                            characters.

         When executing this directive, IND displays text prefixed  by
         an  asterisk  and  suffixed  with "? [Y/N]:".  IND recognizes
         four answers:

                   1.  Y<ret>      - set symbol to true.
                   2.  N<ret>      - set symbol to false.
                   3.  <ret>       - set symbol to false
                   4.  <esc><ret>  - set symbol to true; set  <ESCAPE>
                       to true if escape recognition has been enabled.

         5.2.2  .ASKN Directive

         The .ASKN directive prints on the terminal a request for  nu-
         meric  data, waits for it to be entered, optionally tests the
         range of the numeric response and/or applies a default value,
         and sets the specified symbol accordingly.  If the symbol has
         not previously been defined, IND makes an entry in the symbol
         table.    If  the  symbol  was defined as a logical or string
         symbol, IND exits with a fatal error.

         Format:

                   .ASKN symbol text
                   .ASKN[low:high] symbol text
                   .ASKN[::def] symbol text
                   .ASKN[low:high:def] symbol text

                   (the brackets are required syntax)
         Indirect Command File Processing                   Page 14
         For RT-11 V4.0                             February 2, 1983


         where:

                   symbol   is a one to six character symbol  name  to
                            be assigned a numeric value.

                   text     is a one to seventy character string, pre-
                            ceded   by  at  lease  one  blank,  to  be
                            displayed as a question by IND.

                   low:high are the inclusive numeric  limits  of  the
                            response.

                   def      is the default value.

         The range and default arguments permit combination of numeric
         symbols  or constants with other numeric symbols or constants
         to form expressions.  The command line cannot exceed 80 char-
         acters  in  length.    When executing an .ASKN directive, the
         processor displays text prefixed by an asterisk and  suffixed
         with  "[O]:"  to  indicate that the response is considered as
         octal or "[D]:" to indicate decimal.  The  reply  must  be  a
         number  either  within the specified range or in the range 0-
         177777 octal (0-65535 decimal).  If the response is an  empty
         line (null) and no default was specified, IND applies a value
         of 0 to symbol.

         If the range and/or default values are  specified,  IND  adds
         these  values  to  the octal/decimal suffix on the display in
         the format "[x R:low-high D:def]", where x  is  "O"  or  "D",
                                                  _
         low-high  are the low and high limits of the specified range,
         ________
         and def is the specified default.
             ___

         5.2.3  .ASKS Directive

         The .ASKS directive prints on the terminal a  request  for  a
         string  value  to  define  a specified symbol, and optionally
         tests that the number of characters in  the  response  string
         falls  within  the  specified inclusive range.  If the symbol
         has not previously been defined, IND makes an entry into  the
         symbol table.  If the symbol was defined as a numeric or log-
         ical symbol, IND exits with a fatal error.

         Format:

                   .ASKS symbol text
                   .ASKS[low:high] symbol text

                   (the brackets are required syntax)

         where:
                   symbol   is a one to six character symbol  name  to
                            be assigned a string value.

                   text     is any ASCII string, preceded by at  least
                            one  blank, no longer than seventy charac-
                            ters, to be displayed  as  a  question  by
         Indirect Command File Processing                   Page 15
         For RT-11 V4.0                             February 2, 1983


                            IND.

                   low:high are the inclusive limits for the number of
                            characters   permitted   in  the  response
                            string.

         The command line cannot exceed eighty characters  in  length.
         When  specifying  range  arguments,  numeric symbols and con-
         stants may be combined to form  numeric  expressions.    When
         executing the directive, IND displays text prefixed by an as-
         terisk (*) and suffixed by "[S]:".   The  reply  must  be  an
         ASCII character string.

         5.3  Symbol Data Manipulation Directives

         5.3.1  .DEC/.INC Directives

         The .DEC or .INC directive decrements or increments a numeric
         symbol by one.  IND exits with a fatal error if the specified
         symbol was previously defined as a logical or string symbol.

         Format:

                   .DEC symbol

                   .INC symbol

         where symbol is a one to six character numeric symbol name.
               ______

         5.3.2  .ERASE Directive

         The .ERASE directive deletes all local or global  symbol  de-
         finitions.    When  a  symbol  is defined, either locally (by
         defining a symbol value)  or  globally  (by  enabling  global
         symbol  mode  and  preceding  the  symbol  name with a dollar
         sign), IND creates an entry in a symbol table.    The  .ERASE
         directive  erases  either  all local or all global entries in
         the table.  Following an .ERASE directive, symbol values  and
         types can be redefined.

         Format:

                   .ERASE LOCAL

                   .ERASE GLOBAL

         An .ERASE LOCAL directive outside of a Begin-End block erases
         all  local symbol.  An .ERASE LOCAL directive within a Begin-
         End block erases only those  local  symbols  defined  in  the
         block.    An .ERASE GLOBAL, either inside or outside a Begin-
         End block, erases all global symbols.

         5.3.3  .PARSE Directive

         The .PARSE directive parses strings into substrings.
         Indirect Command File Processing                   Page 16
         For RT-11 V4.0                             February 2, 1983


         Format:

                   .PARSE string cntrl var1 var2 var3 . . . varn

         where:
                   string   is the string constant  or  symbol  to  be
                            parsed

                   cntrl    is the parsing control  string,  described
                            below

                   var1...  are the variables into which  string  will
                                                          ______
                            be parsed

         The string will be decomposed into substrings as specified by
         the  control string, and the substrings stored in the specif-
         ied variables.  The first character  of  the  control  string
         delimits  the  first substring, the second character delimits
         the second substring, and so on.  The last character  of  the
         control  string will be repeated if the number of destination
         variables exceeds the length of the control string.  If there
         are  more variables specified than substrings, the additional
         variables will be set to null strings.  <STRLEN> will be  set
         to the actual number of arguments processed (including expli-
         cit null arguments).

         Note that the last output variable will contain the  trailing
         part  of  the  source string that would not fit in any of the
         other output variables.

         5.3.4  .SETT/.SETF Directives

         The .SETT/.SETF directives define or change the  value  of  a
         specified  logical  symbol.    If the symbol has not been de-
         fined, IND makes an entry in the symbol table  and  sets  the
         logical  symbol  to  the  value specified.  If the symbol was
         previously defined as a numeric or string symbol,  IND  exits
         with a fatal error.

         Format:

                   .SETT symbol

                   .SETF symbol

         where symbol is a one to six character logical symbol name to
               ______
         be  assigned  a true or false value.  The logical symbol name
         must be preceded by at least one blank.

         5.3.5  .SETN Directive

         The .SETN directive defines or changes the numeric value of a
         specified  numeric  symbol.    If the symbol has not been de-
         fined, IND makes an entry in the symbol table  and  sets  the
         symbol  to  the  numeric  value specified.  If the symbol was
         previously defined as a logical or string symbol,  IND  exits
         Indirect Command File Processing                   Page 17
         For RT-11 V4.0                             February 2, 1983


         with a fatal error.

         Format:

                   .SETN symbol numexp

         where:
                   symbol   is the one to six character  name  of  the
                            numeric symbol to be defined or changed.

                   numexp   is a numeric expression  representing  the
                            new value of symbol.

         When specifying a numeric value to assign to a symbol, numer-
         ic  symbols  and  constants may be combined to form a numeric
         expression.  If numeric expressions  are  used,  no  embedded
         blanks  or  tabs are permitted.  Evaluation is done from left
         to right unless parentheses are used to  form  subexpressions
         that are evaluated first.  The type of an expression is octal
         if all the operands are octal;  otherwise the type  is  deci-
         mal.

         5.3.6  .SETS Directive

         The .SETS directive defines or changes the string value of  a
         specified string symbol.  If the symbol has not been defined,
         IND makes an entry in the symbol table and sets the symbol to
         the  specified string value.  IND exits with a fatal error if
         the symbol was previously defined as  a  logical  or  numeric
         symbol.

         Format:

                   .SETS symbol strexp

         where:
                   symbol   is a one to six  character  string  symbol
                            name

                   strexp   is any string expression.

         IND assigns the specified symbol the string value represented
         by  the  string  expression  strexp.  If a string constant is
                                      ______
         used for strexp, it must be enclosed  in  quotes  ("ABCDEF").
                  ______
         String  symbols,  constants,  and  substrings may be combined
         with the string concatenation operator (+) to form any string
         expression.

         5.4  Logical Control Directives

         5.4.1  .BEGIN Directive

         The .BEGIN directive  marks  the  beginning  of  a  Begin-End
         block.    All local symbols following the directive are local
         to the block, instead of the entire command file.  an  .ERASE
         LOCAL directive erases all local symbols within the block.
         Indirect Command File Processing                   Page 18
         For RT-11 V4.0                             February 2, 1983


         Begin-End blocks can be nested up to a maximum depth of  127.
         IND  usually  exhausts  stack  space before this limit can be
         reached.

         Format:

                   .BEGIN

         .BEGIN must be the only directive on a line.

         Begin-End blocks isolate local symbol definitions and labels.
         All local symbols defined inside a block lose definition out-
         side the block.  However, all symbols defined outside a block
         retain  definition  throughout  the  command file.  Note that
         symbols defined outside a block and then  modified  within  a
         block assume and retain the value assigned in the block.

         The block must be terminated with an .END directive.

         5.4.2  .END Directive

         The .END directive marks the end of a Begin-End  block.    If
         IND  encounters  more .END directives than .BEGIN directives,
         command file processing terminates.

         Format:

                   .END

         as the only directive on a line.

         5.4.3  .EXIT Directive

         The .EXIT directive terminates processing of the current com-
         mand  file  or  Begin-End  block  and  returns control to the
         previous level command file or, if the directive is  executed
         within  a Begin-End block, to the line following the .END di-
         rective.  If the directive is encountered at the top indirect
         nesting  level,  IND exits and passes control to the keyboard
         monitor.

         The directive also allows the user to  optionally  specify  a
         value to copy to the special symbol <EXSTAT>.

         Format:

                   .EXIT [value]

                   (brackets not part of syntax)

         where value is an optional numeric expression to be copied to
               _____
         the special symbol <EXSTAT>.

         5.4.4  .GOSUB Directive
         Indirect Command File Processing                   Page 19
         For RT-11 V4.0                             February 2, 1983


         The .GOSUB directive saves the current position in  an  indi-
         rect file and then branches to a label.  The label identifies
         an entry point to a  subroutine  which  is  terminated  by  a
         .RETURN directive.

         When a .GOSUB directive is issued  from  within  a  Begin-End
         block,  IND  saves  the  current block context and then scans
         down the file searching for the first occurrence of  the  su-
         broutine  label.   Note that during the scan, IND ignores any
         intervening .BEGIN or .END directives.  The .RETURN directive
         restores previous block context.  Thus, the subroutine can be
         contained within a Begin-End block.

         The maximum nesting depth for subroutine calls is eight.

         Format:

                   .GOSUB label

         where label is the label that designates the first line of  a
               _____
         subroutine, but without the leading period and trailing colon
         that are required to define the label (thus,  ".EVAL:"  would
         become "EVAL" in this statement).  The label must be preceded
         by at least one space.

         5.4.5  .GOTO Directive

         The .GOTO directive causes a branch from one line in an indi-
         rect  file  to  another.    All  commands  between  the .GOTO
         directive and the specified label are ignored.  Branches  can
         go forward or backward in the file.

         When executing a  .GOTO  directive,  IND  ignores  all  lines
         within a nested Begin-End block.  Thus, the target label of a
         .GOTO directive cannot be contained within  a  block  (unlike
         the  target  label  of  a  .GOSUB directive).   Likewise, the
         target of a .GOTO branch from within a Begin-End  block  must
         be contained in that block; the .GOTO directive cannot branch
         into or out of a block.   Note,  however,  that  IND  permits
         branches  across  nested blocks.  When IND encounters a .GOTO
         directive within a Begin-End block, it scans  for  the  label
         within that block.  Since the label scan starts at the .BEGIN
         directive and continues to the .END directive,  multiply  de-
         fined labels are permitted within a block.

         Format:

                   .GOTO label

         where label is the name of the label, but without the leading
               _____
         period  and trailing colon (thus ".EVAL:" would become "EVAL"
         in this statement).  The label must be preceded by  at  least
         one space.

         5.4.6  .ONERR Directive
         Indirect Command File Processing                   Page 20
         For RT-11 V4.0                             February 2, 1983


         The .ONERR directive allows the user to trap errors in  proc-
         essing and pass control to an error handling routine.  IND is
         equipped to trap the following errors:

                   *    Undefined symbol

                   *    Bad syntax

                   *    Unrecognized command

                   *    String substitution error (any command)

                   *    Symbol type  error  (.IF,  .IFT,  .IFF,  .INC,
                        .DEC)

                   *    Redefinition of a symbol to a  different  type
                        (.ASK,  .ASKN,  .ASKS,  .SETT,  .SETF,  .SETN,
                        .SETS)

                   *    Data file error (.OPEN, .OPENA, .DATA, .CLOSE,
                        between .ENABLE DATA and .DISABLE DATA)

         On encountering one of these errors, if an  .ONERR  directive
         has  been issued, IND will transfer control of indirect proc-
         essing to the label specified in the directive.  This feature
         provides  a  means of gaining control of error conditions and
         terminating command file processing in an orderly manner.

         Note that the .ONERR directive applies only to the error con-
         ditions  listed  above.   RT-11 command syntax errors are not
         processed by .ONERR.

         Format:

                   .ONERR label

         where label is the label to which control is to pass  on  the
               _____
         detection of one of the above error conditions.

         The .ONERR directive must be issued before IND encounters the
         error  condition.  If the directive is executed, i.e., one of
         the above errors is encountered, control passes to  the  spe-
         cified  label.    Subsequent  errors pass control to the same
         label until a new .ONERR directive is executed.  If the label
         specified by the .ONERR directive does not exist and an error
         condition occurs, IND exits to the keyboard monitor.

         5.4.7  .RETURN Directive

         The .RETURN directive signifies the end of a  subroutine  and
         returns  control  to  the most recently saved position in the
         indirect file (the line immediately following the .GOSUB  di-
         rective that initiated the subroutine).

         Format:
         Indirect Command File Processing                   Page 21
         For RT-11 V4.0                             February 2, 1983


                   .RETURN

         5.4.8  .STOP Directive

         The  .STOP  directive  immediately  terminates  command  file
         processing and exits.

         Format:

                   .STOP

         5.4.9  / Logical End-Of-File Directive

         The / directive is logically equivalent to the  .STOP  direc-
         tive.

         Format:

                   /

         as the first non-blank character on a line.

         5.5  Logical Test Directives

         5.5.1  .IF Directive

         The .IF directive compares a numeric or  string  symbol  with
         another  expression  of  the same type to determine if one of
         several possible conditions is true.  If the condition is sa-
         tisfied,  the processor executes the remainder of the command
         line.  When comparing a string symbol with a  string  expres-
         sion,  IND  compares  the  ASCII  values  of  each  operand's
         characters (from left to right) one by one.   An  operand  is
         considered  greater  if  the  first non-equal character has a
         greater value than the corresponding character in  the  other
         operand.   Numeric symbols are compared strictly on the basis
         of magnitude.

         Format:

                   .IF symbol relop expr stmnt

         where:
                   symbol   is a one to six character name of a numer-
                            ic or string symbol

                   relop    is  one  of   the   following   relational
                            operators:

                            EQ or =    - equal to
                            NE or <>   - not equal to
                            GE or >=   - greater than or equal to
                            LE or <=   - less than or equal to
                            GT or >    - greater than
                            LT or <    - less than
         Indirect Command File Processing                   Page 22
         For RT-11 V4.0                             February 2, 1983


                   expr     is an  expression  of  the  same  type  as
                            symbol

                   stmnt    is a  statement  to  be  executed  if  the
                            condition tests true

         5.5.2  .IFDF/.IFNDF Directives

         The .IFDF or .IFNDF directive tests whether a logical, numer-
         ic,  or string symbol has been defined (.IFDF) or not defined
         (.IFNDF).  If the test result is true, the rest of  the  com-
         mand  line  is  processed.   This directive does not test the
         value of the symbol.

         Format:

                   .IFDF symbol stmnt

                   .IFDF symbol stmnt

         where:
                   symbol   is a one to six character symbol  name  to
                            be tested

                   stmnt    is the statement to  be  executed  if  the
                            test result is true

         At least one blank must precede and follow the symbol name.

         5.5.3  .IFT/.IFF Directives

         The .IFT or .IFF directive tests whether a logical symbol  is
         true (.IFT) or false (.IFF).  If the test result is true, IND
         processes the remainder of the directive line.  The processor
         exits  with a fatal error if the symbol being tested was pre-
         viously defined as a numeric or string symbol.

         Format:

                   .IFT symbol stmnt

                   .IFF symbol stmnt

         where:
                   symbol   is a one to six character  logical  symbol
                            name

                   stmnt    is the statement to execute  if  the  test
                            result is true

         At least one blank must precede and follow the symbol name.

         5.5.4  .TEST Directive

         The .TEST directive moves the length of a string symbol  into
         the special numeric symbol <STRLEN>.  It also tests the char-
         Indirect Command File Processing                   Page 23
         For RT-11 V4.0                             February 2, 1983


         acters of the string and sets  the  special  logical  symbols
         <ALPHAN> and <RAD50> as appropriate.

         Format:

                   .TEST symbol

         where symbol is the string symbol to be tested.
               ______

         5.5.5  Compound Tests

         Logical tests may be combined by using the .AND and  .OR  di-
         rectives.    An  implied .AND directive is effected when more
         than one test occurs on the same line without being separated
         by an .AND or .OR directive.  The compound operators .AND and
         .OR must be preceded and followed by at least one blank.

         The .AND directive takes precedence over the .OR directive as
         shown in the following example:

                   .IFT A .OR .IFT B .AND .IFT C .GOTO D

         IND reads this line as:

                   .IFT A .OR (.IFT B .AND .IFT C) .GOTO D

         5.6  File Access Directives

         5.6.1  .CHAIN Directive

         The .CHAIN directive closes the current indirect file,  masks
         all  local  symbols,  and continues processing using commands
         fetched from another file.   However,  the  .CHAIN  directive
         does  not  close  data  files  or change the file indirection
         level.

         Format:

                   .CHAIN filnam [/switch]

                   (brackets not part of syntax)

         where:
                   filnam   is the name of the file that contains  the
                            new commands

                   switch   is one of the valid switches described  in
                            Section 3.1.

         5.6.2  .CLOSE Directive

         The .CLOSE directive closes the secondary file opened  by  an
         .OPEN directive.

         Format:
         Indirect Command File Processing                   Page 24
         For RT-11 V4.0                             February 2, 1983


                   .CLOSE [#n]

                   (brackets not part of syntax)

         where #n is an optional file number in the range  #0-#3,  in-
               __
         clusive.    If  the  file  number  is  left  out,  the .CLOSE
         directive closes file #0 only.  Numeric symbols may  be  sub-
         stituted for n by enclosing the symbol name in apostrophes.
                      _

         5.6.3  .DATA Directive

         The .DATA directive specifies text that is to be output to  a
         secondary file previously opened by an .OPEN directive.

         Format:

                   .DATA [#n] text

                   (brackets not part of syntax)

         where:
                   #n       is an optional file number  in  the  range
                            #0-#3,  inclusive.   Default is zero.  Nu-
                            meric  symbols  may  be   substituted   by
                            enclosing   the   symbol  name  in  single
                            quotes.

                   text     is the text to be output to the  secondary
                            file

         The command line cannot exceed eighty characters.  (The  spe-
         cified  text  cannot  continue  onto  the  next  line.)  If a
         secondary file is not open, an error  condition  exists;  IND
         issues an error message and begins error processing.

         5.6.4  .OPEN Directive

         The .OPEN directive opens a specified secondary  file  as  an
         output file.

         Format:

                   .OPEN [#n] filnam

                   (brackets not part of syntax)

         where:
                   #n       is an optional file number  in  the  range
                            #0-#3, inclusive.  Default is #0.  Numeric
                            symbols may be substituted for  n  by  en-
                                                            _
                            closing the symbol name in single quotes.

                   filnam   is the name of  the  file  to  be  opened.
                            Default file type is .DAT.
         Indirect Command File Processing                   Page 25
         For RT-11 V4.0                             February 2, 1983


         5.6.5  .OPENA Directive

         The .OPENA directive opens a secondary file and  appends  all
         subsequent data to the file.

         Format:

                   .OPENA [#n] filnam

                   (brackets not part of syntax)

         where:
                   #n       is an optional file number  in  the  range
                            #0-#3, inclusive.  The Default is #0.  Nu-
                            meric  symbols  may  be   substituted   by
                            enclosing   the   symbol  name  in  single
                            quotes.

                   filnam   is the name of the file to be opened.  De-
                            fault file type is .DAT.

         Once the file has been opened, data output to the  file  will
         be appended after the last byte of the file.

         5.6.6  .OPENR Directive

         The .OPENR directive opens a file for input, after which  the
         file may be read via a .READ directive.

         Format:

                   .OPENR [#n] filnam

                   (brackets not part of syntax)

         where:
                   #n       is an optional file number  in  the  range
                            #0-#3,  inclusive.   Default is zero.  Nu-
                            meric  symbols  may  be   substituted   by
                            enclosing   the   symbol  name  in  single
                            quotes.

                   filnam   is the name of the file opened

         To read from a data file, the file must first be opened  suc-
         cessfully  using  the  .OPENR directive.  Records may then be
         read using the .READ directive until either <EOF> is true  or
         <FILERR>  returns an error.  When processing is complete, the
         file should be closed with a .CLOSE directive.

         5.6.7  .READ Directive

         The .READ directive is used to read data from a file that has
         been opened for input by an .OPENR directive.
         Indirect Command File Processing                   Page 26
         For RT-11 V4.0                             February 2, 1983


         Format:

                   .READ [#n] symbol

                   (brackets not part of syntax)

         where:
                   #n       is an optional file number  in  the  range
                            #0-#3,  inclusive.   Default is zero.  Nu-
                            meric  symbols  may  be   substituted   by
                            enclosing   the   symbol  name  in  single
                            quotes.

                   symbol   is the name of the symbol to read the data
                            into

         The .READ directive causes IND to  load  all  the  characters
         from  the  current  file  pointer to the next occurrence of a
         carriage return/line feed combination into the  symbol.    If
         the  record  is  more  than  eighty characters long, an error
         occurs.  If an error occurs while reading a file,  the  vari-
         able will be unchanged from its previous state.

         The <EOF> special symbol is only set by the .READ  directive.
         This  means  that  its  state  is  indeterminate following an
         .OPENR directive until a .READ directive is encountered.   If
         an end-of file occurs, both <EOF> and <FILERR> will be set to
         reflect it.

         5.6.8  .TESTFILE Directive

         The .TESTFILE directive is used to determine  if  a  specific
         file exists, or to determine translations of assigned logical
         device names.

         Format:

                   .TESTFILE filspc

         where filspc is the file specification to be tested.  The di-
               ______
         rective  causes <FILSPC> and <FILERR> to be set in accordance
         with the file's true name and existence.  If no  filename  is
         included  in  the file specification, only device translation
         will be performed.  If a filename is included, the  specified
         file will be looked up and the fully qualified name placed in
         <FILSPC>.

         5.7  Enabling and Disabling Operating Modes

         The .ENABLE and .DISABLE directives are used  to  enable  and
         disable, respectively, one of the six operating modes of IND.

         Format:

                   .ENABLE LOWERCASE
         Indirect Command File Processing                   Page 27
         For RT-11 V4.0                             February 2, 1983


                   .ENABLE DATA [#n]
                   (brackets not part of syntax)

                   .ENABLE GLOBAL

                   .ENABLE SUBSTITUTION

                   .ENABLE ESCAPE

                   .ENABLE QUIET

                   .DISABLE LOWERCASE

                   .DISABLE DATA [#n]
                   (brackets not part of syntax)

                   .DISABLE GLOBAL

                   .DISABLE SUBSTITUTION

                   .DISABLE ESCAPE

                   .DISABLE QUIET

         5.7.1  LOWERCASE Mode

         The LOWERCASE mode  controls  the  conversion  of  lower-case
         ASCII alphabetic characters to upper-case.  When LOWERCASE is
         enabled by an  .ENABLE  LOWERCASE  directive,  no  conversion
         takes place.  When LOWERCASE is disabled by a .DISABLE LOWER-
         CASE directive, all lower-case alpha characters are converted
         to upper-case.

         The representation of characters is significant when  compar-
         ing  strings,  since  the .IF directive treats lower-case and
         upper-case characters as distinct.  Also, note that if LOWER-
         CASE is disabled and the response to a query is in lower-case
         letters, the special logical symbol <ALPHAN> is set to false.

         This mode is enabled on entry to indirect file processing.

         5.7.2  DATA Mode

         In DATA mode, IND outputs the lines that follow the directive
         line  .ENABLE DATA to a secondary file.  The .ENABLE DATA di-
         rective accepts an optional file number in the same manner as
         the .OPEN directive.

         Data is output to the file until a .DISABLE DATA directive is
         encountered.    These  two directives allow multiple lines of
         data to be output to secondary files (as opposed to the .DATA
         directive, which sends one line at a time).

         The DATA mode is disabled on entry to indirect file  process-
         ing.
         Indirect Command File Processing                   Page 28
         For RT-11 V4.0                             February 2, 1983


         5.7.3  GLOBAL Mode

         The GLOBAL mode, when enabled, causes  IND  to  treat  symbol
         names  that  begin  with  a  dollar sign ($) as global to all
         levels of indirect files;  once such a symbol  has  been  de-
         fined,  all  levels of processing will recognize and are able
         to alter it.  Symbols that do not begin with  a  dollar  sign
         are always recognized only by the level that defines them.

         The GLOBAL mode is disabled  on  entry  to  indirect  command
         processing.

         5.7.4  SUBSTITUTION Mode

         When enabled, SUBSTITUTION mode tells IND to  substitute  the
         string  equivalent  of  any  symbol enclosed in single quotes
         ('SYMBOL').  When SUBSTITUTION is enabled, IND performs  sub-
         stitutions   on  each  line  before  scanning  the  line  for
         directives and RT-11 commands.

         SUBSTITUTION mode is disabled on entry to  indirect  process-
         ing.

         5.7.5  ESCAPE Mode

         When this mode is enabled, IND permits  the  response  to  an
         .ASK, .ASKN, or .ASKS directive to be a single escape charac-
         ter.  A question answered with a single escape character sets
         the  special  logical  symbol  <ESCAPE>  to true.  The escape
         character must be used only as an immediate terminator to the
         question;  if  one  or more characters precede the escape, an
         error condition exists, and the query will be repeated.  Note
         that  an  escape  response to an .ASK directive also sets the
         specified symbol to true.

         ESCAPE mode is disabled on entry to indirect file processing.

         5.7.6  QUIET Mode

         The QUIET mode is enabled if the RT-11 commands in  the  com-
         mand file are not to be echoed on the terminal.  If this mode
         is disabled, RT-11 commands are echoed  on  the  terminal  as
         they are encountered.

         QUIET mode is disabled on entry to indirect file processing.
         Indirect Command File Processing                   Page 29
         For RT-11 V4.0                             February 2, 1983


         Appendix A:  Alphabetic Directive Listing

         Directive   Section   Function
         _________   _______   ________

         .ASK        5.2.1     Define a logical  symbol  and  set  the
                               symbol value based on terminal input.

         .ASKN       5.2.2     Define a numeric  symbol  and  set  the
                               symbol value based on terminal input.

         .ASKS       5.2.3     Define a  string  symbol  and  set  the
                               symbol value based on terminal input.

         .BEGIN      5.4.1     Marks  the  beginning  of  a  Begin-End
                               block.

         .CHAIN      5.6.1     Close current indirect  file  and  con-
                               tinue  processing  using  commands from
                               another file.

         .CLOSE      5.6.2     Close a secondary data file.

         .DATA       5.6.3     Specify a single line of data to output
                               to secondary data file.

         .DEC        5.3.1     Subtract one from a numeric symbol.

         .DISABLE    5.7       Disable an operating mode.

         .ENABLE     5.7       Enable an operating mode.

         .END        5.4.2     Marks the end of a Begin-End block.

         .ERASE      5.3.2     Delete all local or global  symbol  de-
                               finitions from the symbol table.

         .EXIT       5.4.3     Terminate  processing   of   either   a
                               Begin-End  block or the current command
                               file, returns control to  the  previous
                               level,   and  optionally  sets  special
                               symbol <EXSTAT> value.

         .GOSUB      5.4.4     Branch to a label identifying a subrou-
                               tine within the command file.

         .GOTO       5.4.5     Branch to a label  within  the  command
                               file.

         .IF         5.5.1     Ask whether a symbol satisfies  one  of
                               several  condition and execute a state-
                               ment if the answer is yes.

         .IFDF       5.5.2     Ask whether a symbol has  been  defined
                               and  execute  a statement if the answer
                               is yes.
         Indirect Command File Processing                   Page 30
         For RT-11 V4.0                             February 2, 1983


         .IFF        5.5.3     Ask whether  a  logical  symbol  has  a
                               false  value and execute a statement if
                               the answer is yes.

         .IFNDF      5.5.2     Ask whether a symbol has not  been  de-
                               fined  and  execute  a statement if the
                               answer is yes.

         .IFT        5.5.3     Ask whether a logical symbol has a true
                               value  and  execute  a statement if the
                               answer is yes.

         .INC        5.3.1     Add one to a numeric symbol.

         .label:     5.1       Define a label.

         .ONERR      5.4.6     Identify a label in the command file to
                               which  to  branch  in  the  event of an
                               error.

         .OPEN       5.6.4     Create and open an output data file.

         .OPENA      5.7.5     Open an existing file and append subse-
                               quent data.

         .OPENR      5.6.6     Open an existing file for input.

         .PARSE      5.3.3     Parse a string into substrings.

         .READ       5.6.7     Read a record from an input file.

         .RETURN     5.4.7     Exit a subroutine and return control to
                               the line immediately following the last
                               encountered .GOSUB directive.

         .SETF       5.3.4     Define a logical symbol and assign  the
                               symbol a false value.

         .SETN       5.3.5     Define a numeric symbol and assign  the
                               symbol a specified numeric value.

         .SETS       5.3.6     Define a string symbol and  assign  the
                               symbol a specified string value.

         .SETT       5.3.4     Define a logical symbol and assign  the
                               symbol a true value.

         .STOP       5.4.8     Immediately  terminate   command   file
                               processing.

         .TEST       5.5.4     Move the length of a string  symbol  to
                               the   special   symbol   <STRLEN>,  set
                               <ALPHAN> and <RAD50> as appropriate.

         .TESTFILE   5.6.8     Determine if a file exists or determine
                               translations of assigned logical device
         Indirect Command File Processing                   Page 31
         For RT-11 V4.0                             February 2, 1983


                               names.

         /           5.4.9     Equivalent to .STOP