Google
 

Trailing-Edge - PDP-10 Archives - tops20_v6_1_tcpip_installation_tp_ft6 - new-system/tops20.doc
There are 37 other files named tops20.doc in the archive. Click here to see a list.












                           TOPS-20 Doc File


                              22 Jul 85


                          Version 6.1(6763)




COPYRIGHT (C) DIGITAL EQUIPMENT CORPORATION 1976,  1985.   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 RESPONSIBLITY FOR THE USE  OR  RELIABILITY  OF  ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL.
TOPS-20 Doc File, V6.1 (6763)                                   Page 2
                                                             22 Jul 85


                               CONTENTS
                                of the
                        TOPS-20 Doc File, V6.1



        1.0     Product Summary  . . . . . . . . . . . . . . . . . . 3
        1.1       TOPS-20 V6.1 System Facilities Specification . . . 4
        2.0     Software Capabilities  . . . . . . . . . . . . . . . 6
        2.1       New Features in V6.0 . . . . . . . . . . . . . . . 6
        2.2       New Features in V6.1 . . . . . . . . . . . . . . . 9
        2.2.1       Monitor Features . . . . . . . . . . . . . . . . 9
        2.2.2       Internal Monitor Changes . . . . . . . . . . .  11
        2.2.3       EXEC Enhancements  . . . . . . . . . . . . . .  12
        2.3       KL Microcode Enhancements  . . . . . . . . . . .  16
        3.0     The TOPS-20 V6.1 Software Package  . . . . . . . .  17
        4.0     System Performance Information . . . . . . . . . .  18


APPENDIX A      V6.0 ADDRESS SPACE WORK

        A.1     Introduction . . . . . . . . . . . . . . . . . . . A-1
        A.2     Strategy . . . . . . . . . . . . . . . . . . . . . A-1
        A.2.1     Movement of Data to Extended Sections  . . . . . A-1
        A.2.1.1     Static Data  . . . . . . . . . . . . . . . . . A-2
        A.2.1.2     Dynamic Data . . . . . . . . . . . . . . . . . A-2
        A.2.1.3     Other Data . . . . . . . . . . . . . . . . . . A-2
        A.2.2     Movement of Code . . . . . . . . . . . . . . . . A-2
        A.2.3     Isolation of Section 0 Code  . . . . . . . . . . A-3
        A.3     Effects  . . . . . . . . . . . . . . . . . . . . . A-3
        A.3.1     Configurations . . . . . . . . . . . . . . . . . A-3
        A.3.2     Performance  . . . . . . . . . . . . . . . . . . A-3
        A.3.3     Changes to Monitor Build Procedures  . . . . . . A-4


APPENDIX B      V6.1 ADDRESS SPACE WORK

        B.1     Address Space Work for V6.1  . . . . . . . . . . . B-1
        B.2     Overview: Linking the Symbol Table into an 
                Extended Section . . . . . . . . . . . . . . . . . B-2
        B.3     Overview: Using a PDV in the Monitor . . . . . . . B-2
        B.4     Overview: Moving code to Extended Sections . . . . B-2
        B.5     The Monitor PDV  . . . . . . . . . . . . . . . . . B-3
        B.6     Linked Image . . . . . . . . . . . . . . . . . . . B-3
        B.7     POSTLD . . . . . . . . . . . . . . . . . . . . . . B-4
        B.8     EDDT in user mode  . . . . . . . . . . . . . . . . B-5
        B.9     BOOT . . . . . . . . . . . . . . . . . . . . . . . B-6
        B.10    Monitor Initialization . . . . . . . . . . . . . . B-7
        B.11    EDDT in Executive Mode . . . . . . . . . . . . . . B-8
        B.12    Other Monitor Work . . . . . . . . . . . . . . . . B-9
        B.13    The Symbol Table . . . . . . . . . . . . . . . . . B-9
        B.14    How to Move Code to Extended Sections  . . . . . . B-9
        B.15    PSECT Restrictions and Boundaries  . . . . . . .  B-10
TOPS-20 Doc File, V6.1 (6763)                                   Page 3
Product Summary                                              22 Jul 85


1.0  Product Summary

TOPS-20 V6.1 will include all the functionality of TOPS-20  V6.0  plus
support  for  the  NIA20 Ethernet port, DECnet Phase IV via NI, CI and
DN20, TCP/IP via NI, CI and AN20, LAT  terminal  concentrators,  CTERM
remote command terminals and Common File System.

TOPS-20 V6.0  is  an  interim  release  which  provides  the  software
required  to  use  HSC50 controllers and RA81/RA60 disks, by providing
support for the KL 2060/2065 interface to the CI (the  CI20)  and  the
software interfaces to the new disk subsystem.

TOPS-20 V6.0 and  V6.1  will  be  products  only  on  the  KL10  based
2060/2065 systems.  TOPS-20 V6.1 will include updates from the TOPS-20
V6.0 Field Test and from the latest Autopatch distribution at the time
of  its delivery (Autopatch Tape 10).  There will be a major update to
the TOPS-20 documentation set along with this release.
TOPS-20 Doc File, V6.1 (6763)                                   Page 4
Product Summary                                              22 Jul 85


1.1  TOPS-20 V6.1 System Facilities Specification

The following list outlines  the  major  points  of  support  in  V6.1
introduced since V5.1, as well as certain restrictions.

     1.  TOPS-20 V6.1, the CI20 and the NIA20 require a KL10  Model  B
         Processor.

     2.  TOPS-20 V6.1, the CI20 and the NIA20 will not be supported on
         KL10 Model A or KS10 processors.

     3.  There can be a maximum of one CI20 and one NIA20 installed in
         a KL10 processor and the CI must be a dual path CI.

     4.  TOPS-20 V6.1, the CI20 and the NIA20  will  work  with  legal
         combinations of internal (MF20 or MB20) memory.

     5.  The CI20 and NIA20 will not be supported on  external  memory
         if  the system uses SA10s, DX10s or if the external memory is
         other than MH10 or MF10, configured in 4-Bus mode.

     6.  The CI20 and NIA20 will not be supported on a system  without
         cache (not 2040s).

     7.  TOPS-20 V6.1 will always contain the code for the CI  and  NI
         support whether or not the system has a CI20 or an NIA20.

     8.  TOPS-20 V6.1 will require a MINIMUM of 768K words of  memory,
         one megaword for CFS congigurations.

     9.  TOPS-20 V6.1 will support a MAXIMUM memory configuration of 4
         megawords.

    10.  TOPS-20 V6.1 will support RA81 and RA60 disks on  the  HSC50,
         but will not support TA78 or other HSC-based tape drives.

    11.  TOPS-20 V6.1 will not support the use of an HSC50 disk  as  a
         PS: structure.

    12.  At system start up the program PS:[SYSTEM]IPALOD.EXE will  be
         run  by  job  0  to  cause  the  CI20 microcode to be loaded.
         During  normal  operation,  the  monitor  will  automatically
         reload the CI20 microcode if required.

    13.  The NIA20 microcode will initially be loaded at system  start
         up  by  a  program  called  SYSTEM:KNILDR.EXE,  running under
         SYSJOB.   During  normal   operation,   this   program   will
         automatically reload the NIA20 microcode if required.  KNILDR
         can also be run manually by a privileged user.

    14.  A Maximum of 3 HSC50s per CI is recommended.
TOPS-20 Doc File, V6.1 (6763)                                   Page 5
Product Summary                                              22 Jul 85


    15.  TOPS-20 V6.1 will support a maximum of  24  RAxx  drives  per
         HSC50.

    16.  TOPS-20 V6.1 will support a maximum of 60 RAxx drives per CI.

    17.  An RA81 disk structure may consist of 1 to 4 spindles.

    18.  TOPS-20 V6.1 will support up to 32 LAT terminal concentrators
         with  a  total  of up to 128 terminal sessions connected to a
         TOPS-20 system at a time.

    19.  DECnet

         1.  TOPS-20 V6.1 will support DECnet  communication  via  the
             DN20 as in previous releases, and will now support the NI
             (Ethernet) and the CI as well.  Up to three DECnet  DN20s
             can be connected to a single KL.

         2.  TOPS-20 V6.1 will support DECnet Phase IV routing, either
             as  a  level  1  router  or  as an Ethernet End Node.  In
             either case, V6.1 will fully participate in  a  Phase  IV
             network  with  one exception:  links which pass through a
             DN20 will be restricted to the local routing area,  since
             the  MCB  is  a  Phase III node and thus can only address
             nodes with addresses up to 285 in a single  area.   Links
             over  the  NI and the CI will be able to address the full
             Phase IV network of up to 6 areas of  up  to  1023  nodes
             each.

         3.  DECnet-20's Network Management  will  downline  load  and
             upline  dump  dependent nodes across the DTE20 (eg, DN20)
             and across the Ethernet (eg, LAT servers).  An additional
             special  case  allows Network Management to downline load
             the communication processor Remote Console Facility  (eg,
             in a DECSA).


    20.  ARPAnet (TCP/IP)
             TOPS-20 V6.1 will support TCP/IP  communication  via  the
             AN20 as in previous releases, and will now support the NI
             (Ethernet) and the CI as well.

         1.  TCP/IP Maximum Configuration

             TOPS-20  V6.1  monitors  built  to  support  both  TCP/IP
             (ARPAnet)  and  DECnet  networks will not support maximum
             configurations (number of jobs, TTYs, memory, etc).  At a
             minimum,  such monitors will support those configurations
             possible under TOPS-20 V5.1.  (Approximately 80 jobs, 2MW
             of memory, 10 pages less than normal JSB free space).
TOPS-20 Doc File, V6.1 (6763)                                   Page 6
Product Summary                                              22 Jul 85


         2.  Non-DECnet builds  of  TOPS-20  will  not  be  supported,
             except  for the special case of TCP/IP.  Since we will be
             restricting the  configurations  possible  for  TCP/IP  +
             DECnet  monitors, we will continue to make it possible to
             build non-DECnet monitors (through the use  of  an  build
             parameter,  as  is  now  the  case)  in  combination with
             TCP/IP.

         3.  TCP/IP will not have NCP Capability

             The  TCP/IP   implementation   will   not   include   NCP
             capability.  NCP is in the release 5 alpha test of TCP/IP
             and provides  the  ARPAnet  customer  with  a  method  of
             transitioning  between  the  two  protocols.  By the time
             V6.1 is released, there should not be  a  need  for  this
             facility.





2.0  Software Capabilities

2.1  New Features in V6.0

This section contains a brief  description  of  the  new  features  in
TOPS-20 V6.0 which have been carried forward to V6.1.

     1.  SCA support

         This task will provide support in the  Monitor  to  implement
         the  SCA  protocol  on  the CI.  This includes JSYS level SCA
         support for  user  mode  diagnostics.   SCA  is  a  corporate
         protocol  which provides process-to-process communications on
         the CI.

     2.  CI20 Support

         Provide Monitor software to drive the CI on a KL10 using  the
         CI20  hardware.   This  task  includes producing software to:
         load the port microcode, provide error  logging  of  hardware
         detected errors, and support for user mode diagnostics.

     3.  HSC50 Disk, Host support

         This is the disk driver module in TOPS-20 which  communicates
         with the HSC50 disk or equivalent using the MSCP protocol.

     4.  Diagnostic Support

         This task will add additional facilities to the DIAG JSYS for
         user  mode  diagnostic  support, primarily in the area of the
         CI20.
TOPS-20 Doc File, V6.1 (6763)                                   Page 7
Software Capabilities                                        22 Jul 85


     5.  Multi-Fork Capabilities in the EXEC

         Multiforking is an EXEC feature that organizes a job's memory
         into  separate,  parallel  areas  called  "forks."  Each fork
         contains one program and its inferior forks,  if  any.   This
         organization  of  memory means users can run several programs
         simultaneously.  Furthermore, by placing program forks in the
         "background,"  the  terminal  is  free  for other work.  Once
         loaded in  memory,  program  forks  can  be  invoked  without
         reinitializing.   This  means  that  a  user  can  go  from a
         compiler to an editor and back again without reloading either
         program.

     6.  RAMP Support

         1.  BUGCHK Information

             The TOPS-20 monitor will provide the capability to notify
             the operator on a BUGCHK and other warning message cases.
             The macro defining BUGCHKs will be modified to allow  the
             setting of a flag for operator notification.

         2.  SPEAR Sequence Counter

             A sequence number is added to each ERROR file entry.  The
             sequence number will increment across system crashes.

         3.  Auto-Reload of CI20 Microcode

             Upon detection of a potentially  recoverable  failure  of
             the  CI20 microcode, TOPS-20 will automatically cause the
             CI20 microcode to be reloaded.

         4.  Auto-Reload of NIA20 Microcode

             Upon detection of a potentially  recoverable  failure  of
             the NIA20 microcode, TOPS-20 will automatically cause the
             NIA20 microcode to be reloaded.


     7.  Password Encryption

         TOPS-20  password  encryption   facility   increases   system
         security  by making it much more difficult to steal passwords
         and gain unauthorized access  to  system  resources/services.
         Customers  may  use  the DEC-supplied encryption algorithm or
         they may write their own.  An important feature is a password
         encryption   version   number   that  allows  changes  to  or
         replacement  of  encryption  algorithms   without   affecting
         passwords encrypted with the older algorithm.
TOPS-20 Doc File, V6.1 (6763)                                   Page 8
Software Capabilities                                        22 Jul 85


     8.  CHECKD

         This utility has had a  large  amount  of  maintenance  work,
         especially  in terms of error handling (bad arguments, etc.),
         as well as an update to  use  extended  addressing  (separate
         sections  for  code and data), thus allowing for dealing with
         larger structures and for mapping in DDT.

     9.  DUMPER

         Large parts of DUMPER have been rewritten in order to  answer
         a  large  number  of  SPRs.   The documentation has also been
         heavily modified.

    10.  PTYCON

         This utility was updated to  use  the  COMND%  JSYS  for  its
         command  parsing,  making it compatible with standard TOPS-20
         command syntax.

    11.  PPN support

         To implement more complete support of PPNs in TOPS-20, a word
         was added to the directory and IDXTAB was extended to include
         a PPN.  Changes were made to DUMPER, DLUSR,  CHECKD  and  the
         EXEC build command.

    12.  Active Dual Porting of Massbus Disks

         Support  was  added  to  allow  for  dual   porting   massbus
         disks(RP04,RP06,RP07)  to  two  different channels within the
         same KL, allowing for the use of one channel when  the  other
         is active .

    13.  Address Space

         While not part of the user functionality, major  sub-projects
         within  V6.0 and V6.1 of TOPS-20 have been aimed at supplying
         sufficient code-section address space  to  create  reasonable
         monitor configurations.  See appendix A for details.

    14.  Galaxy Changes

         Galaxy has been enhanced to support new features  in  TOPS-20
         V6.1, particularly those relating to the CI, in particular:
          o  BUGCHK/BUGINF/Device-problem information to OPR
          o  Password Encryption
          o  HSC50 and RA81
          o  CI20 support
          o  QUEUE% JSYS support
TOPS-20 Doc File, V6.1 (6763)                                   Page 9
Software Capabilities                                        22 Jul 85


2.2  New Features in V6.1

This section contains a brief  description  of  the  new  features  in
TOPS-20  V6.1  which  have  been introduced since V6.0.  Many of these
features involve Ethernet support.



2.2.1  Monitor Features


     1.  V6.1 supports Ethernet terminal concentrators using Digital's
         Local  Area  Transport  (LAT)  protocol.  These concentrators
         include LAT-11, DECSA and DECserver-100.  V6.1 provides a LAT
         Control Program (LCP) subsystem in OPR to control LAT.

     2.  V6.1 includes an NI% JSYS which  provides  direct  user  mode
         access  to the Ethernet.  A user program can open an Ethernet
         protocol type and then send and receive datagrams  with  very
         little monitor overhead.

     3.  V6.1 includes an  LLMOP%  JSYS  which  provides  support  for
         Ethernet  Low-Level  Maintenance Operation functions (LLMOP).
         This JSYS is used by the unsupported tool RMTCON  which  will
         access   the  Remote  Console  Facilities  on  some  Ethernet
         servers.  The LLMOP% JSYS is also used by various diagnostics
         available to Field Service personnel.

     4.  V6.1 provides DECnet Phase IV in the KL host.

         1.  The DN20, CI and NI are all supported DECnet data  links.
             The  NI  will be the only fully supported Phase IV DECnet
             connection  to  TOPS-20  systems.   The  CI  will  be   a
             supported  DECnet  link only for communication with other
             TOPS-20 systems.  The MCB software in the DN20  will  not
             be  substantially  changed,  it  will  remain a Phase III
             DECnet node.  Up to three DN20s  running  DECnet  can  be
             connected to a single KL processor.

         2.  V6.1 acts as a DECnet Level 1 Router or  as  an  Ethernet
             End Node.  As a Level 1 Router, V6.1 can participate in a
             DECnet Phase IV network  through  any  of  its  supported
             communication  devices.   As  an  Ethernet End Node, V6.1
             will only communicate by way of the  Ethernet,  and  will
             not incur the CPU overhead of DECnet routing.  The choice
             between level 1 routing and Ethernet  End  Node  must  be
             made at system startup with a command to SETSPD.  See the
             DECnet Installation Guide.

             Since V6.1 is a Phase IV DECnet node, the  NODES  program
             is now obsolete.
TOPS-20 Doc File, V6.1 (6763)                                  Page 10
Software Capabilities                                        22 Jul 85


         3.  V6.1 provides full Phase IV Network Management, including
             Ethernet   Downline  Load/Dump  and  Event  Logging,  but
             excluding  a  Permanent   Database   and   the   Ethernet
             Configurator   Module.   DECnet  Event  Logging  includes
             multiple local and  remote  event  sinks,  console  (OPR)
             logging,  file  (ERROR.SYS)  logging and fully selectable
             event filters.

         4.  V6.1  continues  monitor  mode  support   for   TOPS-20's
             homogeneous NRT terminal protocol.  In the past, incoming
             NRT connections were accepted by the MCBNRT  program  and
             then  handed  over  to  the monitor with a special MTOPR.
             Under TOPS-20 V6.1 incoming  NRT  connections  are  fully
             handled  in  the  monitor,  so the MCBNRT program and its
             special .MOANT MTOPR are obsolete.

         5.  V6.1  includes  support  for  Digital's  Remote   Command
             Terminal  (CTERM)  protocol.   Incoming  connections  are
             handled by a  monitor  module  called  CTHSRV.   Outgoing
             connections  are  handled  by  a user mode program called
             CTERM-SERVER.  The EXEC has a new SET HOST command  which
             will first call CTERM-SERVER to try to make a connection,
             then, if that fails, try to run the program pointed to by
             the  NRT: logical name.  NRT: might be set up to point to
             the  unsupported  SYS:HOST.EXE  program,  or  some  other
             user-provided terminal protocol handler.

         6.  In V6.1 NFT FAL are  replaced  by  the  Data  Interchange
             Utility  (DIU),  which  is  based on the distributed data
             access capabilities of RMS V3.  There is a  corresponding
             RMS-based  File  Access Listener (FAL) as well.  The V5.1
             NFT and FAL will be on the DECnet tools save set and will
             be unsupported.

         7.  V6.1 adds hooks  for  outgoing  VMS-style  Proxy  Access.
             Outgoing  DECnet connections which to not supply a source
             process identifier will have a new  default  source  PID.
             This  PID  is  used  by  VMS  systems  to implement proxy
             access.


     5.  With V6.0 and V6.1, TCP/IP will be available to  all  TOPS-20
         customers  as  an unbundled product.  TCP/IP will communicate
         over the AN20, the NI and the CI.

     6.  The TOPS-20 configuration program SETSPD has added functions:

          *  Dumps are copied to device DMP:.

          *  Daylight savings time can be turned off.
TOPS-20 Doc File, V6.1 (6763)                                  Page 11
Software Capabilities                                        22 Jul 85


          *  Telephone hangup on LOGOUT is now selectable.

          *  New DECNET commands.


     7.  TOPS-20 LAT's initial state can be changed from  ON  to  OFF,
         either  to  reduce  overhead  if LAT is not to be used, or to
         allow LCP commands to change LAT parameters  before  starting
         LAT.

     8.  Some DECnet parameters  which  cannot  be  changed  once  the
         system  is running can be changed with SETSPD.  For examples,
         buffer size, router/endnode status.




2.2.2  Internal Monitor Changes


     1.  The V6.1 monitor has a lot more  use  of  extended  sections.
         Many  data areas are now in non-zero sections.  For instance,
         the all CST's but CST5 are in section 5.  DECnet  and  TCP/IP
         code has been moved to section 6.  EDDT and MDDT also runs in
         non-zero sections.

     2.  Global  job  numbers  are  assigned  across   a   whole   CFS
         configuration.

     3.  The V6.1 BOOT offers faster dumping and the ability  to  BOOT
         from subdirectories.

     4.  The V6.1 DDT has many  improvements  for  extended  sections.
         User-mode  DDT itself runs in section 37.  The program is now
         called XDDT.


1.  DUMPER has been modified to answer a number of  SPRs.   It  has  a
rewritten IO system performance.  Many bugs are fixed.  A TAKE command
has been added.  New documentation has been written.

2.  RSX20F provides support for the MCA25 cache and the  MG20  memory.
RSX20F  has also been enhanced to provide CFS support.  RSX20F can now
Autobaud at 9600 baud.  XON and XOFF are now handled  by  the  Console
Front End.

3.  LINK V6 loads multi-section programs.  It will  not  run  on  V5.1
unless  Autopatch  8  is  installed.   LINK V6 is required in order to
build the TOPS-20 V6.1 monitor.  !.le!  !MS will now  be  bundled  and
supported.!
TOPS-20 Doc File, V6.1 (6763)                                  Page 12
Software Capabilities                                        22 Jul 85


4.  PPN support has been added.

5.  The EXEC RESET command is now synchronous:   it  will  not  return
until all its effects have been completed.

6.  V6.1 includes new JSYSs:
      *  XPEEK%, extended memory version of PEEK.
      *  WSMGR%, for managing working sets.
      *  NTINF% to report  general  network  information.   The  first
         NTINF%  function  reports  the  host network node of a remote
         terminal for SYSTAT.
      *  CNFIG% to report system configuration.
      *  SCS% (for DIGITAL diagnostic  use  only,  not  supported  for
         customer use).
      *  Some NODE% JSYS functions have been  added,  some  have  been
         made obsolete.


7.  Things that will surprise you:

     1.  Rebuilding index table takes a long time  the  first  time  a
         V6.0 or V6.1 monitor is run.

     2.  Numbers are in decimal (units, controllers)

     3.  SYSJOB and its command file now  contain  version  number  in
         filespec




2.2.3  EXEC Enhancements


     1.  A colon after device name is now optional  in  the  following
         commands:   ASSIGN,  BACKSPACE,  DEASSIGN,  DEFINE, DISMOUNT,
         EOF, MOUNT, REWIND, SKIP, INFORMATION STRUCTURE,  INFORMATION
         VOLUMES, and INFORMATION LOGICAL-NAMES.

     2.  The BUILD and ^ECREATE commands have new features:
          *  The PERMANENT and WORKING subcommands take INFINITY as an
             argument.
          *  Subcommand PRESERVE
          *  Subcommand TOPS10-PROJECT-PROGRAMMER-NUMBER nn,nn
          *  No password typeout


     3.  The ^ECEASE command has new features
          *  Requires confirmation, types  node  name  to  assure  the
             operator  is  shutting  down the desired system, downtime
             can be announced.
TOPS-20 Doc File, V6.1 (6763)                                  Page 13
Software Capabilities                                        22 Jul 85


          *  The NOW subcommand to initiate shutdown immediatley after
             the confirmation.  Equivalent to +00:00.


     4.  The COPY command has a new subcommand
          *  SUPERSEDE with ALWAYS, NEVER, OLDER, and NEWER


     5.  The DDT and MERGE commands  have  a  new  subcommand  OVERLAY
         which will force overlaying of existing pages.

     6.  Recognition now works in the DEFINE command.

     7.  The DIRECTORY command has a new subcommand
          *  The COMPLETE subcommand will cause a display  of  a  full
             filespec of each file


     8.  The INFORMATION CLUSTER command  is  added.   Formatted  much
         like  INFORMATION  DECNET,  it  returns  the names of all CFS
         nodes and HSCs on a CI.

     9.  INFORMATION DECNET now allows a node name to be specified.

    10.  INFORMATION LOGICAL-NAMES now accepts  wildcards  in  logical
         name.

    11.  INFORMATION MAIL SYSTEM checks on system mail.

    12.  INFORMATION JOB now outputs TCP/IP or DECnet host names.

    13.  INFORMATION SUPERIORS returns number of superior processes of
         this EXEC level.

    14.  INFORMATION VERSION prints decimal version numbers if  VI%DEC
         bit is on in version word.

    15.  LOAD-class-commands have new switches:
         /10-BLISS       /36-BLISS
         /FAIL           /PASCAL
         /SAIL           /SNOBOL
         /ABORT          /[NO] FLAG-NON-STANDARD
         /[NO] WARNINGS  /[NO]MACHINE-CODE

    16.  The LOGIN command has new features
          *  /FAST switch for logging in without taking command files,
             etc.  The feature can be controlled with
                  ^ESET   [NO]   FAST-LOGINS-ALLOWED   and    SETSPD's
             ENABLE/DISABLE FAST-LOGIN-OPTION command.
          *  Displays date and time of last LOGIN
          *  New system-wide LOGIN.CMD
TOPS-20 Doc File, V6.1 (6763)                                  Page 14
Software Capabilities                                        22 Jul 85


          *  New system-wide BATCH.CMD


    17.  LOGOUT takes the new system-wide LOGOUT.CMD.

    18.  The new PERUSE command runs  EDITOR:   with  the  appropriate
         read-only option.

    19.  The  PUSH  command  now  runs  the   EXEC   pointed   to   by
         DEFAULT-EXEC:.

    20.  One can now RECEIVE or REFUSE USER-MESSAGES  from  the  newly
         unprived TTMSG JSYS as used by the new SEND command.

    21.  The new SEND is equivalent to the privileged ^ESEND  command,
         but is available for unprivileged users.

    22.  Both SEND and ^ESEND have a new user name argument.

    23.  A new SET HOST command  runs  SYS:CTERM-SERVER  or,  if  that
         fails, the program pointed to by the logical name NRT:.

    24.  SET MAIL-WATCH takes two arguments, a user name whose mail is
         to  be watched and a number which sets number of times notice
         of new mail is displayed.

    25.  SET STATUS-WATCH provides a settable control character  which
         will cause the EXEC totype out file status information.

    26.  SYSTAT displays originating  hostname  of  DECnet,  LAT,  and
         TCP/IP connections.

    27.  The ^ESET has new features:
          *  [NO] LEVEL-ONE-MESSAGES
          *  [NO] LEVEL-ZERO-MESSAGES
          *  [NO] WORKING-SET-PRELOADING


    28.  The SET DIRECTORY PASSWORD command is changed so that the old
         password is not requested in certain cases.

    29.  The SET  [NO]  TRAP  JSYS  command  has  the  added  switches
         /DEFINED and /UNDEFINED.

    30.  New TERMINAL commands are
          *  [NO] INHIBIT for graphics terminal.
          *  [NO] RECEIVE advice, user messages, etc.
          *  VT200-SERIES

         The TYPE command has a new  subcommand  UNFORMATTED  to  type
         files without CCOC translation.
TOPS-20 Doc File, V6.1 (6763)                                  Page 15
Software Capabilities                                        22 Jul 85


    31.  MULTIFORKING FEATURES

          *  /STAY can be used on the START or CONTINUE  commands  for
             output only programs.

          *  /BACKGROUND can be used on the START or CONTINUE commands
             for any program which requires input.

          *  /NORMALLY can be used on the START or  CONTINUE  commands
             to keep forks in the forground.

          *  INFORMATION FORK-STATUS lists current forks.

          *  The COMPILE command has  a  /STAY  switch  to  cause  the
             compilation to run in the background.

          *  The CONTINUE n command takes  an  optional  Fork-name  or
             Fork-number  and  may have one of the following switches:
             /BACKGROUND, /NORMALLY, /STAY.

          *  The START command may have one of the following switches:
             /BACKGROUND, /NORMALLY, /STAY.

          *  The  FORK  n  command  takes  an  optional  Fork-name  or
             Fork-number and sets the current default fork to n.

          *  The KEEP command prevents a fork from being killed unless
             the user specifically RESETs it.

          *  The UNKEEP command  removes  KEEP  status  from  a  fork,
             causing it to be killed when a new fork is to be started.

          *  The FREEZE command stops a fork.

          *  The RESET x command kills one or more forks.  x can be
                  * to reset all but kept forks
                  . to reset the current fork
                  fork name, to reset a fork by name.
                  fork number, to reset a fork by number.

          *  The SET NAME command sets the current fork's name.

          *  The ERUN command runs a  system  program  with  EPHEMERAL
             status.

          *  The SET FILE [NO] EPHEMERAL command sets ephemeral status
             for a program file every time it is run.  If a program is
             ephemeral, it will not kill another fork to start, and it
             will  be killed when it finishes.  It will appear to have
             been an internal EXEC command.
TOPS-20 Doc File, V6.1 (6763)                                  Page 16
Software Capabilities                                        22 Jul 85


          *  The SET DEFAULT PROGRAM command sets status for a program
             name,  so  that  every  time a program with the indicated
             name is run it  will  have  the  indicated  status.   The
             argument can be one of [NO-]EPHEMERAL, [NO-]KEEP or NONE.

          *  The INFORMATION DEFAULT  PROGRAM  command  types  default
             program status.

          *  The SET PROGRAM command is a single-use form of  the  SET
             DEFAULT PROGRAM command.  Its arguments can be one of

              o  NONE

              o  [NO-]EPHEMERAL,

              o  KEEP (AND) CONTINUE or START or RE-ENTER

                 A kept program will be reinvoked  when  its  name  is
                 typed as an EXEC command.  The extra argument to KEEP
                 indicates how the program  is  to  be  invoked;   the
                 default is to START.






2.3  KL Microcode Enhancements


     1.  XJRST

         XJRST has been added to complement  the  XJRSTF  instruction.
         XJRST  requires a single word address, the XJRSTF instruction
         requires a two word flags, address pair.

     2.  OWGBP in section 0

         One Word Global Byte Pointers are now legal in section  zero.
         This  makes  application  programming easier, since a routine
         which uses OWGBPs  can  now  be  called  safely  either  from
         section 0 or from an extended section.

         The fact that OWGBPs are legal in section zero may cause some
         existing  programs  to fail, if they use byte pointers with P
         fields larger  than  44.   The  new  microcode  will  try  to
         interpret these previously illegal values.

     3.  Speedups of OWGBPs, byte instructions in general

         The new microcode speeds up byte instructions in general, and
         OWGBPs  in particular.  OWGBPs are now approximately the same
         speed as the new faster standard byte pointers.
TOPS-20 Doc File, V6.1 (6763)                                  Page 17
The TOPS-20 V6.1 Software Package                            22 Jul 85


3.0  The TOPS-20 V6.1 Software Package

!The TOPS-20 V6.1 package is a normal distribution kit except for  the
inclusion!  !of a documentation tape.!

All sites will receive the following:
     1.  Cover Letter
     2.  Software Product Description (SPD) in letter form
     3.  Printed copies of  the  TOPS20.BWR  (beware)  and  TOPS20.DOC
         files
     4.  Installation Tape
     5.  Distribution Tape
     6.  Floppy Disks  for  RSX20F  and  microcode  !.le;TOPS-20  V6.1
         Documentation Tape!

In addition to the base TOPS-20 distribution, TOPS-20  DECnet  (QTD04)
customers receive:
     1.  A DECnet Distribution tape !.le;A DECnet Tools tape!


In addition  to  the  base  TOPS-20  distribution,  TOPS-20AN  (QT031)
customers receive:
     1.  A TCP/IP Distribution tape
     2.  A TCP/IP Installation tape
     3.  A TCP/IP Tools tape


For Source Sites, the package  includes  one  or  more  (depending  on
licenses) of the following source media:
     1.  TOPS-20 Monitor Source Tape
     2.  EXEC Source Tape
     3.  DECnet Source Tapes (DECnet and TOPS-20 Source License)
     4.  TCP/IP Source Tape (QT031 and TOPS-20 Source License)
     5.  RSX20F Source Diskette


The TOPS-20 V6.1 software package contains the same  software  shipped
with V5.1 except for the following:

     1.  Components updated as part of V6.0 development.

     2.  Components updated as part of V6.1 development.

     3.  Components updated as part of V5.1 maintenance.   Autopatched
         components are at the same level as Autopatch Tape 10.


The TOPS20.BWR (beware) file indicates those components which have not
been  updated  and  which  are  not Autopatched.  Since sites may have
local edits in this software, customers  are  advised  (in  the  cover
letter)  to  read the beware file before superseding anything on their
system.
TOPS-20 Doc File, V6.1 (6763)                                  Page 18
The TOPS-20 V6.1 Software Package                            22 Jul 85


The TOPS20.BWR file included on the distribution tape may  not  be  as
complete  as  the  paper copy in the distribution kit, since the paper
copy may have been updated since the tape was made.



4.0  System Performance Information

TOPS-20 V6.1  is  larger  than  V5.1  and  some  of  the  code  paths,
especially  those for I/O, are longer in order to accommodate CI disks
and to provide a base  for  Common  File  System  support.   Customers
should  anticipate  a performance degradation of up to %15 on the same
physical configuration.  While Digital expects that  this  degradation
will  be  less  in  most  environments,  it  is  difficult  to be more
definitive.  CI20 performance for a single user is roughly  equivalent
to  an RP06.  When multiple users are accessing HSC50 disks, the total
throughput approaches RP07 speed.

TOPS-20 V6.1 makes greater use of the MCA25 than does V5.1.   In  most
environments,  V6.1  will  perform  better on a 2065 (with MCA25) than
V5.1 does on a 2060 (no MCA25) where both systems have more  than  one
megaword of memory.











                              APPENDIX A

                       V6.0 ADDRESS SPACE WORK



The address space changes in TOPS-20 V6.1 were  made  in  two  stages.
Since some customers have seen the first stage of changes in V6.0, the
changes are presented here in two separate appendices.  This  appendix
deals  with those changes which went into V6.0 and are carried forward
to V6.1.  The next appendix deals with those changes made since V6.0.



A.1  Introduction

This document describes the work performed in Release 6.0 in order  to
make the monitor fit into its available virtual address space.  Unlike
the CI projects, this project does not directly provide new facilities
to the user, nor does it involve the creation of new modules.  Rather,
it consists primarily of changes to existing code.



A.2  Strategy

When the monitor conversion to extended addressing was begun, sections
0  and 1 (both code and data) were mapped together.  Little by little,
code has been changed, and new code has  been  written,  to  obey  the
rules  for running in extended sections.  Such code was therefore able
to reference data in any section, and some data (the DST, directories,
etc.)  had  been moved before TOPS-20 V6.1.  All code continued to run
in sections 0 or 1.

The following sections provide a brief description of the changes made
in V6.0.



A.2.1  Movement of Data to Extended Sections
V6.0 ADDRESS SPACE WORK                                       Page A-2
Strategy                                                     22 Jul 85


A.2.1.1  Static Data

Three new macros (RSE, NRE, and NRPE) allow the assignment of extended
addresses  to  resident and swappable data locations.  The related new
PSECTs (ERVAR, ENVAR, and EPVAR) are assigned to an  extended  section
by  statements  in  STG  (or  PARAMS).   EDEFST and EMSKST provide the
extended equivalent of DEFSTR and MSKSTR.



A.2.1.2  Dynamic Data

A new routine, ASGVAS, provides for dynamic allocation of space in  an
extended section.  This is used for creating a section map for SCA.

CST0, CST1, CST2, and CST3 have been moved  to  an  extended  section.
Space for these tables is allocated at system startup.

Resident free space can be allocated from an extended section  if  the
caller  requests  it.   The  following  list contains each new user of
extended free space:

        Terminal data
        Timer data
        DECnet data


In addition, new code written for SCA and CFS  uses  extended  section
free space.

Swappable free space can also be allocated from an  extended  section.
ENQ/DEQ and IPCF use this.



A.2.1.3  Other Data

DDT's symbol table no longer lives in a separate map, but is allocated
in an extended section.

The descriptions of BUGINFs, BUGCHKs, and BUGHLTs are  moved  into  an
extended section at system startup.



A.2.2  Movement of Code

We have taken a first step toward allowing code in sections other than
0 and 1.

Executive DDT and MDDT now run in their own section.
V6.0 ADDRESS SPACE WORK                                       Page A-3
Strategy                                                     22 Jul 85


                               Caution

               Users executing JSYSs in MDDT will use a
               global  stack  pointer and may crash the
               system if the JSYS  isn't  prepared  for
               it.





A.2.3  Isolation of Section 0 Code

As more data has been moved out of the code sections,  more  code  has
been converted to run in section 1.  The style of some code makes such
conversion difficult, however.

Since code running in section 0  cannot  reference  data  in  extended
sections,  we  have  needed  to protect ourselves against accidentally
running in section 0.  And since this case is not readily detected, we
have  decided to remove code from the section 0 map wherever possible.
Thus V6.0 and V6.1 are the first releases in which sections  0  and  1
are mapped separately.

Resident code that can run in section 1  is  allocated  to  the  RSCOD
PSECT.   It  and all swappable code exist only in section 1.  Resident
code that must run in section 0 is allocated to the  SZCOD  PSECT  and
mapped  to  both  sections.  This allows us to call it from section 1,
and to convert it gradually to run in section 1.



A.3  Effects

A.3.1  Configurations

Many data structures whose size varied according to the  configuration
have  now  been moved to extended sections.  Thus we will no longer be
able to squeeze some extra space  by  reducing  configurations.   Each
time  we  need  more space, we will have to move new data or code, and
test the effects.



A.3.2  Performance

At a minimum, referencing data outside of the code section requires an
indexed or indirect reference.  It seems likely that we have increased
the frequency of pager conflicts.  All of these will have  a  negative
effect on performance.
V6.0 ADDRESS SPACE WORK                                       Page A-4
Effects                                                      22 Jul 85


A.3.3  Changes to Monitor Build Procedures

Because of the limitations of LINK, the PSECTS that exist in  extended
sections are created in a nonstandard way.  This has caused changes to
the procedures for building monitors.











                              APPENDIX B

                       V6.1 ADDRESS SPACE WORK



At the start of the V6.1 project there  were  both  linked  image  and
runtime  address space problems in the TOPS-20 monitor.  This memo was
written as a plan for dealing with this address space problem.  It now
serves as a description of what was done.



B.1  Address Space Work for V6.1

The V6.1 monitor cannot be loaded to its full  extent  into  a  single
section.   The  symbol  table  has to be truncated, leading to missing
symbols at runtime and problems with  programs  that  use  the  SNOOP%
JSYS.   Additional  linked image address space is required in order to
support a full-sized symbol table.

In order to support a full monitor configuration with 128 jobs and 120
terminals,  approximately  25  pages  of  runtime  address  space  are
required.  To support  a  DECnet/Arpanet  monitor  with  80  jobs  and
terminals, approximately 35 pages are required.

With the advent of  LINK  version  6.0  and  its  capability  to  load
multi-section  programs,  the  linked  image problem can be completely
remedied  and  a  mechanism  for  moving  code  to  extended  sections
relieving  section  0  address space can be put in place.  The actions
are:

      o  Link the symbol table into an extended section.

      o  Use a PDV to point to the symbol table, enabling EDDT/MDDT to
         be in another section than the symbol table.

      o  Create a new  runtime  section  that  will  contain  the  new
         extended code psects XRCOD and XNCOD.


Note that this project will only provide a mechanism for  moving  code
to extended sections.  The actual moving of code is not included.
V6.1 ADDRESS SPACE WORK                                       Page B-2
Address Space Work for V6.1                                  22 Jul 85


A few terms:

      o  Linked image - the EXE file output by LINK

      o  POSTLD image - the EXE file produced by POSTLD.   This  image
         maps 1-1 into what BOOT loads into physical memory

      o  Runtime - after paging is set up and turned on




B.2  Overview:  Linking the Symbol Table into an Extended Section

LINK version 6.0 will put the symbol table in any section, and this is
used  to  load  the 6.1 symbols into section 6.  However, in order for
EDDT to access the symbols before paging  is  turned  on,  the  symbol
table has to be moved to section 0 of the POSTLD image by POSTLD.

When paging is turned on, the symbols can be moved out  of  section  0
and put in their runtime location in section SYMSEC.



B.3  Overview:  Using a PDV in the Monitor

The symbol table is currently defined by  .JBSYM  and  .JBUSY  in  the
JOBDAT  area.  The symbols have to be in the same section as EDDT/MDDT
since the pointers in .JBSYM/.JBUSY are 18-bit quantities.

This restriction can be relieved if the symbol table is pointed to  by
a PDV.  In addition, this will simplify EDDT/MDDT.



B.4  Overview:  Moving code to Extended Sections

The goal is to move  already  existing  code  into  non-0/1  sections.
Currently,  EDDT and MDDT are the only code pieces running in extended
sections.

Existing code makes local (18-bit) references to other code  and  data
parts  of  the  monitor.  It is therefore desirable that extended code
can continue to do this as much as possible.  It is suggested  that  a
new  monitor  section  (symbolic  name  XCDSEC)  is  created.  The map
(XCDMAP) for the section will be filled with indirect pointers back to
the  section 0/1 map.  The extended code obviously has to go somewhere
in XCDSEC, and it is suggested that it  overlays  the  NRCOD  part  of
XCDSEC.

This means that code that makes local references to resident code  and
data,  as  well  as  to  the  JSB  and  PSB,  can  be moved.  However,
references to the swappable monitor code has  to  be  changed  to  use
30-bit  addresses.  Note that LINK will not be able to detect any such
V6.1 ADDRESS SPACE WORK                                       Page B-3
Overview: Moving code to Extended Sections                   22 Jul 85


references, so this may cause obscure bugs.

The extended code psects will be linked into  section  6.   XRCOD  and
XNCOD will make local references to addresses in another section (i.e.
section 0 where RSCOD/RSDAT/...  are  linked).   LINK  would  normally
generate  a  warning  message  for each such reference.  However, LINK
cannot distinguish between a section-local reference and a  section  0
address,  and  no undesired warning will therefore be generated.  (The
LINK group assures that there are no plans to change this).



B.5  The Monitor PDV

The monitor will have a PDV defined with the following format:

MONPDV ------> PDVBLK:  EXP .PVSYM+1    ;.PVCNT
                        [ASCIZ /MON/]   ;.PVNAM
                        EXP 0           ;.PVSTR
                        EXP 0           ;.PVREE
                        EXP VRSN        ;.PVVER
                        EXP 0           ;.PVMEM
                        EXP .+1         ;.PVSYM
(symbol table)          EXP 7           ;Count
                        .R50D!len       ;Defined symbols!length
PDVSYM:                 address         ;Address of symbols
                        0
                        .R50U!0         ;Undefined!length
PDVUSY:                 address         ;= address above
                        0


This means that only PDVSYM and PDVUSY have to  be  changed  when  the
symbol table is moved.

The monitor PDV will live in the RSDAT psect.



B.6  Linked Image

The output of LINK will be a linked image of the following layout (the
actual psect boundaries will vary with the size of the monitor):

        Page(s)         Contents

        0               Absolute storage
        1-223           RSCOD
        224             SZCOD
        225-231         INCOD
        232-240         RSDAT
        241-244         <space for PPVAR>
        245-360         <space for RSVAR>
        361-377         <space for NRVAR>
V6.1 ADDRESS SPACE WORK                                       Page B-4
Linked Image                                                 22 Jul 85


        400-415         <space for PSVAR>
        416-473         <space for JSVAR>
        474-721         NRCOD
        722-767         <space for NPVAR>
        770-777         <currently free>

        6000            <Not used>
        6001-6017       BGSTR
        6020-6022       BGPTR
        6023-6267       Symbol table
        6270-6473       <future expansion of symbol table>
        6474-x          XRCOD
         x+1-6721       XNCOD
        6732-6747       ERCOD (EDDT)
        6750-6774       ENCOD (MDDT)
        6775-6777       <Not used>

        37775-37777     POSTCD


POSTCD must run in an extended section in order to access section 6 of
the  linked image.  The monitor start address in the entry vector will
be set to 37,,SYSGO.  (SYSGO is the start address of POSTLD).   POSTLD
will  later set another entry vector that contains the monitor runtime
start address.



B.7  POSTLD

The image produced by BOOT is loaded into physical memory as is,  i.e.
all  things that must be accessible with paging turned off must be put
in section 0 of the image corresponding to the lowest  physical  256K.
These are:

      o  Resident code (RSCOD/SZCOD/INCOD)  and  resident  initialized
         data (RSDAT)

      o  Space for map pages (PPVAR) and resident variables (RSVAR)

      o  The symbol table

      o  EDDT (ERCOD)

      o  Space for BOOT (pages 750-777)


NRCOD has to be moved out of section 0 in order to make room  for  the
symbol  table.   The symbols can overlay NRVAR/PSVAR/JSVAR/NRCOD/NPVAR
but must leave a 10 page gap at the end before the start of EDDT.  (10
pages  =  number of CST's in extended section * 2 pages to map 512K of
physical memory).  Temporary CST's are  built  into  that  gap  during
pager initialization.
V6.1 ADDRESS SPACE WORK                                       Page B-5
POSTLD                                                       22 Jul 85


Section 1  of  the  POSTLD  image  contains  all  other  psects,  i.e.
BGSTR/BGPTR,  NRCOD,  XRCOD,  XNCOD and ENCOD.  BGSTR/BGPTR, X?COD and
ENCOD are moved into the same address within the section as  they  had
in  the  linked  image in section 6.  NRCOD cannot be moved into 'its'
location in section 1, since X?COD are already  there.   Hence,  NRCOD
will  be put right after BGSTR/BGPTR in section 1.  The CST tables are
put in physical memory between NRCOD and XRCOD, so there has to  be  a
gap  of  at  least  4  *  20 = 100 (octal) pages (assuming 4M of core)
between the top of NRCOD and the beginning of XRCOD.   This  leads  to
the following layout of the POSTLD image:

        Page(s)         Contents

        0-240           Absolute storage, RSCOD, SZCOD, INCOD, RSDAT
        241-360         Space for PPVAR and RSVAR
        361-625         Symbol table
        626-721         Future expansion of symbol table
        722-731         Reserved for temporary CST's
        732-747         ERCOD (EDDT)
        750-777         Space for BOOT

        1000            <Not used>
        1001-1017       BGSTR
        1020-1022       BGPTR
        1023-1250       NRCOD
        1251-1373       <Currently free>
        1374-1473       Permanent physical location of CST tables
        1474-x          XRCOD
           x-1721       XNCOD
        1722-1747       <Not used>
        1750-1774       ENCOD (MDDT)
        1775-1777       <Not used>


POSTLD will write some variables so the monitor  initialization  knows
where things are.  These variables are:

      o  FREMEM - address of the first  free  page  after  the  symbol
         table.  This is where the temporary CST's are built.

      o  PNRCOD - address of NRCOD after moving it to section 1

      o  PDVSYM/PDVUSY - symbol table pointers




B.8  EDDT in user mode

When EDDT is run in user mode, it must be mapped  out  of  its  POSTLD
location  in  section  0 to an extended section in order to be able to
reference all of the multi-section image.  NRCOD must be  mapped  into
its  runtime  location in section 0.  This means that the symbol table
has to be moved out of section 0 to make room for NRCOD.   To  support
V6.1 ADDRESS SPACE WORK                                       Page B-6
EDDT in user mode                                            22 Jul 85


patching  of  code  in the extended psects (living in section 1 of the
image) the pages  containing  FFF  must  be  mapped  into  section  1.
Finally, page 0 of section 0 has to be mapped into page 0 of section 1
to make the breakpoint blocks accessible in all sections.

The default section for EDDT in user mode  should  be  changed  to  be
section 0.

The DDTU (entry to EDDT) and DDTCZ (on ^Z) will be busy routines,  and
DDTU needs to do the following:

      o  Map symbol table and EDDT into section 37

      o  Map NRCOD into its runtime location in  section  0  from  its
         POSTLD location in section 1

      o  Map XRCOD and XNCOD into XCDSEC,  and  set  up  the  rest  of
         XCDSEC to map 1-1 to section 0.

      o  Put indirect pointers from 1,,RSDAT to 0,,RSDAT  to  enabling
         patching of section 1 code.  (FFF is located in psect RSDAT).

      o  Put an indirect pointer from page 1,,0 to  0,,0  to  map  the
         EDDT/MDDT breakpoint block into section 1.


DDTCZ will undo this mapping.

Patching to SWPF in extended psects will not be supported in user mode
EDDT.

The consequences to the user mode EDDT user are:

      o  Slower startup and exit from user mode EDDT

      o  No changes for referencing code in section 0.

      o  Patching to SWPF is not allowed in extended psects.

      o  Break points that are set in user mode may not be hit  before
         location  DDTIBP  in  PGRINI  has  been executed (i.e.  until
         paging is turned on).  Warning messages may be  generated  if
         breakpoints are set into SYMSEC in user mode EDDT.




B.9  BOOT

BOOT has to be modified to ignore a PDV entry  in  the  monitor's  EXE
directory.  No other changes are needed to BOOT.
V6.1 ADDRESS SPACE WORK                                       Page B-7
Monitor Initialization                                       22 Jul 85


B.10  Monitor Initialization

The pager initialization routine (PGRINI)  starts  off  with  the  two
sections  of  physical  memory  loaded  by  BOOT, and has to build the
virtual environment that the monitor is going to run in.  The  runtime
layout of sections 0/1, 5 and 6 are:

        Page(s)         Contents

        <Section 0 is mapped 1-1 with section 1 (currently)>

        1000            Absolute storage
        1000-1223       RSCOD
        1224            SZCOD
        1225-1231       INCOD
        1232-1240       RSDAT
        1241-1244       PPVAR
        1245-1360       RSVAR
        1361-1377       NRVAR
        1400-1415       PSVAR
        1416-1473       JSVAR
        1474-1721       NRCOD
        1722-1767       NPVAR
        1770-1777       <Currently free>

        5000            Mapped indirectly to section 0
        5001-5017       BGSTR
        5020-5022       BGPTR
        5023-5267       Symbol table
        5270-5367       CST tables
        5370-5731       Unmapped, for future expansion
        5732-5747       ERCOD (EDDT)
        5750-5767       ENCOD (MDDT)
        5770-5774       Unmapped, for future references
        5775-5777       MDDT private space, mapped to area in PSB

        6000-6473       Mapped indirectly to section 0/1
        6474-6..x       XRCOD
        6..x-6721       XNCOD
        6722-6767       Mapped indirectly to section 0/1


A few changes need to be made to  the  pager  initialization  code  to
support  the  new  locations  of  psects, and the new code section and
extended psects.  These are:

      o  The symbol table is currently moved into a temporary location
         just   after  monitor  start.   This  move,  along  with  the
         variables SYMMV1/SYMMV2/SYMMV3, is not needed any more  since
         POSTLD will put the symbols in the temporary location itself.
V6.1 ADDRESS SPACE WORK                                       Page B-8
Monitor Initialization                                       22 Jul 85


      o  There is a new permanent physical location for the CST's.

      o  Page 0 of SYMSEC is  set  up  with  an  indirect  pointer  to
         section  0/1.  (EDDT/MDDT breakpoint blocks).  No other parts
         of SYMSEC are mapped 1-1 with section 0/1.  Unused  pages  in
         SYMSEC should have a zero in the page map.

      o  The symbol table is mapped out to SYMSEC.

      o  The XCDSEC section is created.

      o  XCDSEC should be set up with indirect pointers to the section
         0/1 map.

      o  XRCOD and XNCOD are mapped into XCDSEC.

      o  There is a new POSTLD location for NRCOD, defined by PNRCOD.

      o  There is a new location for BGSTR/BGPTR psects.




B.11  EDDT in Executive Mode

Since the monitor now provides a PDV, it will be simpler for  EDDT  to
find the symbol table.  EDDT should pick up the pointer to the monitor
PDV from MONPDV, and use that to find the symbol table.

MDDT makes a few local references to data, currently relying on  parts
of section 0/1 being mapped into section 5.  Since this will no longer
be true,  the  following  references  to  the  following  section  0/1
locations have to be made global:
      o  DDTCZ
      o  MONPDV
      o  FORKX
      o  MDDLCK
      o  MDDFX
      o  MRETN
      o  SWPMWE
      o  SWPMWP


The EDDT and MDDT breakpoint blocks (EDDBLK and MDDBLK) must be mapped
into  any  section  in  which a breakpoint may be set.  The breakpoint
blocks live in page 0, and will be accessible from section 0/1, 5  and
6.
V6.1 ADDRESS SPACE WORK                                       Page B-9
Other Monitor Work                                           22 Jul 85


B.12  Other Monitor Work

The routines SWPMLK, SWPMUL, SWPMWE and SWPMWP  have  to  include  the
extended code when they are applied.



B.13  The Symbol Table

The symbol table lives a colourful life:

      o  It is loaded into section 6 by LINK.

      o  POSTLD moves the symbol table to section 0 in order  for  the
         symbols to be accessible to EDDT before paging is turned on.

      o  If user mode EDDT is run, then the symbols have to be  mapped
         out  of  section  0  (routine DDTU) to make room for NRCOD in
         section 0.  (Note:  this requires that EDDT  is  also  mapped
         into a non-zero section).

         When the user exits user mode EDDT, then the symbols have  to
         be mapped back into section 0 (routine DDTCZ).

      o  The symbols will be mapped into SYMSEC by PGRINI after boot.


The following relation must be true  to  fit  the  symbol  table  into
section 0 at boot time:

        symbol_table_size <= ERCOD - 1 - 10000 - NRVAR


I.e.  the symbols are put at virtual address NRVAR in section  0,  and
must  leave  a  gap  of  10  pages  (for  temporary  CST's) before the
beginning of EDDT.

The SNOOP% jsys has to be changed to locate the symbol  table  through
the PDV.

Issue:  is there any other code that relies on .JBSYM/.JBUSY?



B.14  How to Move Code to Extended Sections

All of section 0/1 except NRCOD will be mapped into the extended  code
section.   The  extended  code can make local references to all of the
resident code, to swappable variables (NRVAR)  and  to  resident  free
space  (NPVAR).  To call routines in the swappable monitor, or to call
a subroutine and transfer  to  section  1,  use  the  XCALL,  XJSP  or
XCALLRET macro.
V6.1 ADDRESS SPACE WORK                                      Page B-10
How to Move Code to Extended Sections                        22 Jul 85


These are used in the following way:

        XCALL (MSEC1,ASGRES)
        XJSP (CX,MSEC1,XYZW)
        XCALLRET (MSEC1,MRETN)


There is no psect containing data local to section 6.  Data storage is
defined  either  in  section  0/1  with  the  RS/NR-type macros, or in
extended storage with the RSE/NRE-type macros.

All entry points to extended code have  to  use  the  XRENT  or  XNENT
macro.   The  XRENT  macro defines an entry point to extended resident
code, and XNENT an entry point to extended swappable code.

Assume that an entry point D36INI is defined.  The format should be:

;D36INI - runs in extended swappable code
        XNENT D36INI
        STKVAR <A,B>
        code ....

The XNENT macro will do the following things:

      o  Define a label D36INI in NRCOD.

      o  Define a label XD36INI in psect XNCOD

      o  Jump to label XD36INI in section XCDSEC from D36INI in NRCOD.


A routine in section 1 can call an extended routine defined in the way
described by a simple

        CALL D36INI

since the transfer to XCDSEC will be made at D36INI in  NRCOD.   Note:
the caller has to be in section 1.



B.15  PSECT Restrictions and Boundaries

POSTLD will check for psect overlaps and other restrictions concerning
the relations of modules.  The symbols 'psect' and 'psectZ' define the
beginning and end of each psect.  The following relations are  checked
and enforced:

;First module
        RSCOD==1000

;Psect overlaps in section 0
        SZCOD > RSCODZ
        INCOD > SZCODZ
V6.1 ADDRESS SPACE WORK                                      Page B-11
PSECT Restrictions and Boundaries                            22 Jul 85


        RSDAT > INCODZ
        PPVAR > RSDATZ
        RSVAR > PPVARZ
        NRVAR > RSVARZ
        PSVAR > NRVARZ
        JSVAR > PSVARZ
        NRCOD > JSVARZ
        NPVAR > NRCODZ
        NPVARZ <= 777777

;Psect overlaps in section 6
        BGPTR = 6001000
        BGPTR > BGSTRZ
        SYPSX > BGPTRZ          SYPSX has symbol table
        XRCOD & 777777 = NRCOD & 777777         At NRCOD offset
        XNCOD > XRCODZ
        XNCODZ & 777777 < NPVAR & 777777
        ERCODZ & 777777 < 750000
        ENCOD > ERCODZ
        ENCODZ < 6775000

;Symbol table goes at offset NRVAR and must leave 10 pages before
; EDDT for temporary CST's
        symbol_table_size <= ERCOD - 1 - 10000 - NRVAR

;Verify that NRCOD and permanent CST's will fit between BGPTR and
; XRCOD.
        XRCOD & 777777 - BGPTRZ & 777777 >=
                NRCODZ - NRCOD + 100000

;Verify that FFF is in RSDAT, and that RSDAT, when mapped into section
; 1 by user mode EDDT, will overlay NRCOD
        RSDAT <= FFF <= RSDATZ
        PNRCOD & 777777 <= RSDAT <= (PNRCOD & 777777) + NRCODZ - NRCOD

;Verify that EDDBLK and MDDBLK is in page 0
        EDDBLK < 1000
        MDDBLK < 1000