Google
 

Trailing-Edge - PDP-10 Archives - bb-kl11m-bm - t20src/build.mem
There are 36 other files named build.mem in the archive. Click here to see a list.




















                                  TOPS-20

                                Release 7.0

                Monitor Building Procedures and Information










                      Revision Date: January 16, 1990




     COPYRIGHT (c) DIGITAL EQUIPMENT CORPORATION 1976, 1989.
     ALL RIGHTS RESERVED.

     THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND  COPIED
     ONLY  IN  ACCORDANCE  WITH  THE  TERMS  OF  SUCH  LICENSE AND WITH THE
     INCLUSION OF THE ABOVE COPYRIGHT NOTICE.  THIS SOFTWARE OR  ANY  OTHER
     COPIES  THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY
     OTHER PERSON.  NO TITLE TO AND OWNERSHIP OF  THE  SOFTWARE  IS  HEREBY
     TRANSFERRED.

     THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE  WITHOUT  NOTICE
     AND  SHOULD  NOT  BE  CONSTRUED  AS  A COMMITMENT BY DIGITAL EQUIPMENT
     CORPORATION.

     DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR  RELIABILITY  OF  ITS
     SOFTWARE ON EQUIPMENT THAT IS NOT SUPPLIED BY DIGITAL.
TOPS-20 Monitor Building Procedures and Information                  Page 2


                             TABLE OF CONTENTS


        1.0     Introduction . . . . . . . . . . . . . . . . . . . . 3
        2.0     Monitor Selection and Building Procedures  . . . . . 4
        2.1       How to Select a Monitor Configuration  . . . . . . 4
        2.2       How to Build a Standard Monitor Configuration  . . 5
        2.3       Internals of LN2070.CTL and T20-AN70.CTL . . . . . 7
        3.0     Monitor Configuration Parameters . . . . . . . . .  11
        3.1       Parameters Controlling Software Resources  . . .  11
        3.2       Parameters Controlling System Defaults . . . . .  13
        3.3       Parameters for Hardware Support  . . . . . . . .  15
        4.0     Installation-Specific Terminal Definitions . . . .  18
TOPS-20 Monitor Building Procedures and Information             Page 3


     1.0  Introduction

          This document provides complete information  on  configuring  and
     building the TOPS-20 monitor.  Multiple configurations are provided so
     as to minimize the amount of resident storage  used  while  supporting
     all  of  the  available  peripheral  devices.   The  "build" procedure
     produces a core-image file of the monitor from the various relocatable
     files and the one parameter-dependent source file.

          Generally, an installation  will  be  able  to  run  one  of  the
     standard  monitor configurations supplied.  Section 2 of this document
     tells how to select the appropriate monitor configuration and  how  to
     run the build procedure.

          Some installations  may  wish  to  use  a  set  of  configuration
     parameters  different  from  those  of  the  standard  set.  Section 3
     describes the function  of  each  parameter  and  its  effect  on  the
     resultant configuration.

          Section 4 describes how  to  add  installation-specific  terminal
     definitions.
TOPS-20 Monitor Building Procedures and Information             Page 4


     2.0  Monitor Selection and Building Procedures

          NOTE:  This section is intended for anyone who needs to  build  a
     monitor,  and  it  requires  a  minimum  level of familiarity with the
     structure or operation of the system.  The knowledge which is required
     is:

     1.  How to LOGIN and use basic EXEC commands.

     2.  How to use the magtape file restore program (DUMPER).

     3.  How to bring up the system with an existing monitor.




     2.1  How to Select a Monitor Configuration

          There are five standard monitor configurations.  Each of them are
     configured for general timesharing and batch usage.  The first two are
     intended for customers without a TCP/IP (Arpanet) licence.  The second
     two  are  intended  for  sites  with  a  TCP/IP  license but without a
     DECnet-20 license.  The last one is intended for sites with TCP/IP and
     DECnet-20 licenses.

          You should select the  proper  monitor  based  on  your  hardware
     configuration.   You will want the smallest monitor which supports all
     of the hardware you have and which handles the  number  of  users  you
     wish to allow.

     1.  2060-MONBIG a medium sized monitor, includes  DECnet-20,  excludes
         TCP/IP.

          *  100 Jobs
          *  30 PTYs
          *  64 LAT terminal lines
          *  96 RSX20F terminal lines
          *  10000 pages swapping space


     2.  2060-MONMAX:   the  maximum  sized  monitor,  includes  DECnet-20,
         excludes TCP/IP.

          *  128 Jobs
          *  50 PTYs
          *  128 LAT terminal lines
          *  128 RSX20F terminal lines
          *  15000 pages swapping space
TOPS-20 Monitor Building Procedures and Information             Page 5


     3.  AN-MONBIG:  a medium  sized  monitor,  includes  TCP/IP,  excludes
         DECnet-20.

          *  100 Jobs
          *  30 PTYs
          *  50 LAT terminal lines
          *  128 RSX20F terminal lines
          *  40 TVT terminal lines
          *  10000 pages swapping space


     4.  AN-MONMAX:  a maximum sized  monitor,  includes  TCP/IP,  excludes
         DECnet-20.

          *  128 Jobs
          *  50 PTYs
          *  50 LAT terminal lines
          *  128 RSX20F terminal lines
          *  40 TVT terminal lines
          *  20000 pages swapping space


     5.  AN-MONDCN:   a  maximum  sized  monitor,   includes   TCP/IP   and
         DECnet-20.

          *  100 Jobs
          *  50 PTYs
          *  50 LAT terminal lines
          *  128 RSX20F terminal lines
          *  40 TVT terminal lines
          *  40 CTERM terminal lines
          *  20000 pages swapping space





     2.2  How to Build a Standard Monitor Configuration

          At this point, you will have selected one of the standard monitor
     configurations  described above (or have constructed you own parameter
     file as described in Section 3).  The following step-by-step procedure
     produces  a  monitor  configured  according  to  the parameters in the
     corresponding parameter file.

     1.  Login and connect to a directory  containing  a  complete  set  of
         monitor files.  If the monitor files have not been loaded onto the
         disk, load them from your distribution tape using DUMPER (document
         TOPS20.DOC).
TOPS-20 Monitor Building Procedures and Information             Page 6


     2.  The CTL files require the following logical names be set up.

          *  R:  should point to the directory where REL files  are  to  be
             placed.
          *  MON:  should point to the directory for  the  monitor  sources
             and support files.
          *  SYS:  should point to  the  directory  containing  the  latest
             MONSYM.UNV, MONSYM.REL, MACSYM.UNV, and MACREL.REL.

         These logical names are set up in the CTL by doing a explicit TAKE
         of  BATCH.CMD in the connected directory.  Typically, SYS:  should
         be defined as DSK:,SYS:  and the other the logical  names  may  be
         defined as DSK:.

     3.  If you are building a monitor without TCP/IP (Arpanet),  copy  the
         appropriate parameter file to "PARAM0.MAC".  If you are building a
         monitor with  TCP/IP,  copy  the  appropriate  parameter  file  to
         "PARAN.MAC".  The parameter files for the various monitors are:

          *  For 2060-MONBIG copy P70BIG.MAC to PARAM0.MAC
          *  For 2060-MONMAX copy P70MAX.MAC to PARAM0.MAC
          *  For AN-MONBIG copy ANPBIG.MAC to PARAN.MAC
          *  For AN-MONMAX copy ANPMAX.MAC to PARAN.MAC
          *  For AN-MONDCN copy ANPDCN.MAC to PARAN.MAC


     4.  If you are building a non-TCP/IP  monitor,  copy  the  appropriate
         monitor  name  file to "NAMAM0.MAC".  If you are building a TCP/IP
         monitor, copy the appropriate name file to "NAMAN.MAC".  The  name
         files for the various monitors are:

          *  For 2060-MONBIG copy N70BIG.MAC to NAMAM0.MAC
          *  For 2060-MONMAX copy N70MAX.MAC to NAMAM0.MAC
          *  For AN-MONBIG copy ANNBIG.MAC to NAMAN.MAC
          *  For AN-MONMAX copy ANNMAX.MAC to NAMAN.MAC
          *  For AN-MONDCN copy ANNDCN.MAC to NAMAN.MAC


     5.  Submit the appropriate batch file for the type of monitor you  are
         building:  LN2070.CTL for a non-TCP/IP monitor or T20-AN70.CTL for
         a monitor with TCP/IP.  To build the single monitor, the  switches
         /TAG:SINGLE and /TIME:60 should be used.

          *  For 2060-MONBIG submit LN2070 /TAG:SINGLE /TIME:60
          *  For 2060-MONMAX submit LN2070 /TAG:SINGLE /TIME:60
          *  For AN-MONBIG submit T20-AN70 /TAG:SINGLE /TIME:60
          *  For AN-MONMAX submit T20-AN70 /TAG:SINGLE /TIME:60
          *  For AN-MONDCN submit T20-AN70 /TAG:SINGLE /TIME:60

         The resultant monitor will be called  MONITR.EXE  (LN2070.CTL)  or
         AMONITR.EXE (T20-AN70.CTL).
TOPS-20 Monitor Building Procedures and Information             Page 7


     2.3  Internals of LN2070.CTL and T20-AN70.CTL

          This section is intended to document the  internals  of  the  CTL
     files that build the TOPS-20 monitor.

          The internals of the CTL files do not need to  be  understood  to
     build monitors.

          The monitor CTL files may be started beginning at several tags.

     1.  TRAP::  will execute a command to cause all file  openings  to  be
         displayed.  It then goes to tag BEGIN.

     2.  FORCE::  will execute a command  to  force  recompilation  of  all
         sources.

     3.  CREF::  will execute a command  to  force  CREF  listings  of  all
         sources.  It then goes to tag BEGIN.

     4.  BEGIN::  builds all standard monitors  from  sources  (2060-MONBIG
         and 2060-MONMAX for LN2070.CTL, or AN-MONBIG, AN-MONMAX, AN-MONDCN
         from T20-AN70.CTL).

     5.  ALL::  (LN2070 only) builds all standard monitors  using  existing
         REL libraries LN2070.REL.

     6.  MONDEV::  builds 2060-MONMAX  monitor  (LN2070.CTL)  or  AN-MONDCN
         monitor (T20-AN70.CTL) from sources.

     7.  SINGLE::   builds  MONITR.EXE  from  PARAM0.MAC,  NAMAM0.MAC,  and
         LN2070.REL  (LN2070.CTL)  or  builds  AMONITR.EXE  from PARAN.MAC,
         NAMAN.MAC, and T20AN.REL (T20-AN70.CTL).


          If the sources are to be complied,  the  file  MON:ASEMBL.CMD  is
     TAKEn.   This  file  will  compile all of the source modules needed to
     create LN2070.REL or T20AN.REL.

          After the source files are compiled, the REL files  are  combined
     into  the REL library by MON:APPEND.CMD (LN2070.REL) or MON:APPARP.CMD
     (T20AN.REL).

          Building each monitor consists of the following steps.

     1.  The source file for the name of the monitor,  plus  MON:VEDIT.MAC,
         plus MON:VERSIO.MAC are compiled together to produce R:VERSIO.REL.

          *  For LN2070 SINGLE monitors, NAMAM0.MAC is used.
          *  For 2060-MONBIG monitor, N70BIG.MAC is used.
          *  For 2060-MONMAX monitor, N70MAX.MAC is used.
          *  For T20-AN70 SINGLE monitors, NAMAN.MAC is used.
          *  For AN-MONBIG monitor, ANNBIG.MAC is used.
          *  For AN-MONMAX monitor, ANNMAX.MAC is used.
          *  For AN-MONDCN monitor, ANNDCN.MAC is used.
TOPS-20 Monitor Building Procedures and Information             Page 8


     2.  The source file for the PSECT origins for this monitor,  plus  the
         parameters source file for this monitor, plus MON:PARAMS.MAC, plus
         MON:STG.MAC is compiled together to create R:STG.REL  (LN2070)  or
         R:STGAN.REL (T20-AN70).

          *  For LN2070 SINGLE monitors, PARLM0.MAC+PARAM0.MAC is used.
          *  For 2060-MONBIG monitor, PARLBG.MAC+P70BIG.MAC is used.
          *  For 2060-MONMAX monitor, PARLMX.MAC+P70MAX.MAC is used.
          *  For T20-AN70 SINGLE monitors, PARARP.MAC+PARAN.MAC is used.
          *  For AN-MONBIG monitor, PARBIG.MAC+ANPBIG.MAC is used.
          *  For AN-MONMAX monitor, PARMAX.MAC+ANPMAX.MAC is used.
          *  For AN-MONDCN monitor, PARDCN.MAC+ANPDCN.MAC is used.

         The PSECT origin file (the first file  mentioned  above)  contains
         the  origins  for the PSVAR, JSVAR, NPVAR, ERVAR, ENVAR, and EPVAR
         PSECTs.

     At this point, all of the REL files needed to build the  monitor  have
     been created.

     3.  LINK is run to begin the loading process.  The CCL  file  used  to
         set  PSECT  origins for this monitor is given to LINK first.  This
         file just contains switches to LINK to set PSECT  origins  and  is
         unique to each standard monitor.

          *  For LN2070 SINGLE monitors, LNKLM0.CCL is used.
          *  For 2060-MONBIG monitor, LNKLBG.CCL is used.
          *  For 2060-MONMAX monitor, LNKLMX.CCL is used.
          *  For T20-AN70 SINGLE monitors, LNKARP.CCL is used.
          *  For AN-MONBIG monitor, LNKBIG.CCL is used.
          *  For AN-MONMAX monitor, LNKMAX.CCL is used.
          *  For AN-MONDCN monitor, LNKDCN.CCL is used.

         The CCL file contains the PSECT  origins  for  the  RSCOD,  INCOD,
         RSDAT,  PPVAR,  RSVAR,  NRVAR,  NRCOD, BGSTR, BGPTR, SYPSX, ERCOD,
         XRCOD, XNCOD, ENCOD, and POSTCD PSECTs.

     4.  LNKINI.CCL (LN2070) or LNKANI.CCL  (T20-AN70)  is  given  to  LINK
         next.   This  file  also  sets  various  LINK switches, then loads
         SYS:MONSYM.REL,  LDINIT.REL,  VERSIO.REL,  STG.REL  or  STGAN.REL,
         KDDT.REL, and MDDT.REL.

     5.  The REL library is searched to extract all code that is needed  to
         build  the  monitor  based  on  the selected software and hardware
         configuration.

     6.  After LINK has created the monitor image (MON.EXE or AMON.EXE), it
         is  started at location 142 which starts up DDT.  The built in DDT
         breakpoints for BUGHLT and BUGCHK are set.

     7.  The monitor is then started in the POSTLD  module.   POSTLD  first
         rearranges certain monitor address spaces.  It then prints out the
         start, end, and length for each monitor PSECT.  If there are PSECT
         overlaps  these  are  detected  by  POSTLD, which will result in a
         error message.  POSTLD will write a potential  new  set  of  PSECT
         origins to LNKNEW.CCL and PARNEW.MAC.  These will be used if PSECT
TOPS-20 Monitor Building Procedures and Information             Page 9


         overflows were detected by POSTLD.  POSTLD then saves the ready to
         run monitor as MONITR.EXE (LN2070) or AMONITR.EXE (T20-AN70).

     If POSTLD did not detect PSECT overflows,  the  image  that  was  just
     saved  is  the  monitor  to  use.  If POSTLD did detect an overflow, a
     second pass at the monitor build will be attempted,  as  described  in
     the following steps.

     8.  PARNEW.MAC (containing revised PSECT origins), plus the parameters
         for  this  monitor,  plus  MON:PARAMS.MAC,  plus  MON:STG.MAC  are
         compiled together to  create  R:STG.REL  (LN2070)  or  R:STGAN.REL
         (T20-AN70).

     9.  LINK is run again and LNKNEW.CCL given to LINK to set the  revised
         PSECT origins.  The rest of the monitor LINK switches and commands
         are used to produce another base monitor image just as it was  for
         the previous build.

    10.  The image is started in DDT,  and  the  breakpoints  are  set  for
         BUGHLT  and  BUGCHK are set, and POSTLD is started again.  Because
         PARNEW.MAC and LNKNEW.CCL were used,  there  should  be  no  PSECT
         overflows this time.

    11.  If the monitor just built did not have any  PSECT  overflows,  the
         LINK  CCL  file  for PSECT origins for this monitor is replaced by
         LNKNEW.CCL, and the source MAC file for  PSECT  origins  for  this
         monitor  is replaced by PARNEW.MAC.  The old CCL and MAC files are
         kept around as filename.OLD just in case the work done in  pass  2
         was in error.


          Because POSTLD writes revised PSECT origins, and  the  CTL  files
     handle  PSECT  overflows  automatically,  the monitor building process
     normally proceeds without intervention.

          During the loading of the REL library a number  of  messages  are
     displayed.   Messages  from  LINK  of the form "%LNKFTH Fullword value
     XXXXXX being truncated to halfword" are to be expected.  Messages from
     LINK  of  the  form  "%LNKPOP Psect XXXXXX overlapping psect YYYYYY at
     address OOOOOO" can cause problems if there  are  a  large  number  of
     these  errors  or  the PSECTs overlap severely, because LINK will loop
     while loading the monitor.

          If there are a number of PSECT overflows, or one  or  more  PSECT
     overflows  are severe, LINK will loop while loading the monitor.  This
     will usually result in the batch job terminating after it exhausts its
     runtime.   In this case POSTLD does not have the opportunity to revise
     the PSECTs, and manual intervention is required.

          One of the switches given to LINK is a  /COUNTERS  switch.   This
     switch  displays  the  PSECT  relocation  counters  just  before  LINK
     attempts to resolve global symbols (which is when LINK may loop).

          By examining the LOG file the PSECT  overflows  can  be  seen  by
     looking  at  the  output  of the /COUNTERS switch.  Normally the PSECT
     overflows are caused by massive code additions OR by changing  monitor
TOPS-20 Monitor Building Procedures and Information            Page 10


     parameters (such as drastic changes in number of jobs).  To repair the
     PSECT overflows, edit the CCL file used to load the monitor and change
     the  PSECT  origins  just enough so that they no longer overlap.  Then
     resubmit the monitor build.  If changing one PSECT causes  another  to
     overflow  and  this  overflow  is  not  severe, LINK will not loop and
     POSTLD will be able to write the correct PSECT origins.
TOPS-20 Monitor Building Procedures and Information            Page 11


     3.0  Monitor Configuration Parameters

          This section is intended for anyone needing to  build  a  monitor
     configuration different from the standard configurations.  It requires
     some  familiarity  with  the  operation  of  the  system  and  utility
     programs,  and  some  knowledge  of  the  structure  of  the  monitor.
     Specifically:

     1.  Everything required in Section 2.

     2.  How to use a text editor.

     3.  How to read assembly language.

     4.  The meaning of common TOPS-20 monitor terms (e.g. "jobs", "forks",
         "PTY").


          The monitor configuration is determined  by  a  single  parameter
     file  PARAM0.MAC  (for  non-TCP/IP  monitors) or PARAN.MAC (for TCP/IP
     monitors).   This  file  is  the  only  configuration-dependent   file
     required  for  a  monitor build.  To configure a monitor, you will use
     the text editor to produce this parameter file.

          PARAM0.MAC (or PARAN.MAC) should contain  only  those  parameters
     that  are  different  from  the  standard values listed in PARAMS.MAC.
     This section describes the meaning of each parameter and its effect on
     the monitor configuration.

          You should read each description, determine the proper value  for
     you  configuration,  and note this value on a listing of the parameter
     file.  You can then edit the parameter file to include these values.

          When the new parameter file has been produced, you may follow the
     normal  monitor  build  procedure  to  build  a  single  monitor.  For
     non-TCP/IP monitors submit LN2070 /TAG:SINGLE /TIME:60, and for TCP/IP
     monitors submit T20-AN70 /TAG:SINGLE /TIME:60.



     3.1  Parameters Controlling Software Resources

          The parameters in this catagory cause the monitor to be built for
     different  numbers  of  software  resources.   Because  the  monitor's
     section 0 address space is limited,  increasing  some  parameters  may
     cause  the  section  0 space to overflow.  For example, increasing the
     number of jobs may require that the number of forks be reduced.

     1.  NJOBS

         The number of jobs, defaults to 100.   This  parameter  determines
         the  size  of the jobs tables and hence the maximum number of jobs
         which can exist at any one time.  This  includes  interactive  and
         batch  jobs  and  those  jobs with run under PTYCON.  There are 34
         resident words of monitor space which are  directly  dependent  on
         this  parameter;   in  addition,  the  number  of forks (described
TOPS-20 Monitor Building Procedures and Information            Page 12


         below) is usually determined by the number of jobs, and the normal
         ratio  is  4  forks/job.   Hence  (unless  you change the fork/job
         ratio), the number of resident words  required  for  each  job  is
         (4*18)+10 words resident and 27 words swappable memory.

     2.  NFKS

         The number of forks.  This parameter determines the  size  of  the
         scheduler  fork tables and hence the maximum number of forks which
         can exist at any one time.  This  parameter  is  normally  set  to
         3*NJOBS  thus  allowing  an average of about 3 forks/job.  If your
         system is known to have an average distinctly above or below this,
         this  ratio  may be changed.  The resident memory requirements are
         18*NFKS.

     3.  MAXFKS

         Maximum fork size.  This parameter specifies the maximum  size  to
         which  the  working  set  of  any  fork  (process) can grow.  This
         parameter defaults to 0.  If this value is set to 0,  the  monitor
         will  limit  working  sets  to  a  size 32 less than the number of
         available pages.  CAUTION:  If this number is  set  too  low,  the
         system will thrash.

     4.  SSPT

         The size of the system pages table, defaults to 2560.  This 2-word
         table holds information about every open file and every fork.  Its
         minimum reasonable value is SSPT = 500 + NJOBS =  3*NFKS.   It  is
         also used for holding information about shared file pages if there
         is sufficient space.   This  allows  a  shared  file  page  to  be
         referenced  without  its owing index block also being brought into
         core.  Hence it is probably most efficient  to  set  SSPT  to  the
         value  shown  above plus the average number of shared pages in use
         in your system.  The resident core requirements are:  2*SSPT.

     5.  NOFN

         The number of OFN entries in the SPT.  There  is  OFN  (Open  File
         Number)  assigned  for  each disk file open on the system.  If the
         system appears to run out of OFNs, NOFN may  be  increased.   Each
         OFN requires 9 resident words.

     6.  MAXCOR

         The maximum number of physical pages.  This  parameter  determines
         the  size  of the five core status tables.  It should be set to at
         least the maximum amount of memory  on  your  system  (in  pages).
         Since  all  CSTs  except  CST5  have been moved out of section 0/1
         space, the resident core requirements for this parameter are  just
         MAXCOR words.

     7.  NDST

         The size of the drum status table.  This table has one  entry  for
         each  page of swapping storage.  The swapping area is used for all
TOPS-20 Monitor Building Procedures and Information            Page 13


         active pages whether shared or  private.   If  the  swapping  area
         becomes  full,  the  monitor  will move shared pages back to their
         home address, but it  cannot  move  private  pages.   Hence,  this
         parameter  should be set to at least the maximum number of private
         pages expected to be in use at one time.  Note that at least  this
         much swapping space must have been allocated on the boot structure
         (BS:).  Also, since TOPS-20 V5.0, the DST is located in TABSEC and
         therefore  modifying  its  size has no effect on TOPS-20's section
         0/1 address space.




     3.2  Parameters Controlling System Defaults

          Many of the parameters listed below can be overridden  by  users.
     These parameters control defaults set by the monitor.

     1.  TMZONE

         The time zone.  This parameter specifies the local  time  zone  in
         which the system is being operated.  The monitor standard time and
         date format (see JSYS manual) is GMT.  Hence, this parameter gives
         the  number  of hours by which local time lags GMT.  This value is
         assembled into TIMZON and may be  changed  at  system  startup  in
         7-CONFIG.CMD.   For  the  USA, EST = 5, CST = 6, MST = 7, PST = 8.
         Daylight saving time is  handled  automatically;   this  parameter
         should be set based on the standard local time.

     2.  IPTIMF

         This parameter controls the inclusion of page trap  overhead  time
         in  process  run  times.  A value of 1 causes page trap time to be
         included;  a value of 0 causes page trap time to be excluded.

         "Page Trap Time" is the CPU time spent handling page traps  for  a
         process.  This time typically increases under headier system loads
         because pages will be swapped out and must be  faulted  back  into
         memory   more   often.   This  is  the  major  item  which  causes
         variability in reported process and job runtimes  under  different
         load conditions.

         In monitors prior to release 3, this time was always  included  in
         reported  runtimes.  For compatibility with previous releases, the
         default is to include the page trap time.   Installations  wishing
         to  minimize  the variability of reported runtimes may change this
         value to 0.  Such installations should  be  aware,  however,  that
         this  will  generally  result  in  some  reduction of system total
         chargable time, since the overhead  which  was  being  charged  in
         earlier monitors will be excluded.

     3.  SYSSCF

         This parameter is the total free disk space limit below  which  no
         OPENF's in write mode will be allowed, and defaults to 500 pages.
TOPS-20 Monitor Building Procedures and Information            Page 14


     4.  IEDDTF

         EDDT retention flag.  This parameter is set to 1 if EDDT is to  be
         retained  after  monitor  startup,  0  otherwise.   This  value is
         assembled into EDDTF and may be changed at  startup.   EDDT  takes
         about 16K?  of resident core.

     5.  NTRFE

         This parameter specifies the number of disk cylinders that are set
         aside for the front-end-file-system, which defaults to 10.

     6.  LOGTTY

         Designator for logging information.  This is the terminal on which
         all  login,  logout, and account change commands are recorded.  It
         is not necessary to print this information on a terminal since  it
         is  also  recorded  in  the  USAGE file.  Hence, this parameter is
         normally set to .NULIO.

     7.  DGOFKN

         If a job tries to create a fork, and the number of  forks  in  the
         job  (including  the new one) is greater than the value of DGOFKN,
         then the monitor calls the access-control facility to determine if
         the job is permitted to create the fork.  The default is 5.

     8.  FFFSZE

         This is the size (in words) of the resident  monitor  patch  area,
         FFF.  It defaults to 400 (octal) words.

     9.  COFMIN

         When a job is detached because  of  carrier  loss  (or  any  other
         communications  interruption), the job remains detached for COFMIN
         minutes before it is logged out.  The default is 5 minutes.   This
         value    may   also   be   easily   changed   with   the   "ENABLE
         DETACH-CARRIER-OFF n" command in 7-CONFIG.CMD.

    10.  SWDST

         The default number of pages to reserve for swapping  space  on  an
         areas  of  a  structure.  If no value is declared for SWDST, it is
         set to NDST.

    11.  .STDFP

         The default file protection given to each new file in a  directory
         unless otherwise specified.  It defaults to 777700.

    12.  .STDDP

         The default directory protection  of  each  new  directory  unless
         specifically set to something else, defaults to 777700.
TOPS-20 Monitor Building Procedures and Information            Page 15


    13.  .STDBS

         The default number of versions of each new file to keep,  defaults
         to 1.

    14.  .STDMX

         The default permanent and working disk storage,  defaults  to  250
         pages.

    15.  .STDSD

         Standard subdirectory quota, defaults to zero.

    16.  .STDNE

         Standard on-line expiration for migration of files, defaults to 60
         days.

    17.  .STDFE

         Standard off-line expiration for migrated files on magnetic  tape,
         defautls to 180 days.




     3.3  Parameters for Hardware Support

          The next group of  parameters  refers  to  the  configuration  of
     peripheral  devices.   These  parameters  take  a  number which is the
     maximum number of units of a particular device.   Each  device  has  a
     parameter related to the device name, i.e., for device "xxx", there is
     a parameter "xxxN".  Other symbols in the monitor are  constructed  by
     concatenating the device name with a specific prefix or postfix.

     1.  NDHL, NDLL

         The number of terminals on the RSX20F  front  end  console.   This
         parameter determines the maximum number of physical terminal lines
         including the CTY.  NDHL is  the  number  of  DH11  lines  on  the
         front-end, defaults to 128 (which is the maximum).  This number is
         normally 16 times the number of DH11s in the front-end.   NDLL  is
         the number of DL lines on the front-end, including the CTY, and is
         defaulted to 5 (one for the CTY, one for the KLINIK, one for  each
         of  three  possible  DN20s).   The  resident  storage required per
         terminal line is a function of some ratios described  below.   For
         this   parameter,  the  number  of  resident  words  required  is:
         5*(NDHL+NDLL+1)

     2.  NTTPTY

         The number of pseudo-terminals, defaulted to 30.   This  parameter
         determines  the  number  of  PTYs  available.  You will need 1 for
         PTYCON plus 1 for each PTYCON subjob being run, plus  1  for  each
         simultaneous   batch  job  being  run.   Additional  PTYs  may  be
TOPS-20 Monitor Building Procedures and Information            Page 16


         allocated  for  user  use  of  PTYCON.    The   resident   storage
         requirement  for  a  PTY  is  exactly  the  same as for a physical
         terminal:  5*NTTPTY

     3.  NTTNVT

         The  number  of  Network  Virtual   Terminals   (TELNET   protocol
         terminals),  defaults  to zero.  These devices are present only on
         installations using  an  TCP/IP  monitor.   The  resident  storage
         requirement  for  a  NVT  is  exactly  the  same as for a physical
         terminal:  5*NTTNVT.

     4.  NTTMCB

         The number of DECnet NVTs (Network Virtual Terminals), defaults to
         20.   If  you do not have a DECnet-20 installation, this value may
         be set to zero.  The NVT protocol has been superceded by the CTERM
         protocol  for  Phase  IV  DECnet  systems.   NVT terminals require
         storage like any other terminal device, and  their  resident  core
         requirements are:  5*NTTMCB.

     5.  NTTCTH

         The number of CTERM host terminals, defaults to 10.  If you do not
         use  DECnet-20  or  do not use DECnet-20 for terminal connections,
         this value may be set to zero.  CTERM  terminals  require  storage
         like   any   other   terminal  device,  and  their  resident  core
         requirements are:  5*NTTCTH.

     6.  NTTLAH

         The number of LAT host terminals, defaults to 50.  If you  do  not
         use  LAT,  or  do  not  have  an  NIA20 Ethernet interface on your
         system, this value may be set  to  zero.   LAT  terminals  require
         storage  like  any  other terminal device, and their resident core
         requirements are:  5*NTTLAH.

     7.  ACTLNS

         This is the number of active terminal lines, including TTY and PTY
         lines,  and  is  defaulted to NJOBS.  The number of resident words
         is:  32*ACTLNS?

         In addition, 22 words of resident storage  is  required  for  each
         active  line.  This latter storage changes dynamically as any line
         becomes active or inactive.

     8.  NETN

         Arpanet (TCP/IP) service if set to 1.  This symbol specifies  that
         the  monitor  has  support for TCP/IP software and hardware.  This
         parameter is set to 0 in non TCP/IP monitors to remove TCP/IP code
         from the monitor.
TOPS-20 Monitor Building Procedures and Information            Page 17


     9.  ANXN

         Support for the TCP/IP over AN20 Arpanet 1822 interface.  If  zero
         there  is  no  AN20;   if  one there is an AN20.  (TCP/IP monitors
         only.)

    10.  IPNIN

         Support for TCP/IP over the NIA20.  If zero no support for  TCP/IP
         over  the  NIA20;   if one support TCP/IP over the NIA20.  (TCP/IP
         monitors only.)

    11.  DCN

         DECnet-20 service if set to 1.  This specifies  that  the  monitor
         has support for DECnet-20 software and hardware.  Setting DCN to 0
         removes DECnet code from the monitor.

    12.  FEN

         Front End Device service.  This parameter defines the number of FE
         devices  present,  and  defaults  to 1.  The FE devices are pseudo
         devices used for general transfer of data to and  from  the  front
         end  file  system.   The  FE  program  is  the only use of the FE:
         device.  A maximum of 4 is supported.  Each FE device  requires  7
         resident words.

    13.  MTAN

         Magtape device service.  This parameter is the number  of  magtape
         units  present,  defaulted  to  16.   A maximum of 16 is presently
         supported.  Each magtape device requires 98 resident words and  38
         nonresident words.

    14.  DTEN

         DTE20  service.   This  parameter  denotes  the  number  of  DTE's
         connected  to  the  KL10  processor  including  the console 11/40.
         NOTE:  If this prarmeter is changed, the source module  DTESRV.MAC
         must be rebuilt;  therefore only source sites can change DTEN.

    15.  LPTN

         Lineprinter service (PLPTn:), which defaults to 2.  A maximum of 2
         is  presently  supported.  Each physical printer takes 18 resident
         words and 540 nonresident words.

    16.  CDRN

         Card Reader service (PCDRn:), defaults to 1.  This  specifies  the
         number  of  card readers on the console front end.  A maximum of 1
         is supported.  The spooled card reader device always exists.  Each
         card reader requires 7 resident words and 512 nonresident words.
TOPS-20 Monitor Building Procedures and Information            Page 18


    17.  CDPN

         Spooled card punch, defaults to 1.  If nonzero, spooled card punch
         is allowed.

    18.  PCDPN

         Physical card punch service, defaults to 1.  A  maximum  of  1  is
         supported.  Each physical card punch requres 72 resident words.

    19.  SPLTN

         Spooled plotter, defaults to 0.  If nonzero, spooled  plotting  is
         allowed.

    20.  PLTN

         Plotter service (PPLTn:), defaults  to  0.   A  maximum  of  1  is
         supported.  Each plotter requires 521 words of resident storage.

    21.  SPTPN

         Spooled paper tape punch, defaults  to  0.   If  nonzero,  spooled
         paper tape punch is allowed.

    22.  PTPN

         Paper tape punch (PPTPn:), defaults to  0.   A  maximum  of  1  is
         supported.   Each  paper  tape punch requires 73 words of resident
         storage.




     4.0  Installation-Specific Terminal Definitions

          Installations wishing to define their own terminal types may  use
     terminal  type  codes  4  through  7.   It  is  not possible to define
     corresponding terminal type names.  Note that  DIGITAL  only  supports
     those terminals detailed in the TOPS-20 Software Product Description.

          Setting installation specific terminal types  requires  that  the
     source module STG.MAC be edited.  For each terminal type the following
     information must be known:

     1.  Terminal has mechanical form feed

     2.  Terminal has mechanical tabs

     3.  Terminal has lowercase keyboard input

     4.  Padding after a carriage return

     5.  Padding after a line feed
TOPS-20 Monitor Building Procedures and Information            Page 19


     6.  Padding after a horizontal tab

     7.  Padding after a form feed

     8.  Terminal display length and width

     9.  Terminal automatically enables XON and XOFF processing

    10.  Character strings to be sent to the terminal to effect cursor

     These characteristics are described by tables which can  be  found  in
     the  source  code  module  STG.MAC.  Items 1 through 7 are declared in
     table TTYPE0.  Item 8 item is  in  table  TTYPE1.   Also,  the  cursor
     positioning declarations are in tables for each terminal type, pointed
     to by entries in table TTYPE1.  See table VT100T for an example of the
     table of cursor positioning commands for a specific terminal.



     [End of MONITOR-BUILDING.MEM]