plgc (1) --- interface to Primos PL/I subset G compiler  08/27/84


          | _U_s_a_g_e

                 plgc {-<option>[<level>]} <input file>
                          [-b [<binary file>]]
                          [-l [<listing file>]]
                          [-z <PL1G option>]
                    <option> ::= c | d | e | f | h | k | m | n |
                                 o | p | q | r | s | v | w | x


            _D_e_s_c_r_i_p_t_i_o_n

                 'Plgc'  serves as the Subsystem interface to the Primos PL/I
                 subset  G  compiler  (PL1G).    It   examines   its   option
                 specifications  and  checks  them  for consistency, provides
                 Subsystem-compatible default file names for the listing  and
                 binary files as needed, and then produces a Primos PL1G com-
                 mand and causes it to be executed.

                 OOOppptttiiiooonnnsss

                 The  general  structure of an 'plgc' option is a single let-
                 ter, possibly followed by a "level  number"  indicating  the
                 extent to which an option should be employed.  The following
                 list  outlines the options and the meanings of their various
                 levels.  The first line of  each  description  contains  the
                 option  letter  followed  by  its  default level enclosed in
                 parentheses, the  range  of  available  levels  enclosed  in
                 square  brackets,  and  a  brief description of the option's
                 purpose.  In all cases, when an option is specified  without
                 a level number, the maximum allowable value is assumed.


                 -c(0) [0..1] - Case.

                      Level 0 forces case to be insignificant in identifiers.
                      Upper case identifiers are considered the same as lower
                      case identifiers.

                      Level  1  cause  case  to  significant  in identifiers.
                      Upper case identifiers are  considered  different  from
                      lower case identifiers.

                 -d(0) [0..2] - Debugging control.

                      Level  0  prevents all debugging information from being
                      included in the generated code.  A program so  compiled
                      may not be used with the source level debugger.

                      Level  1  allows  limited  debugging  information to be
                      included in the generated code, but does not  interfere
                      with optimization.

                      Level  2  causes  complete  debugging information to be
                      included   in   the   generated   code   and   inhibits
                      optimization.   (Cannot be used when the "-o" option is


            plgc (1)                      - 1 -                      plgc (1)




            plgc (1) --- interface to Primos PL/I subset G compiler  08/27/84


                      specified with a level greater than zero.)

                 -e(1) [0..1] - Error listing on terminal.

                      Level 0 inhibits the printing of compilation errors  on
                      the user's terminal.

                      Level  1 causes compilation errors to be printed on the
                      terminal.

                 -f(2) [0..3] - Symbol table map and offset map control.

                      Level 0 inhibits the  generation  of  either  a  symbol
                      table  map  or  a  storage offset map.  (Cannot be used
                      when the "-x" option is specified with a level  greater
                      than zero.)

                      Level  1  causes  the  generation  of a map listing the
                      storage offset of  each  program  variable,  but  still
                      inhibits the generation of a a symbol table map.  (Can-
                      not  be  used  when the "-x" option is specified with a
                      level greater than zero.)

                      Level 2 causes the generation of a map listing the sym-
                      bol names appearing in the program,  but  inhibits  the
                      generation of a storage offset map.

                      Level  3 causes the generation of both the symbol table
                      and storage offset maps.

                 -h(0) [0..1] - Huge (multi-segment) arrays.

                      Level 0 insures that dummy arrays and array  parameters
                      will not be treated as multi-segment arrays.

                      Level  1  causes  references  to dummy arrays and array
                      parameters to generate code that will work even if  the
                      arrays  are  larger  than  one  segment  (64K words) in
                      length.

                 -k(0) [0..1] - Compilation statistics.

                      Level 0 inhibits the display of compilation  statistics
                      on the terminal.

                      Level 1 causes the display of compilation statistics on
                      the terminal.

                 -m(2) [2..3] - Addressing mode.

                      Level  2  implies 64V addressing mode.  At present this
                      is the only addressing mode fully supported  under  the
                      Subsystem.

                      Level  3  implies  32I  addressing  mode.  Code in this
                      addressing mode will not execute on a Prime 400.


            plgc (1)                      - 2 -                      plgc (1)




            plgc (1) --- interface to Primos PL/I subset G compiler  08/27/84


                 -n(1) [0..1] - Nesting level indicator.

                      Level 0 inhibits the printing of the nesting  level  of
                      each statement on the listing.

                      Level  1  causes  the  printing of the nesting level of
                      each statement.

                 -o(1) [0..1] - Optimization control.

                      Level 0 turns off all optimizations.

                      Level 1 turns on optimizations.  This option cannot  be
                      used with full debugging (-d2).

                 -p(0) [0..1] - Quick call of internal subroutines.

                      Level  0  causes  all internal subroutines to be called
                      with the normal procedure call (PCL) mechanism.

                      Level 1 causes internal subroutines to be  "quick  cal-
                      led" (shortcalled) whenever possible.  This option can-
                      not be used with full debugging (-d2).

                 -q(1) [0..1] - Suppress warning messages.

                      Level  0  inhibits the display of compiler warning mes-
                      sages.

                      Level 1 allows the display  of  compiler  warning  mes-
                      sages.

                 -r(0) [0..1] - Range checking.

                      Level  0  inhibits  run-time checking of subscripts and
                      substrings.

                      Level 1 causes the compiler to insert code for the run-
                      time checking of subscripts and substrings.

                 -s(1) [0..1] - Constant copying for subroutine calls.

                      Level 0 inhibits the copying  of  constants  into  tem-
                      porary variables for passing as subroutine parameters.

                      Level 1 causes the compiler to copy constants into tem-
                      porary variables before calling subroutines.

                 -v(1) [0..2] - Listing verbosity.

                      Level 0 prevents the listing of source code, but allows
                      the  listing  of  error  messages  and  statements that
                      caused them.

                      Level 1 generates a full source code listing.



            plgc (1)                      - 3 -                      plgc (1)




            plgc (1) --- interface to Primos PL/I subset G compiler  08/27/84


                      Level 2 generates a full source  code  listing  plus  a
                      representation  of  the machine code generated for each
                      statement.

                 -w(0) [0..1] - Generate floating round instructions.

                      Level 0 does not generate floating round (FRN) instruc-
                      tions.

                      Level 1 cause a floating round (FRN) instruction to  be
                      generated before every floating store (FST) instruction
                      in the code produced by the PL1G compiler.  This option
                      improves  the  accuracy  of  single  precision floating
                      point calculations at some slight run-time  performance
                      expense.

                 -x(1) [0..1] - Cross-reference listing control.

                      Level 0 inhibits the generation of a cross-reference.

                      Level  1  causes  the  compiler  to  generate  a cross-
                      reference listing.   (Cannot  be  used  when  the  "-f"
                      option is specified with a level less than two.)

                 In addition to the options above, the "-z" option allows the
                 explicit passing of a string verbatim into the command line.

                 FFFiiillleee CCCooonnntttrrrooolll

                 The  "-b"  option  is used to select the name of the file to
                 receive the binary object code output of the compiler.  If a
                 file name follows the option, then that  file  receives  the
                 object  code.  (Note that if "/dev/null" is specified as the
                 file name, no object code will be produced.)  If the  option
                 is  not  specified,  or  no  file name follows it, a default
                 filename is constructed from the input filename by  changing
                 its  suffix  to ".b".  For example, if the input filename is
                 "prog.plg", the binary file will be "prog.b"; if  the  input
                 filename is "foo", the binary file will be "foo.b".

                 The  "-l"  option  is used to select the name of the file to
                 receive the listing generated by the compiler.   If  a  file
                 name  follows  the  option,  then  that  file  receives  the
                 listing.  The file name "/dev/null" may be used  to  inhibit
                 the  listing; "/dev/tty" to cause it to appear on the user's
                 terminal; "/dev/lps" to cause it to be spooled to  the  line
                 printer.   If  the  "-l"  option is specified without a file
                 name following it, a default filename  is  constructed  from
                 the  input  filename  by  changing  its suffix to ".l".  For
                 example, if the input filename is "gonzo.plg",  the  listing
                 file  will be "gonzo.l"; if the input filename is "bar", the
                 listing file will be "bar.l".  If the  "-l"  option  is  not
                 used, no listing is produced.

                 The  input  filename  may  be  either a disk file name (con-
                 ventionally ending in  ".plg"  or  ".pl1g")  or  the  device


            plgc (1)                      - 4 -                      plgc (1)




            plgc (1) --- interface to Primos PL/I subset G compiler  08/27/84


                 "/dev/tty", in which case input to the compiler is read from
                 the user's terminal.

                 In  summary,  then, the default command line for compiling a
                 file named "file.plg" is

                      plgc -c0d0e1f2h0k0m2n1o1p0q1r0s1v1w0x1 _
                           file.plg  -b file.b  -l /dev/null

                 which corresponds to the PL1G command

                      pl1g -i *>file.plg -b *>file.b -l no



            _E_x_a_m_p_l_e_s

                 plgc file.plg
                 plgc -kf dmach.plg
                 plgc -x dmach.plg -b b_dmach -l l_dmach
                 plgc -m3 i_mode_prog.plg -z"-newopt"


            _M_e_s_s_a_g_e_s

                 "Usage:  plgc ..."  for invalid option syntax.
                 "level  numbers   for   -<option>   are   <lower bound>   to
                      <upper bound>"  if  an  out-of-range  level  number  is
                      specified.
                 "missing input file name" if  no  input  filename  could  be
                      found.
                 "<name>:   unreasonable  input  file name" if an attempt was
                      made to read from the null device or the  line  printer
                      spooler.
                 "<name>:   unreasonable  binary file name" if an attempt was
                      made to produce object code on  the  terminal  or  line
                      printer spooler.
                 "inconsistency  in  internal  tables"  if the tables used to
                      process the options are incorrectly constructed.   This
                      message  indicates  a serious error in the operation of
                      'plgc'  that  should  be  reported   to   your   system
                      administrator.

                 Numerous other self-explanatory messages may be generated to
                 diagnose conflicts between selected options.


            _B_u_g_s

                 'Plgc' pays no attention to standard ports.


            _S_e_e _A_l_s_o

          |      ld (1), plgcl (1), geta$plg (2), init$plg (2), bind (3)



            plgc (1)                      - 5 -                      plgc (1)