TOPS-20
                              Operator's Guide
|                         Electronic Distribution



|                                June 1990

                  This manual gives the  operator  a  task
                  oriented reference for using the TOPS-20
                  operating system and  briefly  describes
                  the  hardware  supported  by the TOPS-20
                  operating system.

                  Change bars in margins indicate material
                  that has been added or changed since the
                  previous printing of this manual.

                  This version of the  guide  revises  the
                  document   having   the   order   number
                  AA-FP80B-TM for KL10 Model B information
                  only.



                  OPERATING SYSTEM:   TOPS-20 Version 7.0







                  digital equipment corporation
                  maynard, massachusetts




   First Printing, September 1985
   Revised, June, 1988
|  Revised, June 1990



   The information in this document is subject to change  without  notice
   and  should  not  be  construed  as  a commitment by Digital Equipment
   Corporation.  Digital Equipment Corporation assumes no  responsibility
   for any errors that may appear in this document.

   The software described in this document is furnished under  a  license
   and  may  only  be used or copied in accordance with the terms of such
   license.

   No responsibility is assumed for the use or reliability of software on
   equipment that is not supplied by Digital Equipment Corporation or its
   affiliated companies.


   Copyright  C 1985, 1988, 1990, Digital Equipment Corporation.

   All Rights Reserved.
   Printed in U.S.A.



   The following are trademarks of Digital Equipment Corporation:

   CI             DECtape     LA50             SITGO-10
   DDCMP          DECUS       LN01             TOPS-10
   DEC            DECwriter   LN03             TOPS-20
   DECmail        DELNI       MASSBUS          TOPS-20AN
   DECnet         DELUA       PDP              UNIBUS
   DECnet-VAX     HSC         PDP-11/24        UETP
   DECserver      HSC-50      PrintServer      VAX
   DECserver 100  KA10        PrintServer 40   VAX/VMS
   DECserver 200  KI          Q-bus            VT50
   DECsystem-10   KL10        ReGIS
   DECSYSTEM-20   KS10        RSX              d i g i t a l














                                     2




                                      CONTENTS



   PREFACE


   CHAPTER 1       RESPONSIBILITIES OF THE OPERATOR

           1.1     DOCUMENTATION  . . . . . . . . . . . . . . . . . . 1-1
           1.1.1     Documentation Supplied by DIGITAL  . . . . . . . 1-1
           1.1.2     Documentation Written at Your Installation . . . 1-2
           1.1.3     Documentation Written by Operators . . . . . . . 1-2
           1.2     OPERATOR'S TASKS . . . . . . . . . . . . . . . . . 1-3
           1.2.1     Hardware Tasks . . . . . . . . . . . . . . . . . 1-3
           1.2.2     Software Tasks . . . . . . . . . . . . . . . . . 1-3
           1.3     UNPRIVILEGED OPERATOR TASKS  . . . . . . . . . . . 1-3


   CHAPTER 2       HARDWARE

           2.1     OVERVIEW . . . . . . . . . . . . . . . . . . . . . 2-1
           2.2     CENTRAL PROCESSORS . . . . . . . . . . . . . . . . 2-3
           2.3     MEMORY . . . . . . . . . . . . . . . . . . . . . . 2-4
           2.4     DATA CHANNELS AND CONTROLLERS  . . . . . . . . . . 2-4
           2.5     CONSOLE FRONT-END PROCESSOR (2040S, 2060)  . . . . 2-4
           2.6     FLOPPY DISKS . . . . . . . . . . . . . . . . . . . 2-5
           2.7     PERIPHERALS  . . . . . . . . . . . . . . . . . . . 2-5
           2.7.1     Line Printers  . . . . . . . . . . . . . . . . . 2-5
           2.7.2     Card Readers . . . . . . . . . . . . . . . . . . 2-7
           2.7.3     Disk Packs . . . . . . . . . . . . . . . . . . . 2-8
           2.7.4     Magnetic Tape  . . . . . . . . . . . . . . . . . 2-9
           2.7.5     Terminals  . . . . . . . . . . . . . . . . . .  2-10


   CHAPTER 3       SOFTWARE

           3.1     OPERATING SYSTEMS AND OTHER MAJOR SOFTWARE 
                   COMPONENTS . . . . . . . . . . . . . . . . . . . . 3-1
           3.2     LANGUAGES  . . . . . . . . . . . . . . . . . . . . 3-1
           3.3     UTILITIES  . . . . . . . . . . . . . . . . . . . . 3-2


   CHAPTER 4       STARTING THE HARDWARE SYSTEM

           4.1     POWERING UP THE SYSTEM . . . . . . . . . . . . . . 4-2
           4.2     LOADING THE SYSTEM . . . . . . . . . . . . . . . . 4-3
           4.2.1     Loading from Disk Pack . . . . . . . . . . . . . 4-5
           4.2.2     Loading from Floppy Disks  . . . . . . . . . . . 4-9
           4.2.3     Loading Via the Switch Register  . . . . . . .  4-14
           4.3     LOADING THE TOPS-20 MONITOR  . . . . . . . . . .  4-19
           4.3.1     Loading TOPS-20 from a Disk Pack with BOOT . .  4-19


                                    iii




           4.3.2     Loading TOPS-20 from Magnetic Tape with MTBOOT  4-20
           4.4     ANSWERING MONITOR START-UP QUESTIONS . . . . . .  4-22
           4.5     READYING THE SYSTEM FOR TIMESHARING  . . . . . .  4-26
           4.5.1     Timesharing with Operator Coverage . . . . . .  4-30
           4.5.2     Timesharing without Operator Coverage  . . . .  4-31
           4.6     STARTING UP A SYSTEM IN A CFS-20 CLUSTER . . . .  4-32
           4.6.1     Virtual Circuits   . . . . . . . . . . . . . .  4-32
           4.6.2     CFS Connections  . . . . . . . . . . . . . . .  4-33


   CHAPTER 5       THE OPERATOR INTERFACE, OPR

           5.1     INTRODUCTION TO THE OPERATOR INTERFACE . . . . . . 5-1
           5.2     RUNNING OPR  . . . . . . . . . . . . . . . . . . . 5-2
           5.2.1     Remote Operator Control  . . . . . . . . . . . . 5-5
           5.2.1.1     DECnet and IBM Networks  . . . . . . . . . . . 5-5
           5.2.1.2     Local Area Networks  . . . . . . . . . . . . . 5-6
           5.2.1.3     CFS-20 Clusters  . . . . . . . . . . . . . . . 5-6
           5.2.2     Multiple Operators on the System . . . . . . . . 5-9
           5.3     OPR COMMAND FEATURES . . . . . . . . . . . . . . . 5-9
           5.3.1     ? (Question Mark) - Listing Available Commands  5-10
           5.3.2     ESCape - Using Recognition . . . . . . . . . .  5-10
           5.3.3     CTRL/H - Reprinting Faulty Commands  . . . . .  5-11
           5.3.4     Getting Help from OPR  . . . . . . . . . . . .  5-12
           5.4     ORION TO OPR MESSAGES  . . . . . . . . . . . . .  5-13
           5.4.1     Controlling OPR Message Output . . . . . . . .  5-14
           5.4.2     Controlling OPR Message Output in a CFS-20 
                     Cluster  . . . . . . . . . . . . . . . . . . .  5-17
           5.5     OPR ERROR MESSAGE DESCRIPTIONS . . . . . . . . .  5-20
           5.6     UNPRIVILEGED OPR . . . . . . . . . . . . . . . .  5-21


   CHAPTER 6       BATCH SOFTWARE TASKS

           6.1     BATCH SYSTEM COMPONENTS  . . . . . . . . . . . . . 6-1
           6.2     BATCH RESPONSIBILITIES . . . . . . . . . . . . . . 6-3
           6.3     CONTROLLING BATCH STREAMS  . . . . . . . . . . . . 6-3
           6.3.1     Setting Batch Stream Parameters  . . . . . . . . 6-4
           6.3.2     Starting Batch Streams . . . . . . . . . . . . . 6-5
           6.3.3     Stopping Batch Streams Temporarily . . . . . . . 6-6
           6.3.4     Continuing Batch Streams . . . . . . . . . . . . 6-6
           6.3.5     Shutting Down Batch Streams  . . . . . . . . . . 6-7
           6.3.6     Sending Messages to Batch Streams  . . . . . . . 6-7
           6.3.7     Displaying Batch Stream Parameters . . . . . . . 6-8
           6.3.8     Displaying Batch Stream Status . . . . . . . . . 6-9
           6.4     CONTROLLING BATCH JOBS . . . . . . . . . . . . .  6-10
           6.4.1     Examining Batch Jobs in the Queues . . . . . .  6-11
           6.4.2     Holding Batch Jobs . . . . . . . . . . . . . .  6-14
           6.4.3     Releasing Batch Jobs . . . . . . . . . . . . .  6-14
           6.4.4     Canceling Batch Jobs . . . . . . . . . . . . .  6-15
           6.4.5     Requeuing Batch Jobs . . . . . . . . . . . . .  6-16
           6.4.6     Modifying Batch Requests . . . . . . . . . . .  6-16


                                     iv




           6.4.7     Deleting Batch Requests  . . . . . . . . . . .  6-17
           6.4.8     Scheduling the Next Batch Request  . . . . . .  6-17
           6.5     CONTROLLING THE LINE PRINTER . . . . . . . . . .  6-18
           6.5.1     Setting the Line Printer . . . . . . . . . . .  6-19
           6.5.2     Starting the Line Printer  . . . . . . . . . .  6-20
           6.5.3     Stopping the Line Printer Temporarily  . . . .  6-21
           6.5.4     Continuing the Line Printer  . . . . . . . . .  6-22
           6.5.5     Shutting Down the Line Printer . . . . . . . .  6-22
           6.5.6     Displaying Line Printer Parameters . . . . . .  6-22
           6.5.7     Displaying Line Printer Status . . . . . . . .  6-24
           6.5.8     Assigning Aliases to Printers  . . . . . . . .  6-27
           6.5.9     Displaying Printer Aliases . . . . . . . . . .  6-28
           6.6     CONTROLLING FORMS ON THE LINE PRINTER  . . . . .  6-29
           6.6.1     The LPFORM.INI File  . . . . . . . . . . . . .  6-30
           6.6.2     Aligning Forms on the Line Printer . . . . . .  6-34
           6.6.3     Backspacing Forms on the Line Printer  . . . .  6-35
           6.6.4     Forwardspacing Forms on the Line Printer . . .  6-36
           6.6.5     Suppressing Carriage Control on the Line 
                     Printer  . . . . . . . . . . . . . . . . . . .  6-37
           6.7     CONTROLLING LINE PRINTER JOBS  . . . . . . . . .  6-38
           6.7.1     Examining Printer Jobs in the Queues . . . . .  6-38
           6.7.2     Holding Printer Jobs . . . . . . . . . . . . .  6-40
           6.7.3     Releasing Printer Jobs . . . . . . . . . . . .  6-41
           6.7.4     Canceling Printer Jobs . . . . . . . . . . . .  6-42
           6.7.5     Requeuing Printer Jobs . . . . . . . . . . . .  6-43
           6.7.6     Modifying Printer Requests . . . . . . . . . .  6-44
           6.7.7     Deleting Printer Requests  . . . . . . . . . .  6-44
           6.7.8     Sending Line Printer Output to Tape  . . . . .  6-45
           6.7.9     Printing Log and Spool Files on Designated 
                     Local Printers . . . . . . . . . . . . . . . .  6-48
           6.8     CONTROLLING THE CARD READER  . . . . . . . . . .  6-48
           6.8.1     Starting the Card Reader . . . . . . . . . . .  6-49
           6.8.2     Stopping the Card Reader . . . . . . . . . . .  6-50
           6.8.3     Continuing the Card Reader . . . . . . . . . .  6-50
           6.8.4     Shutting Down the Card Reader  . . . . . . . .  6-51
           6.8.5     Displaying Card Reader Status  . . . . . . . .  6-51
           6.9     CONTROLLING CARD READER JOBS . . . . . . . . . .  6-52
           6.10    CONTROLLING OTHER OUTPUT DEVICES . . . . . . . .  6-52
           6.10.1    Setting Output Devices . . . . . . . . . . . .  6-53
           6.10.2    The SPFORM.INI File  . . . . . . . . . . . . .  6-55
           6.10.3    Starting Output Devices  . . . . . . . . . . .  6-58
           6.10.4    Stopping Output Devices  . . . . . . . . . . .  6-58
           6.10.5    Continuing Output Devices  . . . . . . . . . .  6-59
           6.10.6    Shutting Down Output Devices . . . . . . . . .  6-59
           6.10.7    Displaying Output Device Parameters  . . . . .  6-60
           6.10.8    Displaying Output Device Status  . . . . . . .  6-61
           6.11    CONTROLLING JOBS ON OUTPUT DEVICES . . . . . . .  6-62
           6.11.1    Examining Output Device Jobs in the Queues . .  6-62
           6.11.2    Holding Output Device Jobs . . . . . . . . . .  6-64
           6.11.3    Releasing Output Device Jobs . . . . . . . . .  6-65
           6.11.4    Canceling Output Device Jobs . . . . . . . . .  6-66
           6.11.5    Requeuing Output Device Jobs . . . . . . . . .  6-66


                                     v




           6.11.6    Modifying Output Device Requests . . . . . . .  6-67
           6.11.7    Deleting Output Device Requests  . . . . . . .  6-68
           6.11.8    Scheduling the Next Output Device Request  . .  6-68


   CHAPTER 7       UNSCHEDULED SOFTWARE TASKS

           7.1     CONTROLLING THE SCHEDULER  . . . . . . . . . . . . 7-1
           7.1.1     Changing Class Scheduling  . . . . . . . . . . . 7-1
           7.1.1.1     Changing a Job's Scheduling Class  . . . . . . 7-2
           7.1.2     Changing Batch-Class Scheduling  . . . . . . . . 7-2
           7.1.3     Changing Bias-Control Scheduling . . . . . . . . 7-3
           7.1.4     Displaying Scheduler Status  . . . . . . . . . . 7-3
           7.2     SETTING DEVICES ON-LINE  . . . . . . . . . . . . . 7-4
           7.3     CONTROLLING THE ORION LOG BUFFER FILE  . . . . . . 7-6
           7.4     INITIALIZING TAPES . . . . . . . . . . . . . . . . 7-7
           7.5     HANDLING USER MOUNT REQUESTS . . . . . . . . . .  7-14
           7.5.1     Displaying Tape Drive Status . . . . . . . . .  7-15
           7.5.2     Controlling Automatic Volume Recognition (AVR)  7-18
           7.5.3     Mounting Labeled Tapes with AVR Enabled  . . .  7-19
           7.5.4     Mounting Labeled Tapes With AVR Disabled . . .  7-20
           7.5.5     Mounting Unlabeled Tapes . . . . . . . . . . .  7-21
           7.5.6     Canceling Mount Requests . . . . . . . . . . .  7-22
           7.5.7     Setting Tape Drives Available or Unavailable .  7-23
           7.6     ARCHIVING FILES WITH DUMPER  . . . . . . . . . .  7-23
           7.7     RUNNING THE REAPER PROGRAM . . . . . . . . . . .  7-27
           7.8     MIGRATING FILES WITH DUMPER  . . . . . . . . . .  7-32
           7.9     RETRIEVING FILES WITH DUMPER . . . . . . . . . .  7-36
           7.10    RESTORING DISK FILES WITH DUMPER . . . . . . . .  7-43
           7.11    ANSWERING STRUCTURE MOUNT REQUESTS WITH OPR  . .  7-47
           7.11.1    Mounting a Structure with MOUNT  . . . . . . .  7-50
           7.11.2    Answering Structure DISMOUNT Requests with OPR  7-53
           7.11.3    Removing a Structure with DISMOUNT . . . . . .  7-55
           7.11.4    Canceling Mount Requests . . . . . . . . . . .  7-61
           7.11.5    Setting Disk Drives Available or Unavailable .  7-62
           7.12    SETTING THE PORT CI AVAILABLE/UNAVAILABLE  . . .  7-63
           7.12.1    Displaying Disk Drive Status . . . . . . . . .  7-68
           7.12.2    Displaying Disk Drive Serial Numbers . . . . .  7-70
           7.12.3    Displaying Structure Status  . . . . . . . . .  7-71
           7.12.4    Setting the NI PORT AVAILABLE/UNAVAILABLE  . .  7-75
           7.13    EXAMINING MOUNT-REQUESTS IN THE QUEUE  . . . . .  7-76
           7.14    CREATING A STRUCTURE DURING TIMESHARING  . . . .  7-77
           7.15    COMMUNICATING WITH USERS . . . . . . . . . . . .  7-81
           7.15.1    Answering PLEASE Requests with OPR . . . . . .  7-81
           7.15.2    Talking to Another User Immediately with SEND   7-83
           7.15.3    Mailing a Message for a User to Read Later . .  7-84
           7.15.4    Reading Your Messages with RDMAIL  . . . . . .  7-86
           7.16    HELPING A USER WITH TERMINAL PROBLEMS  . . . . .  7-87
           7.17    LOGGING OUT A USER WITH LOGOUT . . . . . . . . .  7-90
           7.18    GENERATING ACCOUNTING REPORTS  . . . . . . . . .  7-92
           7.18.1    Getting Disk and System Usage with CHKPNT  . .  7-92
           7.18.2    Reporting Usage with USAG20  . . . . . . . . .  7-94


                                     vi




   CHAPTER 8       SCHEDULED SOFTWARE TASKS

           8.1     SETTING LOGINS-ALLOWED AND OPERATOR-IN-ATTENDANCE  8-1
           8.2     CREATING THE MESSAGE OF THE DAY WITH MAIL  . . . . 8-3
           8.3     ENTERING ACCOUNT VALIDATION DATA WITH EDIT . . . . 8-5
           8.4     UPDATING THE ACCOUNT VALIDATION DATA BASE WITH 
                   ACTGEN . . . . . . . . . . . . . . . . . . . . . . 8-7
           8.5     ADDING, CHANGING, AND DELETING DIRECTORIES WITH 
                   ^ECREATE . . . . . . . . . . . . . . . . . . . . . 8-9
           8.5.1     Adding Directories for Users . . . . . . . . . . 8-9
           8.5.2     Adding Directories on Mountable Structures   .  8-11
           8.5.3     Adding Files-Only Directories  . . . . . . . .  8-12
           8.5.4     Changing Directory Parameters  . . . . . . . .  8-13
           8.5.5     Changing Directory Names . . . . . . . . . . .  8-14
           8.5.6     Deleting User Names or Directories . . . . . .  8-17
           8.6     DUMPING DIRECTORY PARAMETERS WITH DLUSER . . . .  8-21
           8.6.1     Dumping Directory Parameters for BS: . . . . .  8-21
           8.6.2     Dumping Directory Parameters for Other 
                     Structures . . . . . . . . . . . . . . . . . .  8-22
           8.6.3     Using DLUSER . . . . . . . . . . . . . . . . .  8-23
           8.7     GETTING INFORMATION ABOUT DIRECTORIES  . . . . .  8-26
           8.7.1     Listing Directory Parameters with ^ECREATE . .  8-26
           8.7.2     Listing Directory Parameters with ^EPRINT  . .  8-28
           8.7.3     Listing Directory Parameters with ULIST  . . .  8-30
           8.8     CHECKING SYSTEM STATUS . . . . . . . . . . . . .  8-38
           8.8.1     Determining the Status of Jobs with SYSTAT . .  8-38
           8.8.2     Watching System and Job Statistics with WATCH   8-40
           8.8.3     Getting Other Information  . . . . . . . . . .  8-42
           8.9     LISTING USER REMARKS WITH RDMAIL . . . . . . . .  8-43
           8.10    REPORTING SYSTEM ERRORS WITH SPEAR . . . . . . .  8-46
           8.11    BACKING UP DISK FILES WITH DUMPER  . . . . . . .  8-48
           8.12    ENDING TIMESHARING WITH ^ECEASE  . . . . . . . .  8-55


   CHAPTER 9       ERROR RECOVERY PROCEDURES

           9.1     AUTOMATICALLY RELOADING AND DUMPING THE SYSTEM . . 9-1
           9.1.1     Dumping the System for "Continuable" Errors  . . 9-3
           9.2     MANUALLY RELOADING AND DUMPING THE SYSTEM  . . . . 9-3
           9.2.1     Scheduled Reloads  . . . . . . . . . . . . . . . 9-3
           9.2.2     Reloads and Dumps for a Hung or Looping System . 9-4
           9.3     SETTING THE CORRECT DATE AND TIME  . . . . . . . . 9-5
           9.4     ERROR MESSAGES AND ACTION TO TAKE  . . . . . . . . 9-6
           9.4.1     Device Error Messages  . . . . . . . . . . . . . 9-6
           9.4.2     BUGCHKs, BUGINFs, and BUGHLTs  . . . . . . . . . 9-8
           9.4.3     HOME Block or BAT Block Inconsistencies  . . .  9-12
           9.4.3.1     HOME Block Message . . . . . . . . . . . . .  9-13
           9.4.3.2     BAT Block Messages . . . . . . . . . . . . .  9-14
           9.4.4     Parity Errors  . . . . . . . . . . . . . . . .  9-15
           9.4.5     DX20 Error Messages  . . . . . . . . . . . . .  9-16
           9.4.6     Reaper Error Messages  . . . . . . . . . . . .  9-16
           9.4.7     Tape Handling Error Messages . . . . . . . . .  9-18


                                    vii




           9.4.8     Bootstrap Error Messages . . . . . . . . . . .  9-20
           9.5     RECOVERING THE FILE SYSTEM . . . . . . . . . . .  9-24
           9.5.1     Rebuilding a Directory Symbol Table with 
                     EXPUNGE  . . . . . . . . . . . . . . . . . . .  9-24
           9.5.2     Reconstructing a Directory . . . . . . . . . .  9-25
           9.5.2.1     Deleting a Directory . . . . . . . . . . . .  9-25
           9.5.2.2     Re-Creating a Directory and Restoring Its 
                       Files  . . . . . . . . . . . . . . . . . . .  9-27
           9.5.3     Reconstructing the ROOT-DIRECTORY  . . . . . .  9-28
           9.5.4     Re-Creating the File System or a Structure . .  9-30
           9.5.4.1     Re-Creating the System Structure and 
                       Front-End File System  . . . . . . . . . . .  9-31
           9.5.4.2     Re-Creating Other Structures . . . . . . . .  9-32
           9.6     DIAGNOSING YOUR SYSTEM FROM A REMOTE LOCATION VIA 
                   KLINIK . . . . . . . . . . . . . . . . . . . . .  9-34
           9.7     CORRECTING DISK SPACE WITH CHECKD  . . . . . . .  9-38
           9.7.1     Reports from CHECK BITTABLE  . . . . . . . . .  9-45
           9.8     RESTARTING PROGRAMS UNDER SYSJOB . . . . . . . .  9-50
           9.8.1     GALAXY Crash Recovery Procedures . . . . . . .  9-52
           9.9     HUNG CONSOLE TERMINAL  . . . . . . . . . . . . .  9-56
           9.10    MEMORY CONFIGURATION FAILED  . . . . . . . . . .  9-57
           9.11    TOPS-20 MONITOR NOT FOUND  . . . . . . . . . . .  9-57
           9.12    PS NOT FOUND . . . . . . . . . . . . . . . . . .  9-58
           9.13    BOOTSTRAP LOAD FAILED  . . . . . . . . . . . . .  9-59
           9.14    MANUALLY RELOADING THE DX20  . . . . . . . . . .  9-59


   INDEX


   TABLES

           2-1     Line Printer Identification  . . . . . . . . . . . 2-6
           2-2     LP20 Printer Models  . . . . . . . . . . . . . . . 2-7
           2-3     CD20 Card-Reader Models  . . . . . . . . . . . . . 2-8
           2-4     Magnetic Tape Drives . . . . . . . . . . . . . .  2-10
           2-5     Terminals  . . . . . . . . . . . . . . . . . . .  2-11
           4-1     Switch Register Bit Definitions  . . . . . . . .  4-15
           5-1     Remote Operator Commands Given from Your Local 
                   Terminal . . . . . . . . . . . . . . . . . . . . . 5-8
           6-1     LPFORM.INI Switches  . . . . . . . . . . . . . .  6-31
           6-2     SPFORM.INI Switches for All Device Types . . . .  6-56
           6-3     SPFORM.INI Switches for Plotter Devices Only . .  6-56
           7-1     SET INITIALIZE Switches  . . . . . . . . . . . . . 7-8
           7-2     REAPER Commands  . . . . . . . . . . . . . . . .  7-27
           9-1     GALAXY Component Crash Recovery Procedures . . .  9-53








                                    viii
















                                  PREFACE



   This guide gives  you,  the  operator,  an  overview  of  the  TOPS-20
   operating system and serves as a task-oriented reference for operating
   the various hardware components that  support  the  TOPS-20  software.
   The  following  paragraphs  give  a  brief  description of the type of
   information contained in each chapter.

        Chapter  1  provides  a  brief  description  of  the   operator's
        responsibilities and the documentation supplied either by DIGITAL
        or by personnel at your installation.

        Chapter 2 describes the various  CPUs,  memory  types,  front-end
        responsibilities,  and  the  peripherals  that are handled by the
        front-end processor.

        Chapter  3  briefly  describes   the   major   TOPS-20   software
        components.

        Chapter 4 describes the  various  ways  of  loading  the  system,
        loading  the  monitor  using  the various media, and readying the
        system for timesharing.

        Chapter 5 introduces the  operator  interface  command  language,
        OPR.

        Chapter 6 describes all software tasks for the  TOPS-20  (GALAXY)
        batch system.

        Chapter 7 describes those tasks that are  generally  done  on  an
        infrequent  schedule and those tasks that are performed only when
        requested.

        Chapter 8 describes the tasks that  are  usually  included  in  a
        daily schedule.

        Chapter 9 describes the error recovery procedures.



                                     ix




   Although various installations may run their systems differently, this
   guide  describes  a  general set of procedures for running the TOPS-20
   software on the various hardware systems.   Each  installation  should
   tailor  these  procedures  to  suit  its  needs and add procedures for
   specific applications.

   This guide assumes that  you  have  read,  understood,  and  used  the
   TOPS-20  User's  Guide.   In  some  cases this guide refers to another
   manual for additional  information,  or  your  installation  may  have
   purchased  some software in addition to the standard TOPS-20 software.
   For example, this manual does not include the operating procedures for
   ARPANET and DECnet.  Therefore, you should have the latest editions of
   the following documents available:

        1.  TOPS-20 Command Reference Manual

        2.  TOPS-20 User's Guide

        3.  TOPS-20 Operator's Command Language Reference Manual

        4.  TOPS-20 Software Installation Guide

        5.  TOPS-20 KL10 Model B Installation Guide

        6.  TOPS-10/20 USAGE File Specification

        7.  TOPS-10 and TOPS-20 SPEAR Manual

        8.  TOPS-20 DECnet-20 Manuals
            (if your installation has DECnet-20 software)

        9.  IBM Emulation/Termination Manual
            (if your installation has DN64/DN65 software)

       10.  BUGHLT Document

       11.  RSX-20F System Reference Manual

       12.  TOPS-10/TOPS-20 Operator's Hardware  Device  and  Maintenance
            Guide

   You may also want to have  available  the  error  messages  listed  in
   Appendix  A of the TOPS-20 Monitor Calls Reference Manual when you see
   an error message not documented in this guide.










                                     x




   This guide uses the following conventions:

        CTY                 means console terminal.

        PTY                 means pseudo-terminal.

        <RET>               indicates that you press the RETURN key.

        CTRL/character      indicates that you hold  the  CTRL  key  down
                            while typing the character.

        ^character          is the output from typing CTRL/character  or,
                            if otherwise noted, indicates that you should
                            first type the up-arrow  and  then  type  the
                            character.

        underlining         indicates the information that you must  type
                            at your terminal.

        n-                   refers to the latest version of a particular
                            file, for example, 7-CONFIG.CMD.

































                                     xi


























































                                    1-1













                                 CHAPTER 1

                      RESPONSIBILITIES OF THE OPERATOR



   As the TOPS-20 operator, you are responsible for  keeping  the  system
   running  and providing the user with the best possible service.  To do
   this, you must be aware of all the system resources available to  you,
   know  how  to  interact with the system and with users, and be able to
   recognize and solve problems before they become serious.

   Your first task in starting the system is to load  the  front-end  and
   main  processor  monitors.   After that, the system starts a series of
   programs to support batch and timesharing users.  Once the  system  is
   started,  you must check the status of jobs, respond to user requests,
   and perform routine tasks such as replenishing the paper supply for  a
   line printer or cleaning magnetic tape drives.

   Because the system is complex, sometimes a monitor ceases to  function
   and   crashes.   A  crash  may  result  from  software  (programming),
   hardware, or environmental problems.  When a crash  occurs,  you  must
   recognize  the  symptoms, take the appropriate corrective steps to get
   the system  back  up  as  quickly  as  possible,  and  save  important
   information about the crash.



   1.1  DOCUMENTATION

   To keep informed of your responsibilities and to perform the necessary
   operator  tasks,  you should read and have available for reference all
   documentation relevant to an operator.  Documentation is  supplied  by
   DIGITAL,  your  installation,  and  other  operators.   The next three
   sections describe the documentation available from these sources.



   1.1.1  Documentation Supplied by DIGITAL

   DIGITAL supplies many manuals for the TOPS-20 operating system.  Those
   helpful  to  you  as  an  operator,  in  addition  to this manual, are
   mentioned in the Preface.


                                    1-1

                      RESPONSIBILITIES OF THE OPERATOR


   DIGITAL also supplies some text files on the magnetic tapes  used  for
   software  distribution.   These  files can be identified by their file
   types:  .HLP, .MEM, .BWR, or .DOC.  These files are usually in a  disk
   directory  from which you can have them printed or have them typed out
   on a hard-copy terminal.



   1.1.2  Documentation Written at Your Installation

   Your installation personnel may add some text files to the system that
   can be printed or typed.

   You should also have a list  of  specific  duties  for  each  operator
   shift.   This  list  should  be  written  by  the  system  manager and
   operations staff, using this manual as  a  guide.   Your  installation
   personnel  can  also  tailor this manual to their needs.  For example,
   installation-specific instructions,  such  as  locking  computer  room
   doors, finding paper, and running application programs, can be added.



   1.1.3  Documentation Written by Operators

   Your system manager should give  you  an  operator's  notebook  and  a
   system  logbook  that  contain  pages you must fill out to record what
   happens systemwide.

   The operator's notebook is used to record shift-to-shift communication
   among operators, and between operators and the system manager.  Always
   read it before you begin your shift.  Notebook entries  might  include
   scheduled  system  downtime,  new software to install or try, problems
   met on preceding shifts, and specific instructions not in  the  normal
   schedule.

   The system logbook is used to note important events  relative  to  the
   system  availability.   The  entries  should  include system downtime,
   hardware problems, and system shutdown time.  To  identify  the  items
   easily,  separate  hardware  and  software  entries,  perhaps  listing
   hardware entries on left-hand pages and software entries on right-hand
   pages.  Check this log when you start work; be sure to keep it current
   throughout your shift.

   You should also save the output from the  CTY.   Your  system  manager
   should  determine how long to keep it and where to file it.  It can be
   a useful reference when there are system problems.








                                    1-2

                      RESPONSIBILITIES OF THE OPERATOR


   1.2  OPERATOR'S TASKS

   To keep  a  system  running  efficiently,  you  must  perform  certain
   hardware  and software tasks.  These tasks may be performed on a daily
   or weekly basis, or performed as they are required.   Chapters  6,  7,
   and 8 describe the batch tasks and scheduled and unscheduled tasks.



   1.2.1  Hardware Tasks

   Hardware  tasks  include  performing   preventative   maintenance   on
   peripheral  devices,  replenishing  paper  for  input/output  devices,
   operating the hardware components  of  the  system,  and  keeping  the
   computer room clean.  Chapter 2 describes these devices.  Refer to the
   TOPS-10/TOPS-20 Operator's Hardware Device and Maintenance Guide for a
   full description of these tasks.



   1.2.2  Software Tasks

   Software tasks include loading and starting  the  system,  interacting
   with  users,  and  performing  error  recovery  procedures.  Chapter 4
   describes loading and starting  the  system,  Chapters  6,  7,  and  8
   describe the batch tasks and scheduled and unscheduled software tasks,
   and Chapter 9 describes the error recovery procedures.



   1.3  UNPRIVILEGED OPERATOR TASKS

   Your system manager may have granted the  SEMI-OPERATOR  privilege  to
   some  users.   When  enabled,  this  privilege limits operator-related
   activity  to  accessing  system  status  information  and  controlling
   certain devices specified at installation for semi-operator access.

   The SEMI-OPERATOR privilege provides unprivileged users with  valuable
   information  and  device control that was available only to privileged
   operators in older versions of TOPS-20.

   You can enable and disable the SEMI-OPERATOR privilege systemwide,  as
   described in Section 5.6.











                                    1-3


























































                                    2-1













                                 CHAPTER 2

                                  HARDWARE



   2.1  OVERVIEW

   To improve your understanding of  the  system,  this  chapter  briefly
   describes the -20 series hardware.

   You can use the TOPS-20 operating  system  with  the  2040S  and  2060
   series  hardware  models.  The 2040S and the 2060 are identical except
   that the 2060 has cache memory.

   Configurations for the 2040S system are:

         o  20-128 jobs

         o  768K-4Mw MOS memory

         o  8-128 local command terminals on RSX20F

         o  2-8 RH20 channels

         o  1-64 RP04 or RP06 disk drives

         o  1-4 RP20 disk drives

         o  1-4 RP07 disk drives

         o  5 RP20 spindles (disk units) per structure

         o  1 RP07 disk pack per structure

         o  1-6 RP04 disk packs per structure

         o  1-3 RP06 disk packs per structure

         o  1-4 TM02 or TM03 tape controllers

         o  1-2 TM78 tape controllers

         o  1-16 TU45, TU77, or TU78/79 tape drives

                                    2-1

                                  HARDWARE


         o  1-2 DX20 tape or disk controllers

         o  1-2 TX02 (1 per DX20) with TX03 and TX05 switch features

         o  1-16 TU70, TU71, or TU78/79 tape drives (at least one 9-track
            tape drive)

         o  1-2 line printers

         o  0-1 card reader

   Configurations for the 2060 system are:

         o  20-128 jobs

         o  768K-4Mw MOS memory

         o  8-128 local-command terminals on RSX20F and/or LATs

         o  2-8 RH20 channels

         o  1-64 RP04 or RP06 disk drives

         o  1-4 RP20 disk drives

         o  1-4 RP07 disk drives

         o  5 RP20 spindles (disk units) per structure

         o  1 RP07 disk pack per structure

         o  1-6 RP04 disk packs per structure

         o  1-3 RP06 disk packs per structure

         o  1 NI20 per KL10 processor

         o  1 CI20 per KL10 processor

         o  1-3 HSC50 disk controllers per CI20

         o  1-20 RA60 disk drives per HSC50

         o  1-20 RA81 disk drives per HSC50

         o  1-5 RA81 spindles per structure

         o  1-6 RA60 spindles per structure

         o  1-4 TM02 or TM03 tape controllers

         o  1-2 TM78 tape controllers


                                    2-2

                                  HARDWARE


         o  1-16 TU45, TU77, or TU78/79 tape drives

         o  1-2 DX20 tape or disk controllers

         o  1-2 TX02 (1 per DX20) with TX03 and TX05 switch features

         o  1-16 TU70, TU71, or TU72 tape drives (at  least  one  9-track
            tape drive)

         o  1-2 line printers

         o  0-1 card reader

   In addition to the configurations listed above for  the  2060  system,
   the Common File System (CFS-20) configuration requires the following:

         o  2 to 4 2060 systems

         o  1-4Mw Memory per system

         o  1 CI20 per system

         o  1 Star Coupler

                                    NOTE

           Each CFS-20 system requires an RP04 or RP06 disk drive
           for  the  front end file system.  The system structure
           can reside on this disk or on another RP04,  RP06,  or
           RP07  disk;  or be a supported multi-disk RP04 or RP06
           structure.  The system structure cannot reside  on  an
           RP20  disk  or  on  a  disk  controlled  by  an HSC-50
           controller.



   2.2  CENTRAL PROCESSORS

   The KL10 central processor, which  directs  the  entire  operation  of
   2040S and 2060 systems, contains:

        1.  A microcoded instruction set (383 instructions)

        2.  Fast integrated-circuit general-purpose registers

        3.  Interrupt and trap facilities

   The  central  processor,  memory,  and  mass-storage  controllers  are
   contained in two cabinets.





                                    2-3

                                  HARDWARE


   2.3  MEMORY

   There are four types of memory storage units  available  for  the  -20
   series  hardware:   MA20  or  MB20  internal  memory, and MF20 or MG10
   memory.

   The size of memory storage ranges from 768K to 4  megawords  (K=1024).
   Internal  memory  can  be  1-,  2-,  or 4-way interleaved.  You cannot
   specify  interleaving  for  MOS  memory;  however,  it  is  implicitly
   interleaved.  Each word of memory has 36 bits of data.



   2.4  DATA CHANNELS AND CONTROLLERS

   The data channels and controllers provide the interface  between  mass
   storage  devices  (disk  and  magnetic  tape)  and  main  memory.  The
   controllers are units that control the operation of one or  more  disk
   drives   or  tape  drives.   The  channels  in  conjunction  with  the
   controllers transfer information to memory at the request of the  CPU.
   The  channel  that interfaces the DECSYSTEM-20 memory to massbus disks
   and tapes is the RH20.  The channel that interfaces  the  DECSYSTEM-20
   memory  to  the  CI  is  the  CI20.   In  a CFS configuration, another
   DECSYSTEM-20 can be connected to the same CI by means of its own CI20.

   A DX20 tape controller  with  the  TX02  controller  and  channel  can
   support  a  maximum  of  eight  TU70, 71, or 72 tape drives.  With the
   TX03/TX05 tape switch options, a system can address and use up  to  16
   tape  drives  on  a  single controller by switching the access of tape
   drives from one controller to another.

   A DX20 disk controller can support up to eight RP20 disks.  Each  RP20
   disk  unit  has  two spindles.  An HSC50 disk controller can support a
   maximum of 24 RA60 or RA81 disk drives.



   2.5  CONSOLE FRONT-END PROCESSOR (2040S, 2060)

   The console front-end processor is a PDP-11 computer and  is  included
   in 2040S and 2060 systems.  The console front-end handles:

        1.  Line printers

        2.  Card reader

        3.  Floppy disks

        4.  Terminals

        5.  Console functions



                                    2-4

                                  HARDWARE


        6.  Microcode loading

        7.  Memory configuration

        8.  System startup

        9.  Diagnostics

   The console front-end processor is in the cabinet to the left  of  the
   two  cabinets  containing  the central processor, internal memory, and
   mass-storage   controllers.    The   console    front-end    processor
   communicates  with  the central processor through the DTE20 interface.
   The front-end memory consists of 28K of 18-bit words (16 data bits and
   2 parity bits).  The floppy disks are used for initial system loading.



   2.6  FLOPPY DISKS

   Three floppy disks are  distributed  with  each  new  version  of  the
   TOPS-20  front-end  software.   They  are  small,  about  the size and
   appearance of a 45 rpm record, very flexible, magnetic-storage  media.
   Their  main  functions include loading and starting the PDP-11 and the
   KL10.  They are also used to  run  diagnostics  that  pertain  to  the
   front-end processor.



   2.7  PERIPHERALS

   On the 2040S and 2060 systems, the UNIBUS (unipath  bus)  handles  all
   the  communication  lines  between the front-end processor and all the
   devices that are attached to the front-end.

   The standard -20 series hardware peripherals are described below.



   2.7.1  Line Printers

   A maximum of two physical line printers is allowed on 2040S  and  2060
   systems.

   The following is a partial list of the supported  line  printers.   If
   you  have  a line printer that is not mentioned in this section, refer
   to the appropriate line-printer documentation for its characteristics.

        1.  The LP05-V with a 64-character print  set,  a  speed  of  300
            lines  per minute, and a direct access, vertical format unit.
            This printer is included in the  LP20A  line  printer  system
            (printer and controller).



                                    2-5

                                  HARDWARE


        2.  The LP05-W with a 96-character print  set,  a  speed  of  230
            lines  per minute, and a direct access, vertical format unit.
            This printer is included in the  LP20B  line  printer  system
            (printer and controller).

        3.  The LP07 impact printer with a quick-change,  dual  character
            set  Charaband  (64/96  characters),  dual  speed of 1200/900
            lines per minute, and direct access,  vertical  format  unit.
            This  line  printer  is  included  in  the LP200 line printer
            system (printer and controller).

        4.  The LP10-J with a 64-character print set,  a  speed  of  1250
            lines per minute, and a standard sprocketed carriage tape for
            the vertical format unit.  This printer is  included  in  the
            LP20F line printer system (printer and controller).

        5.  The LP10-K with a 96-character print  set,  a  speed  of  925
            lines per minute, and a standard sprocketed carriage tape for
            the vertical format unit.  This printer is  included  in  the
            LP20H line printer system (printer and controller).

        6.  The LP14-V with a 64-character print  set,  a  speed  of  890
            lines  per minute, and a direct access, vertical format unit.
            This printer is included in the  LP20C  line  printer  system
            (printer and controller).

        7.  The LP14-W with a 96-character print  set,  a  speed  of  650
            lines  per minute, and a direct access, vertical format unit.
            This printer is included in the  LP20D  line  printer  system
            (printer and controller).




   Table 2-1:  Line Printer Identification

   ______________________________________________________________________

     Type              Description              Control Panel
   ______________________________________________________________________

     LP05              Small size;              Six     error-indicator
     LP14              control panel            lights,    four   push-
                       on top right.            button switch-indicator
                                                lights,  and two toggle
                                                switches.

     LP10              Large size;              Five     (two-position)
                       control panel            switches,  four   white
                       on top left.             indicator lights,  four
                                                red  error  lights, and
                                                two dial knobs.


                                    2-6

                                  HARDWARE


     LP07              Large size;              Five     (two-position)
                       control panel            switches,  four   white
                       on top left;             indicator  lights, four
                       metal plate              red  error  lights, and
                       that can be              two dial knobs.
                       lifted covers
                       part of control
                       panel.
   ______________________________________________________________________


   Refer  to  the  TOPS-10/TOPS-20   Operator's   Hardware   Device   and
   Maintenance Guide for pictures of various line printers.

   All  the  line  printers  are  132-column  devices.   Those  with  the
   96-character  print set have uppercase and lowercase characters.  Each
   printer has a Vertical Format  Unit,  or  VFU,  which  consists  of  a
   carriage  control  tape  depending  on  the model.  The VFU is used to
   control paper motion in the printer.   The  preceding  information  is
   summarized in Table 2-2 below.


   Table 2-2:  LP20 Printer Models

   ______________________________________________________________________

             Character                 Characters
     Model       Set      Print Speed  Per Drum    VFU           System
   ______________________________________________________________________

     LP05-V  UPPER        300 l/m        64        PROGRAMMABLE  LP20A

     LP05-W  UPPER/LOWER  230 l/m        96        PROGRAMMABLE  LP20B

     LP07    UPPER and    1200/900 l/m   64/96     PROGRAMMABLE/ LP200
             UPPER/LOWER                           TAPE

     LP10-J  UPPER        1250 l/m       64        TAPE          LP20F

     LP10-K  UPPER/LOWER  925 l/m        96        TAPE          LP20H

     LP14-V  UPPER        890 l/m        64        PROGRAMMABLE  LP20C

     LP14-W  UPPER/LOWER  650 l/m        96        PROGRAMMABLE  LP20D
   ______________________________________________________________________



   2.7.2  Card Readers

   Card readers are mainly used in batch processing.  The card reader  is
   an  input  device  only.   The card reader can be a table model CR10-E


                                    2-7

                                  HARDWARE


   (Model M200) that processes 285 cards per minute, or the console model
   CR10-F  (Model RS1200) that processes 1200 cards per minute.  Only the
   RS1200 has a mechanical EOF button.  Model M200 is included in a CD20A
   card-reader system, and Model RS1200 is included in a CD20C system.

   The CD11 card-reader controller is included in CD20 card-reader system
   (controller and reader).


   Table 2-3:  CD20 Card-Reader Models

   ______________________________________________________________________

     Type           Model                   System            Speed
   ______________________________________________________________________

     CR10-E         Table-M200              CD20A             285 cpm

     CR10-F         Console-RS1200          CD20C             1200 cpm
   ______________________________________________________________________



   2.7.3  Disk Packs

   Disk storage allows rapid transfer of data in and out of main  memory.
   The 2040S and 2060 systems require at least one disk be dual-ported so
   that the front-end computer and the central processor can both  access
   the data on the disk.

   The disk packs that the 2040S and 2060 systems support are:

        1.  The RP04 removable disk pack, which  has  a  20-million  word
            (36-bit word) capacity

        2.  The RP06 removable disk pack, which  has  a  40-million  word
            (36-bit word) capacity

        3.  The RP07 non-removable disk pack, which  has  a  112  million
            word (36-bit word) capacity.

        4.  The RP20 non-removable disk pack, which  has  a  120  million
            word (36-bit word) capacity.

   In addition, the 2060 systems support the following:

        1.  The RA60 removable disk pack, which  has  a  46-million  word
            (36-bit word) capacity.

        2.  The RA81 non-removable disk pack, which  has  a  102  million
            word (36-bit word) capacity.



                                    2-8

                                  HARDWARE


   The drives for these packs  provide  error  detection  and  correction
   hardware as well as high-speed access and transfer rates.

   On the 2040S and 2060 systems, the disk drives have an RH20 integrated
   controller  and  data channel for access by the central processor.  If
   the drive has the dual-port option, the  console  front-end  processor
   accesses a disk drive through an RH11 disk controller.  In addition to
   the  massbus  devices  that  are  handled  by  the   RH20   integrated
   controller,  the  2060 system can have the HSC50 controller for access
   by the central processor.



   2.7.4  Magnetic Tape

   The magnetic tape drives currently available on 2040S and 2060 systems
   are:

        1.  The TU45, which is a 9-track drive with  recording  densities
            of 800 bits/inch (31 rows/mm) or 1600 bits/inch (63 rows/mm).
            The recording speed is 75 inches per second (1905 mm/s).  The
            TU45  is interfaced to an RH20 integrated controller and data
            channel through a TM02 or TM03 controller.

        2.  The TU70, which is a 9-track drive with  recording  densities
            of 800 bits/inch (31 rows/mm) or 1600 bits/inch (63 rows/mm).
            The recording speed is 200 inches  per  second  (5080  mm/s).
            The  TU70  is interfaced to an RH20 integrated controller and
            data channel through a DX20 programmed  data  adapter  and  a
            TX02 controller.

        3.  The TU71, which is a 7-track drive with  recording  densities
            of  200 bits/inch (8 rows/mm), 556 bits/inch (22 rows/mm), or
            800 bits/inch (31  rows/mm).   The  recording  speed  is  200
            inches per second (5080 mm/s).  The TU71 is interfaced to the
            same hardware as the TU70.

        4.  The TU72, which is a 9-track drive with  recording  densities
            of  1600  bits/inch  (63  rows/mm)  or  6250  bits/inch  (246
            rows/mm).  The recording speed is 200 inches per second (5080
            mm/s).   The  TU72  is interfaced to the same hardware as the
            TU70.

        5.  The TU77, which is a 9-track drive with  recording  densities
            of 800 bits/inch (31 rows/mm) or 1600 bits/inch (63 rows/mm).
            The recording speed is 120 inches  per  second  (3048  mm/s).
            The  TU77  is interfaced to an RH20 integrated controller and
            data channel through a TM03 controller.

        6.  The  TU78/79,  which  is  a  9-track  drive  with   recording
            densities  of  1600  bits/inch (63 rows/mm) or 6250 bits/inch
            (246 rows/mm).  The recording speed is 120 inches per  second


                                    2-9

                                  HARDWARE


            (3048 mm/s).  The TU78/79 is interfaced to an RH20 integrated
            controller and data channel through a TM78 controller.

   The parameters for the magnetic tapes  are  summarized  in  Table  2-4
   below.


   Table 2-4:  Magnetic Tape Drives

   ______________________________________________________________________

     Model  Tracks   Recording Densities         Interface   Controller
   ______________________________________________________________________

     TU45   9-track  800 b/i or 1600 b/i         RH20        TM02 or 
                                                             TM03

     TU70   9-track  800 b/i or 1600 b/i         RH20        DX20 and
                     (31rows/mm) (63rows/mm)                 TX02

     TU71   7-track  200 b/i, 556 b/i            RH20        DX20 and
                     (8rows/mm) (22rows/mm)                  TX02
                     or
                     800 b/i (31rows/mm)

     TU72   9-track  1600 b/i or 6250 b/i        RH20        DX20 and
                     (63rows/mm) (246rows/mm)                TX02

     TU77   9-track  800 b/i or 1600 b/i         RH20        TM03
                     (31rows/mm) (63rows/mm)

     TU78   9-track  1600 b/i or 6250 b/i        RH20        TM78
                     (63 rows/mm) (246 rows/mm)

     TU79   9-track  1600 b/i or 6250 b/i        RH20        TM78
                     (63 rows/mm) (246 rows/mm)
   ______________________________________________________________________



   2.7.5  Terminals

   You (the operator) and each timesharing user interacts with the system
   through  a  terminal.   Generally,  you use a hard-copy terminal:  for
   example, an LA36, to start, stop, load, and continue  the  system  and
   user  programs.   Using  a  hard-copy  terminal allows you to save the
   printed output of all interactions with users and  the  system.   This
   output  is  especially  useful if you have a problem with your system.
   Users interact with the  system  with  either  a  hard-copy  or  video
   terminal.




                                    2-10

                                  HARDWARE


   Table 2-5 contains a partial list of the terminals that the -20 series
   hardware  supports.   If you have a terminal not described in the list
   refer to the  appropriate  terminal  documentation  for  its  specific
   characteristics.


   Table 2-5:  Terminals

   ______________________________________________________________________

     Terminal Type                  Description
   ______________________________________________________________________

        LA36                DECwriter II hard-copy  terminal,  30  cps,
                            132 columns

        LA37                LA36 with dual APL/ASCII character set

        LA38                DECwriter IV hard-copy table top (or stand)
                            model terminal

        LA120               DECwriter III,  180  cps,  hard  copy  with
                            numeric pad

        VT50                Uppercase video terminal

        VT52                Uppercase/lowercase  video  terminal   with
                            numeric pad

        VT62                Microprocessor-driven   (video)    terminal
                            designed for transaction processing

        VT100/VT125         Uppercase/lowercase  video  terminal   with
                            numeric pad and detached keyboard

        VK100               Uppercase/lowercase  video  terminal   with
                            graphic display capability
   ______________________________________________________________________
















                                    2-11


























































                                    3-1













                                 CHAPTER 3

                                  SOFTWARE



   3.1  OPERATING SYSTEMS AND OTHER MAJOR SOFTWARE COMPONENTS

   The operating system for the -20 series hardware  is  called  TOPS-20.
   If  the  2040S  and 2060 is on the ARPANET (Advanced Research Projects
   Agency Network), the  operating  system  is  called  TOPS-20AN.   Both
   operating systems support concurrent timesharing and batch processing.

   The TOPS-20 command language or command processor is also  called  the
   EXEC.

   On the 2040S and 2060 systems, the RSX-20F console front-end operating
   system  aids  the central processor and TOPS-20 by doing such tasks as
   handling  the  console,  terminal  communications,  peripherals,   and
   diagnostics.



   3.2  LANGUAGES

   The following languages are available with TOPS-20:

        ALGOL          DATATRIEVE
        APL            CPL
        BASIC-PLUS-2   FORTRAN
        COBOL-68       IQL
        COBOL-74       MACRO
        PASCAL         BLISS-36

   These languages can be used under  batch  or  timesharing.   Debugging
   programs are available for programs written in these languages.









                                    3-1

                                  SOFTWARE


   3.3  UTILITIES

   Many utilities are available for TOPS-20  users.   Some  of  the  more
   important ones are:

        DDT         - A debugging utility

        DUMPER      - A utility for backing up disk files

        EDIT        - A line-oriented editor for creating  and  modifying
                      programs and data files

        EDT-20      - A line- or character-oriented editor  for  creating
                      and modifying programs and data files

        LINK        - The TOPS-20 Linking Loader program

        PLEASE      - A    utility    for    providing     nonconflicting
                      communication  between an operator and system users
                      through a terminal

        PTYCON      - A  system  program  that  gives  you  multiple  job
                      control,    allowing    you    to    perform    all
                      software-oriented tasks from a single terminal

        SORT/MERGE  - A utility for sorting records of one or more  files
                      according to a user-specified sequence

        TV          - A  character-oriented  editor  for   creating   and
                      modifying programs and data files

        WATCH       - A utility that allows you  to  periodically  output
                      TOPS-20 monitor statistics and/or a job summary





















                                    3-2













                                 CHAPTER 4

                        STARTING THE HARDWARE SYSTEM



   Before you start the system, you should become  familiar  with  a  few
   switches and lights on the processor.

   The four load switches and two power  switches  are  on  the  leftmost
   cabinet,  to the right of the DECSYSTEM-20 label.  Just above them are
   the fault and power lights.  The switch register is located behind the
   door below the load and power switches.

   The purposes of the four white load switches are from left to right:

        LOAD SWITCH                   PURPOSE

        1.            Loads the system according to the contents  of  the
                      switch register (Section 4.2.3).

        2.            Loads the system from a disk pack (Section 4.2.1).

        3.            Loads the system from floppy disks (Section 4.2.2).

        4.            Enables loading when pushed simultaneously with  SW
                      REG, DISK, or FLOPPY switches.

|  The black power switch, labeled SYSTEM ON  and  SYSTEM  OFF,  normally
|  supplies  power  to  the system.  The red SYSTEM LOCK switch should be
   used only in emergencies, such as in a fire, when you  must  turn  off
   the power as quickly as possible.

                                  CAUTION

|          After you press the SYSTEM LOCK switch, you must  call
           your  DIGITAL  Field Service Representative to restore
           power.

   The switch register contains 18 switches (or bits) which are  used  to
   set certain values when you load via the switch register.




                                    4-1

                        STARTING THE HARDWARE SYSTEM


   When the power light is red, it indicates that power  is  on.   If  it
   blinks,  a  DIGITAL  Field  Service  Representative  at  your site has
   previously set OVERRIDE.  You should not run the system with  OVERRIDE
   set,  unless  instructed  to  do  so  by  your  DIGITAL  Field Service
   Representative,  because  the  system  does  not  power  down  if   it
   overheats.

   The fault light should normally be off.   If  it  glows,  notify  your
   DIGITAL Field Service Representative.  A glowing fault light indicates
   a malfunction, such as overheating, which stops the system.



   4.1  POWERING UP THE SYSTEM

   In most cases you should only have to check  to  see  that  the  power
|  light  over  the black SYSTEM ON/SYSTEM OFF switch is glowing red.  If
|  the light is not glowing red,  place  the  switch  in  the  SYSTEM  ON
   position.

   Be sure that the system is completely powered on:

        1.  Check the disk drives.  If power  is  off,  remove  the  back
            cover and make sure that the breakers labeled CB1 and CB2 are
            both on.  For HSC-50 disk subsystems,  refer  to  the  HSC-50
            User's Guide.

        2.  Check the magnetic tape drives.  If power is off,  press  the
            rocker  switch,  that  is,  the  white  switch containing the
            ON/OFF light on the front panel.  If power is still off, open
            the front cabinet and reset the breaker.

        3.  Check the line printers.  If power is  off  on  an  LP20A  or
            LP20B printer (which has four buttons on the right of the top
            panel), reset the knee-level breaker on the lower panel.  The
            TAPE light will be on.  This means you must reload the Direct
            Access Vertical Format Unit (VFU) when the line printer is up
            and  running.   If  you have an LP20F or LP20H printer (which
            has four rocker switches on the left of the top panel),  lift
            the  cover  just  above the lights and reset the breaker.  Be
            sure that the printer has paper.

        4.  Turn on the console terminal.  Be sure that it is on-line and
            has paper.










                                    4-2

                        STARTING THE HARDWARE SYSTEM


   4.2  LOADING THE SYSTEM

   After powering up the system or deciding you  must  reload,  you  have
   some  system  loading  alternatives.  You can load from a disk pack or
   floppy disks, and you can specify nondefault parameters via the switch
   register.   In most cases, you should load from a disk pack.  However,
   if you do not have a disk drive available on  the  RH20,  or  if  your
   system  manager wants you to use software from a floppy disk, load the
   system using floppy disks.  If you use the switch  register  to  load,
   you also enter the KL initialization operator dialog (KLINIT).  KLINIT
   lets you take nondefault loading paths; that is, you can load  from  a
   unit  other  than  disk  drive  0,  configure  memory yourself, load a
   bootstrap from any file, or specify a monitor other than  the  default
   monitor.

                                    NOTE

           The following examples use the name BS: for  the  name
           of  the  system  structure.   The  name of your system
           structure would appear in the place of BS.

                           LOADING FROM DISK PACK

                               Sample Output

   RSX-20F VB16-00 1:00 5-MAR-88

   [SY0: REDIRECTED TO DB0:]
   [DB0: MOUNTED]
   KLI -- VERSION VB1600 RUNNING
   KLI -- KL10 S/N:  2136., MODEL B, 60 HERTZ
   KLI -- KL10 HARDWARE ENVIRONMENT:
           MOS MASTER OSCILLATOR
           EXTENDED ADDRESSING
           INTERNAL CHANNELS
           CACHE

   KLI -- MICROCODE VERSION 2.1[442] LOADED
   KLI -- ALL CACHES ENABLED
   LOGICAL MEMORY CONFIGURATION:
    ADDRESS        SIZE    INT  TYPE   CONTROLLER
   00000000        768K     4   MF20       11
   03000000        768K     4   MF20       12
   KLI -- CONFIGURATION FILE ALTERED
   KLI -- BOOTSTRAP LOADED AND STARTED

   BOOT V11.0(315)
   [BOOT: STARTING CHN:4 DX20A:0 MICROCODE V10(74)] [OK]
   [BOOT: LOADING] [OK]





                                    4-3

                        STARTING THE HARDWARE SYSTEM


   [BS MOUNTED]

   SYSTEM RESTARTING, WAIT...
   ENTER CURRENT DATE AND TIME: 5-MAR-88 1300<RET>

   YOU HAVE ENTERED SATURDAY, 5-MARCH-1988
    IS THIS CORRECT (Y,N) Y<RET>
   WHY RELOAD? SCH<RET>
   RUN CHECKD? Y<RET>
   [CHECKING FILE CONSISTENCY]

   [WORKING ON STRUCTURE - BS:]


   LOCAL COUNT OF FILE PAGES: 6691
   LOCAL COUNT OF OVERHEAD PAGES: 2671
   LOCAL COUNT OF USED PAGES: 9362

   SYSTEM COUNT BEFORE CHECKD: 9362
   SYSTEM COUNT AFTER CHECKD: 9362

   THERE ARE NO LOST PAGES.

   RUNNING DDMP

   *****
   5-MAR-88    13:07:30 - TGHA 4.2(31) IN OPERATION
   *****

   SYSJOB 7(78) STARTED AT 5-MAR-88 1057
   [KNILDR: LOADING MICROCODE VERSION 1(11) INTO ETHERNET CHANNEL 0]
   RUN SYS:INFO
   RUN SYS:ORION
   RUN SYS:QUASAR
   RUN SYS:MOUNTR
   RUN SYS:MAILER
   RUN SYS:MAPPER
   RUN SYS:LPTSPL
   RUN SYS:CDRIVE
   RUN SYS:SPRINT
   JOB 0 /LOG OPERATOR XX OPERATOR
   ENA
   ^ESET LOGIN PSEUDO
   ^ESET LOGIN CONSOLE
   ^ESET OPERATOR
   PTYCON
   GET SYSTEM:7-PTYCON.ATO
   SILENCE
   LOG
   DEFINE ^$OPR
   CONN OPR
   LOG OPERATOR FOO OPERATOR


                                    4-4

                        STARTING THE HARDWARE SYSTEM


   ENA
   !OPERATOR INTERFACE PARSER
   OPR
   DISABLE OUTPUT-DISPLAY BUGINF-MESSAGES
   DISABLE OUTPUT-DISPLAY BUGCHK-MESSAGES
   DISABLE OUTPUT-DISPLAY SYSTEM-MESSAGES
   TAKE SYSTEM:SYSTEM.CMD
   PUSH
   ENA
   ^ESET LOGIN ANY
   ^ESEND * SYSTEM IN OPERATION
   POP
   ^X
   NO SILENCE
   W ALL
   CONN OPR



   4.2.1  Loading from Disk Pack

   Loading from disk pack is the most common way to load the system.   Be
   sure that system power is ON, that all hardware and software have been
   correctly installed,  and  that  the  disk  packs  have  been  mounted
   properly.   Also,  be  sure  the  formatted  disk  pack containing the
   RSX-20F files is on a  dual-ported  drive  (CONTROLLER  SELECT  switch
   points to A/B), and the drive is unit 0 on the RH11.

   Next, do the following:

        1.  Press the DISK and ENABLE load switches simultaneously.

        2.  Type the current date and time and confirm it.

        3.  Type the reason for reloading.

        4.  Type YES or NO response to the RUN CHECKD question.

   These steps load the front-end software, load the TOPS-20 monitor, and
   start the system for timesharing.

   Now, a more detailed explanation of the above steps:

        1.  Press the upper halves of the DISK and ENABLE  load  switches
            simultaneously.   The following is an example of what is then
            printed on the CTY:








                                    4-5

                        STARTING THE HARDWARE SYSTEM


                 RSX-20F VB16-00 1:00 5-MAR-88

                 [SY0: REDIRECTED TO DB0:]
                 [DB0: MOUNTED]
                 KLI -- VERSION VB1600 RUNNING
                 KLI -- KL10 S/N:  2136., MODEL B, 60 HERTZ
                 KLI -- KL10 HARDWARE ENVIRONMENT:
                         MOS MASTER OSCILLATOR
                         EXTENDED ADDRESSING
                         INTERNAL CHANNELS
                         CACHE

                 KLI -- MICROCODE VERSION 2.1[442]LOADED
                 KLI -- ALL CACHES ENABLED
                 LOGICAL MEMORY CONFIGURATION:
                  ADDRESS     SIZE  INT    TYPE CONTROLLER
                 00000000     768K   4     MF20     11
                 KLI -- CONFIGURATION FILE ALTERED
                 KLI -- BOOTSTRAP LOADED AND STARTED


                 BOOT V11.0(315)
                 [BOOT: LOADING] [OK]


                 [BS MOUNTED]

                 System restarting, wait...

            The first line of output tells you the version  and  creation
            time  and  date of RSX-20F.  The next two lines tell you that
            DB0: (the disk pack on drive 0) is the system  device  (SY0:)
            for  the  front-end  tasks and that it is mounted.  All lines
            beginning with KLI and the text between those  lines  contain
            output  from  KLINIT.  The line BOOT V11.0 (315) notifies you
            that the BOOT program is running, and the line following this
            output  tells  you  what the BOOT program is doing.  The line
            [BS MOUNTED] is output by the TOPS-20 monitor and means  that
            the  system structure has been mounted and the line following
            this output  tells  you  what  the  BOOT  program  is  doing.
            TOPS-20  then  outputs  the  next  line  to  all terminals to
            indicate the system is being restarted  and  is  soon  to  be
            available.











                                    4-6

                        STARTING THE HARDWARE SYSTEM


            If you have a DX20  magnetic  tape  system  or  a  DX20  disk
            system,  you  also  see a message(s) similar to the following
            before [BS MOUNTED]:

                 [BOOT:  STARTING CHN:1 DX20A:0 MICROCODE V74(10)] [OK]

                 [BOOT:  STARTING CHN:2 DX20B:0 MICROCODE V16(3)] [OK]

            If "?" precedes CHN., see Section 9.4.5.

                                        NOTE

                    DX20:A specifies a DX20 tape system
                    DX20:B specifies a DX20 disk system


                                       WARNING

                    If a power-fail occurs, you must  reload  the
                    DX20  microcode  manually.   Refer to Section
                    9.4.5.

                                        NOTE

                    The  above  example  assumes  you  have   the
                    monitor  in BS:<SYSTEM>MONITR.EXE and all BS:
                    packs are on-line.  To boot the system from a
                    structure other than BS:  or from a different
                    file, see Section 4.2.3 for this procedure.

        2.  Continue at Section 4.4, Answering Monitor Start-up Question

                            LOADING FROM FLOPPY DISKS

                                  Sample Output

             RSX-20F VB16-00 8:55 5-MAR-88

             [SY0: REDIRECTED TO DX0:]
             [DX0: MOUNTED]
             [DX1: MOUNTED]
             KLI -- VERSION VB1600 RUNNING
             KLI -- KL10 S/N:  2136., MODEL B, 60 HERTZ
             KLI -- KL10 HARDWARE ENVIRONMENT:
                     MOS MASTER OSCILLATOR
                     EXTENDED ADDRESSING
                     INTERNAL CHANNELS
                     CACHE

             KLI -- MICROCODE VERSION 2.1[442] LOADED
             KLI -- ALL CACHES ENABLED
             LOGICAL MEMORY CONFIGURATION:


                                    4-7

                        STARTING THE HARDWARE SYSTEM


              ADDRESS     SIZE  INT    TYPE CONTROLLER
             00000000     768K   4     MF20     11
             03000000     768K   4     MF20     12
             CONFIGURATION FILE WRITTEN
             KL1 -- BOOTSTRAP LOADED AND STARTED


             BOOT V11.0(315)
             [BOOT: LOADING] [OK]

             [BS MOUNTED]

             System restarting, wait...
             ENTER CURRENT DATE AND TIME: 5-MAR-88 1032<RET>

             YOU HAVE ENTERED WEDNESDAY, 5-MARCH-1988 10:32AM,
              IS THIS CORRECT (Y,N) Y<RET>
             WHY RELOAD? SCH<RET>
             RUN CHECKD? Y<RET>
             [CHECKING FILE CONSISTENCY]

             [WORKING ON STRUCTURE - BS:]


             LOCAL COUNT OF FILE PAGES: 6692
             LOCAL COUNT OF OVERHEAD PAGES: 2671
             LOCAL COUNT OF USED PAGES: 9363

             SYSTEM COUNT BEFORE CHECKD: 9363
             SYSTEM COUNT AFTER CHECKD: 9363

             THERE ARE NO LOST PAGES.

             RUNNING DDMP

             *****
             5-MAR-88    13:07:30 - TGHA V4.2(31) IN OPERATION
             *****

             SYSJOB 7(78) STARTED AT 5-MAR-88 1032
             [KNILDR: LOADING MICROCODE VERSION 1(11) INTO ETHERNET CHANNEL 0]
             RUN SYS:INFO
             RUN SYS:ORION
             RUN SYS:QUASAR
             RUN SYS:MOUNTR
             RUN SYS:MAILER
             RUN SYS:MAPPER
             RUN SYS:LPTSPL
             RUN SYS:CDRIVE
             RUN SYS:SPRINT
             JOB 0 /LOG OPERATOR  XX OPERATOR
             ENA


                                    4-8

                        STARTING THE HARDWARE SYSTEM


             ^ESET LOGIN PSEUDO
             ^ESET LOGIN CONSOLE
             ^ESET OPERATOR
             PTYCON
             GET SYSTEM:7-PTYCON.ATO
             SILENCE
             LOG
             DEFINE ^$OPR
             CONN OPR
             LOG OPERATOR FOO OPERATOR
             ENA
             !OPERATOR INTERFACE PARSER
             OPR
             DISABLE OUTPUT-DISPLAY BUGINF-MESSAGES
             DISABLE OUTPUT-DISPLAY BUGCHK-MESSAGES
             DISABLE OUTPUT-DISPLAY SYSTEM-MESSAGES
             TAKE SYSTEM:SYSTEM.CMD
             PUSH
             ENA
             ^ESET LOGIN ANY
             ^ESEND * SYSTEM IN OPERATION
             POP
             ^X
             NO SILENCE
             W ALL
             CONN OPR

             SJ  0:
             SJ  0:  INSTALLATION-TEST SYSTEM, TOPS-20 MONITOR 7(21017)
             SJ  0: @LOG OPERATOR OPERATOR
             SJ  0:  JOB 1 ON TTY106 5-MAR-88 10:32:46
             [FROM OPERATOR: SYSTEM IN OPERATION]



   4.2.2  Loading from Floppy Disks

   Load from floppy disks if problems prevent you  from  loading  from  a
   disk  pack, or if you need a version of the front-end software that is
   only on floppy disks.  Be sure that system power is ON and the  proper
   software  exists  on the disk packs and the floppy disks (as on System
   Floppy A and System Floppy B).  Mount the floppy containing  the  BOOT
   program  (System  Floppy  A)  on  unit 0, the left unit.  Mount System
   Floppy B on unit 1, the right unit.  Leave the  floppy  disks  mounted
   while the system is running.

   Next, do the following:

        1.  Press the FLOPPY and ENABLE load switches simultaneously.

        2.  Type the current date and time and confirm it.



                                    4-9

                        STARTING THE HARDWARE SYSTEM


        3.  Type the reason for reloading.

        4.  Type a YES or NO response to the RUN CHECKD question.

   These steps load the front-end software, load the TOPS-20 monitor, and
   start the system for timesharing.

   Now, a more detailed explanation of the above steps:

        1.  Press the upper halves of the FLOPPY and ENABLE load switches
            simultaneously.   The following is an example of what is then
            printed on the CTY:

                 RSX-20F VB16-00 8:55 5-MAR-88

                 [SY0: REDIRECTED TO DX0:]
                 [DX0: MOUNTED]
                 [DX1: MOUNTED]
                 KLI -- VERSION VB1600 RUNNING
                 KLI -- KL10 S/N:  2136., MODEL B, 60 HERTZ
                 KLI -- KL10 HARDWARE ENVIRONMENT:
                         MOS MASTER OSCILLATOR
                         EXTENDED ADDRESSING
                         INTERNAL CHANNELS
                         CACHE

                 KLI -- MICROCODE VERSION 2.1[442] LOADED
                 KLI -- ALL CACHES ENABLED
                 LOGICAL MEMORY CONFIGURATION:
                  ADDRESS     SIZE  INT    TYPE CONTROLLER
                 00000000     768K   4     MF20     11
                 03000000     768    4     MF20     12
                 CONFIGURATION FILE WRITTEN
                 KLI -- BOOTSTRAP LOADED AND STARTED


                 BOOT V11.0(315)
                 [BOOT: LOADING] [OK]


                 [BS MOUNTED]

                 System restarting, wait...

            The first line of output tells you the version  and  creation
            time  and  date  of  RSX-20F.   The  next line indicates that
            DX0: (the floppy disk on unit 0) is the system device  (SY0:)
            for  the  front-end  tasks.  The next two lines tell you that
            floppy units 0 and 1 have been mounted.  All lines  beginning
            with KLI and all text between those lines contain output from
            KLINIT.  The line BOOT  V11.0(315)  notifies  that  the  BOOT
            program  is  running and the line following this output tells


                                    4-10

                        STARTING THE HARDWARE SYSTEM


            you what the BOOT program is doing.  The line [BS MOUNTED] is
            output  by TOPS-20  and means  that the  system structure has
            been mounted and the line following  this  output  tells  you
            what  the  BOOT  program  is doing.  TOPS-20 then outputs the
            next line of text to all terminals to indicate the system  is
            being restarted and is soon to be available.

            If you have a DX20  magnetic  tape  system  or  a  DX20  disk
            system,  you  also  see  a  message  similar to the following
            before [BS MOUNTED]:

                 [BOOT:  STARTING CHN:1 DX20A:0 MICROCODE V74(10)] [OK]

                 [BOOT:  STARTING CHN:2 DX20B:0 MICROCODE V16(3)] [OK]

                                        NOTE

                    DX20:A specifies a DX20 tape system
                    DX20:B specifies a DX20 disk system

            If "?" precedes CHN, see Section 9.4.5.

                                       WARNING

                    If a power-fail occurs, you must  reload  the
                    DX20  microcode  manually.   Refer to Section
                    9.4.5.

                                        NOTE

                    The  above  example  assumes  you  have   the
                    monitor  in BS:<SYSTEM>MONITR.EXE and all BS:
                    packs are on-line.  To boot the system from a
                    structure other than BS:  or from a different
                    file, see Section 4.2.3.  for this procedure.

        2.  Continue  at  Section   4.4,   Answering   Monitor   Start-up
            Questions.
















                                    4-11

                        STARTING THE HARDWARE SYSTEM


                         LOADING VIA THE SWITCH REGISTER
                            (bits 0, 1, 2, and 7 set)

                                  Sample Output

             RSX-20F VB16-00 6:28 5-MAR-88

             [SY0: REDIRECTED TO DB0:]
             [DB0: MOUNTED]
             KLI -- VERSION VB1600 RUNNING
             KLI -- ENTER DIALOG [NO,YES,EXIT,BOOT]?
             KLI>YES
             KLI -- KL10 S/N:  2136., MODEL B, 60 HERTZ
             KLI -- KL10 HARDWARE ENVIRONMENT:
                     MOS MASTER OSCILLATOR
                     EXTENDED ADDRESSING
                     INTERNAL CHANNELS
                     CACHE
             KLI -- RELOAD MICROCODE [YES,VERIFY,FIX,NO]?
             KLI>YES
             KLI -- MICROCODE VERSION 2.1[442] LOADED
             KLI -- RECONFIGURE CACHE [FILE,ALL,YES,NO]?
             KLI>ALL
             KLI -- ALL CACHES ENABLED
             KLI -- CONFIGURE KL MEMORY [FILE,ALL,REVERSE,FORCE,YES,NO]?
             KLI>ALL

             LOGICAL MEMORY CONFIGURATION.
              ADDRESS   SIZE   INT   TYPE   CONTROLLER
             00000000   768K    4    MA20     0 & 1
             00400000   768K    4    MF20     11

             KLI -- LOAD KL BOOTSTRAP [YES,NO,FILENAME]?
             KLI>YES
             KLI -- WRITE CONFIGURATION FILE [YES,NO]?
             KLI>NO
             KLI -- BOOTSTRAP LOADED AND STARTED

             BOOT V11.0(315)

             BOOT><RET>
             [BOOT: LOADING] [OK]

             [BS MOUNTED]

             System restarting, wait...
             ENTER CURRENT DATE AND TIME: 5-MAR-88 1057<RET>

             YOU HAVE ENTERED WEDNESDAY, 5-MARCH-1988 10:57AM,
              IS THIS CORRECT (Y,N) Y<RET>
             WHY RELOAD? SCH<RET>
             RUN CHECKD? N<RET>


                                    4-12

                        STARTING THE HARDWARE SYSTEM


             RUNNING DDMP

             *****
             5-MAR-88    13:07:30 - TGHA 4.2(31) IN OPERATION
             *****

             SYSJOB 7(78) STARTED AT  5-MAR-88 1057
             [KNILDR: LOADING MICROCODE VERSION 1(11) INTO ETHERNET CHANNEL 0]
             RUN SYS:INFO
             RUN SYS:ORION
             RUN SYS:QUASAR
             RUN SYS:MOUNTR
             RUN SYS:MAILER
             RUN SYS:MAPPER
             RUN SYS:LPTSPL
             RUN SYS:CDRIVE
             RUN SYS:SPRINT
             JOB 0 /LOG OPERATOR XX OPERATOR
             ENA
             ^ESET LOGIN PSEUDO
             ^ESET LOGIN CONSOLE
             ^ESET OPERATOR
             PTYCON
             GET SYSTEM:7-PTYCON.ATO
             SILENCE
             LOG
             DEFINE ^$OPR
             CONN OPR
             LOG OPERATOR FOO OPERATOR
             ENA
             !OPERATOR INTERFACE PARSER
             OPR
             DISABLE OUTPUT-DISPLAY BUGINF-MESSAGES
             DISABLE OUTPUT-DISPLAY BUGCHK-MESSAGES
             DISABLE OUTPUT-DISPLAY SYSTEM-MESSAGES
             TAKE SYSTEM:SYSTEM.CMD
             PUSH
             ENA
             ^ESET LOGIN ANY
             ^ESEND * SYSTEM IN OPERATION
             POP
             ^X
             NO SILENCE
             W ALL
             CONN OPR
             SJ  0:
             SJ  0:  INSTALLATION-TEST SYSTEM, TOPS-20 MONITOR 7(21017)
             SJ  0: @LOG OPERATOR OPERATOR
             SJ  0:  JOB 1 ON TTY106 5-MAR-88 10:57:18
             [FROM OPERATOR: SYSTEM IN OPERATION]




                                    4-13

                        STARTING THE HARDWARE SYSTEM


   4.2.3  Loading Via the Switch Register

   Load the system using the switch register if you have to do any of the
   following:

        1.  Configure cache or memory yourself, because  you  cannot  use
            the default configuration.

        2.  Load a  bootstrap  with  a  name  other  than  BOOT.EXB,  for
            example,  MTBOOT.EXB,  which  loads  a  monitor from magnetic
            tape.

        3.  Load a TOPS-20 monitor other than BS:<SYSTEM>MONITR.EXE,  for
            example,  a  monitor  on  magnetic  tape  or a monitor with a
            different name on disk.

        4.  Load from a disk pack that is not on unit 0.

        5.  Dump the TOPS-20 monitor after a crash.

   To begin the loading procedure you must use a disk pack or floppy disk
   to  load  the  software  for the front end.  If you are going to use a
   disk pack, it must contain the appropriate software and be mounted  on
   a  dual-ported drive (CONTROLLER SELECT switch is set to A/B).  If you
   are going to use floppy disks, you must have  the  appropriate  floppy
   disks mounted (System Floppy A and System Floppy B).

   Next, do the following:

        1.  Set the proper switches (or bits)  in  the  switch  register.
            Usually,  you  want  to set switches 0, 1, and 2 to enter the
            KLINIT dialog.  If you are going to use a disk pack on unit 0
            to get the front-end software, also set switch 7.

        2.  Press the load switches SW REG and ENABLE simultaneously.

        3.  Answer the questions to the KLINIT dialog (Section 9.6).

        4.  Type the current date and time and confirm it.

        5.  Type the reason for reloading.

        6.  Type a YES or NO response to the RUN CHECKD question.

   These steps load the front-end software, load the TOPS-20 monitor, and
   start the system for timesharing.

   Now, a more detailed explanation of the above steps:

        1.  Set the appropriate switches (or bits) in the switch register
            by raising them.  The bits and the meaning for those used are
            listed in Table 4-1.


                                    4-14

                        STARTING THE HARDWARE SYSTEM


   Table 4-1:  Switch Register Bit Definitions


                              Switch Register
   !--------------------------------------------------------------------!
   ! 17  16 ! 15 ! 14       11 ! 10 ! 9 ! 8 ! 7 ! 6       3 ! 2 ! 1 ! 0 !
   !--------------------------------------------------------------------!

     Bit                              Meaning

     0            If this is set, the remaining bits  are  interpreted.
                  You must set this to load via the switch register.

     1,2          If both  are  set,  the  KL  initialization  operator
                  dialog (KLINIT) is loaded and started.

                  If either one is set,  only  the  front-end  monitor,
                  RSX-20F,   is  started;  there  is  no  communication
                  between the KL and console front-end processors.

                  If neither is set, the system is loaded in  the  same
                  way  as  by the DISK or FLOPPY load switch.  However,
                  because other bits are interpreted, you  can  specify
                  the unit number of the bootstrap device in bits 8-10.
                  The  default  path  is  taken  by  KLINIT  until  the
                  bootstrap prompts with BOOT>.  Then you can specify a
                  monitor   other   than   the   default   (which    is
                  BS:<SYSTEM>MONITR.EXE)   or   give   a   switch,  for
                  example, /D to dump KL memory.

|    3-6          These bits are used to set the speed of the DH11 that
|                 is used as the CTY (see bits 11-14).  If any of these
|                 are set, bits 8-10 are read as the DH11 unit  number,
|                 and  bits  11-14  are  read as the number of the DH11
|                 line that is to be the CTY.  If none  are  set,  bits
|                 8-10  are  read  as  the unit number of the disk from
|                 which to boot.  If you want to redirect the CTY  line
|                 using  the  switch register, you can boot only from a
|                 unit 0 disk.

     7            If this is set, the bootstrap device is a  disk  pack
                  on  an  RP04  or RP06 disk drive attached to the RH11
                  disk channel.  Front-end files on  a  disk  pack  are
                  used for system loading.

                  If this is not set, the  bootstrap  devices  are  the
                  floppy  disks.   Front-end  files on floppy disks are
                  used for system loading.






                                    4-15

                        STARTING THE HARDWARE SYSTEM


     8-10         These three bits allow you to specify in  binary  the
                  unit  number  of  the bootstrap device (0 to 7).  For
                  example, no bits set  indicate  unit  0;  bit  8  set
                  indicates  unit 1, bit 9 set indicates unit 2, bits 8
                  and 9 set indicate unit 3, bit 10 indicates  unit  4,
                  bits  10 and 8 set indicate unit 5, and bits 10 and 9
                  set indicate unit 6.
|  
|    11-14        These bits are used to select the  DH11  line  number
|                 within  the  selected DH11 unit that will be the CTY.
|                 They are valid only if bits 3-6 are set.

     15           This bit indicates what is done  when  an  I/O  error
                  occurs  during  bootstrapping.  When this bit is set,
                  the operation is retried  indefinitely  if  an  error
                  occurs.   If  this bit is not set (the normal case) a
                  halt occurs after ten unsuccessful retries.

     16-17        Currently not used and must not be set.

        2.  Press the upper halves of the SW REG and ENABLE load switches
            simultaneously.

            The following is an example of what is  printed  on  the  CTY
            when  bits 0, 1, and 2 are set, that is, when 7 is entered in
            the switch register.

                 RSX-20F VB16-00 8:55 5-MAR-88

                 [SY0: REDIRECTED TO DX0:]
                 [DX0: MOUNTED]
                 [DX1: MOUNTED]
                 KLI -- VERSION VB1600 RUNNING
                 KLI -- ENTER DIALOG [NO,YES,EXIT,BOOT]?
                 KLI>

            The first line of output tells you the version  and  creation
            time  and  date  of  RSX-20F.   The  next line indicates that
            DX0: (the floppy disk on unit 0) is the system device  (SY0:)
            for  the  front-end  tasks.  The next two lines tell you that
            floppy units 0 and 1 have been mounted.  If bit  7  had  been
            set,  the  system  would have gone to disk drive 0 for a disk
            pack and the line with DX1 would have been omitted.   If  any
            of  bits  8-10  had been set, the unit number would have been
            something other than 0.

            The lines beginning with KLI are printed by  KLINIT,  the  KL
            initialization operator dialog.






                                    4-16

                        STARTING THE HARDWARE SYSTEM


            The following is an example of the CTY output when bit  0  is
            set  with  bits 1 and 2 not set.  Bits 7, 8, and 9 are set to
            specify a different bootstrap device and unit.

                 RSX-20F VB16-00 8:55 5-MAR-88

                 [SY0: REDIRECTED TO DB3:]
                 [DB3: MOUNTED]
                 KLI -- VERSION VB1600 RUNNING
                 KLI -- KL10 S/N:  2136., MODEL B, 60 HERTZ
                 KLI -- KL10 HARDWARE ENVIRONMENT:
                         EXTENDED ADDRESSING
                         INTERNAL CHANNELS
                         CACHE

                 KLI -- MICROCODE VERSION 2.[442] LOADED
                 KLI -- ALL CACHES ENABLED
                 LOGICAL MEMORY CONFIGURATION:
                  ADDRESS     SIZE  INT    TYPE CONTROLLER
                 00000000     768K   4     MF20     11
                 03000000     768K   4     MF20     12

                 CONFIGURATION FILE WRITTEN
                 KLI -- BOOTSTRAP LOADED AND STARTED

                 BOOT V11.0(315)

                 BOOT>
            All lines beginning with KLI and all text between those lines
            contain  output  from  KLINIT.  In this case KLINIT takes the
            default path up to and including the loading and starting  of
            the  KL  bootstrap.   Then,  instead  of  loading the default
            monitor, BS:<SYSTEM>MONITR.EXE, the  bootstrap  prompts  with
            BOOT>  and  lets you type in the name of the monitor that you
            want to load.  For example:

                 BOOT><SUBSYS>TEST01.EXE

            If you press RETURN after BOOT>, you get the default monitor.

            Once you specify the monitor, it is loaded and  started;  the
            system prints:

                 [BS MOUNTED]

                 SYSTEM RESTARTING, WAIT...

            The first line means  that  the  system  structure  has  been
            mounted.  The next line of text is output to all terminals to
            indicate the system is being restarted  and  is  soon  to  be
            available.



                                    4-17

                        STARTING THE HARDWARE SYSTEM


            If you have a DX20 magnetic  tape  system,  you  also  see  a
            message like the following before [BS MOUNTED].

            [BOOT:  STARTING CHN:1 DX20A:0 MICROCODE V74(10)] [OK]

            [BOOT:  STARTING CHN:2 DX20B:0 MICROCODE V16(3)] [OK}

                                        NOTE

                    DX20:A specifies a DX20 tape system
                    DX20:B specifies a DX20 disk system

            If "?" precedes CHN, see Section 9.4.5.

            Because the bit settings in the latter example cause much  of
            the dialog to take a default path, continue reading at Step 4
            for that example.  For the former example, continue  at  Step
            3.

        3.  After the output:

                 KLI -- ENTER DIALOG [NO,YES,EXIT,BOOT]?
                 KLI>

            you are in the KL initialization operator dialog, KLINIT, and
            you must answer the questions asked.

            Once the KL bootstrap has been loaded and started via KLINIT,
            and  you have responded successfully to the BOOT> prompt, the
            TOPS-20 monitor prints:

                 [BS MOUNTED]

                 SYSTEM RESTARTING, WAIT...

            The first line means  that  the  system  structure  has  been
            mounted.  The next line of text is output to all terminals to
            indicate the system is being restarted  and  is  soon  to  be
            available.

   Continue at Section 4.4, Answering Monitor Start-up Questions.













                                    4-18

                        STARTING THE HARDWARE SYSTEM


   4.3  LOADING THE TOPS-20 MONITOR

   The TOPS-20 monitor is loaded during the  procedure  for  loading  the
   system,  which was discussed in the previous three sections.  The next
   two sections  give  additional  information  on  loading  the  TOPS-20
   monitor to emphasize where the monitor can be loaded from.



   4.3.1  Loading TOPS-20 from a Disk Pack with BOOT

   When you load the system using the DISK or FLOPPY load switch, TOPS-20
   is loaded and started from BS:<SYSTEM>MONITR.EXE.

   When you load the  system  via  the  switch  register,  the  bootstrap
   program  issues  a  prompt  and  you  can  either press RETURN for the
   default monitor (BS:<SYSTEM>MONITR.EXE) or type a  file  specification
   for   a   different  monitor.   If  you  omit  a  field  in  the  file
   specification, that field is defaulted to what it is  in  the  default
   monitor.

                            ----- Example -----

        BOOT><TESTSY>MON002.EXE<RET>

   If you set bits 1 and 2 in the switch register and receive the  KLINIT
   question:

        KLI -- LOAD KL BOOTSTRAP [YES,NO,FILENAME]?

   you  can  specify  a  bootstrap  other  than  the  default,  BOOT.EXB.
   However, the file you specify must reside on the bootstrap device.

   In this example the KL bootstrap is VBORP4.EXB and the TOPS-20 monitor
   is BS:<SYSTEM>MON002.EXE.

        KLI -- LOAD KL BOOTSTRAP [YES,NO,FILENAME]?
        KLI>VBORP4<RET>
        KLI -- BOOTSTRAP LOADED AND STARTED

        BOOT V11.0(315)<RET>
        BOOT><SYSTEM>MON002.EXE<RET>

                              ----- Hint -----

   Entering the KLINIT dialog to get the question LOAD KL BOOTSTRAP or to
   get  the  BOOT> prompt is useful for testing new bootstrap programs or
   new TOPS-20 monitors.






                                    4-19

                        STARTING THE HARDWARE SYSTEM


   4.3.2  Loading TOPS-20 from Magnetic Tape with MTBOOT

   If you need to load a TOPS-20  monitor  from  magnetic  tape,  do  the
   following:

        1.  Mount  the  magnetic  tape  containing  the  monitor  on  any
            available tape drive.

        2.  Load the system via the switch register with bits 0, 1, and 2
            set.

        3.  Enter the KLINIT dialog.

        4.  After LOAD KL BOOTSTRAP, type MTBOOT.

        5.  After MTBOOT>, type MT:  and press RETURN to load  and  start
            the monitor on the magnetic tape.

                            ----- Example -----

        KLI -- LOAD KL BOOTSTRAP [YES,NO,FILENAME]?
        KLI>MTBOOT<RET>
        KLI -- BOOTSTRAP LOADED AND STARTED

        MTBOOT>MT:<RET>

                              ----- Hint -----

   If you cannot use drive 0 for Step 1, mount the magnetic tape  on  any
   available drive, but be sure to put all other drives OFF-LINE.
























                                    4-20

                        STARTING THE HARDWARE SYSTEM


                                    NOTE

           Once the monitor has started, it automatically  starts
           the  TGHA  program.   At  this  time it is possible to
           receive one of the following error messages.

        **********************************************************************
        * 5-MAR-88 13:07:30
        * THE FOLLOWING BLOCKS ARE MARKED AS BAD
        * AND ARE NOT ON LINE:
        * CONTROLLER      GROUP   BLOCK
        * 10              2       3
        * THIS CONSISTS OF 64K OF MEMORY THAT IS OFF LINE.
        *** CALL FIELD SERVICE TO REPORT THIS CONDITION ***
        **********************************************************************

                                               or

        **********************************************************************
        * 5-MAR-88 13:07:30
        * TGHA HAS TEMPORARILY CORRECTED A SERIOUS MOS MEMORY FAILURE.
        *** CALL FIELD SERVICE TO REPORT THIS CONDITION ***
        **********************************************************************


   Both the above messages are informing you that there is a problem with
   MOS  memory  and  that  you  should  notify your DIGITAL Field Service
   Representative about the problem.


























                                    4-21

                        STARTING THE HARDWARE SYSTEM


   4.4  ANSWERING MONITOR START-UP QUESTIONS

   After the system  has  configured  memory  and  loaded  the  bootstrap
   program into memory, you are asked the following questions:

   Question:  ENTER CURRENT DATE AND TIME:

   Reply:     Type the current date and time in the format

                    dd-mmm-yy hhmm

              where

                       dd = day of the month
                      mmm = first three letters of the month
                       yy = last two digits of the year
                     hhmm = time, between 0 and 2359

                                    NOTE

           You can use spaces instead  of  hyphens.   Other  date
           formats are accepted but they are not recommended.

   The system then prints a line telling you the day, date, and time  you
   typed  and asks you if the information is correct.  If you entered the
   correct information, type Y for YES; otherwise,  type  N  for  NO  and
   enter the correct information.



























                                    4-22

                        STARTING THE HARDWARE SYSTEM


                            ----- Example -----

        ENTER CURRENT DATE AND TIME:5-MAR-88 1300<RET>

        YOU HAVE ENTERED WEDNESDAY, 5-MARCH-1988 1:00 PM
        IS THIS CORRECT (Y,N) Y <RET>

   Question:  WHY RELOAD?

   Reply:     Type one of the  following  abbreviations  that  gives  the
              reason for reloading the system.

                   OP (OPR)          PM (Prevent Maint.)
                   PA (Parity)       CM (Corrective Maint.)
                   PO (Power)        SA (Stand-Alone)
                   ST (Static)       NE (New)
                   HAR (Hardware)    SCH (Scheduled)
                   HA (Halt)         OT (Other)
                   HU (Hung)

   The answer you type to this question is stored  in  the  system  error
   file and is printed in the SPEAR report.

   If  the  question  isn't  answered  within  one  minute,  the   system
   redisplays  the  question  and  supplies  a  default answer:  "OTHER -
   Question timeout".




























                                    4-23

                        STARTING THE HARDWARE SYSTEM


                            ----- Example -----

        WHY RELOAD? SCH<RET>

                                      NOTE

                At this time the system may automatically run the
                CHECKD   program   if   certain   problems   were
                previously  found;   otherwise,   it   asks   the
                following question.

   Question:  RUN CHECKD?

   Reply:     You must answer Y for YES or N for NO.  If you have a daily
              scheduled  reload  or  experienced  a hardware failure, you
              should answer Y.  Otherwise, you should normally answer N.

   If  the  question  isn't  answered  within  one  minute,  the   system
   redisplays the question and supplies a default answer:  "NO".

   If you answer Y, CHECKD performs a bit-table and consistency check for
   the  system  structure.   It then lists any problems it found with bad
   pages or files.  Next it prints a  summary  of  page  counts  and  the
   number  of  lost  pages.   Any  lost  pages  are allocated to the file
   BS:<OPERATOR>BS-LOST-PAGES.BIN.n (where "n" is the  generation  number
   of the file).

   Depending on the size of the structure and  the  number  of  files  it
   contains,  CHECKD  can take between five and thirty minutes to perform
   its checking.  When the CHECKD program starts, it prints:

        [CHECKING FILE CONSISTENCY]

        [WORKING ON STRUCTURE - BS:]

                                    NOTE

           If CHECKD lists any problems  before  the  summary  of
           page  counts, or if it says there are lost pages after
           the summary, refer to Section 9.7.1 to determine  what
           action to take.













                                    4-24

                        STARTING THE HARDWARE SYSTEM


                            ----- Example -----

        RUN CHECKD? Y<RET>

        [CHECKING FILE CONSISTENCY]

        [WORKING ON STRUCTURE-BS:]

        LOCAL COUNT OF FILE PAGES:  6692
        LOCAL COUNT OF OVERHEAD PAGES:  2671
        LOCAL COUNT OF USED PAGES:  9363

        SYSTEM COUNT BEFORE CHECKD:  9363
        SYSTEM COUNT AFTER CHECKD:  9363

        THERE ARE NO LOST PAGES.

                                      NOTE

                The structure name reported by CHECKD will be the
                actual name of the system structure.

   After CHECKD is done, TOPS-20 runs  the  n-SETSPD.EXE  program.   This
|  program   reads   the   n-CONFIG.CMD  file  that  was  created  during
|  installation and executes the  commands  therein.   If  there  are  no
   errors, there is no output from the n-SETSPD.EXE program.

                                    NOTE

|          You can also run the  n-SETSPD  program  interactively
|          during  timesharing.   Some features cannot be enabled
|          interactively, however.  The following example shows a
|          quick interactive SETSPD session:
|  
|          $R SETSPD<RET>
|          Process SYSTEM:7-CONFIG.CMD (Y or N)?  N<RET>
|          7-SETSPD$?  one of the following:
|           ALLOW                  ARCHIVE-TAPE-RECYCLE-PERIOD
|           BATCH-BACKGROUND       BATCH-CLASS
|           BIAS                   CHANGE
|           CREATE                 DAYLIGHT
|           DECNET                 DEFINE
|           DISABLE                DONTCARE
|           ENABLE                 ETHERNET
|           EXIT                   HOST
|           LAT-STATE              MAGTAPE
|           NODE                   PRINTER
|           RESTRICT               TAPE-RECOGNITION-ERRORS
|           TAPE-RECYCLE-PERIOD    TERMINAL
|           TIMEZONE
|          7-SETSPD$EXIT<RET>
|          $


                                    4-25

                        STARTING THE HARDWARE SYSTEM


   After CHECKD has finished running, it prints the following message:

        RUNNING DDMP

   DDMP is a TOPS-20 background  job  that  moves  pages  from  the  disk
   swapping  area  to  the  disk  file  area.   After the DDMP program is
   finished, the monitor starts the SYSJOB program and prints  a  message
   similar to the following:

        SYSJOB 7(78) STARTED AT 5-MAR-88 11:00

   The SYSJOB program reads the file PS:<SYSTEM>n-SYSJOB.RUN.  This  file
   contains  commands  that  start  various  system  programs.   The last
   command in the n-SYSJOB.RUN  file  is  GET  SYSTEM:n-PTYCON.ATO.   The
   PTYCON.ATO file starts various jobs as subjobs.  (Refer to the TOPS-20
   Operator's Command Language Reference Manual for more  information  on
   the PTYCON program.)

   Once the PTYCON.ATO  file  is  processed,  the  system  is  ready  for
   timesharing.   (Refer  to  Section  4.5.1  if  you  are  going to have
   operator coverage, or Section 4.5.2 if  you  are  not  going  to  have
   operator coverage.)

                                    NOTE

           During  system  initialization,  TOPS-20  defines  the
           logical  name  BS:   to  be  the  physical name of the
           structure from which TOPS-20 was booted, that is,  the
           boot structure, also known as the system structure.

           The logical  name  PS:   (public  structure)  is  also
           defined  to be this structure.  If your system manager
           later enables the "login structure" facility, however,
           PS:   refers  to  the  login  structure,  not the boot
           structure.



   4.5  READYING THE SYSTEM FOR TIMESHARING

   As you saw in previous sections, once RSX-20F and TOPS-20  are  loaded
   and started, SYSJOB starts running under job 0.  SYSJOB then reads and
   prints on the CTY  the  file  <SYSTEM>n-SYSJOB.RUN  and  performs  the
   commands  in  that  file.   These  commands start certain programs and
   issue some commands which aid you  and  the  system  in  providing  an
   efficient timesharing facility.

   To see what commands  SYSJOB  actually  performs,  look  at  the  file
|  PS:<SYSTEM>n-SYSJOB.RUN.   The  following  example  illustrates a file
|  that is similar to the one distributed with the software:

        RUN SYS:INFO
        RUN SYS:ORION
        RUN SYS:QUASAR
                                    4-26

                        STARTING THE HARDWARE SYSTEM


        RUN SYS:MOUNTR
        RUN SYS:MAILER
        RUN SYS:MAPPER
        RUN SYS:LPTSPL
        RUN SYS:CDRIVE
        RUN SYS:SPRINT
        JOB 0 /LOG OPERATOR XX OPERATOR
        ENA
        ^ESET LOGIN PSEUDO
        ^ESET LOGIN CONSOLE
        ^ESET OPERATOR
        PTYCON
        GET SYSTEM:7-PTYCON.ATO
        /
        JOB 1 /LOG OPERATOR XX OPERATOR
        ENA
        RUN SYS:BATCON
        /
        JOB 2 /LOG OPERATOR XX OPERATOR
        ENA
        RUN SYS:NETCON
        /

   This file causes SYSJOB to:

        1.  Run ORION, the program that handles the operator interface.

        2.  Run INFO, the program that passes message identifications for
            any process that requires IPCF communications.

        3.  Run QUASAR, the program that handles the  system  queues  for
            batch jobs and print requests.

        4.  Run MOUNTR, the  program  that  handles  all  tape  and  disk
            mounting procedures.

        5.  Run MAILER, the program that handles messages sent via MAIL.

        6.  Run MAPPER, the program that sets up the program cache.

        7.  Run LPTSPL, the program that handles the line printer.

        8.  Run CDRIVE, the program that handles the card reader.

        9.  Run SPRINT, the program that handles the conversion  of  card
            images to ASCII and the interpretation of control cards.

       10.  Create a job on the system and log it in under OPERATOR.  All
            text between the slashes is passed to the job.  Any input and
            output for the job is printed on  the  CTY  and  preceded  by
            SJ  0:  until you attach to that job (Section 4.5.1).  SYSJOB
            identifies the job as job 0, but the  system  job  number  is
            one.

                                    4-27

                        STARTING THE HARDWARE SYSTEM


   (See the TOPS-20 Operator's Command Language  Reference  Manual  under
   ^ESPEAK    for    details   on   SYSJOB   commands.    Remember   that
   <SYSTEM>n-SYSJOB.RUN must contain only SYSJOB commands.)

   The n-SYSJOB.RUN  file  causes  the  job  under  OPERATOR  to  do  the
   following:

        1.  Enables capabilities.  This enables the OPERATOR  capability,
            normally granted to the OPERATOR directory.

        2.  Does a ^ESET LOGINS ANY to allow LOGINs from all terminals.

        3.  Does  a  ^ESEND  to  send  the  message   SYSTEM IN OPERATION
            followed by a bell to all terminals.

        4.  Runs PTYCON.

        5.  Starts various programs under PTYCON by using the contents of
            the file SYSTEM:7-PTYCON.ATO.

   The PTYCON.ATO file causes PTYCON to do the following:

        1.  Silence output to the CTY from PTYCON until PTYCON  processes
            a  NO SILENCE  command.   This eliminates unnecessary output.
            Therefore, you do  not  see  many  of  the  following  PTYCON
            actions printed on the CTY.

        2.  Create  a  LOG  file  (PTYCON.LOG)  under  <OPERATOR>.   This
            contains a record of everything that happens under PTYCON.

        3.  Connect to  subjob  0  and  log  it  in  under  OPERATOR.   A
            fictitious  password  of  FOO  is  acceptable  in  this case,
            because the job running PTYCON is  already  logged  in  under
            OPERATOR.

        4.  Print the status of all subjobs (WHAT ALL).   Because  PTYCON
            continues  processing  PTYCON  commands  while  it passes off
            commands to subjobs, the WHAT ALL output  may  appear  before
            the subjobs have finished processing their commands.

                                    NOTE

           See the TOPS-20 Operator's Command Language  Reference
           Manual for details on PTYCON.

   When output to the CTY has stopped, you are at OPR command  level  and
   the  system  is  ready  for  timesharing.   The  front-end and TOPS-20
   monitors are running,  and  SYSJOB  and  the  programs  under  it  are
   running.   However,  the CTY is not attached to any of these jobs.  If
   you are going to have operator coverage,  you  should  attach  to  the
   PTYCON  job running OPR (Section 4.5.1).  Otherwise, you should set up
   the system for no operator coverage (Section 4.5.2).


                                    4-28

                        STARTING THE HARDWARE SYSTEM


                                  WARNING

           Whenever you type CTRL/\ (control  backslash)  at  the
           CTY, you enter the console processor command.  To exit
           from this command language, type QUIT or CTRL/Z.

   If your system manager wants SYSJOB to perform  functions  other  than
   those above, you can edit the SYSTEM:n-SYSJOB.RUN file to reflect what
   is needed.  Remember that SYSJOB commands, documented under ^ESPEAK in
   the TOPS-20 Operator's Command Language Reference Manual, must be used
   in the n-SYSJOB.RUN file.

|  Improving Performance of Special System Jobs
|  
|  If you need to improve system performance, you can start up the GALAXY
|  components  under PTYCON rather than under SYSJOB.  Then there will be
|  fewer competing subjobs running under  job  0.   The  following  is  a
|  sample PTYCON.ATO file:
|  
|  SILENCE
|  LOG
|  DEFINE ^$GAL
|  CONN GAL
|  LOG OPERATOR FOO OPERATOR
|  ENABLE
|  GET SYS:ORION
|  START/STAY
|  GET SYS:QUASAR
|  START/STAY
|  GET SYS:MOUNTR
|  START/STAY
|  GET SYS:LPTSPL
|  START/STAY
|  GET SYS:LPTSPL
|  START/STAY
|  GET SYS:CDRIVE
|  START/STAY
|  GET SYS:SPRINT
|  START/STAY
|  ^X
|  DEFINE ^$BAT
|  CONN BAT
|  LOG OPERATOR FOO OPERATOR
|  ENABLE
|  RUN SYS:BATCON
|  ^X
|  DEFINE ^$NEB
|  CONN NEB
|  LOG OPERATOR FOO OPERATOR
|  ENABLE
|  RUN SYS:NEBULA
|  ^X
|  DEFINE ^$OPR
|  CONN OPR
                                    4-29

                        STARTING THE HARDWARE SYSTEM


|  LOG OPERATOR FOO OPERATOR
|  ENABLE
|  OPR
|  TAKE SYSTEM:SYSTEM.CMD
|  ^X



   4.5.1  Timesharing with Operator Coverage

   If you are going to have operator coverage, you should send a  message
   stating  that  the system has operator coverage.  To send this message
   perform the following steps:

        1.  Type CTRL/C to get the system identification message.

        2.  Type ATTACH OPERATOR 1 and press the RETURN key.

        3.  After the message [ATTACHED  TO  TTYn,  CONFIRM],  press  the
            RETURN key.

        4.  After the PASSWORD prompt, type your password and  press  the
            RETURN key twice.

        5.  Type PUSH to OPR.

        6.  ENABLE your capabilities.

        7.  Type ^ESET OPERATOR-IN-ATTENDANCE.

        8.  Type POP to return to OPR command level.

                            ----- Example -----

        <CTRL/C>
        INSTALLATION-TEST SYSTEM, TOPS-20 MONITOR 7(21017)
        @ATTACH OPERATOR 1<RET>
        [ATTACHED TO TTY102, CONFIRM]<RET>
        PASSWORD: your password<RET>
        <RET>
        OPR>PUSH<RET>
         TOPS-20 COMMAND PROCESSOR 7(4143)
        @ENABLE<RET>
        $^ESET OPERATOR-IN-ATTENDANCE<RET>
        $POP<RET>
        OPR>








                                    4-30

                        STARTING THE HARDWARE SYSTEM


   4.5.2  Timesharing without Operator Coverage

   To  continue  timesharing,  but  without  operator  coverage,  do  the
   following:

        1.  Type CTRL/C to get the system identification message.

        2.  Type ATTACH OPERATOR 1 and press the RETURN key.

        3.  After the message [ATTACHED  TO  TTYn,  CONFIRM],  press  the
            RETURN key.

        4.  After the PASSWORD prompt, type your password and  press  the
            RETURN key twice.

        5.  Type PUSH to OPR.

        6.  ENABLE your capabilities.

        7.  Type ^ESEND * NO OPERATOR COVERAGE AFTER time.

        8.  Type POP to return to OPR command level.

   Just before you end operator coverage, type to OPR:

        1.  PUSH.

        2.  ENABLE your capabilities.

        3.  Type ^ESET NO OPERATOR and press the RETURN key.

                                        NOTE

                    In the following steps,  the  ^C  has  to  be
                    typed  as  up-arrow C, not CTRL/C, and the ^E
                    and ^Z must be typed as CTRL/E and CTRL/Z.

        4.  ^ESPEAK
            JOB 0/
            ^C
            /Z

        5.  ^ESPEAK
            JOB 0/
            ATTACH OPERATOR 1

            POP

            /^Z





                                    4-31

                        STARTING THE HARDWARE SYSTEM


   After you type the above, the commands given to ^ESPEAK are printed on
   the  CTY.   Then the actual processing of the commands is indicated by
   output preceded by SJ  0:.  If  any  messages  are  output  by  PTYCON
   subjobs, they are also printed on the CTY preceded by SJ  0:.

                              ----- Hint -----

   The ^E commands are documented in detail  in  the  TOPS-20  Operator's
   Command Language Reference Manual.

                            ----- Example -----

        <CTRL/C>
        INSTALLATION-TEST SYSTEM, TOPS-20 MONITOR 7(21017)
        @ATTACH OPERATOR 1<RET>
        [ATTACHED TO TTY102 CONFIRM]<RET>
        PASSWORD: your password<RET>
        <RET>
        OPR>PUSH<RET>
        TOPS-20 COMMAND PROCESSOR 7(4103)
        @ENABLE<RET>
        $^ESEND * NO OPERATOR COVERAGE AFTER hh:mm<RET>
        $POP<RET>
        OPR>



   4.6  STARTING UP A SYSTEM IN A CFS-20 CLUSTER

   It is important that TOPS-20 systems clustered on  a  CI  be  able  to
   communicate  with each other and with HSC disk subsystems.  Therefore,
   when a CFS system initializes, it makes sure that it has: (1) an  open
   virtual circuit to the CI nodes that are already running and (2) a CFS
   connection to the TOPS-20 nodes among them.  If there are problems  in
   either  area,  the system sends a message to the CTY and then suspends
   the initialization process.  The system appears to hang.



   4.6.1  Virtual Circuits

   The CI20 creates a "system block" for each node that has responded  to
   its  start-up  request  for  recognition.  This block allows a virtual
   circuit to be established between  the  starting  system  and  another
   node.   (A  virtual  circuit  is  a  software  mechanism  that  allows
   inter-system communication and data transmission over  the  CI.)  When
   the  CI20 is unable to create the block, the following message is sent
   to the CTY:






                                    4-32

                        STARTING THE HARDWARE SYSTEM


   %CANNOT JOIN CLUSTER WITH NODE nn BECAUSE:  No System Block created

   where:  nn is the decimal number assigned to the  other  CFS  node  at
   installation

   This situation is often the result of a problem at the  remote  node's
   CI20.   You can usually correct the problem by shutting down that node
   and restarting it.  But first, examine CI-related BUGINFs and  BUGCHKs
   on each system's CTY to get a clue to the problem.

|  If the CI20 is unable to  create  a  virtual  circuit,  the  following
|  message is printed:
|  
|  %CANNOT JOIN CLUSTER WITH NODE nn BECAUSE:  No open Virtual Circuit

   At least one KLPOVC BUGINF appears on the  CTY  for  every  successful
   open virtual circuit.



   4.6.2  CFS Connections

   After a virtual circuit has  been  established,  the  starting  system
   tries  to  make  a  "CFS  connection," by way of the circuit, to every
   TOPS-20 system that is already running.  When the system cannot make a
   CFS connection, the following message is sent to the CTY:

   %CANNOT JOIN CLUSTER WITH NODE nn BECAUSE:  No CFS connection

   where:  nn is the decimal number assigned to the  other  CFS  node  at
   installation

   As with virtual  circuit  problems,  you  should  look  at  CI-related
   problems on each system's CTY.

|  A CFCONN BUGINF  appears  on  the  starting  system's  CTY  for  every
|  successful CFS connection.
|  
|  After a starting system has been successfully connected to all  nodes,
|  the following message appears on the CTY:
|  
|  [Successfully joined CFS cluster]












                                    4-33


























































                                    5-1













                                 CHAPTER 5

                        THE OPERATOR INTERFACE, OPR



   5.1  INTRODUCTION TO THE OPERATOR INTERFACE

   The Operator Command Language (OPR) provides you, the  operator,  with
   one  command  language  to  communicate with various components of the
   TOPS-20 operating system.  These components are:

        1.  QUASAR, the Batch System Nucleus

        2.  BATCON, the Batch Controller

        3.  LPTSPL, the Line-Printer Spooler

        4.  CDRIVE, the Card-Reader Spooler

        5.  SPRINT, the Reader Interpreter

        6.  SPROUT, the Card-Punch and Paper-Tape-Punch Spooler

        7.  MOUNTR, the Tape-Drive and Disk-Drive Controller

        8.  NEBULA, the cluster GALAXY inter-system message router

        9.  LISSPL, the cluster printer server  for  remote-node  cluster
            print requests

   In addition, you can use this same command language to interface  with
   any program requesting operator action to be taken, such as the PLEASE
   program, and with any user on the system.  The program  that  receives
   the  OPR  commands and communicates with all the other system programs
   is ORION.









                                    5-1

                        THE OPERATOR INTERFACE, OPR


   5.2  RUNNING OPR

   To  start  OPR,  you  must  have  WHEEL,  OPERATOR,  or  SEMI-OPERATOR
   privileges.   (See  your  system manager to obtain these privileges if
   you do not already have them.)

   To handle all batch software tasks and all PLEASE, MOUNT, and DISMOUNT
   requests,  you  must  have  OPR  running.   Normally,  commands in the
   PTYCON.ATO file start  OPR  automatically  as  a  PTYCON  subjob.   An
   example of the PTYCON.ATO file is shown below.

        SILENCE
        LOG
        DEFINE ^$OPR
        CONNECT OPR
        LOG OPERATOR FOO OPERATOR
        ENABLE
        OPR  
        TAKE SYS:SYSTEM.CMD
        PUSH
        ENABLE
        ^ESET LOGIN ANY
        ^ESEND * SYSTEM IN OPERATION
        POP
        WHAT ALL
        CONNECT OPR

   The command TAKE SYS:SYSTEM.CMD in the above command file executes any
   number   of  OPR  commands  to  set  and  start  devices  and  streams
   automatically.  An example of the SYSTEM.CMD file is shown below.

        SET BATCH-STREAM 0 TIME-LIMIT 5
        SET BATCH-STREAM 1 TIME-LIMIT 10
        SET BATCH-STREAM 2:3 TIME-LIMIT 11000
        SET BATCH-STREAM 3 PRIORITY-LIMITS 20:63
        SET BATCH-STREAM 0:1 PRIORITY-LIMITS 1:19
        START BATCH-STREAM 0:3
        SET PRINTER 0 PAGE-LIMIT 20000
        SET PRINTER 1 PAGE-LIMIT 500
        START PRINTER 0:1
        START READER 0
        START CARD-PUNCH 0

   These  commands  are  described  in  the  TOPS-20  Operator's  Command
   Language Reference Manual.









                                    5-2

                        THE OPERATOR INTERFACE, OPR


                                    NOTE

           It is the responsibility of  your  system  manager  to
           determine  whether OPR is to run as subjob 0 of PTYCON
           or  as  another  subjob.   In  addition,  your  system
           manager  should determine whether any other program or
           utility should be started as a PTYCON subjob.

           The tasks in this part and the following parts  assume
           that   you,  the  operator,  have  only  one  terminal
           available to perform the various tasks.  If  there  is
           more  than one terminal available to you, you may want
           to dedicate one terminal  to  run  only  OPR  and  use
           another  terminal  for  the various tasks, for example
           DUMPER.  One reason you would  use  two  terminals  is
           that while you were running a program like DUMPER, you
           could not receive any messages sent to or from OPR  on
           the  terminal  running  DUMPER.   However,  you  could
           receive the OPR messages on the terminal running OPR.

   To start OPR yourself under  a  job  with  OPERATOR  capability,  type
   ENABLE and then type OPR.

        @ENABLE<RET>
        $OPR<RET>
        OPR>

   If possible, you should have one hard-copy terminal dedicated to  OPR.
   The  reason  for  this  is that OPR is your primary interface with the
   operating system and its devices.  You can dedicate the CTY to running
   OPR  and  logging system messages by simply not using it for any other
   work.  You need not log in a job or ATTACH to any of  the  subjobs  of
   SYSJOB.   In  the  following  example  your  password  is FOO and your
   account is OPERATOR:

   If you choose to dedicate a hard-copy terminal to OPR, you can  ATTACH
   the job running PTYCON to the CTY.

















                                    5-3

                        THE OPERATOR INTERFACE, OPR


        <CTRL/C>
         KL2102 Development ALL System, TOPS-20 Monitor 7(21211)
        @ENABLE<RET>
        $SYSTAT OPERATOR<RET>

           0   DET  SYSJOB  OPERATOR
           1   205  PTYCON  OPERATOR
           2   207  BATCON  OPERATOR
           3   210  EXEC    OPERATOR
           4   211  OPR     OPERATOR
                    .
                    .
        $ATTACH OPERATOR 1<RET>
         [Attached to TTY205, CONFIRM]<RET>
        Password: FOO<RET>
        <RET>
        OPR>

   If your installation has  more  than  one  terminal  assigned  to  its
   operators,   you  can  run  multiple  copies  of  OPR  from  different
   terminals.  (See Section 5.2.2.) Thus, OPR can run as a  subjob  under
   PTYCON  at  one  terminal  and as a job by itself at another terminal.
   All OPRs have the same functionality as the OPR running as a subjob of
   PTYCON  and  connected  to the CTY.  ORION, OPR's controlling program,
   can handle an unlimited number of OPRs running.

   When you issue a command to OPR, it checks  the  command  for  format,
   syntax,  and  the placement of switches and values.  If the command is
   correct,  OPR  passes  the  command  to  ORION.   If  the  command  is
   incorrect,  OPR  outputs  an  error  message.  If you receive an error
   message, you can retype the entire OPR command,  or  press  CTRL/H  to
   reprint  the command up to the point where the error occurred.  (Refer
   to Section 5.3.3.)

   To exit from OPR at any time, type the EXIT command.  You  immediately
   return  to  TOPS-20  command level and are prompted by the dollar sign
   ($).  For example:

        OPR>EXIT<RET>
        $

   If OPR is a subjob of PTYCON, you can type CTRL/X to return to  PTYCON
   command level.  For example:

        OPR>^X
        PTYCON>

   In addition, you can also give the PUSH command to OPR  to  return  to
   TOPS-20  command  level.  You can execute any program or task and then
   give the POP command to return to OPR.  When you give the PUSH command
   to OPR, any messages sent to OPR will be displayed on the CTY.



                                    5-4

                        THE OPERATOR INTERFACE, OPR


        OPR>PUSH<RET>

         TOPS-20 Command processor 7(4404)
        @ENABLE<RET>
        $DUMPER<RET>
        DUMPER>
                   .
                   .
                   .
        $DISABLE<RET>
        @POP<RET>
        OPR>

   All OPR commands described in this manual are shown as they relate  to
   the  tasks  involved.  For a complete description of all OPR commands,
   their  arguments,  keywords,  and  switches,  refer  to  the   TOPS-20
   Operator's Command Language Reference Manual.



   5.2.1  Remote Operator Control

   5.2.1.1  DECnet and  IBM  Networks - If  your  system  is  part  of  a
   network,  you  can  have a TOPS-20 host with up to three communication
   front-ends.  These communication front-ends can control  DECnet-20  or
   IBM  communications software.  OPR provides you with the facilities to
   communicate with IBM-type termination stations, and to communicate  in
   a minimal fashion with an IBM* host.

   The /NODE:   switch  is  available  with  many  of  the  OPR  commands
   described  in  this  manual.  The /NODE:  switch allows you to specify
   the logical identifier (name) optionally followed by two  colons  (::)
   of a remote station in your system network.  This switch is valid only
   if  your  installation  has  installed  the  TOPS-20  DECnet  software
   package.   If DECnet is present, there can be remote station operators
   in the network.

   If you are a remote station  operator,  the  OPR  processing  at  your
   station  can  only  control  the  devices at your remote station.  All
   commands you specify default to your node in the  messages  passed  to
   ORION.   Therefore,  you  need not specify the /NODE:  switch with any
   OPR command for your node.  However, when you want to refer to another
   node  on  the  system,  you must specify the /NODE:  switch in the OPR
   command.

   In addition, you have complete control over all  jobs  located  and/or
   queued  for  your node, as compared with the Central Site operator who
   has control of all jobs and devices at all nodes on the system.
   ---------------

    * IBM is a registered trademark of  International  Business  Machines
      Corporation.


                                    5-5

                        THE OPERATOR INTERFACE, OPR


   A DECnet network will also enable you to start,  stop,  and  otherwise
   manipulate  printers connected to remote nodes in a CFS-20 cluster, as
   well as obtain information on them.  In addition, print  requests  can
   be  queued  to  printers connected to VMS systems.  These printers are
   Distributed Queue Service (DQS) devices or CFS-20 cluster printers.

   Table 5-1 shows the commands that you can use from your local terminal
   for remote control in various types of networks.



   5.2.1.2  Local Area Networks - Your system may be part of a local area
   network,  with  systems  and  output devices interconnected on the NI.
   Here, users can send output requests  to  printers  connected  to  LAT
   servers.    As  an  operator,  you  can  start,  stop,  and  otherwise
   manipulate these Local Area  Transport  (LAT)  printers,  as  well  as
   obtain information on them.

   You can perform these tasks from an OPR terminal on your local system.



   5.2.1.3  CFS-20 Clusters - There may be up to four systems in a CFS-20
   cluster sharing disk resources at your site.  In this type of network,
   if the cluster GALAXY facility is enabled, OPR lets you send  messages
   to  users  on  remote  systems,  get remote-system status information,
   mount/dismount remote structures, and  control  printers  on  all  the
   systems.

   Table 5-1 shows the commands you can use  from  a  local  terminal  in
   various  types of networks.  The /CLUSTER-NODE:  and /NODE:  switches,
   as well as the CFS, DQS, and LAT keywords, available with many of  the
   OPR  commands,  provide  the means for you to accomplish many of these
   remote activities.




















                                    5-6

                        THE OPERATOR INTERFACE, OPR


                            ----- Example -----

   Show the status of printer queues on all queues in a CFS-20 cluster:

   OPR>SHOW OPERATORS /CLUSTER-NODE:*<RET>
   OPR>
   16:01:16   -- Operators --

       Node      Type   Terminal    Job             User
   -----------  ------  --------    ---  ----------------------------
   SYSA         system       236    133  OPERATOR
   SYSA         system       453    163  HILL

   **** SEMI-OPR is enabled ****

   16:01:17  Received message from SYSB::
   16:01:21   -- Operators --

       Node      Type   Terminal    Job             User
   -----------  ------  --------    ---  ----------------------------
   SYSB         system       236     69  OPERATOR

   **** SEMI-OPR is enabled ****

   16:01:17  Received message from SYSC::
   16:01:07   -- Operators --

       Node      Type   Terminal    Job             User

   -----------  ------  --------    ---  ----------------------------
   SYSC        system       236    197  OPERATOR

   **** SEMI-OPR is enabled ****

   16:01:17  Received message from SYSD::
   16:01:17   -- Operators --

       Node      Type   Terminal    Job             User
   -----------  ------  --------    ---  ----------------------------
   SYSD        system       236      5  OPERATOR

   **** SEMI-OPR is enabled ****













                                    5-7

                        THE OPERATOR INTERFACE, OPR


   Table 5-1:  Remote Operator Commands Given from Your Local Terminal

   ______________________________________________________________________

   COMMANDS                                  NETWORKS           
                                                                CFS-20
                                             DQS      LAT       CLUSTER
   ______________________________________________________________________

   ALL  OPR  commands  except  ENTER,  EXIT,                    X
   HELP, PUSH, TAKE, WAIT

   ALL LCP commands                                             X

   ABORT                                     X        X         X

   ALIGN                                              X         X

   BACKSPACE                                          X         X

   CONTINUE PRINTER                          X        X         X
|  
|  DEFINE ALIAS                              X        X         X

   FORWARDSPACE                                       X         X

   NEXT                                      X        X         X

   REQUEUE                                   X        X         X

   ROUTE                                     X        X         X

   SEND ALL                                                     X

   SET PRINTER FORMS-TYPE                             X         X

   SET PRINTER LIMIT-EXCEEDED-ACTION         X        X         X

   SET PRINTER PAGE-LIMITS                   X        X         X

   SET PRINTER PRIORITY-LIMITS               X        X         X
|  
|  SHOW ALIAS                                X        X         X

   SHOW PARAMETERS PRINTER                   X        X         X

   SHOW QUEUES PRINTER                       X        X         X

   SHOW STATUS PRINTER                       X        X         X

   SHUTDOWN PRINTER                          X        X         X



                                    5-8

                        THE OPERATOR INTERFACE, OPR


   Table 5-1:  Remote Operator Commands Given from  Your  Local  Terminal
   (Cont.)


   COMMANDS                                  NETWORKS           
                                                                CFS-20
                                             DQS      LAT       CLUSTER

   START PRINTER                             X        X         X

   STOP PRINTER                              X        X         X

   SUPPRESS                                           X         X
   ______________________________________________________________________



   5.2.2  Multiple Operators on the System

   You can have more than one job  running  OPR  on  the  same  operating
   system.   ORION  keeps  track  of  each  OPR and sends the appropriate
   acknowledgement messages to the OPR that sent the command.

   Each OPR that is processing can be set to enable or disable the  types
   of  messages that are displayed at that OPR console.  Refer to Section
   5.4.1 for descriptions of the DISABLE and ENABLE commands.



   5.3  OPR COMMAND FEATURES

   The OPR command language has three command features that allow you  to
   do the following:

        1.  List available commands - ?

        2.  Use recognition - <ESC>

        3.  Reprint faulty commands - <CTRL/H>

   The command features are described in detail in the following sections
   of this manual.

   If you are a  remote  station  operator,  you  cannot  use  the  above
   features.   However,  you can obtain help with the HELP command at OPR
   command level.  See Section 5.3.4.

   Other CTRL/character commands such as CTRL/R and  CTRL/U  function  at
   OPR command level as they do at TOPS-20 command level.





                                    5-9

                        THE OPERATOR INTERFACE, OPR


   5.3.1  ?  (Question Mark) - Listing Available Commands

   The question mark feature lists all available commands to OPR.  If you
   are  in the process of entering a command, the question mark lists any
   command keywords, arguments, or switches  for  the  command  and  then
   retypes  your OPR command up to the point where you typed the question
   mark.

   When you type a ?  to OPR, it lists the available commands.  When  you
   type  a  ?   after an OPR command, OPR lists the available keywords to
   that command.  When you type a ?  after the  keyword,  OPR  lists  the
   available  values, arguments, and/or switches to that keyword.  If you
   type a ?  after an entire OPR command, OPR responds with  the  message
   "confirm with carriage return", retypes your entire command, and waits
   for you to press the carriage return key.

   Only the OPR  commands  EXIT  and  PUSH  do  not  have  any  keywords,
   arguments, or switches.

   After you have started OPR and the system prompts you with OPR>,  type
   a ?.

        @ENABLE<RET>
        $OPR<RET>
        OPR>? one of the following:
         ABORT       ALIGN      BACKSPACE       CANCEL      CLOSE
         CONTINUE    DEFINE     DISABLE         DISMOUNT    ENABLE
         ENTER       EXIT       FORWARDSPACE    HELP        HOLD
         IDENTIFY    MODIFY     MOUNT           NEXT        PUSH
         RELEASE     REPORT     REQUEUE         RESPOND     ROUTE
         SEND        SET        SHOW            SHUTDOWN    START
         STOP        SUPPRESS   SWITCH          TAKE        UNDEFINE
         WAIT
           or one of the following:
         LCP    NCP
        OPR>

                                    NOTE

           The DEFINE command appears in  the  above  example  if
           your  installation  has  DN60  software.   The  DEFINE
           command   is   described   in    the    TOPS-20    IBM
           Emulation/Termination Manual.



   5.3.2  ESCape - Using Recognition

   The ESCape key allows recognition input and guide words to  appear  on
   your console when you give an OPR command.




                                    5-10

                        THE OPERATOR INTERFACE, OPR


                                    NOTE

           All OPR commands accept  recognition  input  when  you
           press  the  ESCape  key  and most OPR commands provide
           guide words within parenthesis.  However, this is  the
           only  section  of  this  manual  that  describes  this
           feature of the OPR command language.

   Type the OPR command  ABORT  with  the  use  of  the  ESCape  key  for
   recognition and guide words.

            <ESC>                  <ESC>
              !                      !
        OPR>ABORT (Current Job on) BATCH-STREAM (Stream Number) 1-<RET>

          <ESC>          <ESC>
            !              !
        /REQUEST-ID:127/NOERROR-PROCESSING<RET>
        OPR>
        10:23:02        Batch-stream 1  --Aborted--
                        Job TBUILD Req #127 for HURLEY
                        No Reason Given with NOERROR-PROCESSING

        OPR>
        10:23:17        Batch-stream 1  --End--
                        Job TBUILD Req #127 for HURLEY
                        -- Job Aborted by Operator --
        OPR>

                                    NOTE

           If the terminal makes a bell-like sound, it is because
           the  character  you  typed  is  not  unique.   If this
           happens, type  in  another  character  and  press  the
           ESCAPE  key.  Continue to do this until the characters
           you typed are unique to the specific command.



   5.3.3  CTRL/H - Reprinting Faulty Commands

   The CTRL/H command causes OPR to retype your last command  up  to  the
   point  where  the  error occurred.  An OPR error message occurs when a
   command does not have the correct format, syntax, switch, or value.

   Specify the OPR command FORWARDSPACE, in  its  abbreviated  form,  but
   mistype  the  numeric  value for the /PAGES:  switch.  After you press
   CTRL/H, enter the correct numeric value.






                                    5-11

                        THE OPERATOR INTERFACE, OPR


        OPR>FORWARDSPACE PRINTER 0 /PAGES:3)<RET>
        ? Not confirmed: ""
        OPR><CTRL/H>
        OPR>FORWARDSPACE PRINTER 0 /PAGES:30<RET>

        OPR>
        13:25:04        Printer 0  --Forwardspaced 30 Pages--
        OPR>



   5.3.4  Getting Help from OPR

   Instead of using the question mark feature to list available commands,
   their keywords, and their arguments or switches, you can give the HELP
   command to OPR.

   The keyword to the HELP command is any of the OPR commands.  When  you
   give  the HELP command in this format, OPR prints on your terminal the
   function of  the  command  you  specify  with  its  format,  keywords,
   arguments, and switches.

   Specify HELP RELEASE and OPR prints the  function,  format,  keywords,
   and arguments of the RELEASE command.

        OPR>HELP RELEASE<RET>
                        --- Help for RELEASE command ---
                The RELEASE command allows you to release a job request
                that was held with the HOLD command.

                The format is:

                RELEASE keyword

                where keyword must be one of the following:

                          BATCH-JOBS
                          CARD-PUNCH-JOBS
                          PAPER-TAPE-PUNCH-JOBS
                          PLOTTER-JOBS
                          PRINTER-JOBS

                followed by one of these arguments:

                          <request-id-number>    (for a single job)
                          User name              (for all jobs of a user)
                          *                      (for all job requests)

        OPR>





                                    5-12

                        THE OPERATOR INTERFACE, OPR


   5.4  ORION TO OPR MESSAGES

   There are two types of messages that can appear at your OPR terminal.

        1.  OPR error messages (see Section 5.5.)

        2.  ORION to OPR messages

   The types of ORION messages that can appear are:

        1.  Errors generated when ORION accepts an OPR command, but  does
            not have the appropriate devices, streams, nodes, or jobs

        2.  Messages from jobs that start processing within a  stream  or
            on a device

        3.  Messages from jobs that end processing within a stream or  on
            a device

        4.  Messages specifying actions that you must perform for various
            devices, streams, or jobs

        5.  Messages to which you must RESPOND

        6.  Results from TAKE command files

        7.  Messages from NEBULA, in a CFS-20 configuration with  cluster
            GALAXY  enabled,  related  to structure MOUNTs/DISMOUNTs that
            involve remote systems in the cluster, SENDs to remote  nodes
            in  the  cluster,  status of remote nodes in the cluster, and
            other cluster-GALAXY activity

   Each OPR command that is sent to ORION is time stamped by  ORION  when
   the command is accepted and executed.  The acceptance and execution of
   the command is then returned to the OPR terminal  in  the  form  of  a
   message  with  the  time  stamp  as  the first eight characters of the
   message.  ORION to  OPR  error  messages  are  also  time-stamped  and
   displayed  at  the  OPR terminal in the same format.  For example, the
   OPR command:

        OPR>SET PRINTER 0 FORMS-TYPE NARROW<RET>

   prints on your terminal an ORION message in the format:

        hh:mm:ss        Printer 0  --Set Accepted--

   where hh is the hour, mm is the minutes, and ss is  the  seconds  that
   the  command  was accepted and executed.  Likewise, when ORION accepts
   an OPR command, but returns a message, that message will also  contain
   a time stamp.  For example, the OPR command:

        OPR>SHOW MESSAGES<RET>


                                    5-13

                        THE OPERATOR INTERFACE, OPR


   displays  the  following  information  message  when  there   are   no
   outstanding messages to respond to:

        hh:mm:ss        --No Outstanding Messages--

   When a particular job starts to process within a batch stream or on  a
   device,  ORION  displays  a message at your OPR terminal to notify you
   that the stream or device is active.  For example:

        hh:mm:ss        Batch-stream 0  -Begin--
                        Job TEST Req #274 for ZINA

        OPR>

   appears on your terminal when a job named TEST begins  to  process  in
   batch  stream  0 for user ZINA.  The hh:mm:ss at the beginning of this
   message is the time that the job started to process.

   Likewise, when a particular job ends its  processing  within  a  batch
   stream  or  on a device, ORION displays a message at your OPR terminal
   to notify you that the stream or device is not active and the job  has
   completed.  For example:

        hh:mm:ss        Batch-stream 0  -ENDED--
                        Job TEST Req #274 for ZINA

        OPR>

   appears on your terminal when a job named TEST ends the processing  in
   batch  stream  0 for user ZINA.  The hh:mm:ss at the beginning of this
   message is the time that the job ended the processing (hours, minutes,
   seconds).



   5.4.1  Controlling OPR Message Output

   You can control the types of messages that  appear  at  your  terminal
   with  the  use  of the OPR commands ENABLE and DISABLE.  When you give
   either of these commands specify the OUTPUT-DISPLAY keyword  with  one
   or more of the arguments described below.

   The ENABLE  OUTPUT-DISPLAY  command  and  the  DISABLE  OUTPUT-DISPLAY
   command  provide  the  mechanism  so that each terminal running OPR at
   your installation can have its own set of messages  appearing  on  its
   terminal.   Below  are  the descriptions of available arguments to the
   OUTPUT-DISPLAY keyword.

   ALL-MESSAGES                      prints all messages.  These messages
                                     include  the  messages  described by
                                     the remaining arguments.   When  you
                                     ENABLE      (or     DISABLE)     the


                                    5-14

                        THE OPERATOR INTERFACE, OPR


                                     OUTPUT-DISPLAY of all messages, then
                                     all  operator, system, device, user,
                                     and error messages do  (or  do  not)
                                     appear at the OPR terminal.

   BATCH-MESSAGES                    prints all  the  messages  generated
                                     when  batch job requests are entered
                                     into and processed by the system.

   BUGCHK-MESSAGES                   prints all BUGCHK messages generated
                                     by the system.

   BUGINF-MESSAGES                   prints all BUGINF messages generated
                                     by the system.

   CARD-PUNCH-MESSAGES               prints all  the  messages  generated
                                     when   users  request  cards  to  be
                                     punched as output from the system.

   CARD-READER-INTERPRETER-MESSAGES  prints all messages  generated  when
                                     cards   are   read  and  interpreted
                                     through the card reader  or  when  a
                                     batch  job  was  submitted  with the
                                     /READER switch specified.

   DECNET-EVENT-MESSAGES             prints all  DECNET  events  messages
                                     generated by NMLT20.

   DECNET-LINK-MESSAGES              prints all messages  generated  when
                                     an  attempt  to  establish a link to
                                     another node fails.

   FILE-RETRIEVAL-MESSAGES           prints all messages  generated  when
                                     users  request a retrieval of a file
                                     that has been archived  or  migrated
                                     to tape.

   LCP-MESSAGES                      prints all messages generated by LCP
                                     for LAT events.

   MOUNT-MESSAGES                    prints all messages  generated  when
                                     users   request  tape  or  structure
                                     mounts.

   NCP-MESSAGES                      prints all messages  generated  when
                                     users  start  and  shutdown  network
                                     nodes.    (Valid   only   if    your
                                     installation has DECnet software.)

|  NODE nodename                     enables   and   disables    messages
|                                    generated   on   the  specified  CFS
|                                    cluster node from appearing on  your


                                    5-15

                        THE OPERATOR INTERFACE, OPR


|                                    terminal.   (Refer  to Section 5.4.2
|                                    for related information.)  The  node
|                                    name can be abbreviated.

   PAPER-TAPE-PUNCH-MESSAGES         prints all messages  generated  when
                                     users    request    paper-tape-punch
                                     output from the system.

   PLOTTER-MESSAGES                  prints all messages  generated  when
                                     users  request  plotter  output from
                                     the system.

   PRINTER-MESSAGES                  prints all messages  generated  when
                                     users request line printer output.

   READER-MESSAGES                   prints all messages  generated  when
                                     jobs  are  entered  into  the system
                                     through  the  card   reader.    Card
                                     reader jobs become batch requests.

   SYSTEM-MESSAGES                   prints  system  messages  concerning
                                     system space and operation.

   USER-MESSAGES                     prints all messages  generated  when
                                     users make requests to you using the
                                     PLEASE  program.   These   are   WTO
                                     (Write-to-Operator)  messages,  WTOR
                                     (Write-to-Operator-with-Response)
                                     messages,   or   other  messages  as
                                     defined by the switches below.

   All above arguments with the exception of BUGCHK, BUGINF,  and  SYSTEM
   have  three  optional  switches.   If  you do not specify one of these
   switches with one of the above arguments, the system assumes all three
   that are described below.

   /INFORMATION-MESSAGES             messages  that  are   informational,
                                     such  as errors that occur due to an
                                     application  problem.    Also,   WTO
                                     messages  are considered information
                                     messages  from  users,  because   no
                                     response is necessary from you.

   /JOB-MESSAGES                     messages  that  notify  you  when  a
                                     device   or   stream  has  begun  to
                                     process a job request and  when  the
                                     job    request    has    ended   its
                                     processing.

   /OPR-ACTION-MESSAGES              messages that  notify  you  of  some
                                     action  to be performed as requested
                                     by a user or a job.   Also  included


                                    5-16

                        THE OPERATOR INTERFACE, OPR


                                     are  messages that require action to
                                     be taken, but are not  job  or  WTOR
                                     related.     All   operator   action
                                     messages must be answered  with  the
                                     RESPOND command.

                            ----- Examples -----

        1.  You have OPR at a terminal  for  file  retrievals  and  mount
            requests only.  Since all messages are enabled when you start
            OPR, you can DISABLE the output display of all  messages  and
            then  ENABLE  the  output  display of the file retrievals and
            mount requests.

            OPR>DISABLE OUTPUT-DISPLAY ALL-MESSAGES<RET>
            OPR>
            9:32:14        --Output Display for OPR Modified--
            OPR>ENABLE OUTPUT-DISPLAY FILE-RETRIEVAL-MESSAGES<RET>
            OPR>
            9:32:25        --Output Display for OPR Modified--
            OPR>ENABLE OUTPUT-DISPLAY MOUNT-MESSAGES<RET>
            OPR>
            9:32:37        --Output Display for OPR Modified--
            OPR>

        2.  You have OPR at a terminal for operator action messages only.

            OPR>DISABLE OUTPUT-DISPLAY ALL-MESSAGES/INFORMATION-MESSAGES
             /JOB-MESSAGES<RET>
            OPR>
            10:45:09        --Output Display for OPR Modified--
            OPR>
|  
|  
|  
|  5.4.2  Controlling OPR Message Output in a CFS-20 Cluster
|  
|  You can give a command that is processed on a remote cluster node  and
|  that  may result in an ORION message.  The message is displayed to all
|  the operators on the remote system, and then it is sent to your  local
|  node  where  it  is  displayed  to  local  operators  who have ENABLED
|  OUTPUT-DISPLAY for that message type from the remote node.
|  
|  You can use the following commands to control ORION output in a CFS-20
|  cluster:
|  
|        o  ENABLE/DISABLE BROADCAST-MESSAGES
|  
|           The ENABLE BROADCAST-MESSAGES command allows  ORION  messages
|           generated  on the local node to be sent to one or more remote
|           cluster nodes.  Furthermore, it allows the selective  sending
|           of  these  messages.   For  instance, you may want all except


                                    5-17

                        THE OPERATOR INTERFACE, OPR


|           BUGCHK messages sent if you  know  that  the  local  node  is
|           generating an excessive amount of BUGCHKs.
|  
|           The following illustrates this command:
|  
|           OPR>ENABLE BROADCAST-MESSAGES ?  one of the following:
|            ALL-MESSAGES              BATCH-MESSAGES
|            BUGCHK-MESSAGES           BUGINF-MESSAGES
|            CARD-PUNCH-MESSAGES       CARD-READER-INTERPRETER-MESSAGES
|            DECNET-EVENT-MESSAGES     DECNET-LINK-MESSAGES
|            FILE-RETRIEVAL-MESSAGES   MOUNT-MESSAGES
|            PAPER-TAPE-PUNCH-MESSAGES PLOTTER-MESSAGES
|            PRINTER-MESSAGES          READER-MESSAGES
|            SYSTEM-MESSAGES           USER-MESSAGES
|             or one of the following:
|            LCP-MESSAGES   NCP-MESSAGES
|  
|           OPR>ENABLE BROADCAST-MESSAGES ALL-MESSAGES NODE SYSA1
|           /CLUSTER-NODE:SYSB20<RET>
|  
|        o  ENABLE/DISABLE OUTPUT-DISPLAY
|  
|           The  NODE  keyword  to  the   ENABLE/DISABLE   OUTPUT-DISPLAY
|           commands  (described  in  Section 5.4.1) allows you to select
|           which ORION messages from remote nodes are displayed on  your
|           terminal.
|  
|        o  SHOW BROADCAST-MESSAGES
|  
|           This command shows whether  or  not  remote  broadcasting  of
|           ORION  messages  is  enabled or disabled to particular nodes.
|           For example:






















                                    5-18

                        THE OPERATOR INTERFACE, OPR


|           OPR>SHOW BROADCAST-MESSAGES<RET>
|           14:42:28                       -- Broadcast Messages --
             
|              SYSA1  SYSB20   SYSC1    Message Type
|             ------  ------  ------    ------------
|               Ena    Dis     Ena      All-messages       
|               Ena    Ena     Dis      Batch-messages
|               Ena    Ena     Ena      Bugchk-messages      
|               Dis    Dis     Dis      Buginf-messages
|               Ena    Dis     Dis      Card-punch-messages      
|               Dis    Ena     Dis      Card-reader-interpreter-messages
|               Dis    Ena     Dis      DECnet-event-messages      
|               Ena    Ena     Ena      DECnet-link-messages
|               Ena    Ena     Ena      File-retrieval-messages     
|               Dis    Dis     Dis      Mount-messages
|               Dis    Ena     Dis      Paper-tape-punch-messages     
|               Ena    Ena     Dis      Plotter-messages
|               Ena    Ena     Ena      Printer-messages      
|               Dis    Dis     Dis      Reader-messages
|               Ena    Ena     Ena      System-messages      
|               Dis    Dis     Ena      User-messages
             
|               Ena    Ena     Ena      LCP-messages 
|               Ena    Dis     Dis      NCP-messages
|  
|  
|        o  SHOW OPERATORS
|  
|           If the /ALL switch is included in this command, the display
|           shows whether or not particular messages are to be received
|           by the
|           different operators.  For example:
|  





















                                    5-19

                        THE OPERATOR INTERFACE, OPR


|           OPR>SHOW OPERATORS/ALL<RET>
|           OPR>
|           14:03:00                  -- Operators --
             
|               Node      Type   Terminal    Job             User
|           -----------  ------  --------    ---  ----------------------------
|           SYS1         system       435     76  HILL
|                SYSA1  SYSB20   SYSC1    Message Type
|               ------  ------  ------    ------------
|                 Ena    Dis     Ena      All-messages       
|                 Ena    Ena     Dis      Batch-messages
|                 Ena    Ena     Ena      Bugchk-messages      
|                 Dis    Dis     Dis      Buginf-messages
|                 Ena    Dis     Dis      Card-punch-messages      
|                 Dis    Ena     Dis      Card-reader-interpreter-messages
|                 Dis    Ena     Dis      DECnet-event-messages      
|                 Ena    Ena     Ena      DECnet-link-messages
|                 Ena    Ena     Ena      File-retrieval-messages     
|                 Dis    Dis     Dis      Mount-messages
|                 Dis    Ena     Dis      Paper-tape-punch-messages     
|                 Ena    Ena     Dis      Plotter-messages
|                 Ena    Ena     Ena      Printer-messages      
|                 Dis    Dis     Dis      Reader-messages
|                 Ena    Ena     Ena      System-messages      
|                 Dis    Dis     Ena      User-messages
             
|                 Ena    Ena     Ena      LCP-messages 
|                 Ena    Dis     Dis      NCP-messages
             
|           **** SEMI-OPR is enabled ****
|  



   5.5  OPR ERROR MESSAGE DESCRIPTIONS

   When OPR is running, it may print various  error  messages.   All  OPR
   error  messages  begin  with  a  ?   and  are  followed by the message
   explaining the error.  In addition, the ?  does not represent a  fatal
   error in OPR as it does in some other system programs.

   When you receive an error message, you can  press  CTRL/H  (to  retype
   your  OPR  command  up  to  the  point where you entered the incorrect
   keyword, switch, or value)  and  specify  the  correct  input  to  the
   command.   As  with  all  OPR commands, if you do not know the command
   format or you have forgotten the keywords, switches, or values, type a
   ?  and OPR lists the command arguments that you can specify.

   Refer to the TOPS-20 Operator's Command Language Reference Manual  for
   a complete description of all OPR error messages.




                                    5-20

                        THE OPERATOR INTERFACE, OPR


   5.6  UNPRIVILEGED OPR

   You can enable and disable operator-related  activity  for  users  who
   have been granted the SEMI-OPERATOR privilege.  For example:


   OPR>ENABLE SEMI-OPR<RET>

   09:06:03                          --SEMI-OPERATOR enable--
   OPR>

   OPR>DISABLE SEMI-OPR<RET>

   09:05:59                          --SEMI-OPERATOR disable--
   OPR>







































                                    5-21


























































                                    6-1













                                 CHAPTER 6

                            BATCH SOFTWARE TASKS



   The batch system operates under the control of the  TOPS-20  operating
   system  and  increases the efficiency of the system by processing jobs
   that do not require human interaction.  These types of jobs are  those
   that  are  large  and long-running, jobs that require large amounts of
   data, jobs that are frequently  run  for  production,  and  jobs  that
   require no interaction with the user.



   6.1  BATCH SYSTEM COMPONENTS

   The batch system consists of the following programs:

        1.  OPR

        2.  ORION

        3.  QUASAR

        4.  BATCON

        5.  LPTSPL

        6.  CDRIVE

        7.  SPRINT

        8.  SPROUT

        9.  NEBULA*

       10.  LISSPL*




   ---------------
   * If your system installer enabled the cluster GALAXY option.

                                    6-1

                            BATCH SOFTWARE TASKS


   OPR allows you to communicate with the various batch system components
   and  with the job requests that process jobs on the devices controlled
   by these components.  This  chapter  describes  the  OPR  commands  to
   accomplish these various batch software tasks.

   ORION is the interface between OPR and  all  other  batch  components.
   ORION logs each OPR command it receives and then passes the command to
   the appropriate program.

   QUASAR, the system queue manager, is the heart of  the  batch  system.
   It  is  responsible  for  scheduling  all  batch jobs entered into and
   processed from the system  queues  by  the  components  in  the  batch
   system.   BATCON,  the  batch  controller,  is the system program that
   initiates and controls the processing of batch jobs.   QUASAR  selects
   jobs  from  the  batch  input  queue  and  gives  them  to  BATCON for
   processing.  The OPR commands that have BATCH-STREAM  as  an  argument
   are the commands that allow you to control batch job processing.

   LPTSPL, the line-printer spooler, is a program that handles a specific
   printer  and  all  the  print  requests for the system including those
   submitted through the PRINT command,  spooled  requests  generated  by
   user  programs,  and  batch  job log files.  QUASAR selects jobs to be
   printed according to a variety of parameters.  The OPR  commands  that
   have PRINTER as an argument are the commands that allow you to control
   line printer processing.

   CDRIVE and SPRINT are responsible for the card-reader  input.   CDRIVE
   reads  cards  from the card reader(s), places the data on the cards on
   disk, and queues  a  request  for  SPRINT.   SPRINT  reads  the  data,
   interprets the $JOB card and other control cards, and then creates and
   submits the user's batch job to BATCON.  The OPR  commands  that  have
   READER  as  an  argument or keyword are the commands that allow you to
   control card reader processing.

   SPROUT, the card punch, paper-tape punch, and plotter spooler, is  the
   program  that  handles all the output requests other than line printer
   requests.  QUASAR selects data to be output on these devices according
   to  a  variety  of parameters.  The OPR commands that have CARD-PUNCH,
   PAPER-TAPE-PUNCH, and PLOTTER as arguments are the commands that allow
   you to control the output processing on these devices.

   NEBULA routes messages from the local ORION and QUASAR to  NEBULAs  on
   the  remote systems in the same CFS-20 cluster.  It routes messages to
   remote nodes in the cluster when you mount a  structure  on  a  remote
   system  or  dismount  a  structure  that  has been mounted on a remote
   system, request queue or other system information for remote nodes, or
   set a structure EXCLUSIVE.

   LISSPL "listens" for  print  requests  from  users  on  remote  CFS-20
   systems  in  the  cluster  and  routes  them  to  the local QUASAR for
   service.



                                    6-2

                            BATCH SOFTWARE TASKS


   6.2  BATCH RESPONSIBILITIES

   The batch software handles many tasks for  you.   However,  there  are
   still  many  operations  for you to perform in order to keep the batch
   system running efficiently.  These operations  are  important  because
   the  user  is  absent  and  dependent  on you to see that his jobs are
   completed.

   In the batch operating environment, your responsibilities are to:

        1.  Set batch-stream and peripheral parameters.

        2.  Adjust the parameters if necessary.

        3.  Service action requests from user jobs.

        4.  Maintain peripheral devices.

        5.  Get the cards read through the card reader when there  are  a
            large number of batch jobs being submitted on cards.

   If users are submitting batch jobs on card decks, your system  manager
   should establish for you:

        1.  Where the decks must be placed for submission

        2.  When the decks are read

        3.  Where and when the decks and output are returned to users

   In addition to the above tasks, you should  periodically  examine  the
   queues and be able to modify the requests if necessary.



   6.3  CONTROLLING BATCH STREAMS

   Before any batch request can be processed by the TOPS-20 batch system,
   batch  streams must be started so that the jobs can run.  In addition,
   you must have QUEUE-REQUESTS enabled so that all users can  issue  the
   SUBMIT  and  PRINT  commands.   If QUEUE-REQUESTS is disabled, and you
   give a SUBMIT or PRINT command, you receive a message specifying  that
   QUEUE-REQUESTS  is  disabled,  then  give  the  ENABLE  QUEUE-REQUESTS
   command from OPR command level.

        OPR>ENABLE QUEUE-REQUESTS<RET>
        OPR>

   The following are the OPR commands that allow  you  to  control  batch
   streams:

        1.  SET BATCH-STREAM


                                    6-3

                            BATCH SOFTWARE TASKS


        2.  START BATCH-STREAM

        3.  STOP BATCH-STREAM

        4.  CONTINUE BATCH-STREAM

        5.  SHUTDOWN BATCH-STREAM

        6.  SEND BATCH-STREAM

        7.  SHOW PARAMETERS BATCH-STREAM

        8.  SHOW STATUS BATCH-STREAM

|  The following sub-sections describe each of the commands  above.   You
|  can  use the /CLUSTER-NODE:  switch with each command to control batch
|  streams on specified nodes in a CFS-20 cluster.



   6.3.1  Setting Batch Stream Parameters

   Normally, a defined number of batch streams are started  automatically
   at  system start-up by the SYSTEM.CMD file.  This number is determined
   by your system manager.  However, you might start an additional  batch
   stream when there are more batch jobs than there are timesharing users
   on the system.  The parameters on any batch stream are used  to  limit
   the  use  of  that  stream  to  requests that meet a particular set of
   criteria.  Before you start the batch stream, set the  parameters  for
   the stream.  The default parameters for a batch stream are:

        1.  OPR-INTERVENTION

        2.  PRIORITY-LIMITS 1:63

        3.  TIME-LIMITS 0:600

   The OPR-INTERVENTION  parameter  specifies  that  the  user  can  pass
   messages  to you through the batch job and you can perform the actions
   requested, such as a tape mount or a structure dismount.   If  you  do
   not  want  OPR-INTERVENTION  to be in effect, set the batch stream for
   NO-OPR-INTERVENTION.  Then, any batch request  that  executes  in  the
   stream  and requests operator intervention is logged out automatically
   by the system.

   The PRIORITY-LIMITS parameter  allows  you  to  specify  the  priority
   (numeric  importance)  of  a batch stream or a range of batch streams.
   The default limits are from 1 to 63.  The greater the number  is,  the
   higher  the  priority.   If  you set a batch stream to have a priority
   limit of 31:41, only those batch requests submitted  with  a  priority
   limit of 31 to 41 are allowed to execute in that batch stream.



                                    6-4

                            BATCH SOFTWARE TASKS


   The TIME-LIMITS parameter allows you to specify the maximum  execution
   time  (in  minutes)  for  a  batch request to execute in the specified
   stream.  The default is from 0 to 3600 minutes.  If a job exceeds  the
   time  limit, it receives an additional 10% of the allotted time before
   the job is canceled automatically by the system.  If you set  a  batch
   stream  to  have  a  time  limit from 0 to 5 minutes, only those batch
   requests that are submitted with a time limit of 5 minutes or less are
   allowed to execute in that batch stream.

                            ----- Example -----

   Set a batch stream for NO-OPR-INTERVENTION with a priority limit of 50
   and a time limit of 90 minutes.

        OPR>SET BATCH-STREAM 7 NOOPR-INTERVENTION<RET>
         9:20:55        Batch-stream 7  --Set Accepted--
        OPR>SET BATCH-STREAM 7 PRIORITY-LIMITS 50<RET>
         9:21:15        Batch-stream 7  --Set Accepted--
        OPR>SET BATCH-STREAM 7 TIME-LIMITS 90<RET>
         9:21:40        Batch-stream 7  --Set Accepted--
        OPR>



   6.3.2  Starting Batch Streams

   Once you have set the parameters for a particular batch  stream  or  a
   range of batch streams, you can then start the stream(s) so that batch
   requests can be scheduled.  If you do not set any parameters  for  the
   stream,  the stream takes the default values described in the previous
   section.

   You can start one or more batch streams at a time.

   To stop the scheduling of batch job requests in a batch  stream  after
   you have started it, use the SHUTDOWN command.

                            ----- Example -----

   Issue the START BATCH-STREAM command to start up streams 6 and 7.

        OPR>START BATCH-STREAM 6:7 <RET>
        OPR>
        10:00:15        Batch-stream 6  --Startup Scheduled--
        OPR>
        10:00:17        Batch-stream 6  --Started--
        OPR>
        10:00:20        Batch-stream 7  --Startup Scheduled--
        OPR>
        10:00:22        Batch-stream 7  --Started--
        OPR>



                                    6-5

                            BATCH SOFTWARE TASKS


   6.3.3  Stopping Batch Streams Temporarily

   If you ever need to temporarily stop a batch  stream  or  a  range  of
   batch  streams,  use  the STOP command.  The STOP BATCH-STREAM command
   temporarily stops a batch stream from processing a job.  You must  use
   the  CONTINUE  command  to  resume the batch stream.  However, in some
   instances the job cannot be continued, depending upon the  point  when
   you issued the STOP command.

   The STOP command has three optional arguments.  They are:

        1.  AFTER CURRENT-REQUEST

        2.  AFTER EVERY-REQUEST

        3.  IMMEDIATELY

   The IMMEDIATELY argument is the default for the STOP  command.   Refer
   to  the  TOPS-20  Operator's  Command  Language Reference Manual for a
   complete description of these commands.

                            ----- Example -----

   Stop the processing of a job in batch stream 4 temporarily because  it
   is taking too much CPU time.

        OPR>STOP BATCH-STREAM 4<RET>
        OPR>
        11:23:09        Batch-stream 4  --Stopped--
        OPR>



   6.3.4  Continuing Batch Streams

   You can give the CONTINUE command to continue the processing of a  job
   (or  jobs)  in  a  batch  stream or a range of batch streams that were
   temporarily stopped with the STOP command.

                            ----- Example -----

   Continue the processing of a job in batch stream 4.

        OPR>CONTINUE BATCH-STREAM 4<RET>
        OPR>
        11:41:18        Batch-stream 4  --Continued--
        OPR>







                                    6-6

                            BATCH SOFTWARE TASKS


   6.3.5  Shutting Down Batch Streams

   If at any time you need to permanently stop a batch stream or a  range
   of  batch  streams,  use  the SHUTDOWN command.  If a job is currently
   processing in the batch stream, the shutdown is  first  scheduled  and
   when that job has been completed, the batch stream is shutdown.

   You must issue the START command to start a batch stream after it  has
   been SHUTDOWN.

                            ----- Example -----

   Shutdown batch stream 5 while a job is still processing in it.

        OPR>SHUTDOWN BATCH-STREAM 5<RET>
        OPR>
        13:34:45        Batch-stream 5  --Shutdown Scheduled--
        OPR>

        When the job in the batch stream has  completed  its  processing,
        the following message appears:

        OPR>
        13:38:25        Batch-stream 5  --Shutdown--
        OPR



   6.3.6  Sending Messages to Batch Streams

   When you need to send a message to a job in a batch stream,  give  the
   SEND BATCH-STREAM command.  You can specify a single-line message with
   the SEND command or press RETURN immediately after  the  batch  stream
   number  and  enter  as many lines as you need to.  You must then press
   CTRL/Z to terminate  the  SEND  command.   You  cannot  specify  batch
   streams in the SEND command.

                          ----- Restriction -----

   The batch stream to which you send the message must be active.  If the
   batch stream is not active, you receive the following message:

        hh:mm:ss        Batch-stream n  --Not Active--











                                    6-7

                            BATCH SOFTWARE TASKS


                            ----- Example -----

   Give the SEND command to notify the job in batch  stream  2  that  the
   requested tape volume cannot be found.

        OPR>SEND BATCH-STREAM 2<RET>
        Enter text and terminate with ^Z
        TAPE VOLUME PAY001 CANNOT BE FOUND IN OPERATIONS<RET>
        BATCH JOB WILL BE CANCELED<RET>
        <CTRL/Z>
                      
        OPR>ABORT BATCH-STREAM 2<RET>
        OPR>
        14:32:09        Batch-stream 2  --Aborted--
                        Job PAY090 Req #159 for ACCOUNTING
                        No Reason Given with ERROR-PROCESSING
        OPR>
        14:32:14        Batch-stream 2  --End--
                        Job PAY090 Req #159 for ACCOUNTING
                        -- Job Aborted by Operator --
        OPR>



   6.3.7  Displaying Batch Stream Parameters

   At any time you can display the current batch stream  parameters  with
   the  SHOW  PARAMETERS  BATCH-STREAM  command  for  one  or  more batch
   streams.  If you do not specify a single stream number or a  range  of
   stream  numbers, the SHOW command defaults to all the batch streams in
   the system.

   The output from the SHOW command displays for each batch stream:

        1.  the number of the batch stream

        2.  the range of processing minutes set for the batch stream

        3.  the priority range set for the batch stream

        4.  whether or not operator intervention has  been  set  for  the
            batch stream

   The display also includes the name of the CFS-20 node where the  batch
   stream  resides  and  the  times  that  the  remote node processed the
   command and the local system received the information, if you used the
   /CLUSTER-NODE:  switch.







                                    6-8

                            BATCH SOFTWARE TASKS


                            ----- Example -----

   Give  the  SHOW  PARAMETERS  BATCH-STREAM  command  to   display   the
   parameters of all current batch streams in the system.

        OPR>SHOW PARAMETERS BATCH-STREAM<RET>
        OPR>
        12:09:33            -- System Device Parameters--

        Batch-stream Parameters:
          Strm     Minutes    Prio  Opr-Intvn
          ----  -----------  -----  ---------
             0      0:10      1:19        Yes
             1      0:10      1:19        Yes
             2      0:11000   1:19        Yes
             3      0:11000  20:63        Yes

        OPR>



   6.3.8  Displaying Batch Stream Status

   At any time, you can display the status of one or more  batch  streams
   with  the  SHOW  STATUS BATCH-STREAM command.  If you do not specify a
   batch stream number or a range of numbers, the command defaults to all
   batch streams in the system.

   The output from the SHOW command displays for each batch stream:

        1.  the number of the batch stream

        2.  the current status of the batch stream

        3.  the name of the job currently active in the batch stream

        4.  the request-id of the job

        5.  the name of the user who made the job request


   The display also includes the name of the CFS-20 node where the  batch
   stream  resides  and  the  times  that  the  remote node processed the
   command and the local system received the information, if you used the
   /CLUSTER-NODE:  switch.

   If the batch stream is not active, the  word  "Idle"  appears  in  the
   Status  column with no job name, request-id, or user name.  If none of
   the batch streams are active, only the stream number and status appear
   in the display.




                                    6-9

                            BATCH SOFTWARE TASKS


   If a stream is active, the display also  shows  the  job  number,  the
   label  which  the job last encountered, and the run time used.  If you
   do not need this additional information with the display of  the  SHOW
   STATUS  BATCH-STREAM  command,  specify  the  /SHORT switch before you
   press RETURN to confirm the command.

                            ----- Example -----

   Give the SHOW STATUS  BATCH-STREAM  command  to  display  the  current
   status of all batch streams in the system.

        OPR>SHOW STATUS BATCH-STREAM<RET>
        OPR>
        19:19:57                -- System Device Status --

        Batch-stream Status:
          Strm      Status       Jobname  Req#            User
          ----  ---------------  -------  ----  ------------------------
             0  Idle           
             1  Active           FDLBLD     59  E.BROWN
                 Job# 18 Running MACRO Last Label: MACRO Runtime 0:00:42
             2  Idle             
             3  Active           PHYCAL     41  MANUFACTURING
                 Job# 31 Running COBOL Runtime 2:31:27

        OPR>



   6.4  CONTROLLING BATCH JOBS

   The following are the OPR commands that allow  you  to  control  batch
   jobs that users submit with the TOPS-20 SUBMIT command:

        1.  SHOW QUEUES BATCH-JOBS

        2.  HOLD BATCH-JOBS

        3.  RELEASE BATCH-JOBS

        4.  ABORT (current job on) BATCH-STREAM

        5.  REQUEUE (current job on) BATCH-STREAM

        6.  MODIFY BATCH-REQUEST

        7.  CANCEL BATCH-REQUEST

        8.  NEXT (job on) BATCH-STREAM





                                    6-10

                            BATCH SOFTWARE TASKS


   The following sub-sections describe how to use each of these  commands
|  to  control  batch  jobs.  You can use the /CLUSTER-NODE:  switch with
|  each command to control batch jobs on  specified  nodes  in  a  CFS-20
|  cluster.



   6.4.1  Examining Batch Jobs in the Queues

   Whenever a user submits a batch job, the job  is  placed  in  a  queue
   where  it  waits  for selection by the batch system for execution.  To
   examine the queues for batch jobs at any time, give  the  OPR  command
   SHOW QUEUES BATCH-JOBS.

   The  output  of  the  SHOW  QUEUES  BATCH-JOBS  command  displays  the
   following information for each job that is waiting or running:

        1.  the name of the batch job

        2.  the request-id number of the batch job

        3.  the scheduled run time of the batch job

        4.  the name of the user who submitted the batch job

   These four columns of the display appear  whether  the  batch  job  is
   currently running (active) or not running (not active).

   If the batch job is active in the batch stream, the display  shows  in
   which  stream the job is active, the job number, the last control file
   label encountered by the job, and the run time used.

   The display also includes the name of the CFS-20 node where the  batch
   stream  resides  and  the  times  that  the  remote node processed the
   command and the local system received the information, if you used the
   /CLUSTER-NODE:  switch.

   The SHOW QUEUES BATCH-JOBS command has five optional switches:

        1.  /NODE:name displays the batch queue of a remote system  whose
            jobs are to be processed on the local system.

        2.  /ALL adds to the display the switches that the user specified
            with  the SUBMIT command.  If no switches were specified, the
            /ALL switch displays the default switches.  In addition,  the
            /ALL  switch  displays  any  switches that you specified, for
            example, /HOLD.







                                    6-11

                            BATCH SOFTWARE TASKS


        3.  /SHORT displays only the job name, the  request  number,  the
            scheduled run time, and the user name.

        4.  /USER:name displays only the batch jobs of a specified user.

        5.  /CLUSTER-NODE:name displays the batch queue of the  specified
            remote  CFS-20  node.  If * is specified, the batch queues of
            all systems in the cluster are displayed.

                              ----- Hint -----

   The asterisk (*) before the  batch  job  name  column  (see  examples)
   indicates that the job is currently active.









































                                    6-12

                            BATCH SOFTWARE TASKS


                            ----- Examples -----

        1.  Give the SHOW QUEUES BATCH-JOBS command with the /ALL  switch
            to  display  the  batch  jobs  in  the  queue  with all their
            switches.

            OPR>SHOW QUEUES BATCH-JOBS /ALL <RET>
            OPR>
            15:02:58                -- System Queues Listing --

            Batch Queue:
            Job Name   Req#   Run Time            User
            --------  ------  --------  ------------------------
            * CHKFIM       9  00:05:00  NELSON                In Stream:0
                      /Uniq:Yes  /Restart:No  /Assist:Yes  /Output:Nolog
                      /Batlog:Append  /Seq:2041
                Job 18 Running DIRECT Last label: DIRECT Runtime 0:01:24
            * CISRV       13  00:15:00  CDUNN                 In Stream:3
                      /Uniq:No   /Restart:Yes /Assist:Yes  /Output:Nolog
                      /Batlog:Super   /Prio:20 /Seq:2039
                Job 33 Running MACRO Last label: CONT Runtime 0:02:05
            * BLDMM        5  00:20:00  MCINTEE               In Stream:2
                      /Uniq:Yes  /Restart:Yes  /Assist:Yes  /Output:Nolog
                      /Batlog:Super  /Prio:20  /Seq:2436
                Job 21 Running MACRO Runtime 0:00:54
              DBLDEV      14  01:00:00  MURPHY   /After: 1-Sep-82  0:00
                      /Uniq:Yes  /Restart:Yes  /Assist:Yes  /Output:Nolog
                      /Batlog:Super  /Prio:20  /Seq:2023

            There are 4 jobs in the Queue (3 in Progress)

            OPR>

        2.  Give the SHOW  QUEUES  BATCH-JOBS  command  with  the  /SHORT
            switch.

            OPR>SHOW QUEUES BATCH-JOBS /SHORT<RET>
            OPR>
            19:44:17            -- System Queues Listing --

            Batch Queue:
            * GENSCH    21  00:05:00  FRIES
              SBUILD    29  01:00:00  KIRSCHEN
              WEEKLY    37  00:05:00  OPERATOR
              SPEAR     39  00:05:00  OPERATOR

            OPR>







                                    6-13

                            BATCH SOFTWARE TASKS


   6.4.2  Holding Batch Jobs

   Whenever you need to prevent a batch job  from  processing,  give  the
   HOLD  BATCH-JOBS  command.   When  you  give this command, the current
   job(s) in the queue (as specified  by  one  of  the  arguments  listed
   below)  is  kept from being processed.  Any batch jobs submitted after
   the HOLD command are not held and are processed when a batch stream is
   available.   You must specify one of the following arguments with this
   command:

        1.  The request-id number, which holds a single batch job

        2.  The user name, which holds all batch jobs submitted  by  that
            user

        3.  An asterisk (*), which holds all batch jobs submitted by  all
            users

                             ----- Hints -----

   You cannot HOLD a batch job  that  is  currently  active  in  a  batch
   stream.

                            ----- Example -----

   Give the HOLD BATCH-JOBS command to hold all batch requests  for  user
   PURRETTA.

        OPR>HOLD BATCH-JOBS PURRETTA<RET>
        OPR>
         9:01:54        --6 Jobs Held--
        OPR>



   6.4.3  Releasing Batch Jobs

   You can give the RELEASE command to release a batch job that has  been
   previously  held  with  the  HOLD  command.   You can specify a single
   request-id number, the user name for all jobs  by  that  user,  or  an
   asterisk  (*)  for  all batch jobs in the system.  The RELEASE command
   reschedules the job(s) for processing.

                              ----- Hint -----

   You must have one or more batch streams started or in the  Idle  state
   to get a batch job processed.







                                    6-14

                            BATCH SOFTWARE TASKS


                            ----- Example -----

   Give the RELEASE command  to  reschedule  all  batch  jobs  that  were
   previously held.

        OPR>RELEASE BATCH-JOBS *<RET>
        OPR>
        10:38:09        --6 Jobs Released--
        OPR>



   6.4.4  Canceling Batch Jobs

   At various times, you might have to cancel a batch  job  while  it  is
   executing  in a batch stream.  You can give the ABORT command with the
   batch stream number and one or more of the following switches:

        1.  /REQUEST-ID:

        2.  /ERROR-PROCESSING, /NOERROR-PROCESSING, or /PURGE

        3.  /REASON:

   The /REQUEST-ID:  switch uniquely identifies the job to be canceled.

   The  /ERROR-PROCESSING,  /NOERROR-PROCESSING,  and   /PURGE   switches
   specify if there are error recovery procedures provided by the user or
   if the system is to flush the entire job from the system  when  it  is
   canceled.  You can specify only one of these switches.  The default is
   /ERROR-PROCESSING.

   The /REASON:  switch allows you to enter one or more lines of text  to
   explain why the batch job is being canceled.

                            ----- Example -----

   Give the ABORT  command  to  cancel  a  batch  job  that  requested  a
   structure that does not exist.

        OPR>ABORT BATCH-STREAM 0 /REASON:NO SUCH STRUCTURE<RET>
        OPR>
        11:32:08        BATCH-STREAM 0       JOB #45      --ABORTED--
                        Job TEST01 Req #35 for JONES
                        NO SUCH STRUCTURE with ERROR-PROCESSING
        OPR>
        11:32:12        Batch-stream 0  --End--
                        Job TEST01 Req #35 for JONES
                        -- Job Aborted by Operator --
        OPR>




                                    6-15

                            BATCH SOFTWARE TASKS


   6.4.5  Requeuing Batch Jobs

   At various times you might want to cancel a batch job  that  is  being
   processed and then reschedule it to be processed at a later time.  You
   can give the REQUEUE command to HOLD the batch job in its entirety and
   to ABORT its current processing.

   For example, you might want to  REQUEUE  a  batch  job  that  requires
   additional  structures  for  its  processing,  but you do not have any
   available disk drives.  Thus, you REQUEUE the job in its entirety  for
   processing when the disk drives become available.

   You can specify the /REASON switch to explain why  the  job  is  being
   requeued.

                            ----- Example -----

   Give the REQUEUE command to hold a batch job that requests  four  tape
   drives that are not available.

        OPR>REQUEUE BATCH-STREAM 2 /REASON:<RET>
        Enter text and terminate with ^Z
        JOB WILL BE RELEASED LATER WHEN TAPE DRIVES ARE AVAILABLE <CTRL/Z>
                                                                      
        OPR>
        13:21:03        BATCH-STREAM 2  --REQUEUED--
                        JOB TAPE01 Req #27 for HACHE
        OPR>
        13:21:05        Batch-stream 2  --End--
                        Job TAPE01 Req #27 for HACHE
                        -- Job Requeued by Operator--
        OPR>



   6.4.6  Modifying Batch Requests

   Whenever you need to change the priority of a batch job request in the
   queue,  give  the  MODIFY  BATCH-REQUEST  command.   You can specify a
   single batch request-id number, a user name for all requests  by  that
   user, or an asterisk (*) for all batch requests in the queue.

   You must specify a new PRIORITY number from 1 to 63.  The  higher  the
   number, the greater the priority.










                                    6-16

                            BATCH SOFTWARE TASKS


                            ----- Example -----

   Give the modify command to change the priority of batch request 135 to
   have  a priority of 63.  This causes the request to be the next job to
   be processed.

        OPR>MODIFY BATCH-REQUEST 135 PRIORITY 63<RET>
        OPR>
         8:51:21         --1 Request Modified--
        OPR>



   6.4.7  Deleting Batch Requests

   Whenever you need to cancel a batch request from the batch queue, give
   the CANCEL BATCH-REQUEST command.  You can specify a single request-id
   number, a user name for all jobs by that user, or an asterisk (*)  for
   all batch requests in the queue.

   If you CANCEL a batch request that is active in a  batch  stream,  the
   batch  job  is deleted immediately from the batch stream.  In this way
   the CANCEL command is the same as the ABORT  command.   The  log  file
   shows a message indicating that the job was deleted by the operator.

                            ----- Example -----

   Give the CANCEL command to batch request  168  from  the  batch  input
   queue.

        OPR>CANCEL BATCH-REQUEST 168<RET>
        OPR>
        10:25:11        --1 Job Canceled--
        OPR>



   6.4.8  Scheduling the Next Batch Request

   Whenever a user requests that his  batch  job  run  next  in  a  batch
   stream, give the next BATCH-STREAM command.

                              ----- Hint -----

   This command requires that you specify a  batch  stream  number.   The
   criteria  for  selecting a batch stream are dependent on your site and
   the immediate status of the batch streams.  If you look at the  active
   jobs in the batch streams, you might recognize a long running job, and
   thus avoid that stream.  Or the user may simply request that  his  job
   run in a certain stream.




                                    6-17

                            BATCH SOFTWARE TASKS


                            ----- Example -----

   Give the NEXT command to make request 66 the next job to run in  batch
   stream 0.

        OPR>NEXT BATCH-STREAM 0 REQUEST-ID 66<RET>
        OPR>
        10:43:11  Batch-Stream 0  --  NEXT request #66 scheduled --
        OPR>



   6.5  CONTROLLING THE LINE PRINTER

   To handle users' requests to have files printed, you must have one  or
   more  line  printers set for the parameters of the users' requests and
   the line printer(s) must be started.  Normally,  the  line  printer(s)
   are  automatically started at system start-up when the SYSTEM.CMD file
   is executed.

   After several listings have been printed, you must  remove  them  from
   the  line  printer,  separate  them, and distribute them.  Your system
   manager should set up the distribution method which includes:

        1.  Where you must put the listings so that users can  pick  them
            up

        2.  When you must distribute them

   The following are the OPR commands that allow you to control printers:

        1.  SET PRINTER

        2.  START PRINTER

        3.  STOP PRINTER

        4.  CONTINUE PRINTER

        5.  SHUTDOWN PRINTER

        6.  SHOW PARAMETERS PRINTER

        7.  SHOW STATUS PRINTER

|       8.  DEFINE/SHOW ALIAS

   The following sub-sections describe each of the commands  above.   The
   commands  let  you  control  local printers, attached to the system on
   which you are working, as well as remote printers.

   Note that local printers can include those attached to terminal lines:


                                    6-18

                            BATCH SOFTWARE TASKS


   Letterwriter  100 (LA100), LA50, or DECprinter III (LA120-RA and -RB).
   They are called terminal printers.

   You specify a remote printer with one of the following keywords to the
   commands above with the appropriate arguments:

   CLUSTER -- a printer connected to another TOPS-20 system in the CFS-20
   cluster.

   DQS -- a printer connected to a VMS system in the DECnet network.

   LAT -- a printer connected to a LAT server in the local area network.

|  You can use the /CLUSTER-NODE:  switch with each  command  to  control
|  printers on specified nodes in a CFS-20 cluster.

   Refer to Table 5-1 for the complete list of remote-operator commands.



   6.5.1  Setting the Line Printer

   Normally, a defined number of line printers are started  automatically
   at system start-up by the SYSTEM.CMD file.  However, you might have to
   start a line printer, for example, when a user requests a printer  for
   his  own use.  Before you start a line printer, you can optionally set
   the parameters for the line printer with the SET PRINTER command.  The
   parameters for this command are:

        1.  FORMS-TYPE

        2.  LIMIT-EXCEEDED-ACTION

        3.  PAGE-LIMITS

        4.  PRIORITY-LIMITS

   These parameters are set  by  your  system  manager  at  GALGEN  time.
   (Refer  to  the  TOPS-20  KL Model B Installation Guide for the GALGEN
   procedures.) When you change  the  FORMS-TYPE,  LIMIT-EXCEEDED-ACTION,
   PAGE-LIMITS,  or  PRIORITY-LIMITS for a printer, the change remains in
   effect until you make another change.

   The FORMS-TYPE parameter specifies the name of the form or the name of
   the  form  type.   The name of the form should be the same as the form
   name  in  the  LPFORM.INI  file.   Refer  to  Section  6.6.1  for  the
   description  and  use  of the LPFORM.INI file.  This parameter applies
   only to local and LAT printers.

   The LIMIT-EXCEEDED-ACTION parameter specifies  what  action,  if  any,
   should  be  taken if a printer job exceeds the output limit set by the
   user.  You can set this parameter to:


                                    6-19

                            BATCH SOFTWARE TASKS


        1.  RESPOND with either IGNORE (to continue  the  print  job)  or
            ABORT (to cancel the print job)

        2.  Always ABORT the print job when the limit has been exceeded

        3.  Always IGNORE the output page limit of the line printer

   The PAGE-LIMITS parameter specifies the  minimum-to-maximum  range  of
   pages allowed to print per job on the line printer.

   The  PRIORITY-LIMITS  parameter  specifies  the  range  of  print  job
   priorities  that  the printer accepts.  For example, if a print job is
   queued with a priority of 19 and there are no line printers that  have
   been  set  to accept a priority of 19, the print request is queued but
   not printed.  The request remains in the  print  queue  until  a  line
   printer has been set to accept that priority.  However, you can change
   the priority number of a print request with the MODIFY  PRINT-REQUESTS
   command.  (Refer to Section 6.7.6.)

                            ----- Example -----

   Set line printer 0 to print requests with a priority from 1 to 21  and
   a page limit from 1 to 1000.

        OPR>SET PRINTER 0 PRIORITY LIMIT 21<RET>
        OPR>
        12:01:21        Printer 0  --Set Accepted--
        OPR>SET PRINTER 0 PAGE-LIMITS 1000<RET>

        12:01:40        Printer 0  --Set Accepted--
        OPR>



   6.5.2  Starting the Line Printer

   Once you have set the parameters for one or more  line  printers,  you
   can then start the printer(s) so that print requests can be processed.
   If you do not set any parameters for the printer, the  parameters  are
   the parameters set by your system manager at GALGEN time.

   You can start one or more (local only) line printers at a time.

   Refer to the TOPS-20 Operator's Command Language Reference Manual  for
   complete  information  on  starting  DQS,  LAT,  cluster, and terminal
   printers.

   To stop the scheduling of jobs on a line  printer,  use  the  SHUTDOWN
   command.





                                    6-20

                            BATCH SOFTWARE TASKS


                            ----- Example -----

        1.  Issue the START PRINTER command to start line printer 0.

            OPR>START PRINTER 0<RET>
            OPR>
            10:11:15        Printer 0  --Startup Scheduled--
            OPR>
            10:11:17        Printer 0  --Started--
            OPR>

        2.  Issue the START PRINTER command to start an LA120 terminal
            printer on terminal line 14.

            OPR>START PRINTER 3/DEVICE:TTY14:-<RET>
            /TERMINAL-CHARACTERISTIC:LA120<RET> OPR>

            The argument for the /TERMINAL-CHARACTERISTIC:  switch must
            be a value established by your system manager.



   6.5.3  Stopping the Line Printer Temporarily

   If you need to stop one or more line printers, use  the  STOP  PRINTER
   command.   The STOP PRINTER command temporarily stops the line printer
   from printing its current job.  You must give the CONTINUE command  to
   allow the line printer to continue printing the job.

   The STOP command has three optional arguments.  They are:

        1.  AFTER CURRENT-REQUEST

        2.  AFTER EVERY-REQUEST

        3.  IMMEDIATELY

   The IMMEDIATELY argument is the default for the STOP  command.   Refer
   to  the  TOPS-20  Operator's  Command  Language Reference Manual for a
   complete description of these commands.

                            ----- Example -----

   Stop the current job on line printer 2 temporarily in order to  change
   the printer's ribbon.

        OPR>STOP PRINTER 2<RET>
        OPR>
        18:24:09        Printer 2  --Stopped--
        OPR>




                                    6-21

                            BATCH SOFTWARE TASKS


   6.5.4  Continuing the Line Printer

   You can give the CONTINUE command to  continue  the  processing  of  a
   print  request  on  one  or  more  line printers that were temporarily
   stopped with the STOP command.

                            ----- Example -----

   After stopping the  line  printer  to  change  the  printer's  ribbon,
   continue the processing of the current print job.

        OPR>CONTINUE PRINTER 2<RET>
        OPR>
        18:30:41        Printer 2  --Continued--
        OPR>



   6.5.5  Shutting Down the Line Printer

   If at any time you need to shut down the scheduling of print  requests
   for  one  or more line printers, use the SHUTDOWN command.  If a print
   request is currently printing on the  line  printer,  the  request  is
   completed before the line printer is shut down.

   To start the scheduling of jobs on the line  printer,  use  the  START
   command.

                            ----- Example -----

   Shutdown line printer 2 while a request is still printing on it.

        OPR>SHUTDOWN PRINTER 2<RET>
        OPR>
        19:21:03        Printer 2  --Shutdown at EOJ Scheduled--
        OPR>

   When the request on the line printer has been completed, the following
   message appears:

        OPR>
        19:22:54        Printer 2  --Shutdown--
        OPR>



   6.5.6  Displaying Line Printer Parameters

   At any time you can display the current line  printer  parameters  for
   one  or  more  line printers with the SHOW PARAMETERS PRINTER command.
   If you do not specify a single line printer unit number,  a  range  of
   unit numbers, a remote-printer keyword, or the /CLUSTER-NODE:  switch,
   the SHOW command displays information for all line printers.

                                    6-22

                            BATCH SOFTWARE TASKS


   The output from the SHOW PARAMETERS PRINTER command displays for  each
   printer:
|  
|       1.  The aliases for local, cluster, DQS, and LAT printers

        2.  The printer unit number

        3.  The page limits set for the line printer

        4.  The type of forms set for the line printer

        5.  The priority range set for the line printer

        6.  The limit-exceeded-action set for the line printer

        7.  The character device type set for the line printer (uppercase
            or lowercase)

        8.  The queue and node names associated with DQS printers

        9.  The port (or service) and server names  associated  with  LAT
            printers

       10.  The name of the node where the print requests are  routed  if
            the printer is a cluster printer

   In addition, the display includes the name of the  CFS-20  node  where
   the  printer  was started and the times that the remote node processed
   the command and the local system  received  the  information,  if  you
   specified /CLUSTER-NODE:  on the command line.
























                                    6-23

                            BATCH SOFTWARE TASKS


                            ----- Example -----

   Give the SHOW PARAMETERS PRINTER command to display the parameters  of
   all line printers.

   OPR>SHOW PARAMETERS PRINTER <RET>
   OPR>
|  
|  14:34:30                          -- System Device Parameters --
|  
|  Printer Parameters:
|  
|  Local printers
|     Alias  Unit  Page Limits  Form    Prio  Lim-Ex   Chars  Dev-Chars
|    ------  ----  ----------- ------  -----  ------  ------  ---------
|     HARLI     0      0:1000  NORMAL   1:63  Ask             Lower
|       BAR     2      0:250   LQP02    1:63  Ask     LQP02   Lower  TTY2:
|  
|  Cluster printers
|     Alias  Unit      Node        Page Limits     Prio  Lim-Ex
|    ------  ----    ------        ------------   -----  ------
|       FOO     0      SYSA           0:1000000    1:63  Ask
|      BINN     1      SYSB           1:500        1:63  Ask
|  
|  DQS printers
|   Alias           DQS queue name           Node   Page Limits     Prio  Lim-Ex 
|  ------ -------------------------------    ------  -----------     ----  ------
|   LARRY                       TOPS$LN03      CREM      0:250       1:63  Ask  
|                                 SI$8700      ZORA      0:10000     1:63  Proceed
|     JOE                        LVD$LN03       BCT      0:250       1:63  Proceed
|                               SI$87PLOT      WORD      0:10000     1:63  Proceed
|   SHEMP                       SI$BENSON      WORD      0:10000     1:63  Proceed
|  
|  LAT PORT printers
|   Alias      Port name     Server    Page Limits    Form    Prio  Lim-Ex 
|  ------  ----------------  ------    -----------   ------   ----  ------
|    LAT1       24004_LN03A    LAT1        0:250     NORMAL   1:63  Proceed 
|    LAT2       24004_LN03B   LAT70        0:250     NORMAL   1:63  Proceed
|    LAT3              LN03   LAT71        0:250     NORMAL   1:63  Proceed   
|  
|  OPR>
|  



   6.5.7  Displaying Line Printer Status

   At any time you can display the status of one or  more  line  printers
   with  the  SHOW  STATUS PRINTER command.  If you do not specify a line
   printer unit number or a range of unit numbers, the  command  displays
   information for all line printers on the system.



                                    6-24

                            BATCH SOFTWARE TASKS


   The output from the SHOW STATUS PRINTER command displays:
|  
|       1.  The aliases for local, cluster, DQS, and LAT printers

        2.  The printer unit number

        3.  The current status of the printer

        4.  The name of the job currently active on the printer

        5.  The request-id number for the job

        6.  The name of the user who made the print request

        7.  The queue and node names associated with DQS printers

        8.  The port (or service) and server names  associated  with  LAT
            printers

        9.  The name of the node where the print request  was  routed  if
            the printer is a cluster printer

   In addition, the display includes the name of the  CFS-20  node  where
   the  printer  was started and the times that the remote node processed
   the command and the local system  received  the  information,  if  you
   specified /CLUSTER-NODE:  on the command line.

   If the line printer is not active, the  word  "Idle"  appears  in  the
   Status  column with no job name, request-id, or user name.  If none of
   the line printers are active, only the stream number and status appear
   in the display.

   If a printer is active, the display also shows the time that the print
   request started to print and the number of pages printed thus far.  If
   you do not need this information with the display of the  SHOW  STATUS
   PRINTER  command, specify the /SHORT switch before you press RETURN to
   confirm the command.

















                                    6-25

                            BATCH SOFTWARE TASKS


                            ----- Example -----

   Give the SHOW STATUS PRINTER command to display the current status  of
   printers.

   OPR>SHOW STATUS PRINTER <RET>
|  
|  14:34:40                          -- System Device Status --
|  
|  Local printers
|    Alias  Unit      Status       Jobname   Req#             User
|   ------  ----  --------------   -------   ----    ------------------------
|    HARLI     0  Active           G          144    LESTER
|          Started at 12:55:00
|      FOO     2  Idle             
|  
|  
|  Cluster printers
|    Alias  Unit   Node        Status      Jobname  Req#  User
|   ------  -----  -----  ---------------  -------  ----  ------------------------
|      FOO      0   SYSA  Active           GERRY     139  LESTER
|        Started at 13:12:38, printed 1 of 3 pages
|     BINN      1   SYSB  Idle
|  
|  
|  DQS printers
|     Alias           DQS queue name          Node         Status       Jobname
|    ------  ------------------------------  ------   ---------------   -------
|       FOO                       TOPS$LN03  CREM     Active            FUN-SPC
|          Req#39   User:LESTER       Started at 16:06:55
|                                   SI$8700  ZORA     Idle
|                                  LVD$LN03  SYSA     Idle
|       BAR                       SI$87PLOT  WORD     Idle
|                                 SI$BENSON  WORD     Idle
|  
|  LAT PORT printers
|     Alias      Port name     Server  Status          Jobname  Req#  User
|    ------  ----------------  ------  --------------  -------  ----  ----
|        L1       24004_LN03A  LAT1    Active          TRIP       40  OPERATOR
|          Started at 16:07:30
|        L2       24004_LN03B  LAT70   Idle 
|        L3              LN03  LAT71   Idle
|  











                                    6-26

                            BATCH SOFTWARE TASKS


|  6.5.8  Assigning Aliases to Printers
|  
|  Assigning aliases is especially useful  with  DQS,  LAT,  and  cluster
|  printers.     Without    aliases,    the    operator    must    supply
|  printer-identification  details  to  commands   that   control   these
|  printers.  For example, to start a printer with the command, OPR>START
|  PRINTER LAT PORT LN03 SERVER LAT1, the operator must know the LAT port
|  and server names associated with the printer.
|  
|  With aliases, the operator can refer to printers by unique names  that
|  appear in OPR displays and in the operator log file.
|  
|  Major Characteristics
|  
|        o  An alias can be up to six characters long.
|  
|        o  An alias cannot begin with the letter C, D, or L.
|  
|        o  Only one alias can be defined for a printer.
|  
|        o  Aliases are recognized only by the OPR> commands, not by  the
|           EXEC user and privileged commands.
|  
|  
|  Refer to the TOPS-20 Operator's Command Language Reference Manual  for
|  a complete description of the printer alias feature.
|  
|                           ----- Examples -----
|  
|       1.  Assign the alias PRI1 to cluster printer 1 on node ZORA.
|  
|           OPR>DEFINE ALIAS PRI1 CLUSTER 1 NODE ZORA::
|  
|       2.  Change aliases so that the name for cluster printer 1 on ZORA
|           is now PRINT1, and the PRI1 alias is removed.
|  
|           OPR>DEFINE ALIAS PRINT1 PRI1
|  
|       3.  Remove an alias.
|  
|           OPR>DEFINE ALIAS PRINT1













                                    6-27

                            BATCH SOFTWARE TASKS


|  6.5.9  Displaying Printer Aliases
|  
|  The  SHOW  ALIAS  command  displays  aliases  and  associated  printer
|  specifications in several ways:
|  
|        o  For all local and remote printers
|  
|        o  For a specific printer type -- cluster, DQS, or LAT
|  
|        o  For a specific printer
|  
|                           ----- Example -----
|  
|  Display aliases and file specifications for all printers.
|  
|  OPR>SHOW ALIAS<RET>
|  14:34:30                          -- Printer Alias Names --
|  Printer Alias:
|  
|  Local printers
|     Alias  Unit
|    ------  ----
|     HARLI     0
|       FOO     2
|  
|  DQS printers
|   Alias                DQS queue name            Node   
|  ------      -------------------------------   ------
|   LARRY                            TOPS$LN03     SYSA      
|     JOE                             LVD$LN03     SYSB      
|   SHEMP                            SI$BENSON     WORD      
|  
|  LAT PORT printers
|   Alias              Port name    Server  
|  ------       ----------------    ------  
|    LAT1            24004_LN03A     LAT1  
|    LAT2            24004_LN03B     LAT70  
|    LAT3                   LN03     LAT71  
|  
|  LAT SERVER printers
|  Alias                             Service name    Server
|  -----                             ------------    ------
|    FOO                                   LN03_4     LAT_1











                                    6-28

                            BATCH SOFTWARE TASKS


   6.6  CONTROLLING FORMS ON THE LINE PRINTER

   The following are the OPR commands that allow you to control the forms
   on local line printers:

        1.  ALIGN PRINTER

        2.  BACKSPACE PRINTER

        3.  FORWARDSPACE PRINTER

        4.  SUPPRESS PRINTER

   You can give the above commands  either  while  the  line  printer  is
   printing  the  job or after you have pressed the ONLINE/OFFLINE key on
   the line printer.  When you put the line printer off-line,  OPR  sends
   the following message to the CTY.

        hh:mm:ss        Printer n  --Offline--

   When you put the  line  printer  on-line,  the  line  printer  resumes
   printing.

   In addition, the SET PRINTER n or LAT FORMS-TYPE name command  permits
   you to change the type of forms on the line printer.  If you specify a
   forms type that does not have an entry in  the  LPFORM.INI  file,  the
   forms characteristics default to:

        1.  /BANNER:2

        2.  /HEADER:2

        3.  /LINES:60

        4.  /VFU:NORMAL

        5.  /WIDTH:132

        6.  /TRAILER:2

   Refer  to  Section  6.6.1  for   a   complete   description   of   the
   SYS:LPFORM.INI file and its available switches.

   To allow yourself or a user to change the forms on a line printer,  be
   sure you have OPERATOR-IN-ATTENDANCE set.  (See Section 8.1.)

   Note that the LP05 and  LP14  line  printers  have  a  direct  access,
   vertical  format unit.  (Refer to MAKVFU.DOC and MAKVFU.HLP.) However,
   the LP10 line printer uses a standard sprocketed carriage tape for the
   vertical format unit.




                                    6-29

                            BATCH SOFTWARE TASKS


   When the first job request starts  to  print,  the  following  message
   appears,  indicating  the  forms  type being loaded into the printer's
   vertical format unit (VFU):

        hh:mm:ss        Print n  --Loading VFU with 'forms-type'--

   This is strictly an informational message  that  appears  because  the
   system reads the LPFORM.INI file when you start a line printer.

   The following sub-sections describe how to use the LPFORM.INI file and
|  how  to  use  each  of  the  commands  listed  above.  You can use the
|  /CLUSTER-NODE:  switch with each command to control forms on specified
|  nodes in a CFS-20 cluster.



   6.6.1  The LPFORM.INI File

   The LPFORM.INI file allows you to set various  printer  parameters  on
   the basis of form names:

   Each line in the LPFORM.INI file is written in the following format:

        formname:locator/switch1/switch2/switch3...

   where:

        formname            is a 1- to 6-character form name.  The system
                            manager  should  specify  form names that are
                            descriptive of the types  of  forms  used  at
                            your installation.

        :locator            is an optional locator field containing:

                            ALL       all devices (the default).

                            LAT       all LAT printers

                            LOC       all local line printers.

                            LPTnnn    a specific line-printer,  where  nn
                                      is the printer number.

                            REM       line printers at remote stations.

        /switch1...         are one or more switches available to you  to
                            describe the manner in which the forms are to
                            be  used.   Refer  to   Table   6-1   for   a
                            description of the available switches.





                                    6-30

                            BATCH SOFTWARE TASKS


   Table 6-1:  LPFORM.INI Switches

   ______________________________________________________________________

          Switch                            Meaning
   ______________________________________________________________________

     /ALIGN:filespec        The filespec specifies the  file  with  the
                            extension  .ALP, which is used to align the
                            forms on the line printer.  If no  filespec
                            is  specified,  the  system  uses  the file
                            whose filespec is the  name  of  the  form.
                            For   example,   /ALIGN   for  NARROW  uses
                            SYS:NARROW.ALP by default.   The  alignment
                            occurs before the requested file is printed
                            and is not repeated  if  multiple  requests
                            for  the same forms occur for the same line
                            printer.

     /BANNER:nn             The value of nn  specifies  the  number  of
                            banner  pages  (job  header pages) desired.
                            The default is 2 pages and may  be  changed
                            with GALGEN.

     /CHAIN:xxx             The  xxx  represents  a 1-  to  6-character
        or                  ASCII  string that  specifies  the chain or
     /DRUM:xxx              drum to be used on the printer.  The system
                            types  the switch name and argument on your
                            terminal when the forms are scheduled.   If
                            you  specify  both  the  /CHAIN  and  /DRUM
                            switches  for  the  same   entry   in   the
                            LPFORM.INI  file,  OPR prints only the last
                            one it encounters.

     /HEADER:nn             The value of nn  specifies  the  number  of
                            file  header pages desired.  The default is
                            2 pages and may be changed with GALGEN.

     /LINES:nn              The value of nn  specifies  the  number  of
                            lines  that  can  be  printed on each page.
                            The default is 60.  This switch  should  be
                            included  whenever a form type is longer or
                            shorter than the normal 60 lines.

     /NOTE:text             The  text  represents  text  of  up  to  50
                            characters   that  is  typed  on  your  OPR
                            terminal at the time the forms and/or print
                            request are scheduled.






                                    6-31

                            BATCH SOFTWARE TASKS


     /RAM:name              The name represents  a  1-  to  6-character
                            ASCII string that specifies the name of the
                            control RAM to be used.   The  /RAM  switch
                            loads   a   special   program  that  allows
                            character translation on the line  printer.
                            If  the  line  printer has a program loaded
                            RAM (DARAM), the system automatically loads
                            it from the file SYS:name.RAM.

                            For example, if your line  printer  doesn't
                            print  left  and  right angle brackets, you
                            could specify a RAM file that would convert
                            angle  brackets  to  square brackets on the
                            line-printer output.

     /RIBBON:name           The name represents  a  1-  to  6-character
                            ASCII  string  that  specifies  the type of
                            ribbon to be used on the line printer.  The
                            system  types  the switch name and argument
                            on your terminal at the time that the forms
                            are scheduled.

     /TAPE:name             The name  represents  a  1- to  6-character
         or                 ASCII  string that specifies  the  name  of
     /VFU:name              the vertical forms control tape to be used.
                            If  the  line  printer has a program loaded
                            VFU (DAVFU), the system automatically loads
                            it from the file SYS:name.VFU.  If the line
                            printer does not have a DAVFU,  the  system
                            notifies  you of the need to change the VFU
                            tape.  The default VFU name is NORMAL.

     /TRAILER:nn            The value of nn specifies the number of job
                            trailer  pages  desired.   The default is 2
                            pages and may be changed with GALGEN.

     /WIDTH:nn              The value of nn  specifies  the  number  of
                            characters  per  line  for  the  form.  The
                            default width is 132 if the  /WIDTH  switch
                            is not specified.  The /WIDTH switch should
                            be included whenever  a  form  is  narrower
                            than the standard 14-inch wide paper.
   ______________________________________________________________________


   The form name in LPFORM.INI need not be the name of a  physical  form;
   however,  it  ought to specify the type of form (such as NORMAL forms,
   NARROW forms, and so forth).  When a print  request  is  made,  LPTSPL
   compares  the form name associated with the request with the form name
   of the form currently mounted on the line printer.  If the first  four
   characters  of  the name are not the same, then LPTSPL requests you to
   change the forms on the line printer.  If the first four characters of
   the name are the same, then LPTSPL checks the switches associated with
   the requested form name and uses those values when printing the job.
                                    6-32

                            BATCH SOFTWARE TASKS


   If the forms type specified by the user is not the same  as  the  form
   that  is  currently  in  the  printer,  the system uses the first four
   characters to check against the LPFORM.INI file.  (This four-character
   uniqueness  can  be  changed  by  GALGEN; the default is four.) If the
   forms type matches one in the file, a  request  is  made  for  you  to
   supply  the  appropriate  form.   If  the  forms  type  is  not in the
   LPFORM.INI file, you receive an error.

   For example, note the following LPFORM.INI file:

        NARROW/HEADER:1/BANNER:1/TRAILER:1
        NARR01/HEADER:0/BANNER:1/TRAILER:1
        NARR02/HEADER:0/BANNER:0/TRAILER:0/NOTE:SPECIAL

   Now, suppose that NARR01 forms  are  currently  mounted  on  the  line
   printer  and  a user makes a print request that requires NARR02 forms.
   The system compares the first four characters of  the  requested  form
   name  (NARR02) with the first four characters of the form name for the
   form that is currently mounted on the line printer (NARR01).   Because
   they  are the same, the system takes the switch values associated with
   NARR01 and applies them to the user's print request.   Therefore,  the
   LPFORM.INI  file  should  contain unique form names for each different
   type or form.  This ensures that the correct forms are mounted when  a
   user submits a print request.

   Each line in LPFORM.INI  can  also  contain  a  locator  field,  which
   specifies  the  parameters  a  form  should have when it is mounted on
   specific line printers.  For example:

        NORMAL:LPT001/HEADER:1/BANNER:1/TRAILER:0
        NORMAL:ALL/HEADER:2/BANNER:2/TRAILER:2

   If form NORMAL is printed on line printer LPT001, it takes  the  forms
   parameters  given  in  the  first  entry  of the LPFORM.INI file shown
   above.  If form NORMAL is printed on any other line printer,  then  it
   takes the forms parameters given in the second entry of the file.

   Note that entries in LPFORM.INI having identical form names but having
   different  locators  must  be  listed  from  specific  locator to more
   general locator.  In the example above, the  entry  specifying  device
   LPT001 for form NORMAL appears before the entry specifying locator ALL
   for the same form name.  This order is important because  LPTSPL  uses
   the  first  entry  in  LPFORM.INI that can be applied to the device on
   which the request is printed.

   Also, note that ALL is the default locator value.  For example,

        NORMAL/switches

   is equivalent to:

        NORMAL:ALL/switches


                                    6-33

                            BATCH SOFTWARE TASKS


   6.6.2  Aligning Forms on the Line Printer

   At various times during your daily system operation, you might have to
   align  special  forms for a particular line printer job.  For example,
   you might have to load payroll checks on the  line  printer  for  your
   scheduled payroll process.  The ALIGN command allows you to adjust the
   forms on the line printer as many times as necessary to print the  job
   correctly.

   When you give the ALIGN PRINTER command, the system uses an  alignment
   file that is specified as "formsname.ALP" for the print request, where
   formsname is the name of the form that was  specified  in  the  user's
   print request.  The "formsname.ALP" file contains a pattern applicable
   to the special forms being mounted.  If you do not  want  the  default
   .ALP  file  used,  you can specify another alignment file in the ALIGN
   PRINTER command.  For example, the  file  for  NORMAL  forms  at  your
   installation could be:

        SYS:<SPOOL>NORMAL-ALIGN.ALP

   In addition, the ALIGN PRINTER command  has  three  optional  switches
   that you can specify to:

        1.  Change the number of seconds between the repeat  printing  of
            the .ALP file (/PAUSE:  switch)

        2.  Change the number  of  printing  repeats  of  the  .ALP  file
            (/REPEAT-COUNT:  switch)

        3.  Resume normal printing and stop aligning special forms (/STOP
            switch)

   When you specify either  of  these  switches,  you  are  changing  the
   default  for  the  current  job  on the printer.  When you specify the
   /STOP switch, the printer stops printing the contents of the .ALP file
   and resumes printing the print request.

                            ----- Examples -----

        1.  Give the ALIGN PRINTER command to align  forms  for  a  print
            request  for  payroll  checks.   At  your  installation,  the
            /PAUSE:  switch was set for 10 seconds and the /REPEAT-COUNT:
            switch was set for 25 repeats.  Change the /REPEAT-COUNT:  to
            15.

            OPR>ALIGN PRINTER 0 /REPEAT-COUNT:15<RET>
            OPR>
            12:46:02        Printer 0  --Alignment--
                            Job PAYROL Req #32 for ACCOUNTING
            OPR>




                                    6-34

                            BATCH SOFTWARE TASKS


        2.  Give the ALIGN PRINTER command again after you have correctly
            aligned the form for the checks.  Specify the /STOP switch to
            resume the normal printing of the payroll checks.

            OPR>ALIGN PRINTER 0 /STOP<RET>
            OPR>
            12:52:43        Printer 0  --Alignment Stopped--
                            Job PAYROL Req #32 for ACCOUNTING
            OPR>



   6.6.3  Backspacing Forms on the Line Printer

   At various times, you might have to backspace a particular  file  that
   is  being  printed  on the line printer, such as when the forms become
   jammed in the printing mechanism.  The BACKSPACE command allows you to
   backspace  the  print  file  so  that  the pages of the file that were
   jammed or incorrectly printed can be reprinted.

   With the BACKSPACE PRINTER  command,  you  must  specify  one  of  the
   following switches:

        1.  /COPIES:  - specifies the  number  of  copies  of  the  print
            request to backspace.

        2.  /FILE - specifies to backspace 1 file so that it  is  printed
            again.

        3.  /PAGES:  - specifies the number of pages to be backspaced and
            printed again.

   When you give a BACKSPACE PRINTER command, the system first clears the
   printer  buffer  by  printing  its  contents,  and  then executes your
   command.  The number of pages that are printed to clear the buffer are
   included with the number of pages you specify in the BACKSPACE PRINTER
   command.  Therefore, when you specify the /PAGES:  switch, you  should
   add  two  or  three  pages  to  the  total number given as the /PAGES:
   value.

                            ----- Example -----

   Printer 1 has just had a paper jam which has put the printer off-line.
   The following messages appear at your console:

        OPR>
        9:38:18        Printer 1  --Offline--

        9:39:39  <12>  Printer 1  --VFU error--
                        Re-align forms and put on-line
                        Type 'Respond <number> CONTINUE' when ready
        OPR>


                                    6-35

                            BATCH SOFTWARE TASKS


   Clear the printer of the jammed pages and re-align the forms.   Before
   you  put  the  printer  on-line, give the BACKSPACE PRINTER command to
   repeat the number of pages that were jammed and add a couple of  pages
   for  the  printer  buffer (the following example describes backspacing
   printer 1 by 25 pages).  Then RESPOND to message <12>.

        OPR>BACKSPACE PRINTER 1 /PAGES:25<RET>
        OPR>
        9:45:06        Printer 1  --Backspaced 25 Pages--

        OPR>RESPOND 12 CONTINUE<RET>
        OPR>

   At this point, the line printer prints the remaining contents  of  the
   printer buffer and then backspaces 25 pages to reprint what was jammed
   or incorrectly printed.



   6.6.4  Forwardspacing Forms on the Line Printer

   At various times, you might have to  forwardspace  a  particular  file
   that  is  being  printed  on  the  line  printer,  such as when a user
   requests only a portion of some file to be printed.  The  FORWARDSPACE
   command allows you to forwardspace the file so that you can save paper
   and print only what is needed.

   With the FORWARDSPACE PRINTER command, you must  specify  one  of  the
   following switches:

        1.  /COPIES:  - specifies the  number  of  copies  of  the  print
            request to forwardspace.

        2.  /FILE - specifies to forwardspace 1 file in the  print  queue
            so that the file is not printed.

        3.  /PAGES:  - specifies the number of pages of the print request
            that are not printed.

   When you give a FORWARDSPACE PRINTER command, the system first  clears
   the  printer  buffer  by  printing its contents and then executes your
   command.  The number of pages that are printed to clear the buffer  is
   included  with  the  number  of  pages you specify in the FORWARDSPACE
   PRINTER command.  Therefore, when you specify the /PAGES:  SWITCH, YOU
   SHOULD  SUBTRACT  TWO  OR THREE PAGES TO THE TOTAL NUMBER GIVEN AS THE
   /PAGES:  value.








                                    6-36

                            BATCH SOFTWARE TASKS


                            ----- Example -----

   A user issued  the  command  @PRINT  A.TXT,B.TXT,C.TXT,D.TXT  and  has
   requested  you  to forwardspace line printer 2, so that the B.TXT file
   is printed before the A.TXT file is printed.  After the print job  has
   printed  the  header  and  banner pages, you put the printer off-line,
   give the FORWARDSPACE PRINTER command for 1 file,  and  then  put  the
   printer on-line.

        OPR>
        9:38:28        Printer 2  --Offline--

        OPR>FORWARDSPACE PRINTER 2 /FILE<RET>
        OPR>
        9:45:26        Printer 2  --Forwardspaced 1 File--

        OPR>

   At this point, the line printer prints the remaining contents  of  the
   printer buffer and then forwardspaces 1 file of the print job.



   6.6.5  Suppressing Carriage Control on the Line Printer

   At various times, you might have to suppress the carriage  control  on
   the  line  printer for a particular job, such as when a user's program
   causes a print loop that makes the forms  in  the  line  printer  pass
   through  with  one  line  written  on each form.  The SUPPRESS command
   allows you to suppress the carriage control.

   The SUPPRESS PRINTER command  suppresses  all  blank  lines  and  form
   feeds.   For  example, if you had a 25-page file with one line of text
   per page, the SUPPRESS PRINTER command would cause all  the  lines  of
   text to print on one page.

   With the  SUPPRESS  PRINTER  command,  you  can  specify  one  of  the
   following switches.

        1.  /FILE - suppresses blank lines and form feeds for the current
            file printing.

        2.  /JOB - suppresses blank lines and form feeds for  the  entire
            job printing.

        3.  /STOP - stops the suppression of printing and resumes  normal
            printing with blank lines and form feeds.

   The /JOB switch is the default if you do not specify any of the  above
   switches.




                                    6-37

                            BATCH SOFTWARE TASKS


                            ----- Example -----

   A user's program has caused a print loop.  Give the  SUPPRESS  PRINTER
   command to stop the form feeds, thus saving paper.

        OPR>SUPPRESS PRINTER 1<RET>
        OPR>
        10:43:47        Printer 1  --Carriage control suppressed--
                        Job TEST01 Req #55 for PTAYLOR
        OPR>



   6.7  CONTROLLING LINE PRINTER JOBS

   The following OPR commands allow you to control line printer jobs that
   a  user  queues  either with the processing of a batch job or with the
   TOPS-20 PRINT command:

        1.  SHOW QUEUES PRINTER-JOBS

        2.  HOLD PRINTER-JOBS

        3.  RELEASE PRINTER-JOBS

        4.  ABORT (current job on) PRINTER

        5.  REQUEUE (current job on) PRINTER

        6.  MODIFY PRINTER-REQUEST

        7.  CANCEL PRINTER-REQUEST

        8.  NEXT (job on) PRINTER

   The following sub-sections describe how to use each of these  commands
|  to  control line printer jobs.  You can use the /CLUSTER-NODE:  switch
|  with each command to control line printer jobs on specified nodes in a
|  CFS-20 cluster.



   6.7.1  Examining Printer Jobs in the Queues

   Whenever a user issues a request for the line printer, the request  is
   placed  in  a  queue  where  it  waits for selection by the system for
   printing.  To examine the queues for print jobs, give the OPR  command
   SHOW QUEUES PRINTER-JOBS.






                                    6-38

                            BATCH SOFTWARE TASKS


   The output of the SHOW QUEUES PRINTER-JOBS command displays  for  each
   job:

        1.  The name of the print job

        2.  The request-id number of the print job

        3.  The page limit of the print job

        4.  The name of the user who requested the print job

   These four columns of the display appear  whether  the  print  job  is
   currently  printing  (active)  or  is  not  printing  (inactive).   In
   addition to the above, if the job is active on the line  printer,  the
   display  also  shows  the line printer unit number on which the job is
   printing, the time that the print job started, and the total number of
   pages printed.

   The display also includes the  name  of  the  CFS-20  node  where  the
   printer  was  started and the times that the remote node processed the
   command  and  the  local  system  received  the  information,  if  you
   specified /CLUSTER-NODE:  on the command line.

   The SHOW QUEUES PRINTER-JOBS command has five optional switches:

        1.  /NODE:name displays the printer  queue  of  a  remote  system
            whose jobs are to be processed on the local node.

        2.  /ALL adds to the display the switches that the user specified
            with  the  PRINT command.  If no switches were specified, the
            /ALL switch displays the default switches.  In addition,  the
            /ALL  switch  displays  any  switches that you specified, for
            example, /HOLD.

        3.  /SHORT displays only the job name, the  request  number,  the
            scheduled run time, and the user name.

        4.  /USER:name displays only the printer job of a specified user.

        5.  /CLUSTER-NODE:  name displays printer queue information  from
            the  specified  remote  CFS-20  node.  If * is specified, the
            printer names of all nodes in the cluster are displayed.












                                    6-39

                            BATCH SOFTWARE TASKS


                            ----- Example -----

        1.  Give the SHOW QUEUES PRINTER-JOBS command to display  printer
            jobs in the queues.

            OPR>SHOW QUEUES PRINTER-JOBS <RET>
|  OPR>
|  14:38:09                  -- System Queues Listing --
|  
|  Printer Queue: 
|  Job Name  Req#   Limit             User               Alias 
|  -------- ------ -------   ------------------------   ------
|    G         161       3   LESTER                     LAT3
|      /Remote-name:LN03  /Dest:LAT71 
|   There is 1 job in the queue (one in progress)

   OPR>

        2.  Give the SHOW QUEUES PRINTER-JOBS  command  with  the  /SHORT
            switch.

            OPR>SHOW QUEUES PRINTER-JOBS /SHORT<RET>
            OPR>
            10:49:07            -- System Queues Listing --

            Printer Queue:
            * DAILY     11     24  OPERATOR
            * TRAP79    12    161  BELANGER
              MF20      13     23  SROBINSON
              WEEKLY    14     17  OPERATOR
              SPEAR     15     10  OPERATOR

            OPR>



   6.7.2  Holding Printer Jobs

   Whenever you need to prevent print requests from processing, give  the
   HOLD  PRINTER-JOBS command.  When you give this command, current print
   requests in the queue are held.  Any requests  for  the  line  printer
   queued  after  the  HOLD  command has been issued are not held and are
   processed as soon as a  line  printer  becomes  available.   You  must
   specify one of the following with this command:

        1.  The request-id number, which holds a single printer job

        2.  The user name, which holds all printer jobs  queued  by  that
            user, or

        3.  An asterisk (*), which holds all printer jobs queued  by  all
            users.


                                    6-40

                            BATCH SOFTWARE TASKS


                             ----- Hints -----

   You cannot HOLD a printer job that  is  currently  active  on  a  line
   printer.

                            ----- Example -----

   Give the HOLD PRINTER-JOBS command to hold all  printer  requests  for
   user SMITH.

        OPR>HOLD PRINTER-JOBS SMITH <RET>
        OPR>
         8:37:26          -- 2 Jobs Held --
        OPR>



   6.7.3  Releasing Printer Jobs

   You can give the RELEASE command to allow the printing of a  job  that
   has  been  previously  held with the HOLD command or requeued with the
   REQUEUE command.  You can specify a single request-id number, the user
   name  for  all  jobs  by that user, or an asterisk (*) for all printer
   jobs in the system.  The RELEASE command reschedules  the  job(s)  for
   processing.

                              ----- Hint -----

   You must have one or more line printers started or in the  idle  state
   to get a printer job processed.

                            ----- Example -----

   Give the RELEASE command to reschedule  all  printer  jobs  that  were
   previously held.


        OPR>RELEASE PRINTER-JOBS * <RET>
        OPR>  
         8:37:52          -- 2 Jobs Released --
        OPR>EX













                                    6-41

                            BATCH SOFTWARE TASKS


   6.7.4  Canceling Printer Jobs

   At various times, you might have to cancel a printer job while  it  is
   printing.  You can give the ABORT command with the printer unit number
   and one or more of the following switches:

        1.  /REQUEST-ID:

        2.  /PURGE

        3.  /REASON:

   The /REQUEST-ID:  switch uniquely identifies the job to be canceled.

   The /PURGE switch flushes the entire job from the system  when  it  is
   canceled.   There are no header, banner, or trailer pages printed when
   the print request is purged.

   The /REASON:  switch allows you to enter one or more lines of text  to
   explain why the printer job was canceled.

   You can also specify remote-printer command keywords to  cancel  print
   jobs requested on DQS, LAT, or cluster printers.































                                    6-42

                            BATCH SOFTWARE TASKS


                            ----- Example -----

   Give the ABORT command to cancel a printer  job  because  a  user  has
   requested that you do so.

        OPR>ABORT PRINTER 1 /REASON:USER REQUEST<RET>

        OPR>
        11:32:08        PRINTER 1  --ABORTING--
                        JOB TEST01 Req #35 for JONES
                        REASON:USER REQUEST
        OPR>
        11:32:12        Printer 1  --End--
                        Job TEST01 Req #35 for JONES
        OPR>



   6.7.5  Requeuing Printer Jobs

   At various times, you might want to cancel  a  printer  job  and  then
   reschedule it to be printed at a later time.  You can give the REQUEUE
   command to HOLD the printer job in its entirety and ABORT its  current
   printing.  This command can only be used when the job is active.

   For example, you might want to REQUEUE a  printer  job  that  requires
   multiple  boxes  of forms so that it prints at a later time when fewer
   users are requesting printer jobs.  Thus, you REQUEUE the job  in  its
   entirety for printing when the time becomes available.

   In order to have the job start again after it has been  requeued,  you
   must give the OPR command RELEASE.

   You can specify the /REASON switch to explain why  the  job  is  being
   requeued.

   You can requeue remote DQS, LAT, and cluster printer jobs as  well  as
   local printer jobs.
















                                    6-43

                            BATCH SOFTWARE TASKS


                            ----- Example -----

   Give the REQUEUE command to hold a  printer  job  that  requires  four
   hours to print.

        OPR>REQUEUE PRINTER 2 /REASON:<RET>
        Enter text and terminate with ^Z
        JOB REQUIRES FOUR HOURS TO PRINT.<RET>
        JOB WILL BE RELEASED FOR PRINT ON 2ND SHIFT. <CTRL/Z>
        OPR>
        13:21:03        PRINTER 2  --REQUEUED--
                        JOB ARFORM Req #37 for AR.OFFICE
                        Reason:JOB REQUIRES FOUR HOURS TO PRINT.
                        JOB WILL BE RELEASED FOR PRINT ON 2ND SHIFT.^Z
        OPR>
        13:21:25        Printer 2  --End--
                        Job ARFORM Req #37 for AR.OFFICE
        OPR>



   6.7.6  Modifying Printer Requests

   Whenever you need to change the priority of a printer job  request  in
   the queue, give the MODIFY PRINTER-REQUEST command.  You can specify a
   single printer request-id number, the user name for  all  requests  by
   that user, or an asterisk (*) for all printer requests in the queue.

   You must specify a new PRIORITY number from 1 to 63.  The  higher  the
   number, the greater the priority.

                            ----- Example -----

   Give the MODIFY command to change the priority of batch request 135 to
   have  a  priority  of  63.  This causes the request to be the next job
   processed.

        OPR>MODIFY PRINTER-REQUEST 135 PRIORITY 63<RET>
        OPR>
        8:51:21        --1 Job Modified--
        OPR>



   6.7.7  Deleting Printer Requests

   Whenever you need to delete a printer request from the printer  queue,
   give  the  CANCEL  PRINTER-REQUEST  command.  You can specify a single
   request-id number, the user name for all jobs  by  that  user,  or  an
   asterisk (*) for all printer requests in the system.




                                    6-44

                            BATCH SOFTWARE TASKS


   When you delete a print request that  is  currently  printing  on  the
   printer,  the  printer  stops  printing  the  data, prints the trailer
   pages, and starts printing the next job in the queue.

                            ----- Example -----

   Give the CANCEL command to delete print request 168 from the queue.

        OPR>CANCEL PRINTER-REQUEST 168<RET>
        OPR>
        10:25:11        --1 Job Canceled--
        OPR>



   6.7.8  Sending Line Printer Output to Tape

   You can send output to a magnetic tape instead of a line printer  with
   the OPR command, START PRINTER nn /DEVICE:MTAn:.

   The advantages for doing this are:

        1.  When your line printers are down due to a  hardware  problem,
            you can spool the output to tape and then copy this output on
            another system where the printer(s) is not down.

        2.  When it is desired to microfiche the output, you can send the
            output to tape instead of printing it on the line printer.

        3.  When you want to transfer the output from one site to another
            or to another system, you can put it on tape.  Transferring a
            tape is easier than mailing or carrying the printed output.

   To perform this task, do the following:

        1.  Type to OPR:

            SET TAPE-DRIVE MTAn: UNAVAILABLE<RET>

            where n is the tape drive unit  number.   (Refer  to  Section
            7.5.7  for  additional  information  on  the  SET  TAPE-DRIVE
            command.)

        2.  Physically mount and bring on-line a tape on the  tape  drive
            that   has   been  made  UNAVAILABLE.   Make  sure  that  the
            write-ring has been inserted in the tape (WRITE-ENABLED).








                                    6-45

                            BATCH SOFTWARE TASKS


        3.  Type to OPR:

            HOLD PRINTER-JOBS *<RET>

            to hold all printer job requests  in  the  printer(s)  queue.
            You  can  specify  the  user's  name  for  all  requests by a
            specific user or a  request-id  number  for  a  single  print
            request.

        4.  Type to OPR:

            START PRINTER nn /DEVICE:MTAn:<RET>

            where nn is a line  printer  unit  number  other  than  those
            already in use and n is the tape drive unit number.

        5.  If you are to print a type of form other than the type when a
            printer  is  started (the default) at your installation, type
            to OPR:.

            SET PRINTER nn FORMS-TYPE forms-name<RET>

            where forms-name is the desired type of form to be spooled to
            the tape.

        6.  Type to OPR:

            RELEASE PRINTER-JOBS *<RET>

            to release those printer job requests that were held.

        7.  When the printer requests have completed being output to  the
            tape, type to OPR:

            SHUTDOWN PRINTER nn<RET>

            to rewind and unload the tape automatically.

        8.  Type to OPR:

            SET TAPE-DRIVE MTAn: AVAILABLE<RET>

            to  make  the  tape  drive  available  for  user  tape  mount
            requests.










                                    6-46

                            BATCH SOFTWARE TASKS


                            ----- Example -----

   Start printer 2 on MTA0:   to  output  all  printer  requests  in  the
   printer  queue  for  NARROW forms because there are no NARROW forms at
   your site.

        OPR>SET TAPE-DRIVE MTA0: UNAVAILABLE<RET>
        Enter Text and Terminate with ^Z
        ALL NARROW FORMS WILL BE PRINTED AT ANOTHER SITE.<RET>
        THERE ARE NO NARROW FORMS IN STOCK.<CTRL/Z>
        OPR>
        7:52:19          --Tape Drive Set Unavailable--
                        MTA0: SET UNAVAILABLE FOR ASSIGNMENT BY MOUNTR
        OPR>HOLD PRINTER-JOBS *<RET>
        7:53:45        --10 Jobs Held--
        OPR>START PRINTER 2 /DEVICE:MTA0:<RET>
        7:55:34        Printer 2  --Startup Scheduled--
        OPR>SET PRINTER 2 FORMS-TYPE NARROW<RET>
        7:56:15        Printer 2  --Set Accepted--
        OPR>RELEASE PRINTER-JOBS *<RET>
        7:57:23        --10 Jobs Released--
        OPR>
        7:57:37        Printer 2  --Started--
        OPR>
        7:57:38        Printer 2  --Begin--
                        Job DAILY Req #11 for PAYROLL
        OPR>
        7:58:29        Printer 2  --End--
                        Job DAILY Req #11 for PAYROLL
        7:59:01        Printer 2  --Begin--
                        Job WEEKLY Req #12 for PAYROLL
        OPR>
                        .
                        .
                        .
        OPR>
        8:09:10        Printer 2  --End--
                        Job YEARLY Req #20 for PAYROLL
        OPR>SHUTDOWN PRINTER 2<RET>
        OPR>
        8:10:12        Printer 2  --Shutdown--
        OPR>SET TAPE-DRIVE MTA0: AVAILABLE<RET>
        OPR>
        8:12:30          --Tape Drive Set Available--
                        MTA0: set available for assignment by MOUNTR
        OPR>








                                    6-47

                            BATCH SOFTWARE TASKS


                                    NOTE

           If all copies of the line printer spooler (LPTSPL) are
           active,  you  may  have to start an additional copy of
           LPTSPL as a process under SYSJOB  or  if  your  GALAXY
           components  are  running  as  a  process  in  a PTYCON
           subjob, then under that PTYCON  subjob,  to  output  a
           print file to tape.



   6.7.9  Printing Log and Spool Files on Designated Local Printers

   Normally, batch log files and spooled files are printed on  the  first
   available   local   printer.   However,  it  is  possible  to  specify
   particular local printers for these files.  To  enable  this  feature,
   give the following command:

   OPR>ENABLE LOGFILES-TO-SPECIFIC-PRINTERS<RET>

   After this command is given, you must indicate which local  printer(s)
   will be allowed to print log and spooled files:

   OPR>ENABLE  PRINT-LOGFILES  local   printer   number   or   range   of
   numbers<RET>

   You can later disable this feature with DISABLE commands.

   Refer to the Operator's Command Language Reference Manual for complete
   details on this feature.



   6.8  CONTROLLING THE CARD READER

   To handle a user's request to have card decks read into the system for
   batch  processing,  you  must have started one (or possibly more) card
   reader(s)  at  your  installation.   Normally,  the  card  reader   is
   automatically  started  at system start-up when the SYSTEM.CMD file is
   executed.

   Your system manager should establish the following when you have batch
   users submitting their jobs as card input:

        1.  Where the users place the card decks for submission

        2.  When you load the card decks into the card reader for reading

        3.  Where and when you place the card decks and output  from  the
            batch jobs to return to the users




                                    6-48

                            BATCH SOFTWARE TASKS


   The following are the OPR commands that allow you to control the  card
   reader(s) at your installation:

        1.  START READER

        2.  STOP READER

        3.  CONTINUE READER

        4.  SHUTDOWN READER

        5.  SHOW STATUS READER

   The following sub-sections describe each  of  the  above  commands  to
|  assist  you  in  the  control  of  card  reader(s).   You  can use the
|  /CLUSTER-NODE:  switch with each command to control  card  readers  on
|  specified nodes in a CFS-20 cluster.



   6.8.1  Starting the Card Reader

   In order for you to load and read cards through the card  reader,  you
   must  start  the  card reader with the START READER command.  Starting
   the card reader allows batch card jobs to be scheduled for  processing
   in the TOPS-20 batch system.  You can specify one or more unit numbers
   with the START command.

   To stop the scheduling of card batch jobs on a card  reader,  use  the
   SHUTDOWN command.

                            ----- Example -----

   Issue the START READER command to start up card reader 0.

        OPR>START READER 0<RET>
        OPR>
        10:11:15        Reader 0  --Startup Scheduled--
        OPR>
        10:11:17        Reader 0  --Started--
        OPR>













                                    6-49

                            BATCH SOFTWARE TASKS


   6.8.2  Stopping the Card Reader

   If you need to stop one or more card readers, use  the  STOP  command.
   The  STOP  READER  command  temporarily  stops  the  card  reader from
   processing its current job.  You must give  the  CONTINUE  command  to
   allow the card reader to continue reading the input job.

   The STOP command has three optional arguments.  They are:

        1.  AFTER CURRENT-REQUEST

        2.  AFTER EVERY-REQUEST

        3.  IMMEDIATELY

   The IMMEDIATELY argument is the default for the STOP  command.   Refer
   to  the  TOPS-20  Operator's  Command  Language Reference Manual for a
   complete description of these commands.

                            ----- Example -----

   Stop the current job on card reader 0 temporarily to fix a card in the
   deck that was accidentally folded.

        OPR>STOP READER 0<RET>
        OPR>
        18:24:09        Reader 0  -- Shutdown at EOJ Scheduled --
        OPR>



   6.8.3  Continuing the Card Reader

   You can give the CONTINUE command to continue one or more card readers
   that were temporarily stopped with the STOP command.

                            ----- Example -----

   After stopping the card reader to fix  a  folded  card,  continue  the
   current card reader job.

        OPR>CONTINUE READER 0<RET>
        OPR>
        18:30:41        Reader 0  --Continued--
        OPR>









                                    6-50

                            BATCH SOFTWARE TASKS


   6.8.4  Shutting Down the Card Reader

   If at any time you need to shutdown  the  scheduling  of  card  reader
   requests, use the SHUTDOWN command.  If a card reader job is currently
   being read from the card reader, the request is completed  before  the
   card reader is shutdown.

   To start the scheduling of jobs on the card reader, use  the  SHUTDOWN
   command.

                            ----- Example -----

   Shutdown card reader 0 while a request is still being  read  into  the
   system.

        OPR>SHUTDOWN READER 0<RET>
        OPR>
        19:21:01        Reader 0  --Shutdown at EOJ Scheduled--
        OPR>

   When the batch card job has completed being read into the system,  the
   following message appears:

        OPR>
        19:22:44        Reader 0  --Shutdown--
        OPR>



   6.8.5  Displaying Card Reader Status

   At any time you can display the status of one  or  more  card  readers
   with  the  SHOW STATUS READER command.  If you do not specify a number
   or a range of unit numbers, the default is all  card  readers  on  the
   system.

   The output from the SHOW STATUS READER command displays:

        1.  The card reader unit number

        2.  The current status of the card reader (either idle or active)

   If you specified the /CLUSTER-NODE:  switch, the display also includes
   the  name of the remote CFS-20 node and the times that the remote node
   processed the command and the local node received the information.  If
   the  card  reader  is active, there is currently a deck of cards being
   read into the system.  The system  does  not  recognize  a  job  name,
   request-id, or user name until the last card of the deck has been read
   and the card reader is idle.  At this time, the card deck has become a
   job  request  with  a  request-id number and can be displayed with the
   SHOW QUEUES BATCH-JOBS command.



                                    6-51

                            BATCH SOFTWARE TASKS


                            ----- Example -----

   Give the SHOW STATUS READER command to display the current  status  of
   the card reader at your installation.

        OPR>SHOW STATUS READER<RET>
        OPR>
        13:51:39            -- System Device Status --

        Reader Status:
          Unit      Status     
          ----  ---------------
             0  Active
        OPR>



   6.9  CONTROLLING CARD READER JOBS

   Because a card reader job becomes a batch input queue request when the
   last  card  of the job (EOJ card) is read, you can only abort the card
   job while it is being read into the system.

   At various times you might have to cancel the  card  job  being  read,
   such  as  when a card jam occurs in the card reader.  You can give the
   ABORT READER command by specifying the reader unit  number  to  cancel
   the job before it becomes a job request in the batch input queue.

   In addition, you can specify a reason with the /REASON:  switch as  to
|  why  the  job  was  canceled.  You can also specify the /CLUSTER-NODE:
|  switch to control card reader jobs on  specified  nodes  in  a  CFS-20
|  cluster.

                            ----- Example -----

   Give the ABORT to cancel a card reader job because of a  massive  card
   reader jam.

        OPR>ABORT READER 0 /REASON:CARD JAM<RET>
        OPR>
        12:32:09        Reader 0  --Aborting--
                        REASON:CARD JAM
        OPR>



   6.10  CONTROLLING OTHER OUTPUT DEVICES

   The commands and descriptions in this section are applicable  only  if
   you have the hardware available at your installation site.

   Other output devices available to users are:


                                    6-52

                            BATCH SOFTWARE TASKS


        1.  CARD-PUNCH

        2.  PAPER-TAPE-PUNCH

        3.  PLOTTER

   If your installation has one or more of these output devices, you must
   have the parameters set so that the user(s) requests can be processed.
   Normally,  if  your  installation  has   these   devices,   they   are
   automatically  started  at system start-up when the SYSTEM.CMD file is
   executed.

   When the output from the card punch, paper-tape punch, and plotter has
   been  completed,  you  must remove the output and distribute it.  Your
   system manager should set up the distribution method which includes:

        1.  Where you must put the output so that users can pick it up

        2.  When you must distribute the output

   The following commands are the OPR commands that allow you to  control
   the card punch, paper-tape punch, and plotter at your installation:

        1.  SET output device

        2.  START output device

        3.  STOP output device

        4.  CONTINUE output device

        5.  SHUTDOWN output device

        6.  SHOW PARAMETERS output device

        7.  SHOW STATUS output device

   where output device can be CARD-PUNCH, PAPER-TAPE-PUNCH, or PLOTTER.

   The following sub-sections describe each  of  the  above  commands  to
|  assist  you  in  the control of these output devices.  You can use the
|  /CLUSTER-NODE:  switch with each command to control output devices  on
|  specified nodes in a CFS-20 cluster.



   6.10.1  Setting Output Devices

   Normally, a defined number of output devices  are  started  at  system
   start-up  by the SYSTEM.CMD file.  However, you might have to start an
   output device (for example, the card punch) when  a  user  requests  a
   card  punch  job.   Before  you  start  an  output device (CARD-PUNCH,


                                    6-53

                            BATCH SOFTWARE TASKS


   PAPER-TAPE-PUNCH, or PLOTTER), you can set  the  parameters  for  that
   device.  The parameters for these three devices are:

        1.  FORMS-TYPE name

        2.  LIMIT-EXCEEDED-ACTION word

        3.  OUTPUT-LIMIT number

        4.  PRIORITY-LIMITS range

   Where "name" is the name of the output device form.   The  default  is
   NORMAL  and  is  defined  in the SPFORM.INI file for each device type.
   (Refer to Section 6.10.2.)

   The "word" of  the  LIMIT-EXCEEDED-ACTION  parameter  refers  to  what
   action,  if  any,  should  be  taken  if  the device that is currently
   processing the job request exceeds the output limit.  You can set this
   parameter to:

        1.  RESPOND with either IGNORE the limit for the  output  job  or
            ABORT to cancel the output job

        2.  Always ABORT the output job when the limit has been exceeded

        3.  Always IGNORE the set output limit of the device

   The "number" of the OUTPUT-LIMIT parameter refers to the following:

        1.  Number of cards for the CARD-PUNCH

        2.  Number of folds for the PAPER-TAPE-PUNCH

        3.  Number of units for the PLOTTER

   These parameters default to the following if they are not included  in
   the SYSTEM.CMD file at system start-up:

        1.  500 cards for the CARD-PUNCH

        2.  500 units for the PAPER-TAPE-PUNCH

        3.  500 units for the PLOTTER

   The "range" of the PRIORITY-LIMITS parameter refers to a range of  job
   priority  numbers  the  output  device  accepts.  The default priority
   range is 1:63.  For example,  if  an  output  job  is  queued  with  a
   priority of 19 and there are no devices for the request that have been
   set to accept a priority of 19, the request is not  output  until  you
   change the priority range for the device.  You can change the priority
   number of the job request with the MODIFY command  (refer  to  Section
   6.11.6).   When  you  set  an  output device to change the FORMS-TYPE,


                                    6-54

                            BATCH SOFTWARE TASKS


   LIMIT-EXCEEDED-ACTION, OUTPUT-LIMIT, or  PRIORITY-LIMITS,  the  change
   remains in effect until you make another change.

                            ----- Examples -----

        1.  Set the priority limits for the  paper-tape  punch  to  be  a
            range of 20:63.

            OPR>SET PAPER-TAPE-PUNCH 0 PRIORITY-LIMITS 20:63<RET>
            OPR>
            11:34:09        Paper-tape-punch  --Set Accepted--
            OPR>

        2.  Set the limit exceeded action for the job  currently  on  the
            card punch to be ignored.

            OPR>SET CARD-PUNCH 0 LIMIT-EXCEEDED-ACTION IGNORE<RET>
            OPR>
            12:23:18        Card-punch 0  --Set Accepted--
            OPR>



   6.10.2  The SPFORM.INI File

   The forms handler for the output devices CARD-PUNCH, PAPER-TAPE-PUNCH,
   and  PLOTTER  allows you to automatically set various forms parameters
   on the basis of form names.  To accomplish this, you  or  your  system
   manager must set up a file on SYS:  called SPFORM.INI which contains a
   list of form names and switch settings for those forms.

   Each line in the SPFORM.INI file is written in the following format:

        devtyp formname:locator/switch1/switch2/switch3...

   where:

        devtyp              the device type for which this line  applies.
                            The allowable types are as follows:

                            CDP for the card punch
                            PTP for the paper-tape punch
                            PLT for the plotter

        formname            a 1- to 6-character form name.  You  or  your
                            system  manager  should  specify  unique form
                            names that are descriptive of  the  types  of
                            forms used at your installation.

        :locator            an optional locator field containing:

                            ALL       all devices (the default)


                                    6-55

                            BATCH SOFTWARE TASKS


                            LOC       all devices at the local site
                            REM       all devices at remote stations

        /switch1...         one or more  switches  available  to  you  to
                            describe the manner in which the forms are to
                            be used.  Refer to Tables 6-2 and 6-3  for  a
                            description of switches.  Table 6-2 describes
                            the four switches that can be  used  for  all
                            the output device types.  Table 6-3 describes
                            the three switches that can be used only  for
                            the plotter (PLT:).


   Table 6-2:  SPFORM.INI Switches for All Device Types

   ______________________________________________________________________

     Switch                                 Meaning
   ______________________________________________________________________

     /BANNER                specifies  whether  banner  units  will  be
                            output.

     /HEADER                specifies  whether  header  units  will  be
                            output.

     /NOTE:xxx              The xxx represents  a  text  of  up  to  50
                            characters  that  are  printed  on  the OPR
                            terminal  at  the  time   the   forms   are
                            scheduled.  There is no default.

     /TRAILER               specifies whether  trailer  units  will  be
                            output.
   ______________________________________________________________________


   Table 6-3:  SPFORM.INI Switches for Plotter Devices Only

   ______________________________________________________________________

        Switch                             Meaning
   ______________________________________________________________________

     /MAXIMUM:xx:yy         specifies the  maximum  form  size  in  the
                            horizontal  (xx)  and  vertical  (yy) axis.
                            The values of xx and  yy  are  measured  in
                            units; the unit size is defined by the /SPU
                            switch.  The plotter, when mounted with the
                            specified  type  of form, will accept plots
                            no larger than the  values  of  xx  and  yy
                            indicate.



                                    6-56

                            BATCH SOFTWARE TASKS


     /MINIMUM:xx:yy         specifies the  minimum  form  size  in  the
                            horizontal  (xx)  and  vertical  (yy) axis.
                            The values of xx and  yy  are  measured  in
                            units; the unit size is defined by the /SPU
                            switch.  The plotter, when mounted with the
                            specified  type  of form, will accept plots
                            no smaller than the values  of  xx  and  yy
                            indicate.

     /SPU:nnn               specifies the Steps Per Unit.  A step is  a
                            measurement   length   as  defined  in  the
                            hardware manual  for  the  device  at  your
                            installation.   The  value of nnn should be
                            step-sizennn=one  unit.   For  example,  to
                            define  an  inch as the unit if the plotter
                            step is .01 inches, use /SPU:100.
   ______________________________________________________________________


                                    NOTE

           Refer to the hardware owner's manual for  the  plotter
           device  at your installation before entering a line in
           the SPFORM.INI file for the plotter because there  are
           many different types of plotters.

   The form name in SPFORM.INI need not be the actual name of a  physical
   form; however, it usually is close to the type of form (such as normal
   forms, narrow forms, and so forth).  When a device  request  is  made,
   SPROUT  compares  the  form  name associated with the request with the
   form name of the form currently mounted on the output device.  If  the
   first  four  characters  of the name are not the same, then the system
   requests you to change the forms on the output device.  If  the  first
   four  characters  are  the  same,  then  the  system simply checks the
   switches associated with the requested form name and uses those values
   when  processing  the  output  job.  The number of characters that the
   system uses to compare the form name can be changed by running GALGEN;
   the default is four characters.

   For example, note the following SPFORM.INI file:

        CDP NORMAL/HEADER/BANNER/TRAILER
        CDP NORM01/HEADER/BANNER/TRAILER
        CDP NORM02/HEADER/BANNER/TRAILER/NOTE:SPECIAL

   Now, suppose that NORM01 forms are currently mounted on the card punch
   and  a  user makes a punch request that requires NORM02 forms.  SPROUT
   compares the first four characters of the requested form name (NORM02)
   with  the  first four characters of the form name for the form that is
   currently mounted in the card punch (NORM02).  Because  they  are  the
   same,  SPROUT  takes  the  switch  values  associated  with NORM01 and
   applies them to the user's punch request.  Therefore,  the  SPFORM.INI


                                    6-57

                            BATCH SOFTWARE TASKS


   file should have a unique name for each type of form.

   Each line  in  SPFORM.INI  can  also  contain  a  locator  field  that
   specifies  the  location  of  the output device.  The locator ALL (the
   default) refers to all of the devices as specified by the device type.
   The locators LOCAL and REMOTE are applicable only if your installation
   has TOPS-20 network software.



   6.10.3  Starting Output Devices

   Once you have set the parameters for the  particular  output  devices,
   you  must start the device so that output requests can be processed on
   them.  If you do not set any parameters for  the  device,  the  device
   uses the default parameters set by your system manager at GALGEN time.

   You can start one output device at a time or a range of devices.

   To stop the scheduling of jobs on an output device, use  the  SHUTDOWN
   command.

                            ----- Example -----

   Issue the START CARD-PUNCH command to start up card punch 0.

        OPR>START CARD-PUNCH 0<RET>
        OPR>
        10:23:21        Card-punch 0  --Startup Scheduled--
        OPR>
        10:23:25        Card-punch 0  --Started--
        OPR>



   6.10.4  Stopping Output Devices

   If you ever need or want to stop one or more output devices,  use  the
   STOP  command.   The  STOP  command temporarily stops an output device
   from processing its current job.  You must use the CONTINUE command to
   resume the output to the device.

   The STOP command has three optional arguments.  They are:

        1.  AFTER CURRENT-REQUEST

        2.  AFTER EVERY-REQUEST

        3.  IMMEDIATELY

   The IMMEDIATELY argument is the default for the STOP  command.   Refer
   to  the  TOPS-20  Operator's  Command  Language Reference Manual for a


                                    6-58

                            BATCH SOFTWARE TASKS


   complete description of these commands.

                            ----- Example -----

   Stop the current job on card punch 0 temporarily  to  load  more  card
   forms and empty its hopper.

        OPR>STOP CARD-PUNCH 0<RET>
        OPR>
        18:24:09        Card-punch 0  --Stopped--
        OPR>



   6.10.5  Continuing Output Devices

   You can give the CONTINUE command to  continue  processing  an  output
   device request that was temporarily stopped with the STOP command.

                            ----- Example -----

   After stopping the card punch to load more cards and empty the hopper,
   continue the output of the current punch job.

        OPR>CONTINUE CARD-PUNCH 0<RET>
        OPR>
        18:35:41        Card-punch 0  --Continued--
        OPR>



   6.10.6  Shutting Down Output Devices

   If at any time you need to shutdown the scheduling of output  requests
   on  an output device or on a range of output devices, use the SHUTDOWN
   command.  If an output request is currently  being  processed  on  the
   device, the request is completed before the output device is shutdown.

   To start the scheduling of jobs on the output device,  use  the  START
   command.














                                    6-59

                            BATCH SOFTWARE TASKS


                            ----- Example -----

   Shutdown paper-tape punch 0 while a request is still being  output  on
   it.

        OPR>SHUTDOWN PAPER-TAPE-PUNCH 0<RET>
        OPR>
        19:21:03        Paper-tape-punch 0  --Shutdown Scheduled--
        OPR>

   When the request on the paper-tape punch has completed its output, the
   following message appears:

        OPR>
        19:23:55        Paper-tape-punch 0  --Shutdown--
        OPR>



   6.10.7  Displaying Output Device Parameters

   You can display the current output device  parameters  with  the  SHOW
   PARAMETERS device command, where device can be:

        1.  CARD-PUNCH unit-number

        2.  PAPER-TAPE-PUNCH unit-number

        3.  PLOTTER unit-number

   If you do not specify a unit number with the  device  name,  the  SHOW
   command defaults to all units of the device that you specified.

   The output from  the  SHOW  PARAMETERS  device  command  displays  the
   following for each of the three devices listed above:

        1.  The unit number for the output device

        2.  The output limits for the output device

        3.  The type of forms for the output device

        4.  The priority range for the output device

        5.  The limit-exceeded-action for the output device

        6.  The character device type for the output device

   In addition, the display shows the remote CFS-20  node  name  and  the
   times  that  the  remote node processed the command and the local node
   received the information, if you specified the /CLUSTER-NODE:  switch.



                                    6-60

                            BATCH SOFTWARE TASKS


                            ----- Example -----

   Give the SHOW  PARAMETERS  PAPER-TAPE-PUNCH  command  to  display  the
   parameters of paper-tape punch 0 on the system.

        OPR>SHOW PARAMETERS PAPER-TAPE-PUNCH<RET>
        OPR>
        13:09:42            -- System Device Parameters--

        Papertape Parameters:
          Unit  Min:Max Unit   Form    Prio  Lim-Ex  Dev-Chars
          ----  ------------  ------  -----  ------  ---------
             0      1:500    NORMAL   1:63     Ask

        OPR>



   6.10.8  Displaying Output Device Status

   You can display the status of an output device or a  range  of  output
   devices  with the SHOW STATUS device command.  If you do not specify a
   unit  number  or  a  range  of  unit  numbers,  the  command  displays
   information for all of the specified devices on the system.

   The output from the SHOW STATUS device command displays the  following
   for each device:

        1.  The unit number of the output device

        2.  The current status of the output device

        3.  The job name currently active on the output device

        4.  The request-id number of the job

        5.  The name of the user who made the output request

   If the output device is not active, the word  "Idle"  appears  in  the
   Status  column  with no jobname, request-id, or user name.  If none of
   the devices are active, only the unit number and status appears in the
   display.

   If an output device is active, the output also shows the time that the
   output  request  started  and the number of output cards or units thus
   far.  If you do not need this information with the display of the SHOW
   STATUS  device  command,  specify  the  /SHORT switch before you press
   RETURN to confirm the command.

   If you specifed the /CLUSTER-NODE:  switch, the display also  includes
   the  remote  CFS-20  node  name  and  the  times  that the remote node
   processed the command and the local system received the information.


                                    6-61

                            BATCH SOFTWARE TASKS


                            ----- Example -----

   Give the SHOW STATUS CARD-PUNCH command to display the current  status
   of card punch 0 on the system.

        OPR>SHOW STATUS CARD-PUNCH 0<RET>
        OPR>
        13:51:39            -- System Device Status --

        Card-Punch Status:
          Unit      Status       Jobname  Req#            User
          ----  ---------------  -------  ----  ------------------------
             0  Active          PUNCH9    137  HEISER
                Started at 13:35:23, punched 687 of 2000 cards
        OPR>



   6.11  CONTROLLING JOBS ON OUTPUT DEVICES

   The following are the OPR commands that allow you  to  control  output
   device  jobs  that a user queues either with the processing of a batch
   job or with the TOPS-20 PUNCH or PLOT command:

        1.  SHOW QUEUES device-JOBS

        2.  HOLD device-JOBS

        3.  RELEASE device-JOBS

        4.  ABORT (Current Job on) device

        5.  REQUEUE (Current Job on) device

        6.  MODIFY device-REQUEST

        7.  CANCEL device-REQUEST

   Where "device" can be CARD-PUNCH, PAPER-TAPE-PUNCH, or PLOTTER.

   The following sub-sections describe how to use each of these  commands
|  to control output device jobs.  You can use the /CLUSTER-NODE:  switch
|  with each command to control output device jobs on specified nodes  in
|  a CFS-20 cluster.



   6.11.1  Examining Output Device Jobs in the Queues

   Whenever a user issues a request to an output device job, the  request
   is  placed  in  a queue where it waits for selection by the system for
   processing.  To examine the queues for output  device  requests,  give


                                    6-62

                            BATCH SOFTWARE TASKS


   the OPR command SHOW QUEUES device-JOBS.

   The output of the SHOW QUEUES device-JOBS command displays:

        1.  The name of the output job

        2.  The request-id number of the output job

        3.  The output limit of the job

        4.  The name of the user who requested the output job

   These four columns of the display appear whether  the  output  job  is
   currently   being   processed  (active)  or  is  not  being  processed
   (inactive).

   In addition to the above, if the output is active on the  device,  the
   display  shows  the  device  unit  number  on  which  the job is to be
   processed, the time that the output started, and the total  number  of
   cards or units processed.

   If you specified the /CLUSTER-NODE:  switch, the display also includes
   the  remote  CFS-20  node  name  and  the  times  that the remote node
   processed the command and the local received the information.

   The SHOW QUEUES device-JOBS command has five optional switches:

        1.  /NODE:name displays the device queue of a remote system.

        2.  /ALL adds to the display the switches that the user specified
            with  the  PUNCH  or  PLOT  command.   If  no  switches  were
            specified, the /ALL switch displays the default switches.  In
            addition,  the  /ALL  switch  displays  any switches that you
            specified, for example, /HOLD.

        3.  /SHORT displays only the job name, the  request  number,  the
            scheduled run time, and the user name.

        4.  /USER:name displays only the device jobs of a specified user.

        5.  /CLUSTER-NODE:name displays device queue information from the
            specified  remote  CFS-20  system.   If  *  is specified, the
            output queues of all nodes in the cluster are displayed.

                              ----- Hint -----

   The asterisk (*) before the job name column (see  examples)  indicates
   that the job is currently being processed.






                                    6-63

                            BATCH SOFTWARE TASKS


                            ----- Examples -----

        1.  Give the SHOW  QUEUES  PLOTTER-JOBS  command  with  the  /ALL
            switch  to  display  the  plotter  jobs in the queue with all
            their switches.

            OPR>SHOW QUEUES PLOTTER-JOBS /ALL<RET>
            OPR>
            10:49:07            -- System Queues Listing --

            Plotter Queue:
            Job Name  Req#  Limit            User
            --------  ----  -----  ------------------------
            * GRAPH     17    100  OPERATOR
                On Unit:0  /Seq#:3320
                Started at 10:47, plotted 25 of 100 units
              MF20      19    200  P.TAYLOR
                /Unit:0  /Seq#:3341
              MF21      27    590  P.TAYLOR
                /Unit:0  /Seq#:3349
              MF22      31    300  P.TAYLOR
                /Unit:0  /Seq#:3355

            There are 4 jobs in the Queue (1 in Progress)

            OPR>

        2.  Give the SHOW QUEUES PLOTTER-JOBS  command  with  the  /SHORT
            switch.

            OPR>SHOW QUEUES PLOTTER-JOBS /SHORT<RET>
            OPR>
            10:49:07            -- System Queues Listing --

            Plotter Queue:
            * GRAPH     17    100  OPERATOR
              MF20      19    200  P.TAYLOR
              MF21      27    590  P.TAYLOR
              MF22      31    300  P.TAYLOR

            OPR>



   6.11.2  Holding Output Device Jobs

   Whenever you need to prevent output jobs from  being  processed,  give
   the   HOLD  device-JOBS  command,  where  device  can  be  CARD-PUNCH,
   PAPER-TAPE-PUNCH, or PLOTTER.  When you  give  this  command,  current
   jobs  in  the  queue  are held.  Any output jobs queued after the HOLD
   command has been issued are not held and are processed when the device
   becomes  available.   You  must specify one of the following with this


                                    6-64

                            BATCH SOFTWARE TASKS


   command:

        1.  The request-id number, which holds a single output job

        2.  The user name, which holds all output  jobs  queued  by  that
            user

        3.  An asterisk (*), which holds all output jobs  queued  by  all
            users

                             ----- Hints -----

   You cannot HOLD an output job that is currently active  on  an  output
   device.

                            ----- Example -----

   Give the HOLD CARD-PUNCH-JOBS command to hold all card punch  requests
   for user BROWN.

        OPR>HOLD CARD-PUNCH-JOBS BROWN<RET>
        OPR>
        9:01:54        --3 Jobs Held--
        OPR>



   6.11.3  Releasing Output Device Jobs

   You can give the RELEASE command to release an  output  job  that  has
   been  previously held with the HOLD command.  You can specify a single
   request-id number, the user name for all jobs  by  that  user,  or  an
   asterisk  (*)  for all output jobs in the system.  The RELEASE command
   reschedules the job(s) to be processed.

                              ----- Hint -----

   You must have one or more output devices started or in the idle  state
   to get an output job processed.

                            ----- Example -----

   Give the RELEASE command to  reschedule  all  output  jobs  that  were
   previously held.

        OPR>RELEASE CARD-PUNCH-JOBS *<RET>
        OPR>
        10:38:09        --3 Jobs Released--
        OPR>





                                    6-65

                            BATCH SOFTWARE TASKS


   6.11.4  Canceling Output Device Jobs

   At various times, you might have to cancel an output job while  it  is
   processing  on  a  device.   You  can  give the ABORT command with the
   output unit number and one or more of the following switches:

        1.  /REQUEST-ID:

        2.  /PURGE

        3.  /REASON:

   The /REQUEST-ID:  switch uniquely identifies the job to be canceled.

   The /PURGE switch flushes the entire job from the system  when  it  is
   canceled.   There are no header, banner, or trailer pages printed when
   the output request is purged.

   The /REASON:  switch allows you to enter one or more lines of text  to
   explain why the output job was canceled.
                            ----- Example -----

   Give the ABORT command to cancel an output  job  because  a  user  had
   requested that you do so.

        OPR>ABORT PLOTTER 0 /REASON:USER REQUEST<RET>
        OPR>
        11:40:09        PLOTTER 0  --ABORTING--
                        JOB TEST01 Req #35 for JONES
                        REASON:USER REQUEST
        OPR>
        11:40:21        Plotter 0  --End--
                        Job TEST01 Req #35 for JONES
        OPR>



   6.11.5  Requeuing Output Device Jobs

   At various times, you might want to cancel  an  output  job  currently
   being  processed  and  at the same time, reschedule the same job to be
   processed at a later time.  You can give the REQUEUE command  to  HOLD
   the output job in its entirety and ABORT its current output.

   For example, you might want to REQUEUE an  output  job  that  requires
   more  forms  (cards,  paper  tape,  or  plotter  paper)  then  what is
   currently available at your site.  Thus, you REQUEUE the  job  in  its
   entirety for output to be processed when the forms become available.

   You can specify the /REASON:  switch to explain why the job  is  being
   requeued.



                                    6-66

                            BATCH SOFTWARE TASKS


                            ----- Example -----

   Give the REQUEUE command  to  hold  and  cancel  an  output  job  that
   requires four hours to punch.

        OPR>REQUEUE CARD-PUNCH 0 /REASON:<RET>
        Enter text and terminate with ^Z
        JOB REQUIRES FOUR HOURS TO PUNCH.<RET>
        JOB WILL BE RELEASED FOR PUNCH ON 2ND SHIFT. <CTRL/Z>
        OPR>
        13:21:03        CARD-PUNCH 0  --REQUEUED--
                        JOB ARFORM Req #47 for AR.OFFICE
                        Reason:JOB REQUIRES FOUR HOURS TO PUNCH.
                        JOB WILL BE RELEASED FOR PUNCH ON 2ND SHIFT.^Z
        OPR>
        13:21:25        Card-punch 0  --End--
                        Job ARFORM Req #47 for AR.OFFICE
        OPR>



   6.11.6  Modifying Output Device Requests

   Whenever you need to change the priority of an output job  request  in
   the queue, give the MODIFY device-REQUEST command, where device can be
   CARD-PUNCH, PAPER-TAPE-PUNCH, or PLOTTER.  You can  specify  a  single
   output request-id number, the user name for all requests by that user,
   or an asterisk (*) for all output requests in the queue.

   You must specify a new PRIORITY number from 1 to 63.  The  higher  the
   number, the greater the priority.
                            ----- Example -----

   Give the MODIFY command to change the priority of batch request 135 to
   have  a  priority  of  63.  This causes the request to be the next job
   processed.

        OPR>MODIFY PAPER-TAPE-PUNCH 135 PRIORITY 63<RET>
        OPR>
        8:51:21        --1 Job Modified--
        OPR>













                                    6-67

                            BATCH SOFTWARE TASKS


   6.11.7  Deleting Output Device Requests

   Whenever you need to delete an output request from the  output  queue,
   give   the   CANCEL   device-REQUEST  command,  where  device  can  be
   CARD-PUNCH, PAPER-TAPE-PUNCH, or PLOTTER.  You can  specify  a  single
   request-id  number,  the  user  name  for all jobs by that user, or an
   asterisk (*) for all output requests in the system.

   If you CANCEL an output request that is active on an output unit,  the
   output job is immediately deleted from the output unit.

                            ----- Example -----

   Give the CANCEL command to cancel output request  186  from  the  card
   punch output queue.

        OPR>CANCEL CARD-PUNCH 186<RET>
        OPR>
        10:25:11        --1 Job Canceled--
        OPR>



   6.11.8  Scheduling the Next Output Device Request

   You can force an output queue to schedule a particular request  to  be
   processed  immediately  by  using  the NEXT command with BATCH-STREAM,
   CARD-PUNCH, PAPER-TAPE-PUNCH, PLOTTER or PRINTER as the keyword.  This
   command  starts  the  job  immediately  after  the  current request is
   finished.  The NEXT command does  not  alter  the  sequence  of  other
   requests in the queue.

                            ----- Example -----

   Give the NEXT command to make request 230 the next job to  be  printed
   on printer 0.

   OPR>NEXT PRINTER 0 REQUEST-ID 230
   OPR>
    8:53:37                 Printer 0  -- NEXT request #230 scheduled --
   OPR>













                                    6-68













                                 CHAPTER 7

                         UNSCHEDULED SOFTWARE TASKS



   This chapter  describes  various  tasks  that  you  can  perform  when
   requested  or  needed.   Therefore,  these  tasks  are  considered  as
   unscheduled software tasks.  If any of these tasks are performed on  a
   regular  basis  at  your installation, decide upon a schedule for them
   with your system manager.

|  Note that you can use the /CLUSTER-NODE:   switch  with  the  commands
|  described  in  this  chapter  to  affect  jobs on specified nodes in a
|  CFS-20 cluster.



   7.1  CONTROLLING THE SCHEDULER

   As the operator of the TOPS-20 operating system, you may be instructed
   by  your  system  manager  to  change  the scheduling scheme that your
   system is currently using.  The following  sub-sections  describe  the
   ways of temporarily changing the various scheduling schemes.



   7.1.1  Changing Class Scheduling

   If your system is using class scheduling, you  may  override  whatever
   has  been  set in the n-CONFIG.CMD file for a specific class by giving
   the following OPR command:

        OPR>SET SCHEDULER CLASS n nn<RET>

   The first argument specifies the class number and the second  argument
   specifies  the  percentage  of  CPU  time  given  to  that class.  The
   percentage  of  CPU  time  allocated  cannot  exceed  100%.   Whatever
   percentage  of  CPU  time  is not allocated becomes part of the system
   windfall.  (Refer to the  TOPS-20  System  Manager's  Guide  for  more
   information on class scheduling.)




                                    7-1

                         UNSCHEDULED SOFTWARE TASKS


   7.1.1.1  Changing a Job's Scheduling Class - If your system has  class
   scheduling  controlled  by  a  policy  program, you may change a job's
   scheduling class by giving the following OPR command:

        OPR>SET JOB n SCHEDULER-CLASS y<RET>

   The first argument specifies the job number and  the  second  argument
   specifies  the  class you want the job to run in.  When you issue this
   command, it temporarily places the job in the specified class.

                            ----- Example -----

   Change job 24 to run in scheduler class 3.

        OPR>SET JOB 24 SCHEDULER-CLASS 3<RET>



   7.1.2  Changing Batch-Class Scheduling

   If your system manager has specified a special  class  for  all  batch
   jobs,  you  may  change the class number or the percentage of CPU time
   allocated in  the  n-CONFIG.CMD  file  by  giving  the  following  OPR
   command:

        OPR>SET SCHEDULER BATCH-CLASS n<RET>

   The argument can be either a class number, the word BACKGROUND, or the
   word  NONE.   If  you enter a class number, the percentage of CPU time
   specified in the n-CONFIG.CMD file for that class  will  be  given  to
   batch  jobs.   For  example,  if you change the batch class to a class
   that has been set up with 50% of the CPU time,  then  batch  jobs  for
   that  class  receive 50% of the CPU time.  If this is the case and you
   do not want batch jobs to have that percentage of CPU time, you should
   first give the SET SCHEDULER CLASS command to change the percentage of
   CPU time for that class, and then give the SET  SCHEDULER  BATCH-CLASS
   command.

   You can  change  the  percentage  of  CPU  time  for  the  batch-class
   specified  in  the  n-CONFIG.CMD file by giving the BACKGROUND or NONE
   argument.  When you give the BACKGROUND argument, batch jobs for  that
   class  receive  the percentage of CPU time that has not been allocated
   to the other classes.  When you give the NONE argument, batch jobs for
   that  class  receive  no  CPU  time.   (Refer  to  the  TOPS-20 System
   Manager's Guide for more information on batch class scheduling.)

|  If you are not using the  class  scheduler,  the  BACKGROUND  argument
|  causes batch jobs to run in the lowest priority queue.






                                    7-2

                         UNSCHEDULED SOFTWARE TASKS


   7.1.3  Changing Bias-Control Scheduling

   If your system is using  bias-control  scheduling,  you  may  override
   whatever has been set in the n-CONFIG.CMD file by giving the following
   OPR command:

        OPR>SET SCHEDULER BIAS-CONTROL n<RET>

   The argument is a integer from 1 to 20.  To allocate  higher  priority
   to  interactive jobs, you would set n in a range between 1 to 10, with
   1  being  the  highest  priority.   To  allocate  higher  priority  to
   compute-bound jobs, you would set n to be in a range between 11 to 20,
   with 20 being the highest priority.

                                    NOTE

           Remember these commands only  temporarily  change  the
           scheduling  scheme.  If the system has to be restarted
           for any reason, the scheduling scheme reverts to  what
           has been set up in the n-CONFIG.CMD file.



   7.1.4  Displaying Scheduler Status

   At any time, you can display the status of the scheduler by giving the
   following OPR command:

        OPR>SHOW SCHEDULER<RET>

   When  you  issue  this  command  the  system  prints   the   following
   information:

         o  The class scheduling status

         o  The bias-control setting

         o  The batch class

         o  The class number

         o  The percentage of CPU time allocated to each class

         o  The percentage of CPU time being used by each class

         o  The load averages for each class

         o  The windfall allocation status

         o  The accounting  mechanism  (by  accounts  or  by  the  policy
            program)



                                    7-3

                         UNSCHEDULED SOFTWARE TASKS


   The display also includes the name of the remote CFS-20 node  and  the
   times  that the remote node processed the command and the local system
   received the information, if you specified the /CLUSTER-NODE:  switch.

   Refer to the TOPS-20 System Manager's Guide for  more  information  on
   scheduling.

   The SHOW SCHEDULER command has one optional switch:

        1.  /CLUSTER-NODE:name displays scheduler  information  from  the
            specified  CFS-20  system.   If * is specified, the scheduler
            information from all nodes in the cluster are displayed.


                            ----- Example -----

   OPR>SHOW SCHEDULER<RET>
   OPR>
   11:29:00               -- System Scheduler Information --

                  Class Scheduler: On              Bias Control: 11
                                                   Batch Class: 1

                                               ------Load Averages------

                  CLASS     SHARE(%)   USE(%)  1-MIN     5-MIN     15-MIN
                    0         80        73      5.19      4.31      4.07
                    1         15        27      9.80      5.23      3.29
                    2          5         0      0.00      0.00      0.00

                  Windfall: Allocated            Classes by Account

   OPR>



   7.2  SETTING DEVICES ON-LINE

   If you have a DX20 channel controller installed and  on-line  at  your
   installation,  you  can  bring one of the devices listed below on-line
   with OPR after the device has been newly installed at your site.  This
   function  allows the system to accept the hardware address of a device
   that is not known to the monitor but is available for use.  You do not
   need to reload the TOPS-20 monitor.

   The devices that are interfaced through the DX20 are:

        1.  TX02 - tape controller

        2.  TX03 - channel selector




                                    7-4

                         UNSCHEDULED SOFTWARE TASKS


        3.  TX05 - tape drive selector

        4.  TU70 - tape drive

        5.  TU71 - tape drive

        6.  TU72 - tape drive

        7.  RP20 - disk drive

   In addition, when your DIGITAL Field Service Representative takes  one
   of  these  devices  off-line for repair of a hardware problem and then
   returns the device back to you for your control, you can give the  OPR
   command:

        SET ONLINE channel,unit,controller number<RET>

   to cause the system to recognize the device as on-line and  ready  for
   use  by  the system.  The address (ch,unit,cntrlr) separated by commas
   is:

        1.  Channel number (ch)

        2.  Device unit number (unit)

        3.  Controller number (cntrlr)

   The controller number can be  omitted  if  the  device  is  interfaced
   directly to the channel bus.

                              ----- Hint -----

   If the TOPS-20 monitor is reloaded, such as after a system crash,  you
   do  not  need  to  set  the  device  on-line  again.   The  device  is
   automatically recognized by the monitor as being on-line.

                            ----- Examples -----

        1.  Set the TX02  hardware  device  on-line  after  it  has  been
            installed   during  timesharing.   Specify  the  argument  of
            channel 1, unit 1, controller 1.

            OPR>SET ONLINE 1,1,1<RET>
            OPR>
            8:32:13        --Set Online Accepted--
            OPR>

        2.  Set the hardware device  on-line  after  your  DIGITAL  Field
            Service Representative has repaired the tape unit.

            OPR>SET ONLINE 1,2,1<RET>
            OPR>


                                    7-5

                         UNSCHEDULED SOFTWARE TASKS


            14:43:09        --Set Online Accepted--
            OPR>



   7.3  CONTROLLING THE ORION LOG BUFFER FILE

   ORION maintains  a  log  of  all  messages  sent  through  it.   ORION
   timestamps  and  identifies  the  type  of  message  and  provides any
   additional information available.  This function of ORION is  referred
   to as a Centralized Logging Facility.

   The ORION log buffer  file  contains  all  OPR-to-ORION  commands  and
   transactions  performed  at  the operator's console.  The OPR commands
   that control this logging facility are:

        1.  ENABLE LOGGING

        2.  DISABLE LOGGING

        3.  CLOSE LOG

   The Centralized Logging Facility is on by default at  system  startup,
   but  can  be  disabled  by  placing the DISABLE LOGGING command in the
   SYSTEM.CMD file or by giving this command at OPR command level.

   To enable the Centralized Logging  Facility  again,  give  the  ENABLE
   LOGGING  command  at  OPR  command  level or place this command in the
   SYSTEM.CMD file.

   The  CLOSE  LOG  command  closes  the  current  log  buffer  file  and
   automatically  creates  a  new  log  buffer  file.  When the CLOSE LOG
   command is issued, the commands and transactions recorded in  the  log
   buffer  file  are  copied  to the ORION-SYSTEM.LOG file and the buffer
   file is cleared.  You can then print the ORION-SYSTEM.LOG file on  the
   line  printer to obtain a hard copy of all the operating processes for
   a given period.

   The name of the log file is  determined  by  your  system  manager  at
   GALGEN  time.   (Refer  to the TOPS-20 Software Installation Guide for
   the GALGEN procedures.) The default name is ORION-SYSTEM-LOG.nnn.













                                    7-6

                         UNSCHEDULED SOFTWARE TASKS


                            ----- Examples -----

        1.  Disable the logging facility for a period of  time  when  the
            system is operating stand-alone.

            OPR>DISABLE LOGGING<RET>
            OPR>
            8:52:12        --ORION Logging Disabled by JOB 6 OPERATOR
                              at terminal 14--
            OPR>

        2.  Close the current log buffer file and automatically create  a
            new log buffer file.

            OPR>CLOSE LOG<RET>

            OPR>



   7.4  INITIALIZING TAPES

   At various times, you are asked to initialize and/or  re-initialize  a
   magnetic tape.  When you initialize a tape, the system writes specific
   information on the tape pertaining to the identification of the  tape.
   When  you  initialize  a  tape  specifying  a TOPS-20, ANSI, or EBCDIC
   standard label, the system writes the  following  information  on  the
   tape:

        1.  A  standard   volume   label   that   contains   the   volume
            identification (volid) of the tape.

        2.  Standard header and trailer labels.  Later, when  a  file  is
            written   on   the   tape,   these  labels  contain  specific
            information pertaining to the file.

   When you initialize a tape as unlabeled, the system writes a record of
   80  null  characters  followed  by  two  tapemarks  on the tape.  This
   prevents the tape from running off the end of  the  reel  when  MOUNTR
   inspects it for a volume label.

   To initialize one or more tapes, give the following OPR command:

        OPR>SET TAPE-DRIVE MTAn:  INITIALIZE /switch:,/switch:,...<RET>

        where "n" is the unit number of the tape drive.

   The  following  table  describes  the  valid  switches  for  the   SET
   INITIALIZE command:





                                    7-7

                         UNSCHEDULED SOFTWARE TASKS


   Table 7-1:  SET INITIALIZE Switches

   ______________________________________________________________________

     Switch                                    Meaning
   ______________________________________________________________________

     /COUNT:nn                      specifies the number (nn) of  tapes
                                    to  be  initialized.   This  switch
                                    allows you to  initialize  multiple
                                    tapes  with  the  same  attributes.
                                    Every time you initialize  a  tape,
                                    the  system  asks  you  to  type  a
                                    volume identifier unless  the  tape
                                    has  only  numeric characters, with
                                    no   leading   zeroes,    in    the
                                    VOLUME-ID.   If it has only numeric
                                    characters, then the next label  is
                                    equal to the present volume-ID plus
                                    the value of the /INCREMENT switch.
                                    When  the initialization process is
                                    complete, the  system  unloads  the
                                    tape  from  the  drive.   When  the
                                    specified number of tapes have been
                                    initialized,  you  can use the tape
                                    drive   to   satisfy   user   mount
                                    requests.

     /DENSITY:nnnn                  specifies  the   density   of   the
                                    tape(s)   being  initialized.   The
                                    "nnnn" can be 200, 556, 800,  1600,
                                    or  6250.   If you do not give this
                                    switch,  the   system   uses   1600
                                    bits/in as the default.

     /INCREMENT:nn                  specifies the  numeric  value  (nn)
                                    that   is  used  to  increment  the
                                    volume identifiers.  This switch is
                                    valid  only when specified with the
                                    /VOLUME-ID switch.  If you  do  not
                                    give this switch, the system uses 1
                                    as the default.

     /LABEL-TYPE:type               specifies  the  type  of   standard
                                    volume  label  to be written on the
                                    tape.  The "type" can  be  TOPS-20,
                                    ANSI, EBCDIC, or UNLABELED.  If you
                                    do not specify a  label  type,  the
                                    system uses TOPS-20 as the default.





                                    7-8

                         UNSCHEDULED SOFTWARE TASKS


   /OVERRIDE-EXPIRATION:(YES or NO) specifies  whether  to  ignore  the
                                    expiration  date of the data on the
                                    tape.   If  you  specify  NO,   the
                                    system   does   not  allow  you  to
                                    initialize a tape whose  expiration
                                    date  has  not  yet  expired.  (The
                                    expiration  date  of  the  tape  is
                                    defined  as  the expiration date of
                                    the first file on the tape.) If you
                                    specify YES, the system initializes
                                    the tape  even  if  the  expiration
                                    date  has  not  been reached.  When
                                    you are initializing new tapes, you
                                    should   always   specify   YES  to
                                    prevent the tape from running away.
                                    If you do not give this switch, the
                                    system uses NO as the default.

     /OWNER:name                    specifies the name of the owner  of
                                    the   tape(s)   being  initialized.
                                    This switch is valid  only  if  the
                                    label  type  is TOPS-20.  If you do
                                    not give this switch, the  tape  is
                                    initialized as a scratch tape.

     /PROTECTION:nnnnnn             specifies a six-digit octal  number
                                    as the protection code of the tape.
                                    The number  (nnnnnn)  can  be  from
                                    000000 (no one except the owner can
                                    use  the   tape)   through   777777
                                    (anyone  can  use  the tape).  This
                                    switch is valid only if  the  label
                                    type  is  TOPS-20.   If  you do not
                                    give this switch, the  system  uses
                                    the  protection  code  of 777777 as
                                    the default.


















                                    7-9

                         UNSCHEDULED SOFTWARE TASKS


     /TAPE-DISPOSITION:condition    specifies what is to be  done  with
                                    the   tape   after   it   has  been
                                    initialized.  The  "condition"  can
                                    be  either  HOLD or UNLOAD.  If you
                                    specify  HOLD,  the  tape   remains
                                    mounted  on  the  drive  after   it
                                    has  been  initialized.    If   you
                                    specify   UNLOAD,   the   tape   is
                                    unloaded from the  drive  after  it
                                    has  been initialized.  If you give
                                    the /COUNT:  switch  with  a  value
                                    greater       than      1,      the
                                    /TAPE-DISPOSITION  is  ignored  and
                                    UNLOAD  is assumed.  If this switch
                                    is  not  given,  the  system   uses
                                    UNLOAD as the default.

     /VOLUME-ID:volid               specifies the volume identifier for
                                    the  tape.  The  volid  can be from
                                    1 to 6  characters.   If  the volid
                                    contains  non-alphanumeric  charac-
                                    ters, you  must enclose  the  volid
                                    in double quotes (").
   ______________________________________________________________________


   When you use a tape drive for initializing tapes, the  tape  drive  is
   not  available  for  user  mount  requests.   When  the initialization
   process is completed, the tape drive automatically  becomes  available
   for user mount requests.  To force a tape drive out of initialize mode
   prematurely, refer to Section 7.5.7.























                                    7-10

                         UNSCHEDULED SOFTWARE TASKS


                            ----- Examples -----

        1.  A user (J.JONES) has requested a tape mount of an  ANSI  tape
            with  a volid of FOOBAR and has requested that you initialize
            the tape first.  The volume is initialized with  ANSI  labels
            and  a volid of FOOBAR.  The system default for density (1600
            BPI) is used.  When the tape is mounted  on  the  drive,  the
            tape  is  initialized  and the drive becomes available to the
            user (/TAPE-DISPOSITION:HOLD).  Automatic Volume  Recognition
            (AVR  - See Section 7.5.2) takes over and satisfies the mount
            request for FOOBAR.

            OPR>
            12:11:34   --Tape Mount Request # 31--
            Mount ANSI volume FOOBAR, 9-track, 1600 BPI, WRITE-ENABLED
                       User J.JONES, Job 39, Terminal 13
                       User remarks: PLEASE INITIALIZE TAPE FIRST
            OPR>SET TAPE-DRIVE MTA3: INITIALIZE /LABEL-TYPE:ANSI-<RET>
            /TAPE-DISPOSITION:HOLD/VOLUME-ID:FOOBAR<RET>
            OPR>
            12:12:01     --Mount Tape To Be Initialized--
               Mount tape volume FOOBAR for initialization on MTA3:
            OPR>
            When the initializing is completed,  the  system  issues  the
            following message:

            12:13:14   --MTA3: Volume FOOBAR Initialized--
                       Label Type: ANSI        Density:       1600
            OPR>
            12:13:19     --INITIALIZE Completed--
                       MTA3: available for user tape requests
            OPR>
            12:13:30   --MTA3: Volume FOOBAR, ANSI labeled tape mounted--
            OPR>
            12:13:33     --Tape Drive Given To Request 31--
                       MTA3: Volume FOOBAR now in use by
                       User J.JONES, Job 39, Terminal 13
            OPR>
















                                    7-11

                         UNSCHEDULED SOFTWARE TASKS


        2.  You initialize multiple tapes on the same drive with  numeric
            volume  identifications.   This  sets  up the drive MTA0:  to
            initialize all tapes mounted on it with  volume-ids  starting
            at  100000  and incremented by one for each tape mounted.  As
            each  tape  is  mounted,  you  are  informed  of  the  volume
            information.

            OPR>SET TAPE-DRIVE MTA0: INITIALIZE /COUNT:10-<RET>
            /OWNER:OPERATOR/VOLUME-ID:100000<RET>
            OPR>
            13:20:05   --Mount Tape To Be Initialized--
                   Mount tape volume 100000 for initialization on MTA0:
            OPR>
            13:21:10   --MTA0: Volume 100000 Initialized--
                   Label type: TOPS-20  Density:  1600
                   Owner:  OPERATOR Protection: 777777
            OPR>
            13:21:35   --Mount Tape To Be Initialized--
                   Mount tape volume 100001 for initialization on MTA0:
            OPR>
            13:23:01   --MTA0: Volume 100001 Initialized--
                   Label type: TOPS-20  Density:  1600
                   Owner:  OPERATOR Protection: 777777
            OPR>
                      .
                      .
                      .
            13:40:23        --MTA0: Volume 100009 Initialized--
                          Label Type: TOPS-20     Density:        1600
                          Owner:  OPERATOR       Protection:     777777
            OPR>

            After you initialized the number of tapes, release  the  tape
            drive so that it can be used for user MOUNT requests.

            OPR>SET TAPE-DRIVE MTA0 AVAILABLE<RET>
            OPR>
            13:47:37          --INITIALIZE Complete--
                            MTA0: available for user tape requests
            OPR>














                                    7-12

                         UNSCHEDULED SOFTWARE TASKS


        3.  You initialize two tapes with non-numeric labels.

            OPR>SET TAPE-DRIVE MTA1: INITIALIZE /COUNT:2/DENSITY:800-<RET>
            /LABEL-TYPE:ANSI/PROTECTION:770077/VOLUME-ID:PAYMAS<RET>
            OPR>
            15:07:47  --Mount Tape To Be Initialized--
                   Mount tape volume PAYMAS for initialization on MTA1:
            OPR>
            15:09:43  --MTA1: Volume PAYMAS Initialized--
                   Label type:ANSI        Density: 800
            OPR>
            15:10:12  <18>  --Key In Volume Identifier--
                   What is the volume-id of the next tape to be
                   initialized on drive MTA1:
                     RESPOND n volid
            OPR>RESPOND 18 PAYMA1<RET>
            OPR>
            15:10:56  --Mount Tape To Be Initialized--
                   Mount Tape volume PAYMA1 for initialization on MTA1:
            OPR>
            15:13:34  --MTA1: Volume PAYMA1 Initialized--
                   Label type: ANSI       Density: 800
            OPR>
            15:14:27  --INITIALIZE Complete--
                   MTA1: available for user tape requests
            OPR>




























                                    7-13

                         UNSCHEDULED SOFTWARE TASKS


   7.5  HANDLING USER MOUNT REQUESTS

   There are two types of tapes you may be requested to  mount:   labeled
   tapes  and unlabeled tapes.  The differences in handling the two types
   of tape requests are explained in the  following  sections.   If  your
   system  has tape drive allocation enabled, the user must issue a MOUNT
   command to request that a tape be mounted.  When the  system  receives
   this request, OPR prints the following message:

        hh:mm:ss       -- TAPE MOUNT REQUEST#nn--
                     MOUNTlabel-typeVOLUMEvolid,n-track,nnnnBPI,mode
                     USER:username,JOBnn,TERMINALnn
                     VOLUMES IN SET setname:volid1,volid2,...
                     USER REMARK: text

   where:

        hh:mm:ss       specifies  the  time  the  operator  received  the
                       message.

        REQUEST#nn     specifies the request number assigned to the mount
                       request.

        label-type     specifies    the    type    of    label,    either
                       TOPS-20,ANSI,EBCDIC, or UNLABELED.

        VOLUME volid   specifies the internal and/or external name of the
                       tape.

        n-track        specifies the channel structure of the tape, i.e.,
                       9-track.

        nnnnBPI        specifies  the  density  at  which  the  data  was
                       recorded  on  the  tape.   The valid densities are
                       200,556,800,1600, and 6250.  If the user does  not
                       specify  a  density,  the  system uses 1600 as the
                       default.

        mode           specifies whether the  tape  is  write-enabled  or
                       read-only.

        username       specifies the name of  the  user  who  issued  the
                       MOUNT command.

        JOBnn          specifies the job number  the  user  was  assigned
                       when he logged onto the system.

        TERMINALnn     specifies the line number  of  the  terminal  from
                       which the user issued the MOUNT request.





                                    7-14

                         UNSCHEDULED SOFTWARE TASKS


    setname:volid1,    specifies  the  name  the  user  assigned   to   a
                       multi-volume  tape  set and the volume identifiers
                       for  each  tape  in  the  set.   This  information
                       appears  only  if  the  user  has requested that a
                       multi-volume tape set be mounted.

    USER'S REMARK:text specifies any remarks the user gave with the MOUNT
                       command.   This  information  appears  only if the
                       user gave a remark with the MOUNT command.

   If tape drive allocation is not enabled, the  user  issues  an  ASSIGN
   command  to  assign a tape drive to his job.  In this case, you do not
   receive a mount request message on the terminal running OPR.



   7.5.1  Displaying Tape Drive Status

   If you need to find out the status of one or all of the tape drives on
   the  local system or on a remote CFS-20 system, give the following OPR
   command:

        OPR>SHOW STATUS TAPE-DRIVE MTAn:  or /switch<RET>

   The switches for this command are:

    Switch                                       Meaning

     /ALL                    displays the status of all the  tape  drives
                             on  the  system.   This  switch  causes  the
                             system to print the following information:

                              o  The  unit  number  of  the  tape   drive
                                 (MTAn:)

                              o  The current state of the tape drive  (In
                                 Use, Loaded, or Unloaded)

                              o  The volid of the tape on the drive

                              o  The  request  number  assigned  to   the
                                 request

                              o  The job number assigned to the user

                              o  The name of the user who  has  the  tape
                                 mounted

                              o  The  status  of   AVR   on   the   drive
                                 (Yes=enabled or No=disabled)




                                    7-15

                         UNSCHEDULED SOFTWARE TASKS


                              o  The mode of the tape  (WRITE-ENABLED  or
                                 read-only)

                              o  The label-type  of  the  tape  (TOPS-20,
                                 ANSI, EBCDIC, or Unlabeled)

                              o  The  density  at  which  the  data   was
                                 written on the tape

   /FREE                     displays the tape drives that are  available
                             to  you  for  mounting  tapes.   This switch
                             displays, for all available drives, the same
                             information   as   the   /ALL   switch.   In
                             addition, you are told  if  the  tape  is  a
                             scratch tape.

   /CHARACTERISTICS          displays the following information:

                              o  The physical unit number  of  the  tape,
                                 for example, MTA0:

                              o  The type of drive (9-track or 7-track)

                              o  The densities the drive supports

   /CLUSTER-NODE:name        displays  tape-drive  information  for   the
                             specified  remote  CFS-20  system.   If * is
                             specified, the  tape-drive  information  for
                             all nodes in the cluster is displayed.

   If you do not give a physical device or one the  above  switches,  the
   display you see is similar to the following:

        OPR>
        10:19:51         --Tape Drive Status--
        DRIVE   STATE        VOLID     REQ#   JOB#   USER
        -----   -----        -----     ----   ----   ----
        MTA0:   In Use       DIST      145    8      LATTA
        MTA1:   In Use       DBL01     148    8      LATTA
        MTA3:   In Use       KEVINM    164    56     MCELMOYLE
        MTA4:   Unloaded
        MTA5:   Unloaded












                                    7-16

                         UNSCHEDULED SOFTWARE TASKS


                            ----- Examples -----

        1.  Give the SHOW STATUS TAPE-DRIVE command for tape drive MTA0:.

                 OPR>SHOW STATUS TAPE-DRIVE MTA0:<RET>
                 OPR>
                 12:26:45    --Tape Drive Status--
                 DRIVE   STATE        VOLID     REQ#   JOB#   USER
                 -----   -----        -----     ----   ----   ----
                 MTA0:   In Use       RICK2     212     56    R.ACE

            This example illustrates that drive MTA0:  is being  used  by
            user  R.ACE.  If the STATE of the drive had been "Loaded", it
            would mean that there is a tape on the drive,  but  that  the
            tape  was not being used at the time.  If this were the case,
            there would not be a number under the heading REQ#.   If  the
            STATE  of  the drive had been "Unloaded", it would mean there
            is no tape on the drive and the drive could be used to  mount
            a tape.

        2.  Give the SHOW STATUS TAPE DRIVE command with the /ALL switch.

                 OPR>SHOW STATUS TAPE-DRIVE/ALL<RET>
                 OPR>
                 11:20:02    --Tape Drive Status--
                 DRIVE   STATE        VOLID     REQ#   JOB#   USER
                 -----   -----        -----     ----   ----   ----
                 MTA0:   Unloaded
                         AVR: Yes
                 MTA1:   In Use       A         100    10     R.ACE
                         AVR: YES, WRITE:  YES, TOPS-20 labels, 1600 BPI
                 MTA2:   Unloaded
                         AVR: Yes
                 MTA3:   Unloaded
                         AVR: Yes
                 MTA4:   Unloaded
                         AVR: No
                 MTA5:   Loaded
                         AVR: Yes, Write:  Yes, Unlabeled
                 OPR>














                                    7-17

                         UNSCHEDULED SOFTWARE TASKS


        3.  Give the SHOW  STATUS  TAPE  DRIVE  command  with  the  /FREE
            switch.

                 OPR>SHOW STATUS TAPE-DRIVE /FREE<RET>
                 OPR>
                 11:18:56    --Tape Drive Status--
                 DRIVE   STATE    AVR  WRITE  VOLID   SCR  LBL TYPE  DENSITY
                 -----   -----    ---  -----  -----   ---  --------  -------
                 MTA0:   Unloaded Yes
                 MTA2:   Unloaded Yes
                 MTA3:   Unloaded Yes
                 MTA4:   Unloaded No
                 MTA5:   Loaded   Yes  Yes            No   Unlabeled
                 OPR>

        4.  Give  the  SHOW  STATUS   TAPE   DRIVE   command   with   the
            /CHARACTERISTICS switch.

                 OPR>SHOW STATUS TAPE-DRIVE /CHARACTERISTICS<RET>
                 OPR>
                 11:20:39    --Tape Drive Status--
                 DRIVE  TYPE     SUPPORTED DENSITIES
                 -----  ----     -------------------
                 MTA0:  9-TRACK  800, 1600
                 MTA1:  9-TRACK  800, 1600
                 MTA2:  9-TRACK  1600, 6250
                 MTA3:  9-TRACK  1600, 6250
                 MTA4:  7-TRACK  200, 556, 800
                 MTA5:  9-TRACK  800, 1600
                 OPR>



   7.5.2  Controlling Automatic Volume Recognition (AVR)

   Automatic Volume Recognition (referred to as AVR) allows you to  mount
   a labeled tape without telling the system the volume identification of
   the tape.  When you mount a labeled tape  on  a  drive  that  has  AVR
   enabled, the system automatically reads the volume identifier from the
   volume label when the tape drive is brought on-line.

   If tape drive allocation is being used on  your  system,  then  it  is
   likely  that  AVR  has been enabled in the n-CONFIG.CMD file.  If, for
   some reason, you need to disable AVR for one or all tape drives,  give
   the following OPR command:









                                    7-18

                         UNSCHEDULED SOFTWARE TASKS


        OPR>DISABLE AUTOMATIC-VOLUME-RECOGNITION argument<RET>

        where the argument can be:

             MTAn:  (for a specific tape drive)
              or
             TAPE-DRIVES (for all tape drives)

   One reason for disabling AVR on a tape drive is to avoid runaway tapes
   when  you  are initializing tapes.  When you disable AVR, OPR does not
   print any message confirming that AVR has been disabled.  To check the
   status  of the tape drive, give the OPR command SHOW STATUS TAPE-DRIVE
   /ALL.

   You can enable AVR for one or more of the tape drives on  your  system
   by giving the following OPR command:

        OPR>ENABLE AUTOMATIC-VOLUME-RECOGNITION argument<RET>

                          ----- Restriction -----

                  You cannot ENABLE  or  DISABLE  AVR  for
                  7-track  tape drives.  If you attempt to
                  do  so,  the  system  will  ignore   the
                  command.   All  tapes mounted on 7-track
                  tape drives are  regarded  as  unlabeled
                  tapes.
                            ----- Example -----

            Disable AVR for tape drive 0.

                OPR>DISABLE AUTOMATIC-VOLUME-RECOGNITION MTA0:<RET>



   7.5.3  Mounting Labeled Tapes with AVR Enabled

   When a user issues a MOUNT command for a labeled tape, you  receive  a
   message similar to the following:

        OPR>
        10:15:43        --Tape Mount Request # 12--
                      Mount Volume 001234, Read-Only
                      User HOVSEPIAN, Job 25,Terminal 2

   If the user has not already given you the tape, the  first  thing  you
   must  do  is physically locate the tape he requested.  When you locate
   the tape, mount the tape on a drive that supports the density the user
   requested in the MOUNT command.  When the tape is brought on-line, the
   system automatically reads the label and prints a message  similar  to
   the following on your terminal:



                                    7-19

                         UNSCHEDULED SOFTWARE TASKS


        OPR>
        10:15:43     --MTA0: Volume 001234 TOPS-20 labeled tape mounted--
        OPR>
        10:15:45     --MTA0: Given To Request 12--
                     Volume 001234 now in use by
                     User HOVSEPIAN, Job 25, Terminal 2

   When the user finishes using the tape drive, he issues a DISMOUNT TAPE
   command  to  release  the tape drive.  When he gives this command, the
   system prints a message similar to the following on your terminal:

        OPR>
        11:20:33      --Tape Drive Released by USER--
                     MTA0:  Volume 001234 being Unloaded
        OPR>

   If a tape has been mounted for a long period without being used, it is
   possible  that  the  user  forgot to give the DISMOUNT TAPE command to
   release the tape drive.  If this is the case, check with the  user  to
   see  if he is finished using the tape.  If he is, give the OPR command
   DISMOUNT TAPE.  When you  give  this  command,  the  system  prints  a
   message similar to the following on your terminal:

        OPR>
        11:45:20      --MTA0:  Unloaded--

                                    NOTE

           Tape handling error messages are explained in  Section
           9.4.7.



   7.5.4  Mounting Labeled Tapes With AVR Disabled

   When a user issues a MOUNT command, you see the same mount request  as
   explained  in the previous section.  However, because AVR is disabled,
   the system does not automatically read the label.  Therefore, you must
   give  the  OPR  command  IDENTIFY  to  inform  the system of the label
   information.

   For example, a user requests a labeled tape whose volid is  112233  to
   be  mounted  on a tape drive.  You mount the tape on a tape drive that
   has AVR disabled, for  example,  MTA0:.   After  you  bring  the  tape
   on-line, give the following command:

        OPR>IDENTIFY MTA0: VOLUME-ID 112233<RET>

   The above command tells the system that a labeled tape with the  volid
   of 112233 is mounted on tape drive MTA0:.

   If the user requests that a labeled tape be mounted as a scratch tape,
   give the following command:

                                    7-20

                         UNSCHEDULED SOFTWARE TASKS


        OPR>IDENTIFY MTA0: SCRATCH<RET>

                                    NOTE

           When a user requests that a labeled tape be mounted as
           a  scratch  tape,  the  volid  in the mount request is
           replaced by the word SCRATCH.



   7.5.5  Mounting Unlabeled Tapes

   When a user requests that an unlabeled  tape  be  mounted  on  a  tape
   drive,  the  mount  request  you  see  is  the same as the ones in the
   previous sections with the exception that the "label-type" is shown as
   unlabeled.   To  inform  the system that you are mounting an unlabeled
   tape, use the OPR command IDENTIFY.

   After you have physically located the tape and mounted it  on  a  free
   tape drive, give the IDENTIFY command to have the system associate the
   tape with the mount request.

   For example, a user requests that an unlabeled tape be mounted with  a
   volid  of  TEST01.   When  the  mount request is processed, the system
   prints the following message on your terminal:

        OPR>
        10:20:10      --Tape Mount Request #12--
                     Mount Unlabeled Volume TEST01
                     User Hovsepian, Job 21, Terminal 7
        OPR>

   When you receive this  request,  locate  and  mount  the  tape  on  an
   available tape drive and then give the following command.

        OPR>IDENTIFY MTAn:  VOLUME-ID TEST01<RET>

   where "n" is the unit number of the tape drive.

   You can also satisfy the mount request by giving the IDENTIFY  command
   with  the request number in place of the volid.  Using the above mount
   request, give the following command:

        OPR>IDENTIFY MTAn:  REQUEST-ID 12<RET>

   If the user requests that an unlabeled scratch tape be  mounted,  give
   the following command:

        OPR>IDENTIFY MTAn:  SCRATCH<RET>





                                    7-21

                         UNSCHEDULED SOFTWARE TASKS


                            ----- Example -----

            A user requests that you mount an unlabeled scratch tape  and
            you comply, as there is a tape drive available.

            OPR>
            12:25:09         --Tape Mount Request #57--
                            Mount Unlabeled scratch tape, WRITE-ENABLED
                            User SMITH, Job 43, Terminal 18
                            User's remark:  PLEASE SEND VOLID TO JOB 43
            OPR>

            You now mount and ready an unlabeled  scratch  tape  on  tape
            drive MTA2:.

            12:27:32        --MTA2:  Unlabeled tape mounted--
            OPR>

            Then reply to OPR with:

            OPR>IDENTIFY MTA2:  SCRATCH<RET>
            OPR>
            12:27:33         --MTA2:  Given To Request 57--
                            Volume SCRATCH tape now in use by
                            User SMITH, Job 43, Terminal 18
            OPR>

            You can now SEND the physical volume identification to job 43
            as the user requested.

            OPR>SEND JOB 43 VOLID IS SCR123<RET>
            OPR>



   7.5.6  Canceling Mount Requests

   If you are unable to satisfy a user's mount request,  you  can  cancel
   the  mount  request by giving the OPR command CANCEL MOUNT-REQUEST nn.
   You should also notify the user why you could not satisfy the  request
   by giving the /REASON:  switch with the command.

   For example, you cancel a mount request because you could not find the
   requested tape.  To do this, give the following command:

        OPR>CANCEL MOUNT-REQUEST nn/REASON:I COULD NOT FIND THE TAPE<RET>

   where "nn" is the request number assigned to the mount request.






                                    7-22

                         UNSCHEDULED SOFTWARE TASKS


                            ----- Examples -----

            Cancel mount request 204.

            OPR>CANCEL MOUNT-REQUEST 204/REASON:I COULD NOT FIND THE
            TAPE<RET>
            OPR>
            11:49:19        --Mount Request 204 Canceled--



   7.5.7  Setting Tape Drives Available or Unavailable

   If tape drive allocation is enabled every time you start  the  system,
   all  tape  drives  are  under control of the MOUNTR program.  However,
   there may be times you want to release MOUNTR's control  of  the  tape
   drive.  To do this, you would give the following command:

        OPR>SET TAPE-DRIVE MTAn:  UNAVAILABLE<RET>

   where "n" is the unit number of the tape drive.

   The system prints:

        ENTER TEXT AND TERMINATE WITH ^Z

   This allows you to enter a comment giving a reason why you are setting
   the tape drive unavailable.

   When you give this command, MOUNTR releases control of the tape  drive
   and  users  can  assign  the  drive  to their jobs by using the ASSIGN
   command.  To return control of the tape  drive  to  MOUNTR,  give  the
   following command:

        OPR>SET TAPE DRIVE MTAn: AVAILABLE<RET>

                            ----- Example -----

            Set MTA0: unavailable because of a hardware problem.

            OPR>SET TAPE-DRIVE MTA0: UNAVAILABLE<RET>
            ENTER TEXT AND TERMINATE WITH ^Z
            TAPE DRIVE MTA0: IS LOSING VACUUM <CTRL/Z>

            OPR>



   7.6  ARCHIVING FILES WITH DUMPER

   If your installation is using  the  archive/virtual  disk  system  for
   off-line  storage of files, you could be requested at various times to


                                    7-23

                         UNSCHEDULED SOFTWARE TASKS


   run the DUMPER program to copy files marked  for  archiving  onto  two
   tapes.   These  requests do not appear at OPR command level.  However,
   you can give the TOPS-20 command INFORMATION  ARCHIVE-STATUS  <*>*.*.*
   to display the files that users have requested to be archived.

        $INFORMATION ARCHIVE-STATUS <*>*.*.*<RET>
         <ACE>TEST01.TST Archive requested
         <BROWN>FOO.BAR Archive requested
         <HOVSEPIAN>OPR.TXT Archive requested
         <LATTA>COBOL.EXE Archive requested
         <SARTINI>CONTNT.EXE Archive requested
         <WOLFE>ABCD.LST Archive requested
               .
               .
               .
        $

                                    NOTE

           This command shows files for your connected  structure
           only.   To show those files for another structure, you
           must  include  the  structure  name  in  the   command
           (str:<*>*.*.*).

   You can archive each file separately using the DUMPER program with the
   following command format:

        DUMPER>ARCHIVE str:<directory>filespec<RET>

   However, it is recommended that you wait until you have more than just
   one archive request to run DUMPER and archive files.

   If no filespec is given in the DUMPER command, all  files  marked  for
   archiving  on  the  connected  structure are copied to tape.  Thus the
   DUMPER command defaults to the following:

        DUMPER>ARCHIVE str:<*>*.*.*<RET>

   You must use two tapes when you are archiving files.  With two  tapes,
   the  archive  provides a backup system in case one of the tapes is bad
   or if one of the tapes gets misplaced.  Your system manager should set
   up  the  procedures  and  the  tapes that are to be used for archiving
   files.

   Archiving  requires  that  DUMPER  make  two  runs  on  the  connected
   structure.  When the files have been successfully copied to two tapes,
   DUMPER then deletes the contents of the  files  from  the  disk.   The
   following are the steps you must take to archive one or more files:

        1.  Physically mount and ready a tape that has been assigned  for
            archiving.



                                    7-24

                         UNSCHEDULED SOFTWARE TASKS


        2.  Type PUSH to OPR.

        3.  Type ENABLE.

        4.  Type MOUNT TAPE setname:  (setname is the name  you  assigned
            to   your   tape)   with   the   /WRITE-ENABLED  switch,  the
            /LABEL-TYPE:   switch,  the  /VOLIDS:   switch,  the  /NOWAIT
            switch,  and  any  additional  switches  desired to the MOUNT
            command.

        5.  When MOUNTR replies with  the  Tape  Mount  Request  and  the
            acknowledgment  of the unlabeled tape being mounted, type POP
            to return to OPR.

        6.  If you are using an unlabeled tape, give the IDENTIFY command
            to OPR to identify the tape drive to the mount request.

        7.  When MOUNTR replies with Tape Drive Given To Request  number,
            type PUSH to OPR.

        8.  After the system has assigned a tape drive, type DUMPER.

        9.  Type to DUMPER:

            TAPE MTn:<RET>
            ARCHIVE str:<dir>filespec<RET>

       10.  DUMPER asks you two questions.  If the tape  has  never  been
            used  before  for  archiving,  you  should answer YES to both
            questions.  If the tape has been used before  for  archiving,
            you  should  answer  NO  to the first question and the second
            question does not appear (see the example below).

       11.  When DUMPER replies with the two Total lines,  type  EXIT  to
            DUMPER.

       12.  Type DISMOUNT MTn:.

       13.  Physically remove the tape from the tape drive.

       14.  Mount and ready the second tape for the  archive  and  repeat
            Steps 4 through 13.

       15.  Type POP to return to OPR.

                            ----- Example -----

   The following is an example of the DUMPER program when used to archive
   files.   It is assumed that you have already mounted an unlabeled tape
   on MTA1:  and the tape has never been used before for archiving.

        OPR>PUSH<RET>


                                    7-25

                         UNSCHEDULED SOFTWARE TASKS


         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $MOUNT TAPE ARCHVE: /WRITE-ENABLED/LABEL-TYPE:UNLABELED-<RET>
        /VOLIDS:500100/NOWAIT<RET>
        [Waiting for Tape/Structure Mount]

   OPR prints on the CTY:

        14:43:18          --Tape Mount Request # 57--
                        Mount Unlabeled volume 500100, WRITE-ENABLED
                        User OPERATOR, Job 6, Terminal 1

        14:43:46          --MTA1: Unlabeled tape mounted--
        $POP<RET>
        OPR>IDENTIFY MTA1: REQUEST-ID 57<RET>
        OPR>
        14:43:50          --MTA1: Given To Request 57--
                        Volume 500100 now in use by
                        User OPERATOR, Job 6, Terminal 1
        OPR>PUSH<RET>
        [Tape set ARCHVE, volume 500100 mounted]
        [ARCHVE: defined as MT0:]
        $DUMPER<RET>
        DUMPER>TAPE MT0:<RET>
        DUMPER>FILES<RET>
        DUMPER>ARCHIVE PS:<TODAY>*.*.*<RET>
        $Is this a new tape? YES<RET>
        $Are you sure? YES<RET>

         DUMPER tape # 1, Fri 27-July-84 1354. ARCHIVE, volid T2

        PS:<TODAY>
          PS:<TODAY>QE5.LIB.1
          PS:<TODAY>QE5.TEC.1

        Pass 2 started.
        Pass 2 completed.


        Total files dumped:     2
        Total pages dumped:     4
        CPU time, seconds:      0
        DUMPER>EXIT<RET>
        $DISMOUNT MT0:<RET>
        [Tape dismounted]
        $
        15:21:09          --Tape Drive Released By User--
                        MTA1: Volume 500100 Being unloaded






                                    7-26

                         UNSCHEDULED SOFTWARE TASKS


                                    NOTE

           If you are using the terminal that OPR is running  on,
           it  is  possible to receive OPR messages while you are
           running the DUMPER program.

   You can now mount and ready another tape for the  archive.   When  you
   PUSH  from  OPR  after  IDENTIFYing  the  mount  request, you can type
   CONTINUE to return to DUMPER.

                                    NOTE

           When a file has been archived, the user who  requested
           the  archive  receives  a message in his MAIL.TXT file
           specifying that the file is archived.



   7.7  RUNNING THE REAPER PROGRAM

   The REAPER program is used to increase free disk space on the  system.
   REAPER frees this disk space by performing the following functions:

        1.  By marking files that  have  not  been  referenced  within  a
            specified period for involuntary migration

        2.  By deleting disk contents pertaining to archived or  migrated
            files that have not been referenced within a specified period

        3.  By trimming directories that are over  their  permanent  disk
            allocations

   In most cases to use the REAPER program, you would give  a  number  of
   commands,  one  for  each operation to be performed.  When all desired
   operations have been specified, you can give  the  BEGIN  command  and
   specify the path of files to be considered.

   Table 7-2 below and on the following pages describe the  commands  you
   can  give  to the REAPER program and what the REAPER program does when
   it is run.


   Table 7-2:  REAPER Commands

   ______________________________________________________________________

     BEGIN (Processing Files)

     specifies which files to process in the  file  system.   Normally,
     you can specify PS:<*>*.*.*, but you can also specify other paths,
     such as PS:<*>*.REL.* or  FOO:<TST*>*.*.*.   This  command  should
     only  be  given  after  all  desired  options have been specified.


                                    7-27

                         UNSCHEDULED SOFTWARE TASKS


     After the specified files have been processed, REAPER  prints  the
     total number of pages reclaimed and then exits.


     DELETE-CONTENTS (of old offline files)

     specifies that files, existing on both  disk  and  on  an  archive
     tape,  that have not been referenced within a specified period are
     to have their contents deleted from disk.  The period is specified
     by  the  PERIOD  command  (described below in this table).  If the
     DELETE command is not given, the  disk  contents  of  the  file(s)
     remain on the disk(s).


     EXIT (to monitor)

     specifies to exit from the REAPER program, without processing  any
     files.


     LIST (output to file)

     specifies an output filespec for the listing produced  by  REAPER.
     This  listing  consists of the names of the files that were marked
     for migration and a list of tapes that have archived  or  migrated
     files.   If  a  tape  that was listed on a previous listing is not
     listed on the current listing, it means that the contents  of  the
     tape have expired and can be released for other purposes.  If this
     command is not given, the listing produced by REAPER is written to
     the file DSK:REAPER.LIST.


     MIGRATE (old files to offline storage)

     specifies that files not referenced within  the  specified  period
     are  to  be  marked  for  involuntary  migration.   The  period is
     specified by the PERIOD command.  If the MIGRATE  command  is  not
     given, files are not marked for migration and remain on disk.

     Files that are marked for migration have the disk contents deleted
     from  disk  when  you  run  the  DUMPER  program with the /MIGRATE
     switch.  (Refer to next section in this chapter.)


     ORDER (For trimming)

     specifies the order in which files that are marked  for  migration
     are  to  be  taken  when  trimming  a  directory  that is over its
     permanent  allocation.   This  order  list  is  made  up  of  file
     specifications,  such  as:  *.TMP.*, *.LST.*, and *.REL.*.  REAPER
     only uses the ORDER list if the TRIM command is given.



                                    7-28

                         UNSCHEDULED SOFTWARE TASKS


     Most users have their  own  MIGRATION  ORDER  file  in  their  own
     directory.   However,  you should always include this command when
     performing trimming operations.


     PERIOD (For migration)

     specifies a time limit in days within which files  should  not  be
     migrated or have their disk contents deleted.  Your system manager
     should inform you of the number of days  to  be  entered  in  this
     command.   For  example,  if  PERIOD is 60 days, it means that all
     files older than 60 days are involuntarily migrated if the MIGRATE
     command  was  given  or  files  older than 60 days have their disk
     contents deleted if you gave the the DELETE command.

     If you do not give a PERIOD command, a default period of  60  days
     is assumed.


|    POLICY (does a TAKE on SYSTEM:REAPER.CMD)
|  
|    executes REAPER commands contained in the file SYSTEM:REAPER.CMD.


     PURGE (Expired FDBs from disk)

     specifies to delete and expunge the File Descriptor Block (FDB) of
     a  file  which  is  off-line  and  the  file's expiration date has
     arrived (or passed).  Sometime before the off-line expiration date
     is  reached,  a  message  is  sent  to  the user who owns the file
     indicating that the expiration of the file is  approaching.   This
     message is sent only once.


     SCAN (Only)            

     specifies that no files are actually DELETEd,MIGRATEd, or TRIMmed.
     Only a listing of the files and directories that would be deleted,
     migrated, and trimmed is produced if you were  to  run  REAPER  at
     this time.


     SKIP (Directories)

     specifies the directories that  are  not  to  be  considered  when
     performing  deletion,  migration,  or  trimming  operations.  Your
     system manager should inform you of the directories that should be
     skipped.  If the SKIP command is not given, all directories on the
     structure are processed.


     TAKE (Commands from file)


                                    7-29

                         UNSCHEDULED SOFTWARE TASKS


     specifies a command file of REAPER commands that  REAPER  executes
     automatically.   This  file should be created when the software is
     installed.  The command file should  contain  your  installation's
     policies  toward  involuntary  migration.  If you do not specify a
     filespec   with   the   TAKE   command,   REAPER    defaults    to
     SYSTEM:REAPER.CMD  as  a filespec.  (See below for an example of a
     REAPER.CMD file.)


     TAPE (Check of tapes in use)

     specifies that the output listing containing a summary of the tape
     information  for  the files considered in the REAPER process.  The
     listing shows  all  tapes  referenced  and  the  number  of  valid
     (unexpired)  files  each  tape  has.  There is no distinction made
     between archive and migration tapes.


     TRIM (Directories over allocation)

     specifies that directories over their permanent allocation will be
     trimmed  down  to the size specified in their directory.  The user
     can specify the order in which the  files  should  be  trimmed  by
     entering  an  order  list  in  a file named MIGRATION.ORDER in the
     user's directory.  If the MIGRATION.ORDER file does not  exist  in
     the  user's  directory,  then  the  order of files for trimming is
     taken from the ORDER command you specify.
   ______________________________________________________________________

   The following is an example of a REAPER.CMD file with  comments  added
   to clarify the commands:

        ! Sample REAPER policy file - Created 17 Sept 79,
        ! Directories not to consider:
        SKIP PS:<*SUBSYS>,PS:<*SYSTEM>,PS:<UNSUPPORTED>
        PERIOD 60        !Specify date limit on files
        MIGRATE          !Files older than PERIOD days
        DELETE           !Delete unreferenced file contents older
                          !than PERIOD with tape backup
        TRIM             !Directories over permanent allocation
        ORDER *.TMP.*,*.LST.* !IN WHICH TO TAKE FILES WITH TRIM

   When REAPER completes its processing, four lines of text  are  printed
   on your terminal.  These lines specify the number of:

        1.  files and pages marked for migration

        2.  archived files and pages deleted from disk

        3.  temporary files and pages deleted




                                    7-30

                         UNSCHEDULED SOFTWARE TASKS


        4.  expired files and pages purged

   If REAPER does not  mark  any  files  for  migration,  it  prints  the
   following information:

        0 files marked for migration, 0 pages
        0 archive files deleted from disk, 0 pages
        0 temporary files deleted, 0 pages
        0 expired files purged, 0 pages

                            ----- Examples -----

        1.  The following is an  example  of  the  REAPER  program.   You
            specify  the SCAN and BEGIN commands.  REAPER defaults to the
            SYSTEM:REAPER.CMD file automatically for your  installation's
            migration  policies.  Within the BEGIN command, you can press
            CTRL/A and REAPER prints the current directory it is  working
            on.

            OPR>PUSH<RET>

             TOPS-20 Command processor 7(31)
            @ENABLE<RET>
            $REAPER<RET>
            REAPER>SCAN<RET>
            REAPER>BEGIN<RET>
                  
             Working on PS:<WORK.DIRECTORY>
            <CTRL/A>
             Working on PS:<LATTA.SNARK>
            <CTRL/A>
             Working on PS:<XYZ.INP>
            <CTRL/A>
            169 files marked for migration, 3040 pages
            0 archive files deleted from disk, 0 pages
            0 temporary files deleted, 0 pages
            0 expired files purged, 0 pages
            $POP<RET>
            OPR>

            At this time, you can PRINT the file  REAPER.LIST  which  was
            written in your directory while REAPER was running.

        2.  The following is an example using the REAPER.CMD  file  shown
            above to migrate and trim files on the connected structure:

            OPR>PUSH<RET>

             TOPS-20 Command processor 7(31)
            @ENABLE<RET>
            $REAPER<RET>
            REAPER>TAKE REAPER.CMD<RET>


                                    7-31

                         UNSCHEDULED SOFTWARE TASKS


   While REAPER is running, you cannot type POP to return to OPR.  If you
   are  running  REAPER  as  a subjob of PTYCON, you can type <CTRL/X> to
   return to PTYCON and CONNECT back to OPR.  It is recommended that  you
   run  REAPER  either as a subjob of PTYCON or as a batch job because of
   the length of time it takes to process.

   When REAPER has completed its processing, REAPER lists the  number  of
   files and pages marked for migration, the number of files deleted, and
   the number of files purged.  You can then EXIT  from  REAPER  and  run
   DUMPER (explained in the next section).  For example:

            169 files marked for migration, 3040 pages
            12 archive files deleted from disk, 102 pages
            13 temporary files deleted, 236 pages
            2 expired files purged, 27 pages

            $POP<RET>
            OPR>



   7.8  MIGRATING FILES WITH DUMPER

   Once a file has been marked for migration you  should  run  DUMPER  to
   dump  the marked files to tape and delete (using the DELETE command in
   REAPER) the files from disk.  The contents of the  files  are  deleted
   after the second tape has been used for migration.

   Like archiving files, migration requires two  tapes.   Two  tapes  are
   used  to  provide  a back-up system in case one of the tapes is bad or
   gets misplaced.  Your system manager should set up the  procedure  and
   assign the tapes to be used for migrating files.

   You must do the following to migrate files with DUMPER:

        1.  Physically mount and ready a tape that has been assigned  for
            migrating files.

        2.  Type PUSH to OPR.

        3.  Type ENABLE.

        4.  Type MOUNT TAPE setname:  with the /WRITE-ENABLED switch, the
            /LABEL-TYPE:    switch,   the   /VOLIDS:    switch,  and  any
            additional switches desired to the MOUNT command.

        5.  When MOUNTR replies with  the  Tape  Mount  Request  and  the
            acknowledgement  of  the  unlabeled tape being mounted, press
            <RET> and type POP to return to OPR.

        6.  If you are using an unlabeled tape, give the IDENTIFY command
            to OPR to identify the tape drive for the mount request.


                                    7-32

                         UNSCHEDULED SOFTWARE TASKS


        7.  When MOUNTR replies with Tape Drive Given To Request  number,
            type PUSH to OPR.

        8.  After the system has displayed the defined tape drive for the
            setname:, type DUMPER.

        9.  Type to DUMPER:

            TAPE MTn:<RET>

                 LIST/MAIL filespec
                 MIGRATE str:<directory>filespec (for Migration)
                 MAIL filespec

       10.  DUMPER asks you two questions.  If the tape  has  never  been
            used  before  for  migration,  you  should answer YES to both
            questions.  If the tape has been used before  for  migration,
            you  should  answer  NO  to the first question and the second
            question does not appear (see the example below).

       11.  When DUMPER replies with the following messages:

                 TOTAL FILES dumped = nn
                 TOTAL Pages dumped = nn

            Type EXIT to DUMPER.

       12.  Type DISMOUNT MTn:

       13.  Physically remove the tape from the tape drive.

       14.  Mount and ready the second tape for the migration and  repeat
            Steps  4 through 12.  The migration of files is now complete,
            and those users who had files migrated receive a  message  in
            their MAIL.TXT files indicating the files that were migrated.
            If files in your directory were  migrated,  you  receive  the
            same message.

       15.  Type POP to return to OPR.

                            ----- Example -----

   The following is an example of the DUMPER program  that  was  used  to
   migrate  files.   It  is  assumed  that  you  have  already  mounted a
   unlabeled tape on MTA1:  and the tape(s) have never been  used  before
   for migration.

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $MOUNT TAPE T1: /WRITE-ENABLED/LABEL-TYPE:UNLABELED-<RET>


                                    7-33

                         UNSCHEDULED SOFTWARE TASKS


        13:43:18          --Tape Mount Request # 57--
                        Mount Unlabled volume 500100, WRITE-ENABLED
                        User OPERATOR, Job 6, Terminal 1

        13:43:46          --MTA1: Unlabeled tape mounted--
        <RET>
        $POP<RET>
        OPR>IDENTIFY MTA1: REQUEST-ID 57<RET>
        OPR>
        13:43:50          --MTA1: Given To Request 57--
                        Volume 500100 now in use by
                        User OPERATOR, Job 6, Terminial 1
        OPR>PUSH<RET>
        [Tape set T1:, volume 500100 mounted]
        [T1: defined as MT3:]
        $DUMPER<RET>
        DUMPER>TAPE T1:<RET>
        DUMPER>REWIND<RET>
        DUMPER>FILES<RET>
        DUMPER>LIST/MAIL TODAY.LST<RET>
        DUMPER>MIGRATE (DISK FILES) PS:<TODAY>*.*.*<RET>
         Is this a new tape? YES<RET>
         Are you sure? YES<RET>

          DUMPER tape #1, Fri 27-Jul-87 1413. MIGRATION , volid T1

         PS:<TODAY>
           PS:<TODAY>FTS.INIT.1
           PS:<TODAY>INIT.CMD.1
           PS:<TODAY>INT.MAC.1
           PS:<TODAY>MS.INIT.1
           PS:<TODAY>NFT.INIT.1
           PS:<TODAY>SED.INIT.1
           PS:<TODAY>TV.EXE.1
           PS:<TODAY>TV.INI.1
           PS:<TODAY>TV2.INI.1
           PS:<TODAY>TVSM.INI.1

         Pass 2 started.
         Pass 2 completed.


         Total files dumped:     10
         Total pages dumped:     38
         CPU time, seconds:      1
        DUMPER>MAIL TODAY.LST <RET>
        DUMPER>EXIT<RET>

        $DISMOUNT T1:
        [Tape dismounted, logical name T1: deleted]

   You can now mount and ready another tape for the migration.  When  you


                                    7-34

                         UNSCHEDULED SOFTWARE TASKS


   PUSH  from  OPR  after  identifying  the  mount  request, you can type
   CONTINUE to return to DUMPER.

        $MOUNT TAPE T2: /WRITE-ENABLED/LABEL-TYPE:UNLABELED-<RET>
        /VOLIDS:500200/NOWAIT<RET>
        [Mount request T2 queued, request #154]

        15:25:09          --Tape Mount Request # 154--
                        Mount Unlabled volume 500200, WRITE-ENABLED
                        User OPERATOR, Job 6, Terminal 1

        15:25:13          --MTA1: Unlabeled tape mounted--
        <RET>
        $POP<RET>
        OPR>IDENTIFY MTA1: REQUEST-ID 154<RET>
        OPR>
        15:27:12          --MTA1: Given To Request 154--
                        Volume 500200 now in use by
                        User OPERATOR, Job 6, Terminal 1
        OPR>PUSH<RET>
        [Tape set T2:, volume 500200 mounted]
        [T2: defined as MT3:]
        $CONTINUE<RET>
        DUMPER>TAPE T2:<RET>
        DUMPER>MIGRATE PS:<TODAY>*.*.*<RET>
        Is this a new tape? YES<RET>
        Are you sure? YES<RET>

         DUMPER tape #1, Fri 27-Jul-87 1417. MIGRATION , volid T2

        PS:<TODAY>
          PS:<TODAY>FTS.INIT.1
          PS:<TODAY>INIT.CMD.1
          PS:<TODAY>INT.MAC.1
          PS:<TODAY>MS.INIT.1
          PS:<TODAY>NFT.INIT.1
          PS:<TODAY>SED.INIT.1
          PS:<TODAY>TV.EXE.1
          PS:<TODAY>TV.INI.1
          PS:<TODAY>TV2.INI.1
          PS:<TODAY>TVSM.INI.1

        Pass 2 started.
        Pass 2 completed.


        Total files dumped:     10
        Total pages dumped:     38
        CPU time, seconds:      2





                                    7-35

                         UNSCHEDULED SOFTWARE TASKS


   7.9  RETRIEVING FILES WITH DUMPER

   Once a file is migrated or archived, the user cannot modify that  file
   unless  he  retrieves  the file with the TOPS-20 RETRIEVE command.  If
   the user wants to modify an archived file, he must first retrieve  the
   file  and then discard the tape archive status from the FDB.  When the
   user gives the RETRIEVE  command,  OPR  responds  with  the  following
   message:

        hh:mm:ss        File Retrieval n  --Retrieval Request--
                        str:<directory>filespec

   where n is the processor number processing the  request,  str: is  the
   requested   structure   name,  <directory>  is  the  requested  user's
   directory name, and filespec is the file specification.

   When a retrieval request is initially queued by a user, the request is
   stored  in  a  request  queue maintained by the system.  All retrieval
   requests are kept in the queue in order by the  archived  or  migrated
   tape   information.    This   information   consists   of  the  volume
   identification, the tape saveset number, and  the  tape  file  number.
   When each additional request is received by the system, the request is
   inserted in the proper sorted position within the queue.  Ordering the
   retrieval requests in this way reduces the amount of tape mounting and
   dismounting that must be performed by  you  when  you  run  DUMPER  to
   retrieve the requested files.

   To retrieve requested files with DUMPER, you must do the following:

        1.  Type PUSH to OPR.

        2.  Type ENABLE.

        3.  Run DUMPER and type:

            RETRIEVE str:<directory>filespec

        4.  When MOUNTR replies with  a  Tape  Mount  Request,  you  must
            physically   locate,  mount,  and  ready  the  tape  for  the
            retrieval.  MOUNTR obtains  the  tape  volid  from  the  file
            descriptor block (FDB) of each file requested for retrieval.

        5.  When MOUNTR replies that the tape is  mounted,  press  CTRL/C
            twice and then type POP to return to OPR.

        6.  If the label type is UNLABELED, give the IDENTIFY command  to
            OPR to identify the tape to MOUNTR.

        7.  After MOUNTR has displayed that the tape has  been  given  to
            the request number, type PUSH to OPR.




                                    7-36

                         UNSCHEDULED SOFTWARE TASKS


        8.  Type CONTINUE to return to the DUMPER program.

        9.  DUMPER then retrieves the files automatically and lists  them
            on your console.

       10.  When  the  retrievals  are  completed,  DUMPER  automatically
            unloads  the  tape.   If the retrievals require more than one
            tape,  DUMPER  unloads  and  requests  the  additional  tapes
            automatically.   Each  tape mount request has to be given the
            IDENTIFY  command  at  OPR  command  level.   You   have   to
            physically remove and mount each tape.

       11.  Type EXIT to DUMPER.

       12.  Type POP to return to OPR.

   The filespec (str:<directory>filespec)  in  the  RETRIEVE  command  is
   referred  to as the "file group descriptor".  This is because the file
   group descriptor can be one file specification  or  a  group  of  file
   specifications with or without the use of wildcard characters.

   When DUMPER retrieves file(s), retrieval requests in the request queue
   can be requeued for one of two reasons:

        1.  The   request    does    not    fall    within    the    path
            (str:<directory>filespec)  specified  by  you  in  the DUMPER
            RETRIEVE command.

        2.  The request called for a tape that had data errors on  it  or
            could not be mounted.

   Requests that are requeued have their time stamp zeroed out,  so  that
   DUMPER  reconsiders  the  request during the same retrieval operation.
   When all requests have been retrieved and there are no new requests to
   be  considered,  the  system informs DUMPER that the request queue has
   been exhausted.

                                  WARNING

           If there are no files in the retrieval queue  and  you
           give  the RETRIEVE command to DUMPER, DUMPER waits for
           approximately  5  minutes.   DUMPER  then  aborts  the
           RETRIEVAL request and sends the message:

                ?Assuming no requests in the retrieval queue.

           Before running DUMPER to retrieve  files,  you  should
           give the SHOW QUEUES RETRIEVAL-REQUESTS/ALL command to
           OPR to see if any retrievals have been requested.  The
           /ALL   switch  allows  you  to  see  the  entire  file
           specification.



                                    7-37

                         UNSCHEDULED SOFTWARE TASKS


   If you are unable to locate the requested  tape  volume  or  the  tape
   volume is bad, perform the following steps:

        1.  Type CTRL/C twice and type POP to return to OPR.

        2.  Type CANCEL MOUNT-REQUEST nn (where nn is the  mount  request
            number).

        3.  Type PUSH and then type CONTINUE to return to DUMPER.

        4.  DUMPER displays the following message:

            ?Cannot mount tape, Mount refused by operator
            Try again?

        5.  Type NO, and DUMPER replies with:

            Should I ask about this tape anymore during this run?

            If you answer no, other requests for the  tape  are  ignored.
            If  you  answer  yes,  additional  requests  for the tape are
            processed.

        6.  DUMPER then requests the next retrieval tape to be mounted.

        7.  You can then follow Steps 5 through 12 on the previous pages.




























                                    7-38

                         UNSCHEDULED SOFTWARE TASKS


                            ----- Examples -----

        1.  Run DUMPER to retrieve the file SCHEDULE.TXT.34 as  requested
            by your system manager.

            OPR>SHOW QUEUES RETRIEVAL-REQUESTS/ALL<RET>
            OPR>
            13:20:30            -- System Queues Listing --

            Retrieval Queue:
             Name   Req#    Tape 1  Tape 2  User
            -----   ----    ------  ------  ---------------------
            SCHEDU   27     400030  400040  MANAGER
            FILE:KL2102:<MANAGER>SCHEDULE.TXT.34
            There is 1 job in the Queue (None in Progress)

            OPR>PUSH<RET>

             TOPS-20 Command processor 7(31)
            @ENABLE<RET>
            $DUMPER<RET>
            DUMPER>RETRIEVE PS:<MANAGER>SCHEDULE.TXT.34<RET>
            [Mounting tape volume 400040]

            13:22:00          --Tape Mount Request # 79--
                            Mount volume 400040, 9-TRACK, 1600 BPI, READ-ONLY
                            User OPERATOR, Job 6, Terminal 1
                            User's remark: RETRIEVAL TAPE


























                                    7-39

                         UNSCHEDULED SOFTWARE TASKS


            Now physically locate tape volume 400040, mount the tape, and
            ready it on an available tape drive.

            13:25:00      --MTA1: Unlabeled tape mounted--

            <CTRL/C><CTRL/C>
            $POP<RET>
            OPR>IDENTIFY MTA1: REQUEST-ID 79<RET>
            OPR>
            13:26:34      --MTA1: Given to Request 79--
                        Volume 400040 now in use by
                        User OPERATOR, Job 6, Terminal 1
            OPR>PUSH<RET>
            $CONTINUE<RET>
            [Volume 400040 mounted]


            PS:<MANAGER>SCHEDULE.TXT.34;P777700;A341 (TO)
            PS:<MANAGER>SCHEDULE.TXT.34  [OK]


            12:40:54      --Tape Drive Released By User--
                        MTA1: Volume 400040 Being unloaded
            DUMPER>EXIT<RET>
            $POP<RET>
            OPR>




























                                    7-40

                         UNSCHEDULED SOFTWARE TASKS


        2.  Run DUMPER to retrieve all requests in the  retrieval  queue.
            In   addition,   two  tape  volumes  are  requested  for  the
            retrievals.

            OPR>PUSH<RET>

             TOPS-20 Command processor 7(31)
            @ENABLE<RET>
            $DUMPER<RET>
            DUMPER>RETRIEVE PS:<*>*.*.*<RET>
            [Mounting tape volume 23401]


            16:30:04   --Tape Mount Request # 97--
               Mount volume 23401, 9-TRACK, 1600 BPI, READ-ONLY
               User OPERATOR, Job 6, Terminal 1


            16:31:12   --MTA0: Unlabeled tape mounted--

            <CTRL/C><CTRL/C>
            $POP<RET>
            OPR>IDENTIFY MTA0: REQUEST-ID 97<RET>
            OPR>
            16:33:30   --MTA0: Given To Request 97--
               Volume 23401 now in use by
               User OPERATOR, Job 6, Terminal 1
            OPR>PUSH<RET>
            $CONTINUE<RET>
            [Volume 23401 mounted]




   PS:<SARTINI>CHAP01.RNO.1;P777700;A341 (TO) PS:<SARTINI>CHAP01.RNO.1 [OK]
   PS:<BROWN>YEARLY.CBL.3;P777700;A341 (TO) PS:<BROWN>YEARLY.CBL.3  [OK]
   PS:<HOVSEPIAN>OPR.TXT.5;P777700;A341 (TO) PS:<HOVSEPIAN>OPR.TXT.5  [OK]
   PS:<HURLEY>DECSPC.MEM.4;P777700;A341 (TO) PS:<HURLEY>DECSPC.MEM.4 [OK]
                        .
                        .
                        .
   PS:<TEEGARDEN>FORTRA.EXE.1;P777700;A341(TO)PS:<TEEGARDEN>FORTRA.EXE.1 [OK]


            16:45:00      --Tape Drive Released By User--
                        MTA0: Volume 23401 Being unloaded

            16:45:03      -- Tape Mount Request # 98--
                        Mount volume 23402, 9-TRACK, 1600 BPI, READ-ONLY
                        User OPERATOR, Job 6, Terminal 1
                        User's remark: RETRIEVAL TAPE



                                    7-41

                         UNSCHEDULED SOFTWARE TASKS


            16:47:32      --MTA0: Unlabeled tape mounted--
            <CTRL/C><CTRL/C>
            $POP<RET>
            OPR>IDENTIFY MTA0: REQUEST-ID 98<RET>
            OPR>
            16:49:09      --MTA0: Given To Request 98--
                        Volume 23402 now in use by
                        User OPERATOR, Job 6, Terminal 1
            OPR>PUSH<RET>
            $CONTINUE<RET>
            [Volume 23402 mounted]
   PS:<J.JONES>SAMPLE.MEM.2;P777700;A341(TO)PS:<J.JONES>SAMPLE.MEM.2 [OK]
             .
             .
   PS:<ANDERSON>EXAM01.TST.5;P777700;A341(TO)PS:<ANDERSON>EXAM01.TST.5 [OK]

            16:57:45          --Tape Drive Released By User--
                            MTA0: Volume 23402 Being unloaded
            DUMPER>EXIT<RET>
            $POP<RET>
            OPR>

































                                    7-42

                         UNSCHEDULED SOFTWARE TASKS


   7.10  RESTORING DISK FILES WITH DUMPER

   If a user requests that you restore some files for him from a magnetic
   tape, be sure to find out:

        1.  What magnetic tape(s) to use.  You might have to use  a  tape
            containing a complete SAVE and some tapes from an INCREMENTAL
            SAVE.  You or the  user  should  look  through  the  terminal
            output kept for each DUMPER SAVE and determine which tapes to
            use.

        2.  What files to restore and what directory they are in.

        3.  What directory to put them into.

        4.  What special DUMPER status commands to use, if any.  (See the
            TOPS-20  User  Utilities  Guide  for details on DUMPER status
            commands.)

        5.  What version of DUMPER is being used.  Dumper may not restore
            passwords correctly if you use an incorrect version of DUMPER
            (see  the  TOPS-20  User  Utilities  Manual  for  details  on
            password encryption.)

                                    NOTE

           DUMPER does not work on a 7-track magnetic tape  drive
           (TU71).

   Then do the following:

        1.  Type PUSH to OPR.

        2.  Type ENABLE.

        3.  Type MOUNT TAPE setname:  with the /LABEL TYPE:  switch,  the
            /VOLIDS:   switch,  and the /NOWAIT switch.  The default mode
            is READ-ONLY.

        4.  If you are connected to another  structure,  CONNECT  to  the
            structure for the restore.

        5.  When MOUNTR replies with  the  Tape  Mount  Request  and  the
            acknowledgement  of  the  unlabeled tape being mounted, press
            <RET> and type POP to return to OPR.

        6.  If the label type is unlabeled, give the IDENTIFY command  to
            OPR to identify the tape drive to the mount request.

        7.  If the desired structure is not mounted for the restore, type
            PUSH to OPR, then give the command MOUNT STRUCTURE str:.



                                    7-43

                         UNSCHEDULED SOFTWARE TASKS


        8.  When the system replies with  Tape  Drive  Given  To  Request
            number  (and  the structure is mounted), and after the system
            has displayed the message that defines the tape drive for the
            setname:, type DUMPER.

        9.  Type the following DUMPER commands.

            TAPE MTn:<RET>
            RESTORE str:<directory>filespec<RET>

            (See argument types for  filespecs  below  or  refer  to  the
            RESTORE command in the TOPS-20 User Utilities Guide.)

       10.  When DUMPER prompts again, type EXIT.

       11.  Type DISMOUNT TAPE MTn:.

       12.  Type DISABLE.

       13.  Type POP to return to OPR.

       14.  Remove the magnetic tape from the drive.

   Argument types for RESTORE:

        1.  To restore an entire user area, for example, to copy all  the
            files  of directory PS:<DIR> on tape to directory PS:<DIR> on
            disk:

            RESTORE PS:<DIR><RET>

        2.  To restore certain files on directory  PS:<DIR>  on  tape  to
            directory PS:<DIR> on disk:

            RESTORE PS:<DIR>file1,PS:<DIR>file2,...<RET>

        3.  To restore PS:<A>A.MAC to PS:<SOURCE>A.MAS and PS:<B>X.MAC to
            PS:<SOURCE>X.MAS:<RET>

            RESTORE <A>A.MAC <SOURCE>A.MAS,<B>X.MAC <SOURCE>X.MAS<RET>

        4.  To copy all files from PS:<SOURCES> on tape to  OLD:<SOURCES>
            on disk:

            (Be sure to MOUNT STRUCTURE OLD:  before you run DUMPER,  and
            DISMOUNT STRUCTURE OLD:  after you run DUMPER.)

            RESTORE PS:<SOURCES> OLD:<SOURCES><RET>






                                    7-44

                         UNSCHEDULED SOFTWARE TASKS


   In addition, you can specify either of two  optional  switches  before
   the file group descriptor.  These switches are as follows:

        1.  /NOTAPE-INFORMATION - specifies that no archive or  migration
            tape  information  is restored with the file(s).  This switch
            can be used when a  user  wishes  to  transfer  a  file  from
            another  system  to  his  disk  area  on  your  system.   The
            /NOTAPE-INFORMATION switch avoids bringing  tape  information
            from another system.

        2.  /TAPE-INFORMATION  -  specifies  that  tape  information   is
            restored  with  the  file(s).  This switch can be used when a
            user wishes to restore a file that was migrated  or  archived
            and  then  inadvertently  deleted  and expunged from his disk
            area.

   If you do not specify either switch, /TAPE-INFORMATION is the default.
   (For  more  information on DUMPER, refer to the TOPS-20 User Utilities
   Guide.)

                              ----- Hint -----

   If the user's files on the DUMPER tape(s) have  accounts  not  in  the
   installed ACCOUNTS-TABLE.BIN file, do the following:

        1.  Log in as the user who requested  the  file  restoration  and
            specif a valid account for that user.

        2.  Follow Steps 3 through 9 in the procedure above, and type the
            DUMPER command:

                 ACCOUNT SYSTEM-DEFAULT<RET>

            before the RESTORE command to DUMPER.

        3.  Type LOGOUT.


















                                    7-45

                         UNSCHEDULED SOFTWARE TASKS


                            ----- Example -----

   A user has requested a restore of all his files on structure MISC:.

        OPR>PUSH<RET>
         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $MOUNT STRUCTURE MISC:<RET>

        18:13:12          --STRUCTURE MOUNTED--
                        Structure MISC mounted            

        $MOU TAPE DUMP09: /LABEL-TYPE:UNLABELED/VOLIDS:DUMP09/NOWAIT<RET>

        18:15:01          --Tape Mount Request # 115--
                        Mount Unlabeled volume DUMP09, READ-ONLY
                        User OPERATOR, Job 6, Terminal 1

        18:16:56          --MTA3: Unlabeled tape mounted--
        <RET>
        $POP<RET>
        OPR>IDENTIFY MTA3: REQUEST-ID 115<RET>
        OPR>
        18:19:20          --MTA3: Given To Request 115--
                        Volume DUMP09 now in use by
                        User OPERATOR, Job 6, Terminal 1
        OPR>PUSH<RET>
        [Tape set DUMP09, volume DUMP09 mounted]
        [DUMP09: defined as MT1:]
        $DUMPER<RET>
        DUMPER>TAPE MT1:<RET>
        DUMPER>RESTORE MISC:<SARTINI>*.*.*<RET>

        DUMPER tape # 1  Volid DUMP09, , Saturday, 14-Apr-79 1206
        MISC:<SARTINI>

        End of saveset
        DUMPER>EXIT<RET>
        $DISMOUNT TAPE MT1:<RET>
        [Tape dismounted]

        18:27:34          --Tape Drive Released By User--
                        MTA3: Volume DUMP09 Being unloaded
        $POP<RET>
        OPR>









                                    7-46

                         UNSCHEDULED SOFTWARE TASKS


   7.11  ANSWERING STRUCTURE MOUNT REQUESTS WITH OPR

   When a user issues a request to mount or dismount a structure with the
   TOPS-20  MOUNT  or  DISMOUNT command, ORION passes a message to OPR to
   inform you of  the  request.   You  can  then  respond  by  physically
   mounting  or dismounting the structure.  When the system receives this
   request, it has OPR  print  the  following  message  on  the  terminal
   running OPR:

        OPR>
        hh:mm:ss          --Structure Mount Request #nn--
        Mount str: (alias ptr:)
        User username, job nn, Terminal nn

                                   FREE DRIVES

        DISK DRIVE INFORMATION                    DISK PACK INFORMATION
              Chan-Cont   Disk     Mount                        Usage
         Type   Drive    Status    Status   Count Name         Options
         ---- --------- --------   ------   ----- ------------ --------

        (List of available drives)

   where:

        hh:mm:ss         specifies the time  the  operator  received  the
                         message.

        Request#nn       specifies the request  number  assigned  to  the
                         mount request.

        Mount str:       specifies the physical name of the structure.

        User username    specifies the name of the user  who  issued  the
                         MOUNT request.

        Job nn,          specifies the job number the user  was  assigned
                         when he logged onto the system.

        Terminal nn      specifies the line number of the  terminal  from
                         which the user issued the MOUNT request.

        FREE DRIVES      specifies the disk drives that are available.

   The list of available disk drives contains those drives that meet  one
   of the following conditions:

        1.  The drive is off-line.

        2.  The drive has a nonrecognizable structure on it.




                                    7-47

                         UNSCHEDULED SOFTWARE TASKS


        3.  The drive is on-line, it has a recognizable structure on  it,
            no  user  has MOUNTed it, no user has CONNECTed to it, and no
            user has a file open on it.

   The list also provides the following information:

        1.  The type of drive (RP04, RP06, RP07, RP20, RA60, or RA81).

        2.  The channel number of the drive.

        3.  The controller number of the drive.

        4.  The physical unit number of the drive.

        5.  The state of the drive (available/unavailable).

        6.  The mount status of the drive.

        7.  The mount count.

        8.  The structure name on the drive.

        9.  The attributes of the structure.

   You reply to a MOUNT request by doing the following:

        1.  Mount all the packs of the structure requested on any of  the
            available   drives  in  the  list.   MOUNTR  then  makes  the
            structure known to the system  and  cancels  the  outstanding
            message.

            Once the structure is known  by  the  system,  OPR  prints  a
            message similar to:

            OPR>
            hh:mm:ss          --STRUCTURE MOUNTED--
                            Structure str: (Alias:name) mounted
            OPR>

            But if the request was for a structure to  be  mounted  on  a
            remote CFS-20 node, OPR prints the following:

            12:01:10     Received Message From (remote system name)::
            11:59:00     -- Mount request by operator completed --
                  Structure (structure name): mounted as alias (alias name):


            OPR  prints  the  preceding  messages  only  after  you  have
            physically mounted all the packs in the structure.





                                    7-48

                         UNSCHEDULED SOFTWARE TASKS


                             ----- Hints -----

   OPR continues to handle other requests from other users, if you do not
   respond  to  a  MOUNT  request with some action.  For example, if five
   separate users request five different structure  MOUNTs  at  the  same
   time, you can respond individually to each request in any order.

   Sometimes you see a message similar to:

        OPR>
        13:02:15          --STRUCTURE MOUNTED--
                        Structure PS: (Alias:DIAG) mounted
        OPR>

   without seeing a MOUNT request.  This happens when a user does a MOUNT
   for  a  structure  that  the  system  found  on-line.  This is just an
   informational message for you; it requires no action.
                            ----- Examples -----

        1.  In this example, a user wanted to MOUNT a structure  that  is
            unavailable.   When  this  message  appears  on your console,
            CANCEL the MOUNT-REQUEST and give a reason.

            13:35:55          --MOUNT PROBLEM--
                            Problem with structure ASDF: structure is set 
                            unavailable
                            User Konen, Job 32, Terminal 11

            13:36:01          --Structure Mount Request # 12--
                            Mount ASDF: (alias ASDF:)
                            User Konen, Job 32, Terminal 11

                                            FREE DRIVES

            DISK DRIVE INFORMATION                   DISK PACK INFORMATION
                  Chan-Cont   Disk    Mount    Mount               Usage
            Type    Drive    Status   Status   Count Name         Options
            ----  --------- --------  ------   ----- ------------ --------
            *RP06 0,  ,1    Avail     Offline
            *RP07 1,  ,0    Avail     Free           FIAT   (1/1)
             RP06 7,01,1    Avail     Free           CHIP   (1/1)
             RA60 7,07,254  Avail     Free
             RA81 7,08,18   Avail     Free           DRV18  (1/1)

            OPR>CANCEL MOUNT-REQUEST 12/REASON:ASDF IS UNAVAILABLE<RET>
            OPR>
            13:40:00          --Mount Request 12 Canceled--
            OPR>






                                    7-49

                         UNSCHEDULED SOFTWARE TASKS


        2.  In this example, a user has requested  that  structure  JACK:
            be MOUNTed.

            OPR>
            12:40:15          --Structure Mount Request # 4--
            Mount JACK: (alias JACK:)
            User KOVALCIN, Job 2, Terminal 1

                                            FREE DRIVES

            DISK DRIVE INFORMATION                   DISK PACK INFORMATION
                  Chan-Cont   Disk    Mount    Mount               Usage
            Type    Drive    Status   Status   Count Name         Options
            ----  --------- --------  ------   ----- ------------ ---------
            *RP06 0,  ,1    Avail     Offline
            *RP07 1,  ,0    Avail     Free           FIAT   (1/1)
             RP06 7,01,1    Avail     Free           CHIP   (1/1)
             RA60 7,07,254  Avail     Free
             RA81 7,08,18   Avail     Free           DRV18  (1/1)

            OPR>

            You can now physically  mount  JACK:   and  make  the  system
            recognize  the  structure  as  being  on-line.   Request 4 is
            completed automatically and the user will be notified.

            OPR>
            12:43:33          --STRUCTURE MOUNTED--
                            Structure JACK: (Alias:JACK) mounted
            OPR>



   7.11.1  Mounting a Structure with MOUNT

   If you need to mount a structure, other than the structures  that  are
   normally  mounted  at  system  start-up, you can give either the MOUNT
   command at TOPS-20 command level or give  the  MOUNT  command  at  OPR
   command  level.   For  example, to mount a structure called SNARK, you
   would give the following command:

        @MOUNT STRUCTURE SNARK:<RET>

   In a CFS-20 cluster that has cluster GALAXY enabled, you can  mount  a
   structure  on  a system by issuing the MOUNT command from any terminal
   in the cluster.  You do not have to use a terminal on the system where
   the  structure is to be mounted.  For example, you can issue a command
   from node SYSA::  that will cause a structure to be  mounted  on  node
   SYSB::.  To do this, you would give the following command from SYSA:

   OPR>MOUNT STRUCTURE DATA:/CLUSTER-NODE:SYSB::<RET>



                                    7-50

                         UNSCHEDULED SOFTWARE TASKS


   If the structure you want to mount has the same  physical  name  as  a
   structure  that  is already mounted, you must assign an alias name for
   the structure you want to mount.  The alias name is placed  after  the
   word STRUCTURE followed by the /STRUCTURE-ID switch and actual name of
   the structure.  You must have WHEEL or OPERATOR privileges enabled  to
   perform  this  task.   For  example,  to specify an alias name for the
   structure SNARK:  you would give the following command:

        $MOUNT STRUCTURE CHECK:  /STRUCTURE-ID SNARK:<RET>

   In the above command you have mounted a structure  with  the  physical
   name  SNARK:  and the alias name CHECK:.  Any user wishing to use this
   structure has to refer to it by the structure name CHECK:.

   If a disk drive containing a structure, other than BS:  or PS:, starts
   to  have hardware problems, you can remove the structure from the disk
   drive.  You must move the structure to an available drive of the  same
   type  but you do not have to give a DISMOUNT command.  If there are no
   available disk drives, and the structure you are moving  is  necessary
   for  normal  system  operation, you must first DISMOUNT a structure on
   another disk drive of the same  type  and  then  MOUNT  the  necessary
   structure on that drive.

                                    NOTE

           When you assign an alias  name  to  a  structure,  the
           physical  name  of  the structure (which is written in
           the home blocks of the  structure)  does  not  change.
           Refer  to  the TOPS-20 System Manager's Guide for more
           information on alias names.

                            ----- Example -----

   A user from another installation wants to mount his  public  structure
   on  your  system.  Because you already have a public structure on your
   system, you must assign his structure an alias.

        OPR>PUSH<RET>
         TOPS-20 Command Processor 7(31)
        @ENABLE<RET>
        $MOUNT STRUCTURE CHECK: /STRUCTURE-ID:PS:<RET>
        [Mount Request CHECK: QUEUED, Request-id 57]

   The terminal running OPR displays the following message:










                                    7-51

                         UNSCHEDULED SOFTWARE TASKS


        10:11:40       --Structure Mount Request # 57--
                        Mount PS: (alias CHECK:)
                        User OPERATOR, Job 6, Terminal 1

                                FREE DRIVES

        DISK DRIVE INFORMATION                    DISK PACK INFORMATION
              Chan-Cont    Disk    Mount    Mount               Usage
         Type   Drive    Status    Status   Count Name         Options
         ---- --------- --------   -------  ----- ------------ --------
         *RP06 0,  ,1   Avail      Offline
         *RP07 1,  ,1   Avail      Free           FIAT   (1/1)
          RP06 7,01,1   Avail      Free           CHIP   (1/1)
          RA60 7,07,254 Avail      Offline
          RA81 7,08,18  Avail      Free           DRV18  (1/1)

   Whether you mount the structure before or  after  the  MOUNT  command,
   when  the  system recognizes the structure as mounted and on-line, the
   following message appears on your terminal:

        Structure CHECK: mounted

   On the terminal running OPR, the following message is displayed.

        10:12:35          --STRUCTURE MOUNTED--
                        Structure PS: (Alias:CHECK) mounted

                                  WARNING

           If the system goes down  while  a  structure  with  an
           alias  name  is mounted, you should put the disk drive
           that the structure with  the  alias  name  is  mounted
           off-line  prior  to restarting the system.  The reason
           for this is that when the  system  is  restarted,  the
           monitor  looks  at  the physical name of the structure
           rather than the  alias  name  and  reports  errors  of
           duplicate  structures  mounted.   After the system has
           restarted, bring the disk drive back on-line and mount
           the structure again with an alias name.

                         ----- Error Message -----

        OPR>
        10:30:11          --MOUNT PROBLEM--
                        Problem with structure : Invalid structure name
                        User OPERATOR, Job 6, Terminal 1
        OPR>

   You have specified a structure name that is invalid and/or the  system
   cannot recognize the name specified.  You might have typed one or more
   non-alphanumeric  characters  in  the  name,  the  name  exceeds   six
   alphanumeric  characters,  or  the  structure  name  has the name of a


                                    7-52

                         UNSCHEDULED SOFTWARE TASKS


   system logical name.   Issue  the  MOUNT  command  again,  specifyinga
   structure name that is valid and/or can be recognized by the system.



   7.11.2  Answering Structure DISMOUNT Requests with OPR

   When a user gives  a  valid  DISMOUNT  STRUCTURE  str:   command,  OPR
   prints:

   OPR>
   hh:mm:ss     --STRUCTURE DISMOUNTED--
              Structure PH4 dismounted

               --DISMOUNT STRUCTURE--
              Remove PH4:
              User HOVSEPIAN, Job 21, Terminal 25

                                MOUNTED DRIVES

            DISK DRIVE INFORMATION                DISK PACK INFORMATION
                    Chan-Cont   Disk    Mount    Mount              Usage
             Type     Drive    Status   Status   Count Name         Options
             ----     ---------         -------- ------             ----- 
             RP06 0,  ,3       Avail    Free     1     PH4    (1/1)

   The status display prints the following:

        1.  The type of disk.  An asterisk (*) to the left  of  the  disk
            drive type indicates a disk drive has an external port.

        2.  The channel, controller, and drive number.

        3.  The state of the disk drive (available/unavailable).

        4.  The mount status of the disk drive.

        5.  The count of the number of users who requested a mount of the
            structure.

        6.  The name of the structure.

        7.  The attributes of the structure.

   You must answer a DISMOUNT request by doing one of the following:

        1.  If the following DISMOUNT message appears at your console,  a
            user  has issued a DISMOUNT STRUCTURE str: command.  However,
            other users are still using the structure.





                                    7-53

                         UNSCHEDULED SOFTWARE TASKS


            OPR>
            16:52:13 <19>    --DISMOUNT QUERY--
                            Removal of structure AHPA: (Alias AHPA:)
                            requested.
                            Other jobs are currently using it. Should
                            removal request be processed (YES or NO)?
                            User KONEN, Job 39, Terminal 11

            OPR>

            If you are to honor the DISMOUNT in  this  case,  you  should
            SEND a message to all other users that the structure is being
            dismounted.  Otherwise, answer the DISMOUNT  QUERY  with  NO.
            If you say "NO", the DISMOUNT request is deleted.

            Once all users have DISMOUNTed the structure,  you  can  then
            complete  the DISMOUNT by removing all packs of the structure
            from their drives after seeing the following message:

            OPR>
            14:36:06          -- STRUCTURE DISMOUNTED --
                            Structure AP20 dismounted
            OPR>
            14:36:07          -- DISMOUNTED STRUCTURE --
            Remove AP20: (alias AP20:)
            User OPERATOR, Job 2, Terminal 233

            DISK DRIVE INFORMATION                   DISK PACK INFORMATION
                  Chan-Cont   Disk    Mount    Mount               Usage
             Type   Drive    Status   Status   Count Name         Options
            ----  --------- --------  ------   ----- ------------ --------
            *RP06 0,  ,1    Avail     Mounted

        2.  If there is a list of free drives and  the  structure  to  be
            removed  appears  in  the  list,  remove  all  packs  in  the
            structure from their drives.

        3.  Do not do anything if you see the message:

            OPR>
            hh:mm:ss        --Message n ABORTED--
            OPR>
            hh:mm:ss          --STRUCTURE DISMOUNT ABORTED--
                              User name, Job number, Terminal number
            OPR>

            In this case, the user has canceled his own request.

        4.  If you need to MOUNT a structure that has been DISMOUNTed but
            not  removed  from  the drive, use the MOUNT command in OPR>.
            Type:



                                    7-54

                         UNSCHEDULED SOFTWARE TASKS


            OPR>MOUNT STRUCTURE alias /Structure-Id:xx<RET>

            OPR>MOUNT STRUCTURE AP20:/Structure-Id:AP20:<RET>

            OPR>

            11:50:16            -- Mount request by operator completed --
                              Structure AP20: mounted as alias AP20

   Responding to Canceled Dismount Requests

   If a user issues a CANCEL command for a pending dismount request,  you
   receive a message similar to the following:

   12:01:00 -- Message n canceled

   where n is the message number associated with the dismount.

   In a CFS-20  configuration,  if  the  original  request  was  for  the
   structure  to  be  dismounted  with  REMOVAL, it may already have been
   dismounted from remote systems in the  cluster  with  NO-REMOVAL  (see
   Section  7.11.3).   If  the  dismount  has  proceeded beyond a certain
   point, you are informed of any  structure  status  changes  on  remote
   nodes, in a message such as:

   12:01:00     -- Dismount Status --
        Dismount request has been canceled.
        However, structure FOO: has  been dismounted from
        nodes SYSA::, SYSB::
        Please mount structure FOO: on the above systems.

   Otherwise, you receive a message such as:

   12:01:00       -- Message 1 canceled --
        Dismount request  canceled by user ROSSELL




   7.11.3  Removing a Structure with DISMOUNT

   If you need to remove a structure from the  system  (perhaps  to  have
   maintenance done on a drive, to run CHECKD on a structure, or to mount
   another structure), perform the  following  procedures  in  the  order
   given below:

        1.  Whenever OPR outputs a list of packs for  removal,  check  if
            the  structure  you want to remove is in the list.  If it is,
            you can remove all the packs  in  the  structure  before  you
            respond  to  the  current  OPR  request.  If it is not in the
            list, go to Step 2.



                                    7-55

                         UNSCHEDULED SOFTWARE TASKS


        2.  If the structure does not appear in the  available  list,  do
            the following with OPR commands:

            a.  Type a SET STRUCTURE str: UNAVAILABLE, so  that  no  user
                can MOUNT the structure and no batch or print request can
                be scheduled for that structure.

            b.  If you intend to run CHECKD on the structure,  also  type
                SET STRUCTURE str: IGNORED.

            c.  Type a SEND ALL message to notify all users  to  DISMOUNT
                the structure by a certain time.

            d.  If you want to remove the  structure  from  the  drive(s)
                after the time is up, type DISMOUNT STRUCTURE str: (with)
                REMOVAL.  However, to run CHECKD on the structure, follow
                Step 3, a.  through d.  and then type CHECKD.

            e.  If OPR outputs the structure name in the  list  of  packs
                available  for  removal,  immediately set one pack of the
                structure off-line.  Otherwise, go to Step 3.

            f.  Remove the packs of the structure  from  the  drives  you
                need.

        3.  If the structure  does  not  appear  in  the  list  (item  1.
            above), you can forcibly dismount the structure by taking the
            following steps.

            a.  Type SHOW STATUS STRUCTURE str name:.

            b.  Type SEND ALL to give those users of the structure a last
                warning to DISMOUNT the structure.

            c.  Type SET STRUCTURE str: UNAVAILABLE.

            d.  Type DISMOUNT STRUCTURE str: (with) REMOVAL.

            e.  Because the structure now appears in the  OPR  output  of
                packs  available  for  removal,  remove  the packs of the
                structure from the drives you need.

   When you want OPR to mount a structure that has been set IGNORED,  set
   the structure to be ACKNOWLEDGED.

                            ----- Example -----

   For example, if you want to remove a structure XYZ from the system  by
   4  P.M.,  and  there are currently users of the structure, declare the
   structure UNAVAILABLE about ten minutes before 4 P.M.  Then warn users
   to DISMOUNT XYZ.



                                    7-56

                         UNSCHEDULED SOFTWARE TASKS


        OPR>SET STRUCTURE XYZ: UNAVAILABLE<RET>
        OPR>
        15:48:03          --STRUCTURE STATUS SET--
                        XYZ: set UNAVAILABLE for use by system

        OPR>SEND ALL FINISH USING XYZ AND DISMOUNT IT IN 10 MIN.<RET>
        OPR>
        15:48:15
   From Operator Terminal 1: FINISH USING XYZ AND DISMOUNT IT IN 10 MIN.
        OPR>

   At 4 P.M.,  type the DISMOUNT command.

        OPR>DISMOUNT STRUCTURE XYZ:<ESC> (with)REMOVAL<RET>
        16:00:34          --STRUCTURE DISMOUNTED--
                          Structure XYZ: dismounted

        OPR>

   CFS-20 Configurations

   In a CFS-20 configuration, structures can be set EXCLUSIVE for use  by
   one  system  or  SHARED for use by all systems.  You do this by typing
   the following OPR> commands:

        SET STRUCTURE str name: EXCLUSIVE<RET>

             or

        SET STRUCTURE str name: SHARED<RET>

   If you then need to dismount and remove  a  structure  from  a  CFS-20
   configuration, perform the following steps in the order given below:

        1.  If the structure is set  EXCLUSIVE,  perform  steps  1  to  3
            listed  above  and add REMOVAL to the DISMOUNT STRUCTURE str:
            command.

        2.  If the structure is set SHARED, perform the following steps:

            a.  Type the SEND ALL /CLUSTER-NODE:* command to  notify  all
                users  on  all  nodes  in  the  cluster  to  DISMOUNT the
                structure by a certain time.

            b.  Type DISMOUNT STRUCTURE  str:   (with)  REMOVAL  on  your
                system.

            c.  Remove the structure from the system.


   Refer to Example 3 for details on the Step 2 procedure.



                                    7-57

                         UNSCHEDULED SOFTWARE TASKS


                                    NOTE

           If the optional argument,  REMOVAL  or  NOREMOVAL,  is
           omitted,  the  structure  will default to removal on a
           non-CFS-20 system and non-removal on a CFS-20 system.


   Step 2 above ensures that the structure is set for  exclusive  use  by
   one  system  before  it  can be removed.  If there are problems during
   this automatic procedure, you may receive any  one  of  the  following
   messages:

        1.  
            12:01:00        -- Dismount error --                                    
                    Unable to lock structure FOO: for dismount.                     
                    Structure FOO: is locked by node GIDNEY:
                    Dismount request failed.

            This error occurs if MOUNTR  cannot  obtain  a  lock  on  the
            structure  through  the  ENQ% monitor call.  (See your system
            programmer or manager for details.)

        2.  
            12:00:00  <4>            -- DISMOUNT QUERY --
                Unable to set structure FOO: EXCLUSIVE
                The following nodes are inaccessible to this system:
                CLOYD::, GIDNEY::
                Dismount structure with NO-REMOVAL from the above nodes.
                If successful, respond PROCEED
                If not successful, respond ABORT

            This message indicates that the structure is mounted  on  the
            indicated  nodes, but the nodes are not accessible to cluster
            GALAXY or do not have  the  cluster  GALAXY  option  enabled.
            Therefore,   the   DISMOUNT  (with)  REMOVAL  command  cannot
            automatically dismount the structure remotely.  So  you  must
            log  into  the  nodes  indicated  and  dismount the structure
            yourself with NO-REMOVAL.

        3.  
             12:01:00  <4>            -- DISMOUNT QUERY --
                  Unable to set structure FOO: EXCLUSIVE 
                  due to (monitor error text)
                  Dismount request failed. Please correct the problem.
                  If successful, respond PROCEED
                  IF not successful, respond ABORT

            This message indicates that there  was  a  monitor  error  in
            setting  the  structure  exclusive.   You are notified of the
            error and given a chance to correct it so  that  the  process
            can continue.



                                    7-58

                         UNSCHEDULED SOFTWARE TASKS


        4.  
            12:01:00  <4>         -- Dismount QUERY --
                          AP20: dismounted from SYSA::, SYSB::
                          AP20: failed to be dismounted from SYSC::
                          error - (monitor error text)
                          Correct the problem indicated on SYSC::
                          If successful, respond PROCEED
                          If not successful, respond ABORT

            This message indicates that the structure was not  dismounted
            successfully  from  a remote system.  You are notified of the
            error and given a chance to correct it so  that  the  process
            can continue.


                            ----- Examples -----

        1.  Give the DISMOUNT STRUCTURE AP20:  (with) NO-REMOVAL command.

            OPR>DISMOUNT STR AP20:<ESC> (with) NO-REMOVAL<RET>
            OPR>

            11:49:35  <2>   -- DISMOUNT QUERY --
               Dismount of structure AP20: (Alias AP20:) requested.
               Other jobs are currently using it. Should
               dismount request be processed (Yes or No)?
               User WONG, Job 37, Terminal 10
            OPR>RES 2 YES<RET>

            OPR>[Structure AP20 has been dismounted]

            11:49:41   -- STRUCTURE DISMOUNTED --
               Structure AP20 dismounted

            11:49:41   -- DISMOUNT STRUCTURE --
            Do not remove AP20: (alias AP20:)
            Structure is set unavailable for mounting
            User WONG, Job 37, Terminal 10
            DISK DRIVE INFORMATION                  DISK PACK INFORMATION
                  Chan-Cont   Disk    Mount   Mount              Usage
             Type   Drive    Status  Status   Count Name         Options
             ---- --------- -------- ------   ----- ------------ --------
            *RP06 0,  ,4    Avail    Free           AP20   (1/1)

            Structure cannot be mounted unless MOUNTed via OPR









                                    7-59

                         UNSCHEDULED SOFTWARE TASKS


        2.  Give the DISMOUNT STRUCTURE AP20: (with) REMOVAL command.

            OPR>DISMOUNT STRUCTURE AP20:<ESC>(with) REMOVAL<RET>
            OPR>
            11:48:30  <1>     -- DISMOUNT QUERY --
                    Dismount of structure AP20: (Alias AP20:) requested.
                    Other jobs are currently using it. Should
                    dismount request be processed (Yes or No)?
                    User WONG, Job 37, Terminal 10
            OPR>RES 1 YES<RET>
            OPR>[Structure AP20 has been dismounted]

            11:48:36          -- STRUCTURE DISMOUNTED --
                            Structure AP20 dismounted

            11:48:36          -- DISMOUNT STRUCTURE --
            Remove AP20: (alias AP20:)
            User WONG, Job 37, Terminal 10
            DISK DRIVE INFORMATION                  DISK PACK INFORMATION
                  Chan-Cont   Disk    Mount   Mount              Usage
             Type   Drive    Status  Status   Count Name         Options
             ---- --------- -------- ------   ----- ------------ --------
            *RP06 0,  ,4    Avail    Free           AP20   (1/1)

            Structure cannot be mounted again unless MOUNTed via  OPR  or
            until removed

        3.  Give the DISMOUNT STRUCTURE  AP20:   (with)  REMOVAL  command
            from a terminal on SYSZ::  in a CFS-20 cluster.

            OPR>DISMOUNT STRUCTURE AP20:<ESC> (WITH) REMOVAL<RET>























                                    7-60

                         UNSCHEDULED SOFTWARE TASKS



            12:00:00  <2>        -- DISMOUNT QUERY --

                   Dismount of structure AP20: (Alias AP20:) requested.
                   Other jobs are currently using it.  Should
                   dismount request be processed (Yes or No)?
                   User OPERATOR, Job 1, Terminal 232
            OPR>RESPOND 2 YES<RET>
            12:00:50  <3>       -- DISMOUNT QUERY --
                   Structure AP20: (Alias AP20:) is in use by:
                   SYSA::, SYSB::, SYSC::
                   and can't be removed from the cluster unless it is dismounted
                   with NO-REMOVAL from the other systems.
                   Respond with PROCEED to continue with the dismount or
                   Respond with ABORT to terminate the dismount request.
            OPR>RESPOND 3 PROCEED<RET>

            12:01:00        -- REMOTE DISMOUNT STATUS --
                            AP20: dismounted from SYSA::, SYSB::, SYSC::

            12:01:20         -- DISMOUNT STRUCTURE --
                    Remove AP20: (alias AP20:)
                    User OPERATOR, Job 2, Terminal 233
          DISK DRIVE INFORMATION                   DISK PACK INFORMATION
                Chan-Cont   Disk   Mount   Mount                Usage
           Type   Drive    Status  Status  Count   Name         Options
           ---- --------- -------- ------- -----   ------------ --------
           RP06 7,04,3    Avail    Free            GALAXY   (1/1)
          Structure cannot be mounted unless MOUNTed via OPR
            The operators on SYSA::,  SYSB::,  and  SYSC::   receive  the
            following message:


            12:01:00         -- DISMOUNT STRUCTURE --
                    Do not remove AP20: (alias AP20:)
                    AP20: (Alias AP20) being dismounted from SYSZ::

          DISK DRIVE INFORMATION                   DISK PACK INFORMATION
               Chan-Cont   Disk   Mount   Mount                Usage
          Type   Drive    Status  Status  Count   Name         Options
          ---- --------- -------- ------- -----   ------------ ---------
          RP06 7,04,3    Avail    Free            AP20   (1/1)
          Structure cannot be mounted unless MOUNTed via OPR



   7.11.4  Canceling Mount Requests

   If you are unable to satisfy a user's mount request,  you  can  delete
   the  mount  request by giving the OPR command CANCEL MOUNT REQUEST nn.
   You should give a reason why you are canceling the mount request.  You
   can do this by giving the /REASON switch with the CANCEL command.


                                    7-61

                         UNSCHEDULED SOFTWARE TASKS


   For example, you cancel a mount request because there is  not  a  free
   drive.

        OPR>CANCEL MOUNT-REQUEST nn /REASON:THERE ARE NO FREE DRIVES<RET>

   where "nn" is the request number assigned to the mount request.

                            ----- Example -----

   Cancel mount request 204.

   OPR>
   OPR>CANCEL MOUNT-REQUEST 204/REASON:There are no disk drives available
   OPR>
   11:49:15               --Mount Request 204 Canceled--



   7.11.5  Setting Disk Drives Available or Unavailable

   You can set a disk drive UNAVAILABLE for assignment by the  system  by
   giving the following OPR command:

        OPR>SET DISK-DRIVE CHANNEL n CONTROLLER n DRIVE n UNAVAILABLE<RET>

   where:

        CHANNEL n      specifies the channel number of the disk drive.

        CONTROLLER n   specifies the controller for the disk drive.

        DRIVE n        specifies the physical unit number of the drive.

   When you give this command, the system prints:

        ENTER TEXT AND TERMINATE WITH ^Z

   The system now waits for you to type a reason explaining why  you  are
   setting  the  drive  unavailable.  A reason you would set a disk drive
   unavailable is that there was a hardware problem with the disk  drive.
   It  is  also recommended that you set the structures on the disk drive
   UNAVAILABLE when you set the disk drive UNAVAILABLE.

   To set a disk drive AVAILABLE for assignment by the system,  give  the
   following command:

        OPR>SET DISK-DRIVE CHANNEL n DRIVE n AVAILABLE<RET>







                                    7-62

                         UNSCHEDULED SOFTWARE TASKS


                            ----- Examples -----

        1.  Set disk drive 4  on  channel  1  UNAVAILABLE  because  of  a
            hardware problem.

            OPR>SET DISK-DRIVE CHANNEL 1 DRIVE 4 UNAVAILABLE<RET>
            ENTER TEXT AND TERMINATE WITH ^Z
            DISK DRIVE 4 HAS A HARDWARE PROBLEM<CTRL/Z>

            OPR prints:

            OPR>
            17:30:39        --Disk Drive Set Unavailable--
                     Chan 1 Drive 4 set unavailable for mounting by MOUNTR
            OPR>

        2.  Set disk drive 4 on channel 1 AVAILABLE  after  the  hardware
            problem has been corrected.

            OPR>SET DISK DRIVE CHANNEL 1 DRIVE 4 AVAILABLE<RET>

            OPR prints:

            17:32:43        --Disk Drive Set Available--
                      Chan 1 Drive 4 set available for mounting by MOUNTR
            OPR>



   7.12  SETTING THE PORT CI AVAILABLE/UNAVAILABLE

   If your installation uses the CI for HSC50 disks or CFS, the  CI  port
   is AVAILABLE by default.  There may be times, however, when the system
   manager determines that the CI port must be set UNAVAILABLE.   Setting
   the  CI port UNAVAILABLE ends the system's use of the CI and any disks
   that use the CI.

   Most often, the CI port is set UNAVAILABLE when  there  is  a  serious
   hardware  problem  and it is necessary to run CI diagnostics.  Setting
   the CI port UNAVAILABLE is not a standard procedure and should not  be
   performed without approval from the system manager.

   To set the CI port UNAVAILABLE, perform the following steps:

        1.  Type SET PORT CI UNAVAILABLE <RET>.

        2.  Once you see the message that indicates which structures  are
            affected,  send  a system message telling users when you plan
            to set the CI  port  UNAVAILABLE  and  which  structures  are
            affected.




                                    7-63

                         UNSCHEDULED SOFTWARE TASKS


        3.  Respond  to  the  message  indicating  which  structures  are
            affected  by  typing RESPOND <RESPONSE NUMBER> and one of the
            following:

            PROCEED - The  PROCEED  response  begins  the  SET  PORT   CI
            UNAVAILABLE  procedure.  PROCEED is the standard response for
            setting the CI port UNAVAILABLE.

            FORCE - The FORCE response dismounts all structures and  sets
            the   CI   UNAVAILABLE   with  no  further  operator  action.
            Structures are dismounted whether or not they are in use.

            ABORT - The  ABORT  response  cancels   the   SET   PORT   CI
            UNAVAILABLE  procedure.   If  the  SET  PORT  CI  UNAVAILABLE
            procedure is aborted at this time, system  operation  is  not
            changed.

   Each structure and disk-drive is now handled on an  individual  basis.
   Depending on the message you see, do one of the following:

        4.  If a structure is on a dual-ported disk-drive:

            a.  You receive  a  message  indicating  that  the  drive  is
                dual-ported.   Respond to the message by setting the port
                switch to a single port following procedures listed below
                and then type one of the following:

                1.  Spin down the pack.

                2.  Set the port switch to either A or B appropriately.

                3.  Spin up the pack.

                PROCEED - The PROCEED reponse  indicates  that  the  port
                switch is set to one system and is no longer dual-ported.
                The process of setting the CI port UNAVAILABLE continues.
                You  DISMOUNT  any mounted structure by responding to the
                request for DISMOUNT.

                FORCE - The FORCE response indicates that the  status  of
                the disk drive should be ignored.  The port switch is not
                changed but the process of  setting  the  CI  UNAVAILABLE
                continues.   Use  caution  with  this  response.  CFS may
                disallow use of a dual-ported disk if the FORCE  response
                is given.  Any MOUNTed structure is DISMOUNTed.

                ABORT - The ABORT  response  terminates  the  process  of
                setting  the  CI  port UNAVAILABLE.  All previous actions
                remain, but the CI port remains AVAILABLE.

        5.  If the structure is mounted on a disk drive connected to  the
            CI:

            You have to DISMOUNT the structure.  DISMOUNT  the  structure
                                    7-64

                         UNSCHEDULED SOFTWARE TASKS


            by responding to the request for DISMOUNT.

        6.  If the structure is not connected to a drive on the CI and is
            not dual-ported:

            The structure is  set  EXCLUSIVE  to  your  system.   If  the
            structure  cannot  be  set  EXCLUSIVE  by the system, you are
            prompted for an action.  You have to DISMOUNT  the  structure
            (with) NO REMOVAL from the other systems before the structure
            is set EXCLUSIVE to your system.

        7.  When all structures mounted on CI disks are  dismounted,  all
            dual-ported disk drives set, and necessary structures are set
            EXCLUSIVE, you see a message indicating that the CI  port  is
            set UNAVAILABLE.

        8.  The CI port  remains  UNAVAILABLE  until  you  set  the  port
            AVAILABLE.

        9.  If at any point during the process, you refuse to dismount  a
            structure or handle a dual-ported disk drive, the SET PORT CI
            UNAVAILABLE procedure is aborted.  All previously  dismounted
            structures   remain   dismounted  but  the  CI  port  remains
            AVAILABLE.

                                   NOTES


           1.  At  any  point  during  the  procedure,  you   can
               dismount  all  structures  at  one  time using the
               DISMOUNT procedures in Section  7.11.3.   In  this
               case,  when  you  type  PROCEED during the CI port
               procedure, you are prompted  only  for  structures
               that have been overlooked.

           2.  At any point during the procedure, you can set all
               drives  that  are  dual-ported  to  a single port.
               When  you  type  PROCEED  during   the   CI   port
               procedure,  you  are only prompted for drives that
               have been overlooked.

           3.  If you type the SET PORT  CI  UNAVAILABLE  command
               and  your  installation  does  not  have a CI, you
               receive an error message.










                                    7-65

                         UNSCHEDULED SOFTWARE TASKS


                            ----- Examples -----

        1.  Set the PORT CI Unavailable using the Proceed response.

            OPR>SET PORT CI UNAVAILABLE <RET>
            OPR>
            12:14:48  <1>     -- Port Unavailable Procedure Notice --
            Setting CI Port 7 UNAVAILABLE

            The following structure(s) need to be dismounted or removed.

            DISK DRIVE INFORMATION                   DISK PACK INFORMATION
                  Chan-Cont   Disk    Mount    Mount              Usage
             Type   Drive    Status   Status   Count Name         Options
             ---- --------- --------  ------   ----- ------------ --------
            *RP06 0,  ,2    Avail     Mounted  1     AP20   (1/1)
             RP06 7,00,1    Avail     Mounted  1     DALE   (1/1)
             RA81 7,07,5    Avail     Mounted  1     EXODUS (1/1)
             RA60 7,07,254  Avail     Mounted  1     DRV354 (1/1)
             RA81 7,07,18   Avail     Mounted  0     DRV18  (1/1)
                  NOTE: Channel 7 indicates CI channel
                  (*) indicates potential external port
            Type 'RESPOND <number> option' where 'option' is one of the
            following:

                 ABORT    To cancel Port Unavailable Procedure.
                 PROCEED  To follow  normal  port  unavailable  procedure
                          verifying each structure change.
                 FORCE    To proceed with no further  notification.   Use
                          this option with extreme caution.

            OPR>RESPOND 1 PROCEED <RET>
            OPR>
            12:15:33          -- Port Unavailable Procedure Notice --
                            Structure CHIP set exclusive due to port 
                            unavailable operation
            OPR>
            12:15:34  <2>     -- Port Unavailable Procedure Notice --

            The following dual ported disk  drive  must  be  resolved  to
            continue SET PORT CI UNAVAILABLE:













                                    7-66

                         UNSCHEDULED SOFTWARE TASKS


            DISK DRIVE INFORMATION                   DISK PACK INFORMATION
                  Chan-Cont   Disk    Mount    Mount              Usage
             Type   Drive    Status   Status   Count Name         Options
             ---- -------   --------  ------   ----- ------------ --------
            *RP06 0,  ,2    Avail     Mounted  1     AP20   (1/1)
                  (*) indicates potential external port

            After the dual-ported disk has been  resolved  Type  'RESPOND
            <number> option' where 'option' is one of the following:

                 ABORT    To cancel Port Unavailable Procedure.
                 PROCEED  The  drive  has  been  single  ported  to  this
                          system.
                 FORCE    To proceed  and  ignore  the  porting  of  this
                          drive.  The drive will be set unavailable.

            OPR>RESPOND 2 PROCEED <RET>
            OPR>
            12:17:49  <3>     -- Port Unavailable Procedure Notice --

            The following dual-ported disk  drive  must  be  resolved  to
            continue SET PORT CI UNAVAILABLE:

            DISK DRIVE INFORMATION                   DISK PACK INFORMATION
                  Chan-Cont   Disk     Mount   Mount              Usage
             Type   Drive    Status   Status   Count Name         Options
             ---- --------- --------  ------   ----- ------------ --------
            *RP07 1,  ,0    Avail     Offline
                  (*) indicates potential external port

            After the dual ported disk has been  resolved  Type  'RESPOND
            <number> option' where 'option' is one of the following:

                 ABORT    To cancel Port Unavailable Procedure.
                 PROCEED  The  drive  has  been  single  ported  to  this
                          system.
                 FORCE    To proceed  and  ignore  the  porting  of  this
                          drive.  The drive will be set unavailable.

            OPR>RESPOND 4 FORCE
            OPR>
            12:19:22   -- Disk Drive Set Unavailable --
               Channel 1 Drive 0 set unavailable for mounting by MOUNTR
            OPR>
            12:19:23   -- Disk Drive Set Unavailable --
   Channel 7 Controller 0 Drive 1 set unavailable for mounting by MOUNTR

            12:19:23  <5> -- Port Unavailable Procedure Notice --

            Dismount of structure DALE: (Alias DALE:) requested.
            Other jobs are currently using it.
            Should dismount request be processed (Yes or No)?


                                    7-67

                         UNSCHEDULED SOFTWARE TASKS


            User WONG, Job 3, Terminal 1

            OPR>RESPOND 5 YES
            OPR>

   12:20:00   -- DISMOUNT STRUCTURE SUCCEEDED AS PART OF PORT OPERATION --
             Structure DALE: (alias DALE:) dismounted
             User WONG, Job 3, Terminal 1

            12:20:01   -- Disk Drive Set Unavailable --
   Channel 7 Controller 7 Drive 5 set unavailable for mounting by MOUNTR

            12:20:01  <6>   -- Port Unavailable Procedure Notice --
                         .
                         .
                         .

            12:21:24   -- Port Unavailable Operation Completed --
             Port Set Unavailable

        2.  Set the PORT CI AVAILABLE

            OPR>SET PORT CI AVAILABLE <RET>
            Is there any other DECSYSTEM-20 using the CI?
            OPR>
            02:22:10   -- Port Available Operation Completed --
             The following disk drive(s) have been returned to available:
             Channel 1 Drive 0 set to available
             Channel 7 Controller 0 Drive 1 set available
             Channel 7 Controller 7 Drive 5 set available
             Channel 7 Controller 7 Drive 376 set available
             Channel 7 Controller 7 Drive 22 set available
             Port set available



   7.12.1  Displaying Disk Drive Status

   You can display the status of the disk drives  with  the  SHOW  STATUS
   DISK-DRIVES  command.   With  this command, you can specify one of the
   following:

        1.  The /ALL switch, to display both FREE and MOUNTED disk drives
            and their current status

            OPR>SHOW STATUS DISK-DRIVES /ALL

        2.  The /FREE switch, to display all disk drives  that  are  FREE
            for mounting

            OPR>SHOW STATUS DISK-DRIVES /FREE



                                    7-68

                         UNSCHEDULED SOFTWARE TASKS


        3.  The /MOUNTED switch, to display those disk  drives  that  are
            currently mounted and being accessed

            OPR>SHOW STATUS DISK-DRIVES /MOUNTED

        4.  The /CLUSTER-NODE:  switch, to display  the  status  of  disk
            drives  on  the  specified  remote  CFS-20  node.   If  *  is
            specified, the disk-drive status of all nodes in the  cluster
            is displayed.

            OPR>SHOW STATUS DISK-DRIVES /CLUSTER-NODE:node

   If you do not specify any switch, the SHOW STATUS DISK-DRIVES  command
   defaults to /ALL.

   The output from the SHOW STATUS  DISK-DRIVES  command  with  the  /ALL
   switch specified displays:

        1.  The type of disk drive (RP04,  RP06,  RP07,  RP20,  RA60,  or
            RA81).   An  asterisk (*) next to the type of drive indicates
            that the disk drive is potentially dual-ported.

        2.  The channel, controller, and drive number.

        3.  The state of the disk-drive (Available/Unavailable).

        4.  The mount status of the disk drive.

        5.  The count number of users who have requested a mount  of  the
            structure.

        6.  The name of the structure on the  drive  and  the  number  of
            packs in the structure.

        7.  Any usage options, if these are specified.

   Information for both FREE and MOUNTED DISK-DRIVES is  shown  with  the
   /ALL switch specified.

   The OUTPUT from the SHOW STATUS DISK-DRIVES  command  with  the  /FREE
   switch  specified, displays information about drives that are free for
   mounting.  There may be a structure on the drive but the structure has
   not been mounted with the MOUNT command.

   The output from the SHOW STATUS DISK-DRIVES command with the  /MOUNTED
   switch  specified displays information about drives that are currently
   mounted.  The output from the SHOW STATUS DISK-DRIVES command with the
   /CLUSTER-NODE:   switch specified displays information about drives on
   the specified remote CFS-20 node.  The output includes the name of the
   remote  node  and the times that the remote node processed the command
   and the local node received the information.



                                    7-69

                         UNSCHEDULED SOFTWARE TASKS


                            ----- Examples -----

        1.  Specify the SHOW STATUS DISK-DRIVES command  with  the  /FREE
            switch.

            OPR>SHOW STATUS DISK-DRIVE /FREE<RET>
            OPR>
            12:11:15          -- Disk Drive Status --

                                    FREE DRIVES

            DISK DRIVE INFORMATION                   DISK PACK INFORMATION
                  Chan-Cont   Disk     Mount   Mount              Usage
             Type   Drive    Status   Status   Count Name         Options
             ---- --------- --------  ------   ----- ------------ --------
            *RP06 0,  ,1    Avail     Offline
            *RP07 1,  ,0    Avail     Free           FIAT   (1/1)
             RP06 7,01,1    Avail     Free           CHIP   (1/1)
             RA60 7,07,254  Avail     Offline
             RA81 7,08,18   Avail     Free           DRV18   (1/1)
             RA81 7,08,5    Avail     Offline
                  NOTE: Channel 7 indicates CI channel
                  (*) indicates potential external port

        2.  Specify the SHOW STATUS DISK-DRIVES command with the /MOUNTED
            switch.

            OPR>SHOW STATUS DISK-DRIVE /MOUNTED<RET>
            OPR>
            12:11:28          -- Disk Drive Status --

                                    MOUNTED DRIVES

            DISK DRIVE INFORMATION                   DISK PACK INFORMATION
                  Chan-Cont   Disk    Mount    Mount              Usage
             Type   Drive    Status   Status   Count Name         Options
             ---- --------- --------  ------   ----- ------------ --------
             RP06 0,  ,0     Avail    Mounted  0     DALE   (1/1)
            *RP06 0,  ,2     Avail    Mounted  1     AP20   (1/1)
             RA81 7,07,5     Avail    Mounted  1     EXODUS (1/1)
                  NOTE: Channel 7 indicates CI channel
                  (*) indicates potential external port



   7.12.2  Displaying Disk Drive Serial Numbers

   If you want to add a disk to the group of disks being  served  by  the
   MSCP server, you need to know the serial number of the disk drive.  To
   find the serial number of a disk drive,  give  the  OPR  command  SHOW
   CONFIGURATION  DISK-DRIVE.   This  command  will  display  information
   similar to that of the SHOW STATUS DISK-DRIVE command as well  as  the


                                    7-70

                         UNSCHEDULED SOFTWARE TASKS


   serial  numbers  of  each  disk drive.  The SHOW CONFIGURATION command
   also takes the /FREE, /ALL, /MOUNTED, and /CLUSTER-NODE:  switches.

         OPR>SHOW CONFIGURATION (of) DISK-DRIVE /ALL
         OPR>
         10:35:57         -- Disk Drive Configuration --

              Chan-Cont                        Mount
         Type   Drive    Drive Serial Number   Status   Name
         ---- --------- ---------------------  -------  ------------
         RP06 0,  ,0    17170432  2369         Mounted  GIDNEY (1/1)
         RP06 0,  ,1    17170432  1156         Mounted  REL61  (1/1)
         RP06 0,  ,2    17170432  8576         Offline
         RP06 0,  ,4    17170432  293          Mounted  PERF   (1/1)
         RP07 1,  ,0    17235968  10337        Mounted  RANDOM (1/1)
         RP07 1,  ,1    17235968  9271         Mounted  GALAXY (1/1)
         RP07 1,  ,2    17235968  8965         Mounted  LOTUS  (1/1)
        *RP07 1,  ,5    17235968  9501         Mounted  DICE   (1/1)
         RA81 7,14,15   33882112  4002         Mounted  SNARK  (1/2)
         RP07 7,11,3    17235968  14374        Mounted  SLICE  (1/1)
         RA81 7,03,6    33882112  4009         Mounted  PEBBLE (1/1)
         RA81 7,03,14   33882112  4258         Offline
         RA60 7,03,16   33816576  1037         Mounted  PUBLIC (1/1)
              NOTE: Channel 7 indicates CI channel
              (*) indicates potential external port



   7.12.3  Displaying Structure Status

   You can  display  the  status  of  structures  with  the  SHOW  STATUS
   STRUCTURE  command.   With  this  command,  you can specify one of the
   following:

        1.  The  /ALL  switch  to  display  both  MOUNTED  and  UNMOUNTED
            structures and their current status.

                 OPR>SHOW STATUS STRUCTURE /ALL

        2.  The /MOUNTED  switch  to  display  all  structures  that  are
            currently mounted.

                 OPR>SHOW STATUS STRUCTURE /MOUNTED

        3.  The /UNMOUNTED switch to display all structures that are free
            for mounting.

                 OPR>SHOW STATUS STRUCTURE /UNMOUNTED

        4.  The  /CLUSTER-NODE:   switch  to  display   the   status   of
            structures  on  the  specified  remote  CFS-20 node.  If * is
            specified, the structure of  all  nodes  in  the  cluster  is


                                    7-71

                         UNSCHEDULED SOFTWARE TASKS


            displayed.

                 OPR>SHOW STATUS STRUCTURE /CLUSTER-NODE:node

        5.  The str: name argument to display information about a  single
            structure.

                 OPR>SHOW STATUS STRUCTURE str:

   If you do  not  specify  any  switch  or  argument,  the  SHOW  STATUS
   STRUCTURE command defaults to /ALL.

   The output from the SHOW STATUS STRUCTURE command with the /ALL switch
   specified displays:

        1.  The Alias name for the structure.

        2.  The physical name of the structure, if there is one.

        3.  The mount status of the structure (mounted or unmounted).

        4.  The count of the number of users who have requested  a  mount
            of the structure.

        5.  The availability of the structure.

        6.  The file count of the structure.

        7.  The    access    to    the    structure    (SHARED/EXCLUSIVE,
            DOMESTIC/FOREIGN).

        8.  The     accounting     status      of      the      structure
            (REGULATED/UNREGULATED).

        9.  The "dumpable" designation for structures that were specified
            in a SET STRUCTURE str:  DUMPABLE command.

       10.  Offline information, where applicable, if your system manager
            has enabled the "offline structures" facility.

   In addition, the output indicates the boot and login  structures.   If
   your  system  manager  has not enabled the "login structure" facility,
   the structures are the same.

   The output from the SHOW STATUS STRUCTURE command with the  /UNMOUNTED
   switch  specified, displays information about structures that are free
   for mounting.

   The output from the SHOW STATUS STRUCTURE command  with  the  /MOUNTED
   switch  specified,  displays  information  about  structures  that are
   currently mounted.



                                    7-72

                         UNSCHEDULED SOFTWARE TASKS


   The  output  from  the  SHOW  STATUS  STRUCTURE   command   with   the
   /CLUSTER-NODE:    switch   specified,   displays   information   about
   structures on the specifed remote CFS-20 node.   The  output  includes
   the  name  of  the  remote  node  and  the  times that the remote node
   processed the command and the local system received  the  information.
   The  output from the SHOW STATUS STRUCTURE command with the str:  name
   argument specified, displays:

        1.  Structure information about the single  structure,  including
            alias,   name,   mount   status,  mount  count,  file  count,
            availability, access, and accounting.

        2.  Disk  drive  information  for  the  drive(s)  on  which   the
            structure   is   mounted.    This  includes  type  of  drive,
            channel-controller-drive, availability of  the  drive,  mount
            status, mount count, name of structure and number of packs in
            the structure, and usage options.

        3.  A list of users who have mounted the structure.

        4.  A list of users who are accessing the structure.

        5.  A list of users who are connected to the structure.

                                    NOTE

           If you are requested to  remove  information  about  a
           structure  from the structure tables, use the UNDEFINE
           STRUCTURE command.  For information  on  the  UNDEFINE
           STRUCTURE  command,  refer  to  the TOPS-20 Operator's
           Command Language Reference Manual.























                                    7-73

                         UNSCHEDULED SOFTWARE TASKS


                            ----- Examples -----

        1.  Specify the SHOW STATUS STRUCTURE command with  the  /MOUNTED
            switch.

            OPR>SHOW STATUS STRUCTURE /MOUNTED <RET>
            OPR>
   16:13:26                     -- Structure Status --

                               MOUNTED STRUCTURES

                 Mount   Mount File
   Alias  Name   State   Count Count Status         Access         Accounting
   ------ ------ ------- ----- ----- -------- -------------------- -----------
   THEP   THEP   Mounted  0     62   Avail    Shared     ## Boot Structure ##
   APATCH APATCH Mounted  0     0    Avail    Shared     Domestic  Regulated
   DBMS20 DBMS20 Mounted  1     0    Avail    Shared     Domestic  Unregulated
   DICE   DICE   Mounted  2     0    Avail    Shared     Domestic  Unregulated
   COMMON COMMON Mounted  1     7    Avail    Shared     Domestic  Unregulated
   PUBLIC PUBLIC Mounted  5     68   Avail    Shared     ## Login Structure ##
   WORK   WORK   Mounted  4     9    Avail    Shared     Domestic  Unregulated
   EXODUS EXODUS Mounted  2     1    Avail    Shared     Domestic  Unregulated

        2.  Specify the SHOW STATUS STRUCTURE command with the /UNMOUNTED
            switch.


            OPR>SHOW STATUS STRUCTURE /UNMOUNTED <RET>
            OPR>
   16:13:55                     -- Structure Status --

                               UNMOUNTED STRUCTURES

                 Mount   Mount File
   Alias  Name   State   Count Count Status         Access         Accounting
   ------ ------ ------- ----- ----- -------- -------------------- ----------
   JULIE                             Avail    Shared     Domestic  Regulated
   NETPKG                            Avail    Shared     Domestic  Regulated
   CG60                              Avail    Shared     Domestic  Regulated
   WHEEL                             Avail    Shared     Domestic  Regulated
   ARK                               Avail    Shared     Domestic  Regulated
   DMLPS                             Avail    Shared     Domestic  Regulated
   GALKL                             Avail    Shared     Domestic  Regulated
   GINSU                             Avail    Shared     Foreign   Regulated
   WONG                              Avail    Shared     Foreign   Regulated
      Structure is Dumpable








                                    7-74

                         UNSCHEDULED SOFTWARE TASKS


        3.  Specify the SHOW STATUS STRUCTURE command with the  structure
            name argument.

            OPR>SHOW STATUS STRUCTURE GALAXY: <RET>
            OPR>
   17:48:07                     -- Structure Status --
    
                 Mount   Mount File
   Alias  Name   State   Count Count Status         Access         Accounting
   ------ ------ ------- ----- ----- -------- -------------------- ----------
   GALAXY GALAXY Mounted  4     5    Avail    Shared     Domestic  Unregulated
       Can't use structure GALAXY: - structure is offline
    
            Disk information pertaining to mounted structure
   DISK DRIVE INFORMATION                   DISK PACK INFORMATION
         Chan-Cont   Disk   Mount   Mount                Usage
    Type   Drive    Status  Status  Count   Name         Options
    ---- --------- -------- ------- -----   ------------ --------------------
    RA81 7,00,36   Avail    Mounted 4       GALAXY (1/1) 
         NOTE: Channel 7 indicates CI channel
    
   Users who have MOUNTed this structure:
   WONG, RASPUZZI, JROSSELL.
    
   Users who are ACCESSing this structure:
   WONG, DUSSEAULT, GSCOTT.
    
   Users who are CONNECTed to this structure:
   WONG, JROSSELL.

   OPR>



   7.12.4  Setting the NI PORT AVAILABLE/UNAVAILABLE

   If  your  installation  is  using  the  NI  port  for  the   DECnet-20
   connection, the NI is set available by default.  However, there may be
   times when  you  need  to  diagnose  the  NI  or  use  the  system  in
   stand-alone mode.  Setting the NI port UNAVAILABLE disables the DECNET
   connection.

   To set the NI port UNAVAILABLE, perform the following procedure.

        @ENABLE<RET>
        $OPR<RET>
        OPR>SET PORT NI UNAVAILABLE<RET>

   OPR will display a message specifying that the NI is  off-line.   Once
   the  NI  is  off-line,  all  connections  to local area transports are
   terminated.



                                    7-75

                         UNSCHEDULED SOFTWARE TASKS


   To set the NI available, give the following OPR command.

        OPR>SET PORT NI AVAILABLE<RET>



   7.13  EXAMINING MOUNT-REQUESTS IN THE QUEUE

   Whenever a user submits a request  for  a  tape  or  disk  mount,  the
   request  is  placed  in  a  queue  where it waits for your response to
   either mount the tape or disk or delete the mount request.  To examine
   the  tape  and disk mount queue at any time, give the OPR command SHOW
   QUEUES MOUNT-REQUESTS.

   The output of the SHOW QUEUES MOUNT-REQUESTS command displays:

        1.  The name of the tape or disk volume

        2.  The status of the request

        3.  The type of request (Tape or Disk)

        4.  The density of the request

        5.  The write access requested

        6.  The number of the request

        7.  The number of the user's job who made the request

        8.  The name of the user

        9.  The label status of a tape (labeled or unlabeled)

   The status column displays the following:

        1.  Waiting, if a tape or disk request is waiting to be satisfied

        2.  A tape drive name (for example, MTA3:),  if  the  request  is
            currently for a tape drive

        3.  Dismount, if a tape or disk is being dismounted

        4.  Aborted, if a tape mount request has been deleted or  aborted
            and  the user has not yet given a dismount command to release
            the logical tape drive (MTn:)

   If you specified the /CLUSTER-NODE:  switch, the display also includes
   the  name of the remote CFS-20 node and the times that the remote node
   processed the command and the local system received the information.




                                    7-76

                         UNSCHEDULED SOFTWARE TASKS


                            ----- Example -----

   Give the SHOW QUEUES MOUNT-REQUESTS command  to  display  the  current
   tape and disk requests in the queue.

   OPR>SHOW QUEUES MOUNT-REQUESTS<RET>

   OPR>
   11:37:10                -- System Queues Listing --

   Volume    Status   Type  Dens   Write    Req#  Job#    User
   -------  --------  ----  ----  ------   -----  ----  --------
   JCR      Waiting   Tape  Defa  Locked      1   143   JROSSELL
      Volume-set: JCR  Tape is unlabeled
   JCR      Waiting   Tape  Defa  Locked      2   143   JROSSELL
      Volume-set: JCR    Tape is labeled
   There are 2 requests in the queue

   OPR>



   7.14  CREATING A STRUCTURE DURING TIMESHARING

   During timesharing, you can create a structure by doing the following:

        1.  Obtain the number of formatted  disk  packs  needed  for  the
            structure.

        2.  Place the packs on any available  disk  drives  and  put  the
            drives on-line.

        3.  Type PUSH to OPR.

        4.  Run CHECKD.

        5.  Type CREATE structure name to CHECKD.

        6.  Answer the questions from CHECKD.

        7.  Type EXIT to CHECKD.

        8.  MOUNT STRUCTURE str:

   If this structure is to be used on a system other than a KL10 Model B,
   perform steps 9 through 11.  Otherwise, proceed at step 12.

        9.  Run CHECKD.

       10.  Type DISABLE LARGE-DIRECTORIES




                                    7-77

                         UNSCHEDULED SOFTWARE TASKS


       11.  Type EXIT to CHECKD.

       12.  Type DISABLE.

       13.  Type POP to return to OPR command level.

   If CHECKD is a subjob of PTYCON at your installation, you need only to
   CONNECT  to the CHECKD subjob and perform Steps 5 through 8 above.  If
   your installation is part of a CFS-20 configuration, CHECKD may not be
   able  to  set  the  structure  exclusive.   If  this happens, you must
   dismount the structure from the  other  systems  using  it.   Use  the
   dismount  procedures  for  CFS-20  systems  in  Section  7.11.3.  Then
   reissue the CHECKD command.

                                    NOTE

           When  you  create  a  structure,   you   destroy   any
           information  that  was previously on the disk packs in
           the structure.  If you want to  save  any  information
           from  an  old  structure, run DUMPER to save the files
           before you create the new structure on the  same  disk
           packs.

   When you are running CHECKD to create  a  structure,  first  type  the
   CREATE  command  and  specify  the  name  of the structure you want to
   create.  This  name  is  a  physical  identification  written  on  the
   structure by CHECKD.

   CHECKD then asks a series of questions.  For  each  question  you  can
   type ?  to get a help message.  The questions are:

   ENTER ALIAS:

        Type a 1- to 6-character alphanumeric name for the alias.  If you
        do  not type a number, or if a structure has the same name as the
        structure you are creating, type the structure name as the alias.
        If another structure of the same name is mounted, press RETURN to
        get the default alias, CHECKD.  If another structure  is  mounted
        with the name CHECKD, use another name.  The alias is a temporary
        name that the system uses for your structure.

   HOW MANY UNITS IN THIS STRUCTURE?

        Type the number of disk packs that will be in the structure.

   DECIMAL channel, CONTROLLER AND UNIT numbers FOR LOGICAL UNIT n:

        This question is asked for each unit n in the structure.  Type in
        a  decimal  channel  number,  followed by a comma, the controller
        number followed by a comma, and  a  unit  (or  drive)  number  to
        indicate where unit n is mounted.



                                    7-78

                         UNSCHEDULED SOFTWARE TASKS


        The help message for this question is similar to:

        Triple of decimal numbers from one of the following:

        TYPE  CHANNEL  CONTROLLER   UNIT   STRUCTURE NAME  LOGICAL UNIT
        ----  -------  ----------   ----   --------------  ------------ 
        RP06        1      -1          0   OFF-LINE
        RP06        1      -1          1   OFF-LINE
        RP04        1      -1          2   STR2            0 (1 OF 1)
        RP06        1      -1          5   OFF-LINE

        This output lists each drive that is available.  Thus, each  disk
        pack  for the structure you are creating must be on some drive in
        the list.  A structure name appears in the list if a disk pack is
        on-line and was formerly part of a structure.  Do not specify the
        drive for that pack if you still want data from that structure.

        If the help message does not eliminate confusion over channel and
        drive   correspondence,   consult   your  DIGITAL  Field  Service
        Representative.
   NUMBER OF PAGES TO ALLOCATE FOR SWAPPING?

        Type 0 if the structure is never going to be used as  the  system
        structure,  BS:.   Press ESCape to set the default value.  Type a
        decimal number between 2000 and 40000 to specify a number.

        If you have any question about the amount of swapping space,  see
        your  system manager.  Note that swapping space is necessary on a
        system structure, but the default value  is  usually  sufficient.
        If  past  experience  has shown many SWAPPING SPACE LOW messages,
        you may need more swapping space.  Increasing the swapping  space
        here,  however,  may  not  be  sufficient,  because  the  maximum
        swapping space allocated within  the  monitor  takes  precedence.
        Thus, you might need a larger monitor or a tailored monitor.

   NUMBER OF PAGES TO ALLOCATE FOR THE FRONT END FILE SYSTEM?

        Type 0 if the structure  is  never  to  be  used  as  the  system
        structure,  BS:.   Press  ESCape  to get the default; the default
        should always be sufficient for the front-end file system.

   OWNER NAME?

        Type a 1- to 12-character alphanumeric name for the owner of  the
        structure.

   IS THIS A SYSTEM STRUCTURE FOR STARTUP?

        If this structure is to be used for  system  startup,  type  YES.
        Otherwise, type NO.




                                    7-79

                         UNSCHEDULED SOFTWARE TASKS


                                      NOTE

                The  following  question  only  appears  if   you
                answered YES to the above question.

   SERIAL NUMBER OF CPU STARTED FROM THIS STRUCTURE?

        Enter the serial number of the system this structure will be used
        on.

   When CHECKD finishes the CREATE function, it prompts again.  When  you
   are finished with CHECKD, type EXIT.
                            ----- Example -----

   In the following example, structure QWERTY  is  created  as  a  1-pack
   structure.  An ESCape was pressed to get the defaults for the swapping
   space allocation and the front-end file system.  Therefore, QWERTY can
   be used as a system structure.

   OPR>PUSH<RET>

    TOPS-20 Command Processor 7(31)
   @ENABLE<RET>
   $CHECKD<RET>
   CHECKD>CREATE (NEW FILE SYSTEM FOR) QWERTY<RET>
   ENTER ALIAS: QWERTY<RET>
   HOW MANY UNITS IN THIS STRUCTURE? 1<RET>
   CHANNEL , CONTROLLER, AND UNIT NUMBER FOR LOGICAL UNIT 0: ?      

   TRIPLE OF DECIMAL NUMBERS FROM ONE OF THE FOLLOWING:

   TYPE  CHANNEL  CONTROLLER   UNIT   STRUCTURE NAME  LOGICAL UNIT
   ----  -------  ----------   ----   --------------  ------------ 

   RP06        1      -1          2   STR2            0 (1 OF 1)


   CHANNEL , CONTROLLER AND UNIT NUMBER FOR LOGICAL UNIT 0: 1,-1,2<RET>
   NUMBER OF PAGES TO ALLOCATE FOR SWAPPING? <ESC>3050<RET>
   NUMBER OF PAGES TO ALLOCATE FOR THE FRONT END FILE SYSTEM? <ESC>950<RET>
   OWNER NAME? KIRSCHEN<RET>
   IS THIS A SYSTEM STRUCTURE FOR STARTUP? NO<RET>

   [QWERTY: MOUNTED AS QWERTY:]

   [DISMOUNTING STRUCTURE - QWERTY:]

   CHECKD>EXIT<RET>
   $DISABLE<RET>
   @POP<RET>
   OPR>



                                    7-80

                         UNSCHEDULED SOFTWARE TASKS


                         ----- Error Messages -----

   ?INVALID CONFIRMATION

        You typed an invalid character within or after an argument.

   ? INVALID DECIMAL NUMBER

        You did not type a valid decimal number for the argument.

   ? NAME STRING GREATER THAN 12. CHARACTERS

        You typed more than 12 decimal characters for the owner name.

   ?WHEEL OR OPERATOR CAPABILITY REQUIRED

        You must have WHEEL or OPERATOR capability enabled.   Use  a  job
        logged  in under OPERATOR, which should have OPERATOR capability,
        and type ENABLE before you run CHECKD.



   7.15  COMMUNICATING WITH USERS

   Timesharing and batch users often need  to  communicate  with  you  to
   perform  various  tasks,  to  obtain  help,  or to send messages.  The
   following sections tell you how to:

        1.  Respond to PLEASE requests with OPR

        2.  Help another user with SEND

        3.  Mail a message to a user with MAIL

        4.  Read any messages sent to you with RDMAIL

   Refer also to the TOPS-10/TOPS-20 DECmail/MS Manual for information on
   the DECmail/MS system.  You can use it in place of MAIL and RDMAIL for
   sending and receiving mail.



   7.15.1  Answering PLEASE Requests with OPR

   When a user sends a message  with  PLEASE,  you  receive  from  OPR  a
   message at the console terminal that is time-stamped and has a message
   number enclosed in angle brackets.  You should then answer the request
   with the RESPOND command in OPR.  If you are not at OPR command level,
   you must connect to the subjob running OPR  in  PTYCON  to  issue  the
   RESPOND command.

   If the user requested some form of physical action, such  as  changing


                                    7-81

                         UNSCHEDULED SOFTWARE TASKS


   the  forms  on  the  line  printer,  you  can make the change and then
   respond to let the user know that the change has been made.   You  can
   type  any response to this message.  However, you should pay attention
   to what the user said in the line of text and try to do what the  user
   requested.   If  further  communication  is necessary, you can use the
   TALK command, the MAIL program, or issue the SEND command in OPR.   If
   the request cannot be satisfied, you can respond with a refusal and/or
   text to explain why the request cannot be satisfied.

   The format of the request from the user appears as follows:

        hh:mm:ss    <n>    --Message from Timesharing User--
                         Job number User at Terminal nnn
                         one or more lines of text (or)
                         PLEASE line of text

   This request contains the word PLEASE if  the  user  sent  a  one-line
   message  with  the  PLEASE  program,  or the line contains one or more
   lines of text ending with a ^Z (Control Z).  This  message  can  be  a
   request  for action, a question, or a comment.  The user who sends you
   a PLEASE message should include a word or two for you  to  include  in
   the  RESPOND command to indicate that the request or question has been
   completed.  If the user does not include any word(s) for  the  RESPOND
   command,  you  can  RESPOND  in any way desired to answer the message.
   With some requests, this line  might  be  repeated  to  allow  you  to
   respond with different words for different circumstances.
                            ----- Examples -----

        1.  A user might ask when timesharing ends.  The message  appears
            as follows:

            OPR>
            12:32:09    <3>    --Message from Timesharing User--
                             JOB 32 BROWN at Terminal 114
                             PLEASE WHEN WILL TIMESHARING END?
                             RESPOND HH:MM:SS
            OPR>

            And, you can respond as follows:

            OPR>RESPOND 3 18:00:00<RET>
            OPR>












                                    7-82

                         UNSCHEDULED SOFTWARE TASKS


        2.  The following example shows what  appears  on  the  terminal,
            running  OPR  as  a  subjob  of  PTYCON  after a user sends a
            multi-line message with PLEASE.

            OPR>
            14:54:01    <13>    --Message from Timesharing User--
                              JOB 12 LATTA at Terminal 21
                              LOAD NARROW FORMS ON PRINTER 2
                              IF YOU ARE UNABLE, ABORT BATCH REQUEST 198
                              RESPOND OK WHEN DONE
                              RESPOND REFUSE IF CAN'T BE DONE
                              ^Z
            OPR>
            OPR>RESPOND 13 REFUSE<RET>
            OPR>ABORT BATCH-STREAM 1 /REQUEST-ID:198<RET>
            OPR>
            14:56:50        Batch-stream 1     JOB #66     --ABORTED--
                            Job TEST Req #198 for LATTA
                            No Reason Given with ERROR-PROCESSING

            OPR>



   7.15.2  Talking to Another User Immediately with SEND

   If a user indicates that help is needed from you to  use  some  system
   feature,  you can help the user with the OPR command SEND.  Connect to
   OPR from PTYCON and then give either of the following commands:

        OPR>SEND JOB n message<RET>

   or

        OPR>SEND TERMINAL n message<RET>

   where n is the number of the timesharing or batch  job  in  the  first
   command above, or the number of the user's terminal line in the second
   command above.

   The SEND command allows you the option of including the message either
   in  the  SEND  command  string  or  as  multiple lines terminated by a
   CTRL/Z.

   The SEND command does not link your job or terminal to the user's  job
   or  terminal.   If  the  user  is  waiting for input to a program, the
   message sent appears on the user's terminal, but it  does  not  affect
   the program he is running.






                                    7-83

                         UNSCHEDULED SOFTWARE TASKS


                            ----- Examples -----

        1.  Tell a user that a task he requested is now complete.

            OPR>SEND JOB 27<RET>
            ENTER TEXT AND TERMINATE WITH ^Z
            THE UPDATED FORTRAN SOURCE LIBRARY IS NOW ONLINE<RET>
            YOU MUST CONNECT TO MISC:<CTRL/Z>
            OPR>

        2.  Send a message to terminal 15 to notify  the  user  that  his
            batch requests are being held.

            OPR>SEND TERMINAL 15 YOUR BATCH REQUESTS ARE BEING HELD<RET>

            OPR>

                             ----- Hints -----

   Refer to the TOPS-20 Operator Command Language Reference Manual for  a
   complete description of the SEND command.

   If you need to link your terminal with the user's  terminal,  use  the
   TOPS-20  ADVISE  or  TALK  command.   Refer  to  the  TOPS-20 Commands
   Reference Manual for a description of these two commands.



   7.15.3  Mailing a Message for a User to Read Later

   You can send a message to one or more users by doing the following:

        1.  Type MAIL.

        2.  After TO:  type the names  of  the  users  to  whom  you  are
            mailing the message.

        3.  After CC:  type the names of  the  users  to  whom  you  want
            copies  of the message sent, or simply press RETURN if you do
            not want copies sent to anyone.

        4.  After SUBJECT:  type a few words to indicate the  subject  of
            the message.

        5.  After the line beginning  with  MESSAGE,  type  the  message,
            which  can  be  several  lines of text, and terminate it with
            ESCape or CTRL/Z.

                            ----- Example -----

   This example shows how to send a message to user JONES.   If  you  are
   going  to  do  this  from the terminal that is running OPR, first type


                                    7-84

                         UNSCHEDULED SOFTWARE TASKS


   PUSH to OPR.

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @MAIL<RET>

        TO: JONES<RET>
        CC:<RET>
        SUBJECT: USER'S GUIDE<RET>
        MESSAGE (TERMINATE WITH ESC OR CTRL/Z):

        WE NOW HAVE MORE COPIES AVAILABLE AT THE COMPUTER CENTER<RET>
        STOP BY IF YOU NEED ONE<RET>
        $
        <ESC>
             
        PROCESSING MAIL...
        NO ERRORS.
        -DONE-
        @POP<RET>
        OPR>

   If you want to follow TO:  or CC:  with  a  list  of  users,  separate
   their names with commas.  You can also specify one indirect file which
   contains a list of names separated by commas.  Precede the  file  name
   with "@", but be sure you put it last in the list.  For example:

        TO: SMITH,JONES,@LISTA.USR<RET>

   sends a message to SMITH,  JONES,  and  all  the  users  in  the  file
   LISTA.USR.   You  can  use recognition input on the user names and the
   filename.

   You can also use one indirect file for the  message  itself.   Precede
   the  filename  which  contains the message with "@" and follow it with
   CTRL/Z or <RET>.  You can use recognition on the filename.

   The following example shows the  use  of  an  indirect  file  for  the
   message:














                                    7-85

                         UNSCHEDULED SOFTWARE TASKS


        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @MAIL<RET>

        TO: SMITH<RET>
        CC: MULLEN<RET>
        SUBJECT: TEST<RET>
        MESSAGE (TERMINATE WITH ESC OR CTRL/Z):

        @A.TST<RET>

        PROCESSING MAIL...
        NO ERRORS.
        -DONE-
        @POP<RET>
        OPR>
   Once you have sent the message, all users in the TO:  or CC:  list who
   are  logged  in are notified immediately that they have a message.  If
   they are not logged in, they are notified the next time they  log  in.
   The  users must read the message by running RDMAIL.  Consequently, the
   time when the message is actually read is up to the user.

   (Refer to the TOPS-20 User Utilities Guide for all error messages from
   MAIL.)



   7.15.4  Reading Your Messages with RDMAIL

   If someone sends you a message with MAIL,  you  are  notified,  either
   when  you log in or when the message is sent, that you have a message.
   You should read the message with RDMAIL.  To do this:

        1.  Type PUSH to OPR.

        2.  Run RDMAIL.

        3.  Press RETURN after DATE AND TIME (/H FOR HELP).

        4.  Type POP to return to OPR.

   Once you press RETURN after DATE AND TIME, any messages that you  have
   not read before are printed on your terminal.  If you want to read old
   messages, specify a date and time after the DATE AND TIME prompt.  The
   format for the date and time is explained when you type /H for HELP.

   (Refer to the TOPS-20 User Utilities Guide  for  more  information  on
   RDMAIL.)





                                    7-86

                         UNSCHEDULED SOFTWARE TASKS


                            ----- Example -----

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @RDMAIL<RET>
        DATE AND TIME (/H FOR HELP)<RET>
           --------
        DATE: 5-MAR-82 15:39
        FROM: WELLS
        TO: OPERATOR

           -----
        SUBJECT: FILES-ONLY DIRECTORY

        WHERE CAN I GET A FORM TO APPLY FOR A FILES-ONLY DIRECTORY?
           ========
        @POP<RET>
        OPR>



   7.16  HELPING A USER WITH TERMINAL PROBLEMS

   If you are notified by a user that his terminal is not responding, try
   the following:

        1.  Check the terminal speed.  Ask  the  user  for  his  terminal
            number,  or  if  the  user  is logged in, do a SYSTAT user to
            determine  the  terminal  number.    Then   type   the   file
            SYSTEM:n-CONFIG.CMD,  where  n is the TOPS-20 version number.
            Find the line referring to the terminal number and  see  what
            its  initial  speed should be.  If the terminal is designated
            for autobaud detection, the speed is 110, 150, 300, or  1200.
            Have  the user manually set the terminal for the proper speed
            and  then  try  again.   (Refer  to  the   TOPS-20   Software
            Installation  Guide  for more information on n-CONFIG.CMD and
            setting terminal speeds.)

        2.  If Step 1 does not work, be sure the user leaves the terminal
            set  at  the  speed specified in the n-CONFIG.CMD file.  Then
            type to OPR:

                 OPR>PUSH<RET>
                 @ENABLE<RET>
                 $^ESET TERMINAL t SPEED s<RET>
                 $POP<RET>
                 OPR>

            where t is the terminal number and s  is  the  speed  in  the
            n-CONFIG.CMD  file.  If there is a different input and output
            speed, you must enter both the input and output speeds.  Then


                                    7-87

                         UNSCHEDULED SOFTWARE TASKS


            have the user try again.

        3.  If Step 2 does not succeed because the user can not  set  the
            terminal  for  the  speed  in  the  n-CONFIG.CMD file, give a
            ^ESET TERMINAL command as above for a speed  which  the  user
            can  manually  set  for the terminal.  Then have the user try
            again.  If that succeeds and the terminal is going to be used
            permanently,     you    should    also    edit    the    file
            SYSTEM:n-CONFIG.CMD to change the speed for that terminal.

        4.  If none of the above works, the terminal is broken or the job
            is  hung.  Notify the user of his options, given below.  Then
            notify your system manager and software specialist.

   If a terminal is not functioning correctly or a job is hung, the  user
   has the following options:

        1.  If he is not logged in, the user can simply look for  another
            terminal and log in.

        2.  If the user is logged in and  wants  the  same  job,  try  to
            unattach the user's job.  Type to OPR:

                 OPR>PUSH<RET>
                 @ENABLE<RET>
                 $UNATTACH (USER) name (JOB #) n<RET>
                 [ATTACHED TO TTYxxx, CONFIRM]<RET>
                 $POP<RET>
                 OPR>

            where name is the user's name and n is the user's job number.

            The user should then try  to  attach  to  job  n  at  another
            terminal.  If the user is still unsuccessful, go to Step 3.

        3.  If the user is logged in, try to log the job out by typing to
            OPR:

                 OPR>PUSH<RET>
                 @ENABLE<RET>
                 $LOGOUT n<RET>
                 [CONFIRM]
                 $<RET>
                 $POP<RET>
                 OPR>

            where n is the user's job number.   (Section  7.17  has  more
            detail  on  logging out a job.) If LOGOUT succeeds within ten
            seconds and the terminal is functioning correctly,  the  user
            should  then  be  able to log in at the same terminal.  If it
            does not succeed, go to Step 4 and report the problem to your
            software specialist.


                                    7-88

                         UNSCHEDULED SOFTWARE TASKS


                OPR>PUSH<RET>

                 TOPS-20 Command processor 7(31)
                @ENABLE<RET>
                $LOGOUT 28<RET>
                User TUCKER on TTY32, running EXEC
                [Confirm]<RET>
                $POP<RET>
                OPR>

        4.  If the user is logged in and LOGOUT in Step 3  did  not  work
            because  of  system  software  problems, you can unattach the
            user by typing to OPR:

                OPR>PUSH<RET>
                @ENABLE<RET>
                $UNATTACH (USER) name (JOB #) n<RET>
                $POP<RET>
                OPR>

            where name is the user's name and n is the user's job number.

            The user should then be able to log in at the same  terminal.
            If the user cannot, there is a problem with the terminal, the
            terminal line, or the system.  Report the situation  to  your
            system  manager.   The  user  must  try  another  terminal or
            terminal line.

                OPR>PUSH<RET>
                 TOPS-20 Command processor 7(31)
                @ENABLE<RET>
                $UNATTACH (USER) PORADA (JOB #) 23<RET>
                 [ATTACHED TO TTY105, CONFIRM]<RET>
                $SYSTAT 23<RET>
                  23   DET   EXEC    PORADA
                $POP<RET>
                OPR>

        5.  If the user cannot find another terminal, he can request that
            you  perform  some task for him.  If this is within the rules
            of your installation, perform the task.   You  might  do  the
            entire task from the subjob O, you might ADVISE the job to do
            the task, or you might attach to  the  user's  job  from  the
            subjob  O,  perform the task, log out, and attach back to the
            subjob.  Be sure to give the correct password.

            To attach to a user's job, type to OPR:

                PUSH
                ENABLE
                ATTACH user n



                                    7-89

                         UNSCHEDULED SOFTWARE TASKS


            where user is the user's name and n is the user's job number.

                OPR>PUSH<RET>

                 TOPS-20 Command processor 7(31)
                @ENABLE<RET>
                $ATTACH (USER) POR (JOB #) 23<RET>
                 DETACHING JOB # 3
                $              !Perform task for user
                   .
                   .
                   .
                $LOGO<RET>
                KILLED JOB 23, USER POR, ACCOUNT 104, TTY 101,
                  AT 5-OCT-87 08:55:16,  USED 0:0:6 IN 0:5:1

                $ATTACH OPERATOR 3<RET>
                $POP<RET>
                OPR>

                             ----- Hints -----

   More information on the ^ESET  TERMINAL  command  is  in  the  TOPS-20
   Operator's Command Language Reference Manual.

   Once a  user  establishes  terminal  communication,  he  can  use  the
   TERMINAL  SPEED  command  (in  the  TOPS-20 User's Guide) to specify a
   different speed and then manually set the  terminal  for  that  speed.
   This  procedure,  however,  does  not  change the default speed of the
   line.  You must edit SYSTEM:n-CONFIG.CMD to change the default speed.



   7.17  LOGGING OUT A USER WITH LOGOUT

   To delete unwanted jobs from the system, type the command:

        LOGOUT n

   where n is the number of the job you want to delete.  You  must  first
   enable  your operator privileges.  Also, be absolutely sure that a job
   is unwanted before you log it out.  The types of unwanted jobs  should
   be  listed  for  you by the system manager.  Then you can periodically
   give the SYSTAT command and check the output against the list to  find
   any  unwanted  jobs.   A  possible  list  of unwanted jobs and ways of
   identifying them in the SYSTAT output are:

        1.  Jobs that have not used  any  runtime  over  a  certain  time
            period.   Periodically, use the command SYSTAT TIME or SYSTAT
            n TIME, where n is a job number, to see if the job's  runtime
            has increased.



                                    7-90

                         UNSCHEDULED SOFTWARE TASKS


        2.  All jobs that have been detached longer  than  five  minutes,
            provided  your  system  manager  has decided not to allow any
            detached jobs and has sufficiently warned all users of  this.
            This   means   you  should  log  out  all  users  whose  line
            designation in the output from SYSTAT  is  DET,  which  means
            detached.  However, you are never able to log out SYSJOB.

        3.  A job that a user has requested you  to  log  out  due  to  a
            problem.   Be sure the request is valid.  Then check that the
            job number the user wants you to  log  out  belongs  to  that
            user.   Do this by typing PUSH to OPR and then type SYSTAT n.
            For example:

                OPR>PUSH<RET>

                 TOPS-20 Command processor 7(31)
                @SYSTAT n<RET>
                      .
                      .
                @POP<RET>
                OPR>

            where n is the job number, and check that the  user  name  is
            correct.  If the name is correct, you can log out the job.

                            ----- Example -----

            If you want to log out job 7 and you do not have any  subjobs
            defined other than OPR, type:

                OPR>PUSH<RET>

                 TOPS-20 Command processor 7(31)
                @ENABLE<RET>
                $LOGOUT 7<RET>
                User TUCKER on TTY32, running EXEC
                [Confirm]<RET>
                $DISABLE<RET>
                @POP<RET>
                OPR>

                             ----- Hints -----

   Because there is no message printed on your terminal to indicate  that
   you  have  successfully  logged out another job, you can use SYSTAT to
   verify that the job is gone.  However, keep in mind that by  the  time
   you  give the SYSTAT command a user could already have that job number
   again.

   If you log out a job that was a subjob  of  PTYCON,  PTYCON  prints  a
   message about the subjob being killed.



                                    7-91

                         UNSCHEDULED SOFTWARE TASKS


                         ----- Error Messages -----

   ?ILLEGAL TO LOGOUT JOB 0

        You are not allowed to log out job 0 under which SYSJOB runs.

   ?THAT JOB DOES NOT EXIST

        You typed the wrong job number, or the job you  intended  to  log
        out is already logged out.

   ?WHEEL OR OPERATOR CAPABILITY REQUIRED TO LOGOUT ANOTHER JOB

        You must have WHEEL or OPERATOR capability.



   7.18  GENERATING ACCOUNTING REPORTS

   The USAG20 and USAH20 programs allow you to produce accounting reports
   from  system  accounting  data.   The  CHKPNT  program  enables you to
   include disk usage in these reports  and  makes  the  accounting  data
   available  to  USAG20  and  USAH20.   In  addition, the CHKPNT program
   allows you to change the accounting periods during normal operation.

   These accounting functions are  discussed  briefly  in  the  following
   sub-sections.   You  can  find more information in the TOPS-10/TOPS-20
   USAGE File Specification.

   You must discuss with your system manager the schedule  (if  any)  for
   performing these tasks.



   7.18.1  Getting Disk and System Usage with CHKPNT

   To include disk usage in the accounting reports and then make the disk
   and system usage available for reports, type to OPR:

        1.  PUSH

        2.  ENABLE

        3.  CHKPNT

        4.  DISK-STATISTICS structure:

            Repeat this command for each structure  for  which  you  want
            disk  usage.   If  you  omit  the  argument  structure:, your
            currently connected structure is used.




                                    7-92

                         UNSCHEDULED SOFTWARE TASKS


        5.  COPY (SYSTEM DATA TO) output file

            The output file can contain up  to  six  characters  for  the
            filename  and  three  characters  for  the file type.  It can
            later be used as the input  file  for  USAG20.   The  default
            filename is USAGE.OUT in your connected directory.

        6.  EXPUNGE (PROCESSED SYSTEM DATA)

        7.  EXIT

        8.  DISABLE

        9.  POP to return to OPR
                            ----- Example -----

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $CHKPNT<RET>
        CHKPNT>DISK-STATISTICS (FOR STRUCTURE) PS:<RET>
        CHKPNT>DISK-STATISTICS (FOR STRUCTURE) AK:<RET>
        CHKPNT>COPY (SYSTEM DATA TO) USAGE.OUT<RET>
        CHKPNT>EXPUNGE (PROCESSED SYSTEM DATA)<RET>
                [123 PAGES FREED]
        CHKPNT>EXIT (TO MONITOR)<RET>
        $DISABLE<RET>
        @POP<RET>
        OPR>

   If you do not want any reports on disk usage, omit Step 4 above.

   The EXPUNGE command to CHKPNT in  Step  6  deletes  and  expunges  all
   system  accounting data files already processed by the COPY command to
   CHKPNT.  If you want to save these files, you should rename them, copy
   them,  or  save them with DUMPER before you expunge them.  The file is
   called SYSTEM-DATA.BIN in BS:<ACCOUNTS>.  If you do not expunge  these
   files, the next COPY command to CHKPNT reprocesses them and makes them
   available to USAG20 or USAH20 again.

   If your system manager wants to change the accounting  period  between
   shifts  to  bill users at a different rate for the next shift, you can
   give the following command to the CHKPNT program:

        CHANGE (ACCOUNTING SHIFT NOW)<RET>

   This command causes a session end entry followed  by  a  session-start
   entry  for  every  active  job  in  the  system.   There is no visible
   indication to the user that an accounting shift change has occurred.




                                    7-93

                         UNSCHEDULED SOFTWARE TASKS


                         ----- Error Messages -----

   ?CHKPNT: COULD NOT FIND SYSTEM-DATA FILE
   ? JSYS ERROR: DIRECTORY ACCESS PRIVILEGES REQUIRED

        You typed the COPY command, but you do  not  have  privileges  to
        read  the  SYSTEM-DATA  files.   Be sure you are connected to the
        subjob OPR, logged in under OPERATOR, and ENABLEd.

   ? CHKPNT: GARBAGE AT END-OF-COMMAND

        You did not press RETURN or LINE FEED after a command.

   ? CHKPNT: INVALID FILENAME SPECIFIED

        Your file specification  contained  an  invalid  filename  or  an
        unmounted structure.

   ? CHKPNT: INVALID STRUCTURE NAME GIVEN

        You specified an unmounted structure, you forgot the colon  after
        the structure name, or you omitted the structure name.

   ? CHKPNT: NO SUCH CHKPNT COMMAND AS "xxx"

        You typed an invalid CHKPNT command.



   7.18.2  Reporting Usage with USAG20

   To get various cost summaries reported in a disk file, which can later
   be  printed  on  the  line printer and distributed, take the following
   steps.  First, be sure that you processed system accounting data  with
   the COPY command to CHKPNT.  You might or might not have included disk
   usage.   Second,  be  sure  you  have  USAG20.CHG  in  your  connected
   directory.   Your  system  manager  should  have created USAG20.CHG by
   using the information in the TOPS-10/TOPS-20 USAGE File Specification.
   Then, type to OPR:

        1.  PUSH

        2.  ENABLE

        3.  USAG20

        4.  input file specification

            This is the file output by the COPY command to CHKPNT in  the
            previous section.  The default is USAGE.OUT in your currently
            connected directory.



                                    7-94

                         UNSCHEDULED SOFTWARE TASKS


        5.  S or D

            S gives a report of system usage, and D  gives  a  report  of
            disk usage.  Press RETURN to get system usage, the default.

        6.  N or A

            N sorts the report by directory name, and A sorts the  report
            by account.  Press RETURN to get name, the default.

        7.  output file specification

            This is the file that contains the report.   The  default  is
            USAGE.RPT in your currently connected directory.

        8.  EXIT

        9.  PRINT output file specification/REPORT:argument

            The argument must correspond to the type of report requested.
            The type of report and arguments are:

                    Report             Argument

            System usage by name       NAME
            System usage by account    ACCOUNT
            Disk usage by name         DNAME
            Disk usage by account      DACCOUNT

       10.  DISABLE

       11.  POP to return to OPR

   If you want to produce different reports, after Step  5,  go  back  to
   Step 2.

   For easy identification you might use  an  output  file  specification
   that indicates the day or week of the report.
















                                    7-95

                         UNSCHEDULED SOFTWARE TASKS


                            ----- Example -----

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $USAG20<RET>
        TOPS20 ACCOUNTING SYSTEM
        READ USAGE FILE: USAGE.OUT<RET>
         INPUT FILE NAME: USAGE .OUT
        REPORT BY [SYSTEM USAGE (S) OR DISK USAGE (D)]: S<RET>
        SORT BY [NAME (N) OR ACCOUNT (A)]: N<RET>
        WRITE TO FILE: USAGE.RPT<RET>
         OUTPUT FILE NAME: USAGE .RPT
        READ USAGE FILE: EXIT<RET>

        EXIT

        $PRINT USAGE.RPT/REPORT:NAME<RET>
        [LPT:USAGE=/SEQ:105/LIMIT:100, 1 FILE]
        $DISABLE<RET>
        @POP<RET>
        OPR>

                              ----- Hint -----

   Refer to the TOPS10/TOPS20 USAGE  File  Specification  for  additional
   accounting information.

                         ----- Error Messages -----

   FILE CHARGE-FILE [USAG20.CHG] CANNOT BE OPENED ON DEVICE DSK

        When you run USAG20, you must have the file  USAG20.CHG  in  your
        connected  directory.  This file, which is created by your system
        manager, contains billing rates.

   FILE IN-FILE [inputfile] CANNOT BE OPENED ON DEVICE DSK

        The file that you want USAG20 to read must be in  your  connected
        directory.   Inputfile  is the filename and file type that USAG20
        interpreted from what you typed after READ USAGE FILE:  prompt.

   INCOMPLETE INPUT SPOOLER ENTRY

        USAG20 did not find all three records of an input-spooler  entry.
        Therefore, the other records of the entry are ignored.

   INCOMPLETE OUTPUT SPOOLER ENTRY

        USAG20 did not find all three records of an output-spooler entry.
        Therefore, the other records of the entry are ignored.


                                    7-96

                         UNSCHEDULED SOFTWARE TASKS


   INCOMPLETE SESSION ENTRY

        USAG20 did not  find  all  three  records  of  a  session  entry.
        Therefore, the other records of the entry are ignored.

   INPUT FILE ERROR:  inputfile

        You typed input file after the  READ  USAGE  FILE:   prompt,  but
        inputfile was not a valid filename and file type.
   OUTPUT FILE ERROR:  outputfile

        You typed outputfile after WRITE TO FILE:  prompt, but outputfile
        was not a valid filename and file type.









































                                    7-97


























































                                    8-1













                                 CHAPTER 8

                          SCHEDULED SOFTWARE TASKS



   As the operator, there  are  several  software  tasks  involving  both
   system  programs  and commands that you need to perform.  Some of them
   must be done on a daily basis and in a particular order.   Others  can
   be  done  less  frequently or only on request.  Your system manager or
   operations staff should establish a daily schedule,  (perhaps  divided
   into  by operator shifts, and weekly, monthly, or yearly schedules, if
   appropriate).

   The following sections in Chapter 8  discuss  in  chronological  order
   possible  scheduled  software tasks.  These tasks are the tasks you do
   after you ready the system for timesharing.   You  should  follow  the
   schedule  given  to  you by your system manager or operations staff to
   determine when you need to perform a task.

                                    NOTE

           For  you  to  perform  any  scheduled  software   task
           described  in  Chapter  8,  you  must  have  WHEEL  or
           OPERATOR capability.   If  either  capability  is  not
           needed  to  perform  the  task, it is mentioned in the
           description of the task.

|  Note that you can use the /CLUSTER-NODE:   switch  with  the  commands
|  described  in  this  chapter  to  affect  jobs on specified nodes in a
|  CFS-20 cluster.



   8.1  SETTING LOGINS-ALLOWED AND OPERATOR-IN-ATTENDANCE

   When the system is started, you must allow LOGINs on  the  appropriate
   terminals  and  indicate  that  you are present.  To do this, take the
   following steps:

        1.  Type PUSH to OPR.




                                    8-1

                          SCHEDULED SOFTWARE TASKS


        2.  Type ENABLE.

        3.  Give the INFORMATION (ABOUT) SYSTEM-STATUS command.

        4.  Use ^ESET LOGINS-ALLOWED if you need to  change  the  set  of
            terminals for LOGINs.

        5.  Use ^ESET OPERATOR-IN-ATTENDANCE, if necessary,  to  indicate
            that you are present.

        6.  Type POP to return to OPR.

   You can also use this procedure later to change the set  of  terminals
   from  which  LOGINs  are allowed, or to indicate that there is not any
   operator  present.   (Details  on  ^ESET  LOGINS-ALLOWED   and   ^ESET
   OPERATOR-IN-ATTENDANCE  are  given  in  the TOPS-20 Operator's Command
   Language Reference Manual.)

                            ----- Example -----

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(4430)
        @INFORMATION (ABOUT) SYSTEM-STATUS<RET>
|        Operator is in attendance
|        Remote logins allowed
|        Local logins allowed
|        Pseudo-terminal logins allowed
|        Internet TCP/IP terminal logins are not allowed
|        DECnet terminal logins allowed
|        LAT terminal logins allowed
|        Console terminal login allowed
|        Accounting is being done
|        Account validation is enabled
|        Working set preloading is disabled
|        Sending of system level zero messages is enabled
|        Sending of system level one messages is enabled
|        Job zero CTY output is enabled
|        Tape-drive allocation is enabled
|        Automatic file-retrieval-waits allowed
|        Maximum offline-expiration is 90 days
|        Scheduler bias-control setting is 11
|        Class scheduling is disabled, batch jobs being run on dregs
|       queue
|        Offline structures timeout interval is 0 minutes and 5 seconds
|        Cluster information is enabled
|        Cluster sendalls are enabled
|        Minimum password length is 8 characters
|        Password expiration is 45 days
|        Password dictionary is enabled
|       @



                                    8-2

                          SCHEDULED SOFTWARE TASKS


   Then to allow LOGINs on all terminals and indicate that an operator is
   present:

        @ENABLE<RET>
        $^ESET LOGINS-ALLOWED (ON) ANY-TERMINAL<RET>
        $^ESET OPERATOR-IN-ATTENDANCE<RET>
        $POP<RET>
        OPR>

                              ----- Hint -----

   You   can   put   the   initial   ^ESET   LOGINS-ALLOWED   and   ^ESET
   OPERATOR-IN-ATTENDANCE   commands  in  the  file  SYSTEM:n-SYSJOB.RUN.
   Decide with your system manager what ^ESET commands, if any,  need  to
   be  in  the  n-SYSJOB.RUN  file, and when you should manually change a
   ^ESET parameter.  It might be wise to put ^ESET LOGINS-ALLOWED ANY  in
   the  n-SYSJOB.RUN  file, but to make the operator on duty do the ^ESET
   OPERATOR-IN-ATTENDANCE.  Thus, if there is no operator  on  duty,  the
   status   is  NO  OPERATOR-IN-ATTENDANCE.   The  defaults,  before  the
   n-SYSJOB.RUN file  is  read,  are  LOGINS  ALLOWED  from  the  CONSOLE
   TERMINAL and PSEUDO-TERMINALS with NO OPERATOR-IN-ATTENDANCE.



   8.2  CREATING THE MESSAGE OF THE DAY WITH MAIL

   To send a message to all users of the system, do the following:

        1.  Type PUSH to OPR.

        2.  Enable capabilities.

        3.  Run MAIL.

        4.  After the TO:, type SYSTEM.

        5.  After the CC:, press RETURN.

        6.  Give the subject.

        7.  Type the message.

        8.  End the message with ESCape or CTRL/Z.

        9.  Type POP to return to OPR command level.

   The message is put into the file MAIL.TXT in PS:<SYSTEM>.  Then when a
   user   logs   in  to the system, the user receives on his terminal the
   messages that he has not seen before.  Also, as  soon  as  you  finish
   sending mail to SYSTEM, all on-line terminals receive the message:

        [NEW MESSAGE-OF-THE-DAY AVAILABLE]


                                    8-3

                          SCHEDULED SOFTWARE TASKS


   Users already logged in can then  read  the  new  message  by  running
   RDMAIL with the /M switch.

                            ----- Example -----

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $MAIL<RET>

        TO: SYSTEM<RET>
        CC:<RET>
        SUBJECT:CHRISTMAS<RET>
        MESSAGE (TERMINATE WITH ESC OR CTRL/Z):

        THE SYSTEM WILL BE UP FOR TIMESHARING ON CHRISTMAS DAY,<RET>
        BUT THERE WILL BE NO OPERATOR COVERAGE.<RET>
        <CTRL/Z>
        PROCESSING MAIL...
        NO ERRORS.
        -DONE-
        $POP<RET>
        OPR>

                             ----- Hints -----

   Never change the file PS:<SYSTEM>MAIL.TXT with an editor.  Always  use
   MAIL.

   If you receive a message from SYSJOB before or  while  trying  to  run
   MAIL, and the message indicates a problem with MAILER or INFO, restart
   MAILER or INFO (refer to Section 9.8).  Then type DIRECTORY  MAIL.CPY.
   If  the  file  is  not  found,  type  UNDELETE  MAIL.CPY.  Then do the
   following:

        1.  Type GET SYS:MAIL.

        2.  Type REENTER.

        3.  After FILE NAME OF MESSAGE FILE:, type MAIL.CPY.

        4.  After -DONE-, type DISABLE.











                                    8-4

                          SCHEDULED SOFTWARE TASKS


                            ----- Example -----

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $GET SYS:MAIL<RET>
        $REENTER<RET>

        FILE NAME OF MESSAGE FILE:MAIL.CPY<RET>

        PROCESSING MAIL...
        NO ERRORS.
        -DONE-
        $DISABLE<RET>
        @POP<RET>
        OPR>

                           ----- Error Messages -----

   ?COULD NOT SEND TO MAILER

        MAILER is hung or not running.  Restart it.

   ?MAILER DIED, MESSAGES NOT SENT

        Restart MAILER.

   PROCESSING MAIL...SYSTEM NOT SENT BECAUSE: reason

        The reason indicates why you could not send the mail.  Often, the
        reason  is WHEEL OR OPERATOR CAPABILITY REQUIRED.  If so, be sure
        that you are logged in under OPERATOR, which should have OPERATOR
        capability, and that you have typed ENABLE.

   PROCESSING MAIL...SYSTEM NOT SENT QUOTA EXCEEDED

        You cannot send the mail because the  directory  PS:<SYSTEM>  has
        exceeded its disk storage limit.



   8.3  ENTERING ACCOUNT VALIDATION DATA WITH EDIT

   To initially create and later  update  account  validation  data,  use
   EDIT.   Create  or  modify account entries as you are directed by your
   system manager.  Your system manager  must  also  tell  you  the  file
   specification of the base account validation file, if one exists.

   Type to OPR>:




                                    8-5

                          SCHEDULED SOFTWARE TASKS


        1.  PUSH

        2.  ENABLE

        3.  CONNECT STR:<directory containing file>

        4.  EDIT file

        5.  Commands to EDIT to add or modify entries in the file

        6.  EU

        7.  CONNECT

        8.  DISABLE

        9.  POP

   The base account  validation  file  contains  entries  for  each  base
   account  in  the  system.   The  format  of  the entries for each base
   account is:

        ACCOUNT name/SUBACCOUNT:file specification
        USER user name, user name,...
        DIRECTORY structure:<directory>
        GROUP (ON STRUCTURE) structure:/USER:user group number
        GROUP (ON STRUCTURE) structure:/DIRECTORY:directory group number

   Part of the format is optional, and some entries  can  be  given  more
   than once.

   Each entry can also specify an expiration date with:

        /EXPIRES:dd-mm-yy hh:mm

   When you place /EXPIRES:  after an account name, user name, directory,
   or  group number, the expiration date applies to that item only.  When
   you place /EXPIRES:   immediately  after  USER,  the  expiration  date
   applies to all user names.

   The various entries are briefly described below.

   ACCOUNT             Specifies the name of the base account.

   /SUBACCOUNT:        Specifies the file containing additional data  for
                       the  base  account.  The ACCOUNT entry allows only
                       one /SUBACCOUNT:.

   USER                Specifies  users  who  are  allowed  to  use   the
                       account.   An argument of * means all users of the
                       system.



                                    8-6

                          SCHEDULED SOFTWARE TASKS


   DIRECTORY           Specifies a directory.  Anyone with  write  access
                       to  the directory can use the account.  A * can be
                       used for the structure or directory  to  mean  all
                       structures or directories.

   GROUP               Specifies that the account can be used by  certain
                       user or directory groups on a structure.

   /CLASS:n            Specifies the numeric (n) class an account is in.

   /USER:              Modifies GROUP and specifies that the account  can
                       be used by this user group.

   /DIRECTORY:         Modifies GROUP and specifies that the account  can
                       be used by this directory group.

                            ----- Example -----

   To add a new base account to PS:<ACCOUNTS>ACCOUNTS.TXT, type:

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $CONNECT <ACCOUNTS><RET>
        $EDIT ACCOUNTS.TXT<RET>
        Edit: ACCOUNTS.TXT.3
        *I10;10<RET>
        00010  ACCOUNT LUMBER/SUBACCOUNT:<FORESTRY>ACCTS.TXT<RET>
        00020   USER MILLER,JACK,HACKSAW<RET>
        00030<ESC>
        *EU<RET>

        [ACCOUNTS.TXT.4]
        $CONNECT<RET>
        $DISABLE<RET>
        @POP<RET>
        OPR>

                              ----- Hint -----

   Refer to the TOPS-20 User's Guide for more  information  on  the  EDIT
   program.



   8.4  UPDATING THE ACCOUNT VALIDATION DATA BASE WITH ACTGEN

   After you change account validation data with EDIT or after a  project
   administrator  changes  a  subaccount file, you must run ACTGEN before
   the new data is effective.



                                    8-7

                          SCHEDULED SOFTWARE TASKS


   Type to OPR>:

        1.  PUSH

        2.  ENABLE

        3.  CONNECT PS:<ACCOUNTS>

        4.  ACTGEN

        5.  TAKE file specification

            Specify the base account validation file used in the previous
            section.

        6.  INSTALL

        7.  EXIT

        8.  DELETE ACCOUNTS-TABLE.BIN,

        9.  KEEP 1

       10.  <RET>

       11.  CONNECT

       12.  DISABLE

       13.  POP

                            ----- Example -----

        OPR>PUSH<RET>

         TOPS-20 Command Processor 7(31)
        @ENABLE<RET>
        $CONNECT PS:<ACCOUNTS><RET>
        $ACTGEN<RET>
        ACTGEN>TAKE (COMMANDS FROM) ACCOUNTS.TXT<RET>
        ACTGEN>INSTALL (NEW ACCOUNT VALIDATION DATA BASE)<RET>
        ACTGEN>EXIT (TO MONITOR)<RET>
        $DELETE ACCOUNTS-TABLE.BIN,<RET>
        $KEEP 1<RET>
        $<RET>
         ACCOUNTS-TABLE.BIN.2 [OK]
        $CONNECT<RET>
        $DISABLE<RET>
        @POP<RET>
        OPR>




                                    8-8

                          SCHEDULED SOFTWARE TASKS


                         ----- Error Messages -----

   ? ACTGEN:  GARBAGE AT END-OF-COMMAND

        Press RETURN at the end of a command.

   ? ACTGEN:  INVALID FILE SPECIFICATION, FILE NOT FOUND

        The file you specified was not found.  Check the directory of the
        file.

   ? ACTGEN:  NO SUCH ACTGEN COMMAND AS "xxx"

        You typed the command "xxx" to ACTGEN and  it  was  not  a  valid
        command,  or  in  the  file you specified for the TAKE command to
        ACTGEN there is an invalid entry beginning with "xxx".

   ? INCORRECT FIELD: xxx  IN ENTRY: aaa
   IN FILE:        file specification

        In the file you specified for the TAKE  command  to  ACTGEN,  the
        field  xxx  was  incorrect  in entry aaa.  If the field is a file
        specification, check that the  file  exists  in  the  appropriate
        directory.



   8.5  ADDING, CHANGING, AND DELETING DIRECTORIES WITH ^ECREATE

   If you need to add a directory or user  name  to  the  system,  or  to
   change  some  directory  parameters,  or  delete  a directory from the
   system, use the ^ECREATE command.



   8.5.1  Adding Directories for Users

   To give users the ability to log in to the  system,  you  must  create
   directories  for  them  on  PS:,  the  public structure.  Use the name
   approved by your system manager for the directory name for a user.

                                    NOTE

           By default, the public structure is the boot structure
           (BS:),  also  known as the system structure.  However,
           if  your  system  manager  has  enabled   the   "login
           structure"   facility,   PS:    points  to  the  login
           structure.

   If the directory name contains a  ".",  for  example,  <C.SMITH>,  the
   directory   is   actually   a   subdirectory.   Before  you  create  a
   subdirectory, you must first have created its superior  directory,  in


                                    8-9

                          SCHEDULED SOFTWARE TASKS


   this  case  <C>.   You  can  determine  the  superior  directory for a
   subdirectory by using the name of the subdirectory and eliminating the
   last  "."  and  the  characters  after  it.  For example, the superior
   directory for <AL.BROWN> is  <AL>,  and  the  superior  directory  for
   <B.BLACK.1> is <B.BLACK>.

   To create a directory with default parameters, type to OPR>:

        1.  PUSH

        2.  ENABLE

        3.  ^ECREATE PS:<directory> password

        4.  <RET> to finish

        5.  DISABLE

        6.  POP

                                    NOTE

           If you are connected to structure PS:   when  you  are
           creating  a  directory  to allow a user to log in, you
           can omit PS:  in the ^ECREATE command.

                            ----- Example -----

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $^ECREATE PS:<NATHANIEL> MATTHEW<RET>
        [NEW]
        $$<RET>
        $DISABLE<RET>
        @POP<RET>
        OPR>

   To create a directory with some nondefault values, type to OPR>:

        1.  PUSH

        2.  ENABLE

        3.  ^ECREATE PS:<directory>

        4.  PASSWORD password

        5.  Other nondefault parameters and arguments, if any




                                    8-10

                          SCHEDULED SOFTWARE TASKS


        6.  <RET> to finish

        7.  DISABLE

        8.  POP

   (Refer to the TOPS-20 Operator's Command Language Reference Manual for
   a description of ^ECREATE commands to set directory parameters.)

                            ----- Example -----

   In this example, assume that subjob 0 is connected  to  structure  PS:
   and that <G> already exists and allows subdirectories.

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $^ECREATE PS:<G.PLAZA><RET>
        [NEW]
        $$PASSWORD STACHIA<RET>
        $$ACCOUNT-DEFAULT TEXTILES<RET>
        $$WORKING (DISK STORAGE PAGE LIMIT) 900<RET>
        $$PERMANENT (DISK STORAGE PAGE LIMIT) 600<RET>
        $$<RET>
        $DISABLE<RET>
        @POP<RET>
        OPR>



   8.5.2  Adding Directories on Mountable Structures

   To create a directory  which  a  user  can  CONNECT  to  or  ACCESS  a
   directory on a structure other than PS:  or BS:, type to OPR>:

        1.  PUSH

        2.  ENABLE

        3.  MOUNT STRUCTURE STR:

        4.  ^ECREATE str:<directory>

        5.  Any nondefault parameters

        6.  <RET> to finish

        7.  DISMOUNT STRUCTURE STR:

        8.  DISABLE



                                    8-11

                          SCHEDULED SOFTWARE TASKS


        9.  POP

                            ----- Example -----

        OPR>PUSH<RET>

         TOPS-20 Command Processor 7(31)
        @ENABLE<RET>
        $MOUNT STRUCTURE 4SQM:<RET>
        STRUCTURE 4SQM: mounted
        $^ECREATE 4SQM:<TESTQ><RET>
        [NEW]
        $$PASSWORD KITS<RET>
        $$<RET>
        $DISMOUNT STRUCTURE 4SQM:<RET>
        STRUCTURE 4SQM: dismounted
        $DISABLE<RET>
        @POP<RET>
        OPR>



   8.5.3  Adding Files-Only Directories

   To create a directory that no one can log in to but that is used  only
   to store files, type to OPR>:

        1.  PUSH

        2.  ENABLE

        3.  ^ECREATE structure:<directory>

        4.  FILES-ONLY

        5.  Other nondefault parameters and arguments, if any

        6.  <RET> to finish

        7.  DISABLE

        8.  POP

   You can specify the structure name in Step 3 or omit  it  to  indicate
   your currently connected structure.









                                    8-12

                          SCHEDULED SOFTWARE TASKS


                            ----- Example -----

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $^ECREATE <FORTRAN-DATA><RET>
        [NEW]
        $$FILES-ONLY<RET>
        $$WORKING (DISK STORAGE PAGE LIMIT) 2000<RET>
        $$PERMANENT (DISK STORAGE PAGE LIMIT) 2000<RET>
        $$DIRECTORY-GROUP 17<RET>
        $$<RET>
        $DISABLE<RET>
        @POP<RET>
        OPR>
                              ----- Hint -----

   A password is optional for a  FILES-ONLY  directory.   (Refer  to  the
   TOPS-20  Operator's  Command  Language Reference Manual for additional
   information on the FILES-ONLY subcommand of the ^ECREATE command.)



   8.5.4  Changing Directory Parameters

   To simply change a password, type to OPR>:

        1.  PUSH

        2.  ENABLE

        3.  ^ECREATE structure:<directory> new-password

        4.  DISABLE

        5.  POP

   You can omit the structure name in Step 3 if you are connected to  the
   structure containing the directory.

                            ----- Example -----

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $^ECREATE <MCKIE> PQXY<RET>
        [OLD]
        $$<RET>
        $DISABLE<RET>
        @POP<RET>
        OPR>

                                    8-13

                          SCHEDULED SOFTWARE TASKS


   To change other directory parameters, type to OPR>:

        1.  PUSH

        2.  ENABLE

        3.  ^ECREATE structure:<directory>

        4.  Parameters and new values

        5.  <RET> to finish

        6.  DISABLE

        7.  POP

                            ----- Example -----

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $^ECREATE QAT:<GOLDSTEIN><RET>
        [OLD]
        $$IPCF<RET>
        $$WORKING (DISK STORAGE PAGE LIMIT) 1000<RET>
        $$<RET>
        $DISABLE<RET>
        @POP<RET>
        OPR>



   8.5.5  Changing Directory Names

   To change a directory name, create a temporary directory,  rename  the
   user's  files  into  it, list the parameters of the directory that you
   are changing, and then kill it.  Then create a new directory with  the
   correct  name and parameters, rename the user's files into it from the
   temporary directory, and kill the temporary directory.

   The procedure for changing a  directory  name  is  given  below.   The
   structure  argument  must  be the name of the structure containing the
   directory you want to change.  You can omit Steps  3  and  24  if  the
   structure is PS:  or BS:.

   Type to OPR>:

        1.  PUSH

        2.  ENABLE

        3.  MOUNT STRUCTURE structure name:

                                    8-14

                          SCHEDULED SOFTWARE TASKS


        4.  CONNECT structure:

        5.  ^ECREATE <temporary-directory>

        6.  FILES-ONLY

        7.  Other directory parameters; be sure  that  the  disk  storage
            page  limits  are  large enough to accommodate the files from
            the old directory that you are changing

        8.  <RET> to finish creating the directory

        9.  RENAME
            <old-directory>*.*.* (TO BE) <temporary-directory>*.*.*

       10.  ^ECREATE <old-directory>

       11.  LIST

       12.  KILL

       13.  <RET> to [CONFIRM]

       14.  <RET> to finish killing the directory

       15.  ^ECREATE <new-directory>

       16.  Directory parameters output by LIST in Step 11

       17.  <RET> to finish creating the directory

       18.  RENAME<temporary-directory>*.*.* (TO BE) <new-directory>*.*.*

       19.  ^ECREATE <temporary-directory>

       20.  KILL

       21.  <RET> to [CONFIRM]

       22.  <RET> to finish killing the directory

       23.  CONNECT

       24.  DISMOUNT STRUCTURE str:

       25.  DISABLE

       26.  POP






                                    8-15

                          SCHEDULED SOFTWARE TASKS


                            ----- Example -----

   This example shows how to change a directory on TST:   from  RINKO  to
   HRINKO.

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $MOUNT STRUCTURE TST:<RET>
        $CONNECT TST:<RET>
        $^ECREATE <TMPDIR><RET>
        [NEW]
        $$FILES-ONLY<RET>
        $$WORKING (DISK STORAGE PAGE LIMIT) 500<RET>
        $$PERMANENT (DISK STORAGE PAGE LIMIT)500<RET>
        $$<RET>
        $RENAME (EXISTING FILE) <RINKO>*.*.* (TO BE) <TMPDIR>*.*.*<RET>
         <RINKO>A..2 => <TMPDIR>A..2 [OK]
         <RINKO>SORT.MAC.1 => <TMPDIR>SORT.MAC.1 [OK]
         <RINKO>TEST..1 => <TMPDIR>TEST..1 [OK]
        $^ECREATE <RINKO><RET>
        [OLD]
        $$LIST<RET>
         NAME <RINKO>
         WORKING DISK STORAGE PAGE LIMIT 350
         PERMANENT DISK STORAGE PAGE LIMIT 350
         NUMBER OF DIRECTORY 24
         LAST LOGIN 5-MAR-87 16:03:25

        $$KILL<RET>
        [CONFIRM]<RET>
        $$<RET>
        $^ECREATE <HRINKO><RET>
        [NEW]
        $$PASSWORD HELEN<RET>
        $$WORKING (DISK STORAGE PAGE LIMIT) 350<RET>
        $$PERMANENT (DISK STORAGE PAGE LIMIT) 350<RET>
        $$NUMBER (OF DIRECTORY) 24<RET>
        $$<RET>
        $RENAME (EXISTING FILE) <TMPDIR>*.*.* (TO BE) <HRINKO>*.*.*<RET>
         <TMPDIR>A..2 => <HRINKO>A..2 [OK]
         <TMPDIR>SORT.MAC.1 => <HRINKO>SORT.MAC.1 [OK]
         <TMPDIR>TEST..1 => <HRINKO>TEST..1 [OK]










                                    8-16

                          SCHEDULED SOFTWARE TASKS


        $^ECREATE <TMPDIR><RET>
        [OLD]
        $$KILL<RET>
        [CONFIRM]<RET>
        $$<RET>
        $CONNECT<RET>
        $DISMOUNT TST:<RET>
        $DISABLE<RET>
        $POP<RET>
        OPR>
        1:02:23            -- Structure TST: Dismounted --
        OPR>



   8.5.6  Deleting User Names or Directories

   To delete a user name or directory from the system, type to OPR>:

        1.  PUSH

        2.  ENABLE

        3.  ^ECREATE structure:<directory>

        4.  KILL

        5.  <RET> to [CONFIRM]

        6.  <RET> to finish

        7.  POP

   You can omit the structure name in Step 3 if you are connected to  the
   structure containing the directory.

                            ----- Example -----

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $^ECREATE BASIC:<HJOHN><RET>
        [OLD]
        $$KILL<RET>
        [CONFIRM]<RET>
        $$<RET>
        $POP<RET>
        OPR>





                                    8-17

                          SCHEDULED SOFTWARE TASKS


                                    NOTE

           When you kill a directory, you  delete  the  files  in
           that directory.  Do not kill a user's directory if the
           user is logged in, because you would not  be  able  to
           free  his job number until you reload TOPS-20.  If you
           need to log out the user, use the LOGOUT command,  and
           then  KILL  the  directory.   If  you  cannot  kill  a
           directory, see the KILL  subcommand  to  the  ^ECREATE
           command  in  the  TOPS-20  Operator's Command Language
           Reference Manual.

   Your system manager should have a form that new users can complete  to
   request  access  to  the system.  A sample form is printed on the next
   page.







































                                    8-18

                          SCHEDULED SOFTWARE TASKS


                            USER ACCOUNT REQUEST


   REQUESTOR'S NAME:                                    DATE:

   SUPERVISOR:

                            --------------------

   NAME OF DIRECTORY:                                   PASSWORD:

   PERMANENT STORAGE ALLOCATION (PAGES):                ACCOUNT:

   WORKING STORAGE ALLOCATION (PAGES):

                            --------------------

   OPTIONAL ATTRIBUTES

   NUMBER OF GENERATIONS TO KEEP (DEFAULT IS 1):

   STANDARD FILE PROTECTION (DEFAULT IS 777700):

   PROTECTION OF DIRECTORY (DEFAULT IS 777700):

   DIRECTORY GROUPS:

   USER-OF-GROUPS:

   MAXIMUM SUBDIRECTORIES ALLOWED:

   SUBDIRECTORY USER GROUPS ALLOWED:

   FILES-ONLY?

   CONFIDENTIAL INFORMATION ACCESS CAPABILITY?

   MAINTENANCE CAPABILITY?

   OPERATOR CAPABILITY?

   WHEEL CAPABILITY?

   IPCF CAPABILITY?

   ENQ-DEQ CAPABILITY?








                                    8-19

                          SCHEDULED SOFTWARE TASKS


                        DO NOT WRITE BELOW THIS LINE
                            --------------------

   APPROVED BY:                                         DATE:

   IMPLEMENTED BY:                                      DATE:

   DIRECTORY NUMBER ASSIGNED:














































                                    8-20

                          SCHEDULED SOFTWARE TASKS


   8.6  DUMPING DIRECTORY PARAMETERS WITH DLUSER

   Once you add, change, or delete a directory, you should run DLUSER  to
   get  a  backup copy of the directory parameters defined with ^ECREATE.
   Also, if your installation allows users to change directory parameters
   with  SET DIRECTORY or to create subdirectories with BUILD, you should
   get this backup copy periodically at a time scheduled by  your  system
   manager.   The backup copy can be used to restore directory parameters
   when you are recovering part of the file system.

   The following three sections explain how to dump directory parameters:

        1.  Dump directory parameters for the system structure, BS:,  and
            create  a  system  backup  tape.   This  tape  is helpful for
            restoring directories.  (See Section 8.6.1)

        2.  Dump directory parameters  for  structures  other  than  BS:.
            Section 8.6.2

        3.  Use DLUSER.  (See Section 8.6.3)



   8.6.1  Dumping Directory Parameters for BS:

   You should put a backup copy of directory  parameters  for  BS:   onto
   magnetic   tape.    For   ease  in  restoring  the  directories  after
   re-creating the file  system,  you  should  also  have  the  following
   critical system programs on the same tape as the directory parameters.

        1.  BS:<SYSTEM>MONITR.EXE

        2.  SYSTEM:EXEC.EXE

        3.  SYS:DLUSER.EXE

        4.  SYS:DUMPER.EXE

        5.  All files from BS:<NEW-SYSTEM> and BS:<SYSTEM>

        6.  All files from BS:<NEW-SUBSYS> and BS:<SUBSYS>

        7.  All files from BS:UETP.LIB











                                    8-21

                          SCHEDULED SOFTWARE TASKS


   To dump user directories  from  BS:   with  DLUSER  and  put  them  on
   magnetic  tape  along  with the files listed above, type PUSH to OPR>.
   Then:

        1.  Type SUBMIT SYS:SYSTAP.CTL.

        2.  Wait until SYSTAP.LOG and SYSTAP.LPT are printed on the  line
            printer.

        3.  Look at the two printed files.  If there are errors, try  the
            SUBMIT command again or notify your system manager.

        4.  Once the control file runs without  error,  file  the  backup
            tape along with the two listings.

                            ----- Example -----

        OPR>PUSH<RET>
         TOPS-20 Command processor 7(31)
        @SUBMIT SYS:SYSTAP.CTL<RET>
        [JOB SYSTAP QUEUED, REQUEST-ID 2745, LIMIT 0:05:00]
        @POP<RET>
        OPR>



   8.6.2  Dumping Directory Parameters for Other Structures

   If there are other structures in addition to BS:  on your system,  put
   a backup copy of the directory parameters for each of those structures
   into files SYSTEM:str.TXT, where str: is the relevant structure  name.
   If  it  is not the system structure, you can also use OPR to MOUNT and
   DISMOUNT the structure.

   For each structure, type to OPR>:

        1.  PUSH

        2.  ENABLE

        3.  MOUNT STRUCTURE str:

        4.  DLUSER

        5.  STRUCTURE str:

        6.  DUMP SYSTEM:str.TXT







                                    8-22

                          SCHEDULED SOFTWARE TASKS


        7.  EXIT

        8.  DISMOUNT STRUCTURE str:

        9.  DISABLE

       10.  POP

                            ----- Example -----

   To get a backup copy of the directory parameters for SNARK:

        OPR>PUSH<RET>

         TOPS-20 Command Processor 7(31)
        @ENABLE<RET>
        $MOUNT STRUCTURE SNARK:<RET>
        $DLUSER<RET>
        DLUSER>STRUCTURE SNARK:<RET>
        DLUSER>DUMP BS:<SYSTEM>SNARK.TXT<RET>

        DONE.
        DLUSER>EXIT<RET>
        $DISMOUNT STRUCTURE SNARK:<RET>
        STRUCTURE SNARK: dismounted
        $DISABLE<RET>
        @POP<RET>
        OPR>



   8.6.3  Using DLUSER

   The following discussion gives more detail on DLUSER if  you  want  to
   run it from your terminal.

   Once DLUSER is running, it outputs DLUSER> as its prompt.  Then, after
   it  finishes  a  command, it outputs the prompt again.  You can type ?
   after the prompt to get a list of the DLUSER commands.   While  DLUSER
   is  processing a DUMP or LOAD command, you can find out what directory
   it is currently working on by typing CTRL/A.  When you type CTRL/A you
   receive the message:

        WORKING ON DIRECTORY structure:<directory>










                                    8-23

                          SCHEDULED SOFTWARE TASKS


   The commands to DLUSER are:

        DUMP filespec      specifies to dump directory parameters into  a
                           file  specification  (filespec).   The default
                           file specification is DSK:USERS.TXT.

        EXIT               specifies to exit from DLUSER  and  return  to
                           the monitor.

        HELP               specifies   to   display   a   help    message
                           summarizing  the  functions  and  commands  of
                           DLUSER.

        LOAD filespec      specifies to load directory parameters from  a
                           file specification (filespec).

        STRUCTURE name     specifies the structure name  (name)  that  is
                           used  for  the  DUMP  or  LOAD  command.   The
                           default is your connected structure.



































                                    8-24

                          SCHEDULED SOFTWARE TASKS


                         ----- Error Messages -----

   ? GROUP BLOCK IS TOO SMALL, ABORTING ...

        If this error occurs, notify the person  responsible  for  system
        software at your installation.

   ? INVALID COMMAND CONFIRMATION

        You pressed a key other than RETURN or LINE FEED after a command.

   ? INVALID STRUCTURE NAME GIVEN

        You specified a structure that is not mounted, or you forgot  the
        colon after the structure name.

   ? NOT A DLUSER COMMAND

        The command that you typed is not a valid DLUSER command.

   ? UNABLE TO GET FIRST DIRECTORY

        There is a problem on the structure for  which  you  are  running
        DLUSER.   The  file  you are dumping is not complete.  Run CHECKD
        with the CHECK BITTABLE command to determine the problems on  the
        structure.
   ? UNABLE TO GET NEXT DIRECTORY

        There is a problem on the structure for  which  you  are  running
        DLUSER.   The  file  you are dumping is not complete.  Run CHECKD
        with the CHECK BITTABLE command to determine the problems on  the
        structure.






















                                    8-25

                          SCHEDULED SOFTWARE TASKS


   8.7  GETTING INFORMATION ABOUT DIRECTORIES

   To check various  directory  parameters  or  to  provide  your  system
   manager  with  certain directory information, you can use the ^ECREATE
   command, the ^EPRINT command, or the  ULIST  program.   The  following
   three sections show what each one can list for you.

   If you decide to change any parameters after you have listed them,  be
   sure to run DLUSER (Section 8.6.3) and dump the directories.



   8.7.1  Listing Directory Parameters with ^ECREATE

   If you expect to change some  directory  parameters,  this  method  is
   useful.

   To list all the parameters of one  directory,  use  the  LIST  VERBOSE
   command  to  ^ECREATE.   To  list only nondefaulted parameters for the
   directory, use the LIST command to ^ECREATE.  Type to OPR>:

        1.  PUSH

        2.  ENABLE

        3.  ^ECREATE structure:<directory>

        4.  LIST VERBOSE or LIST

        5.  DISABLE

        6.  POP

   You can omit the structure name in Step 3 if you are connected to  the
   structure   containing  the  directory.   You  can  also  change  some
   parameters after listing them.  (See the  TOPS-20  Operator's  Command
   Language Reference Manual for details on the ^ECREATE command.)

   The LIST VERBOSE subcommand to ^ECREATE outputs the  same  information
   as  ^EPRINT  directory  VERBOSE, and LIST to ^ECREATE is equivalent to
   ^EPRINT directory.  The advantage of  using  the  LIST  subcommand  to
   ^ECREATE, instead of ^EPRINT, is that you can immediately give another
   subcommand to ^ECREATE.











                                    8-26

                          SCHEDULED SOFTWARE TASKS


                            ----- Examples -----

        1.  To list all parameters:

            OPR>PUSH<RET>

             TOPS-20 Command processor 7(4430)
            @ENABLE<RET>                 
            $^ECREATE <HESS><RET>
            [OLD]
            $$LIST VERBOSE<RET>
             NAME <HESS>
|            Working disk storage page limit 1540
|            Permanent disk storage page limit 1540
|            not WHEEL
|            not OPERATOR
|            not CONFIDENTIAL INFORMATION ACCESS
|            not MAINTENANCE
|            not IPCF
|            not ENQ-DEQ
|            not FILES-ONLY
|            not SECURE
|            Number of directory 154
|            Default file protection 777700
|            Account default for LOGIN - none set
|            Protection of directory 777700
|            Generations to keep 1
|            Maximum subdirectories allowed 15
|            Never logged in interactively
|            Never logged in non-interactively
|            Password expiration date not set
|            No interactive login failures
|            No non-interactive login failures
|            User of groups - none set
|            Directory groups - none set
|            Subdirectory user groups allowed - none set
|            Online expiration default 60 Days
|            Offline expiration default 90 Days
|            TOPS10 project-programmer number - none set















                                    8-27

                          SCHEDULED SOFTWARE TASKS


        2.  To list nondefaulted parameters:

            $^ECREATE (DIRECTORY NAME) ARCH:<MURPHY><RET>
            [OLD]
            $$LIST<RET>
             NAME ARCH:<MURPHY>
|            Working disk storage page limit 1540
|            Permanent disk storage page limit 1540
|            Number of directory 154
|            Account default for LOGIN - none set
|            Maximum subdirectories allowed 15
|            TOPS10 project-programmer number - none set

            $$<RET>



   8.7.2  Listing Directory Parameters with ^EPRINT

   To list all the parameters of one directory, use the  ^EPRINT  command
   with  the  VERBOSE  subcommand.  To list only nondefaulted parameters,
   use ^EPRINT with no subcommands.  Type to OPR>:

        1.  PUSH

        2.  ENABLE

        3.  ^EPRINT structure:<directory>,
            VERBOSE
            <RET>

            or

            ^EPRINT structure:<directory>

        4.  POP

   You can omit the structure name in Step 3 if you are connected to  the
   structure containing the directory.

   After you get the list of parameters with ^EPRINT, you must  then  use
   ^ECREATE to change any of them.












                                    8-28

                          SCHEDULED SOFTWARE TASKS


                            ----- Examples -----

        1.  To list the nondefaulted parameters of a directory:

            OPR>PUSH<RET>

             TOPS-20 Command processor 7(4430)
            @ENABLE<RET>
            $^EPRINT <N.ROSEN><RET>
|            NAME PS:<N.ROSEN>
|            Working disk storage page limit 1540
|            Permanent disk storage page limit 1540
|            Number of directory 154
|            Account default for LOGIN - none set
|            Maximum subdirectories allowed 15
|            TOPS10 project-programmer number - none set

        2.  To list all the parameters of a directory:

            OPR>PUSH<RET>

             TOPS-20 Command processor 7(4430)
            $^EPRINT <CPERLMAN>,<RET>
            $$VERBOSE<RET>
            $$<RET>
|            Name GIDNEY:<CPERLMAN>
|            Working disk storage page limit 1540
|            Permanent disk storage page limit 1540
|            not WHEEL
|            not OPERATOR
|            not CONFIDENTIAL INFORMATION ACCESS
|            not MAINTENANCE
|            not IPCF
|            not ENQ-DEQ
|            not FILES-ONLY
|            not SECURE
|            Number of directory 154
|            Default file protection 777700
|            Account default for LOGIN - none set
|            Protection of directory 777700
|            Generations to keep 1
|            Maximum subdirectories allowed 15
|            Never logged in interactively
|            Never logged in non-interactively
|            Password expiration date not set
|            No interactive login failures
|            No non-interactive login failures
|            User of groups - none set
|            Directory groups - none set
|            Subdirectory user groups allowed - none set
|            Online expiration default 60 Days
|            Offline expiration default 90 Days


                                    8-29

                          SCHEDULED SOFTWARE TASKS


|            TOPS10 project-programmer number - none set

            $DISABLE<RET>
            @POP<RET>
            OPR>



   8.7.3  Listing Directory Parameters with ULIST

   The ULIST program can give you four types of listings:

        1.  An alphabetic list of all directories on a structure and  all
            the directory parameters

        2.  A numeric list of directories on  a  structure  according  to
            directory numbers and all the directory parameters

        3.  A mini-listing containing only directory numbers and names on
            a structure

        4.  A  directory  group  listing  giving  groups  used,   highest
            directory  in  use,  first free directory, the directories in
            each group, the users having access to each group, the  users
            with   special   capabilities,   and   directories  that  are
            files-only.

   To run ULIST, you must have OPERATOR or WHEEL capability, but  you  do
   not need to type ENABLE.  Type PUSH to OPR> and type:

        1.  ULIST

        2.  ULIST commands, separated by <RET>,  to  select  the  desired
            type and format of listing

        3.  BEGIN to start the listing

        4.  EXIT to return to TOPS-20 command level

   When ULIST is running,  it  prompts  with  ULIST>  for  each  command.
   Follow  each  command  with <RET>.  To see the commands to ULIST, type
   HELP as the command.  For example:












                                    8-30

                          SCHEDULED SOFTWARE TASKS


        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ULIST<RET>
        ULIST>HELP<RET>

        COMMANDS ARE:


        ALPHABETIC (LIST OF USERS)
        BEGIN (LISTING)          [Starts outputting the listing]
        DIRECTORY (GROUP LISTING)
        EXIT (TO MONITOR)
        HELP
        MINI (LISTING FORMAT)    [Name & directory number only]
        NARROW (PAPER FORMAT)
        NUMERIC (LIST OF USERS)
        OUTPUT (TO FILE) FILE-SPEC
        PRINT (LISTING ON PRINTER)
        STRUCTURE (TO USE) STR-NAME
        WIDE (PAPER FORMAT)


        ASSUMED ARE: NUMERIC, WIDE, OMIT, AND OUTPUT TO TTY:
        ULIST>

   The  different  types  of  lists  are  obtained  with   the   commands
   ALPHABETIC,  NUMERIC,  MINI, and DIRECTORY.  These commands correspond
   to the explanations at the beginning of this section.  If you  do  not
   specify  the type of list, NUMERIC is assumed.  Each of these commands
   produces a different listing.

   If you want the output on narrow paper (80 columns), give  the  NARROW
   command because WIDE (132 columns) is the default.

   The listing is printed on your terminal, because output  to  TTY:   is
   the  default,  unless you give the OUTPUT or PRINT command.  The PRINT
   command gives you a listing on the line printer.  OUTPUT followed by a
   file  specification puts the listing into the file given.  The default
   file for the OUTPUT command is USERS.TXT.














                                    8-31

                          SCHEDULED SOFTWARE TASKS


                            ----- Examples -----

        1.  To produce a numeric list of directories on  structure  SNARK
            on   the  printer  with  narrow  paper,  give  the  following
            commands.

            OPR>PUSH<RET>

             TOPS-20 Command processor 7(31)
            @ULIST<RET>
            ULIST>PRINT<RET>
            ULIST>STRUCTURE SNARK:<RET>
            ULIST>NARROW<RET>
            ULIST>BEGIN<RET>
             DONE

            ULIST>EXIT<RET>
            @POP<RET>
            OPR>

            The line printer listing starts as follows:

   NAME,ACCOUNT    (STRUCTURE: SNARK)      WED 5-MAR-87     PAGE 1
     DIR#   PRIVILEGES  LOGIN-QUOTA LOGOUT-QUOTA USER-OF-GROUPS  DIR-GROUPS
   (   MODES     DEF-FILE-PRO   DIR-PROT   DEF-FILE-RET )

   SNARK:<ROOT-DIRECTORY>
         1            0         4700         4700
   (600000000000 500000777700 500000777700            1 )
   SNARK:<SYSTEM>
         2            0         7000         7000
   (600000000000 500000777752 500000777740            0 )
   SNARK:<SUBSYS>
         3            0        10000         4800                      1
   (600000000000 500000777752 500000770000            1 )
   SNARK:<ACCOUNTS>
         4            0        10000        10000
   (600000000000 500000777700 500000777700            0 )
   SNARK:<OPERATOR>,390
         5       300000         2000         2000   2479,2480
   SNARK:<SPOOL>
         6            0         2000          150
   (600000000000 500000777700 500000777777            0 )
   SNARK:<TES>,QA
         20       0              250         250        5,4,7 2,4
   (200000000000 500000777700 500000777740            1 )

            Thus,  the  listing  is  in  ascending  order  according   to
            directory   number.   The  line  beginning  and  ending  with
            parentheses is omitted if the values for  the  parameters  in
            that line are system defaults.



                                    8-32

                          SCHEDULED SOFTWARE TASKS


   For each directory the following values are given:

        NAME

             This is the directory name.

        ACCOUNT

             This is the default account for a user logging into the
             directory.
        DIR-#

             This is the number of the directory.

        PRIVILEGES

             This is the right half of the capability word (bits 18-35).

             Bit 18=1 allows WHEEL capability
             Bit 19=1 allows OPERATOR capability
             Bit 20=1 allows CONFIDENTIAL INFORMATION ACCESS capability
             Bit 21=1 allows MAINTENANCE capability
             Bit 22=1 allows IPCF capability
             Bit 23=1 allows ENQ-DEQ capability
             Bit 24=1 allows NET-WIZARD privileges
             Bit 25=1 allows NETWORK ABSOLUTE SOCKET privileges
             Bit 26=1 allows DECnet access
             Bit 27=1 allows ARPANET access

        LOGIN-QUOTA

             This is the number of pages for working  disk  storage  page
             limit.

        LOGOUT-QUOTA

             This is the number of pages for permanent disk storage  page
             limit.

        USER-OF-GROUPS

             This indicates which directory groups the user can access.

        DIR-GROUPS

             This indicates which directory groups this directory is in.








                                    8-33

                          SCHEDULED SOFTWARE TASKS


        MODES

             This is the mode word of the directory (bits 0 to 35).

             Bit  0=1  allows  a  FILES-ONLY  directory  Bit  1=1  allows
             ALPHANUMERIC ACCOUNTS Bit 2=1 allows REPEATED LOGIN MESSAGES

        DEF-FILE-PRO

             This is the default file protection.  Only the rightmost six
             octal digits are significant.

        DIR-PROT

             This is the default protection for the directory.  Only  the
             rightmost six octal digits are significant.

        DEF-FILE-RET

             This is the default number of generations of a file to keep.

        2.  To produce an alphabetic list  of  directories  on  structure
            SNARK  on  your terminal, on narrow paper, type the following
            commands:

            OPR>PUSH<RET>

             TOPS-20 Command processor 7(31)
            @ULIST<RET>
            ULIST>NARROW (PAPER FORMAT)<RET>
            ULIST>STRUCTURE (TO USE) SNARK:<RET>
            ULIST>ALPHABETIC (LIST OF USERS)<RET>
            ULIST>BEGIN<RET>
             DONE




















                                    8-34

                          SCHEDULED SOFTWARE TASKS


            The listing on your terminal starts to appear as follows:

   ^LNAME,ACCOUNT (STRUCTURE: SNARK)      WED 5-MAR-87    PAGE 1
     DIR-# PRIVILEGES  LOGIN-QUOTA LOGOUT-QUOTA USER-OF-GROUPS  DIR-GROUPS
   (   MODES     DEF-FILE-PRO   DIR-PROT   DEF-FILE-RET )

   SNARK:<1A>,
        65            0          250          250
   SNARK:<BEN>
       611       400000         2500         2000
   (600000000000 500000777752 500000777740            1 )
   SNARK:<FIELD-IMAGE>,
       315            0         2000          250                       1
   (600000000000 500000777752 500000777740            1 )
                                               .
                                               .
                                               .

            The  output  is  alphabetical   by   directory   name.    The
            information  for  each  directory  is  identical to that in a
            numeric list.  The line beginning and ending with parentheses
            is  omitted if the values for the parameters in that line are
            system defaults.

        3.  To get a mini-listing on your terminal on narrow paper of the
            directories  on  the  public  structure,  type  the following
            commands:

            @ULIST<RET>
            ULIST>MINI<RET>
            ULIST>NARROW<RET>
            ULIST>BEGIN<RET>
             DONE





















                                    8-35

                          SCHEDULED SOFTWARE TASKS


            The listing appears on your terminal as follows:

            List of structure: PS       Wednesday, 5 March 87   

             1 PS:<ROOT-DIRECTORY>
             2 PS:<SYSTEM>                   72 PS:<BROWN>
             3 PS:<SUBSYS>                   73 PS:<MULLEN.C>
             4 PS:<ACCOUNTS>                 74 PS:<MAINTENANCE>
             5 PS:<OPERATOR>                 75 PS:<TWAITS>
             6 PS:<SPOOL>                    76 PS:<DIPACE.1>
             7                               77 PS:<CALABI>
            10                              100 PS:<SKOGLUND>
            11                              101 PS:<2BOSACK>
            12                              102 PS:<BEERS>
            13                              103 PS:<LEACHE>
            14                              104 PS:<MILLER>
            15                              105 PS:<HOLLAND>
            16                              106 PS:<SAMBERG>
            17                              107 PS:<FREE4>
            20 PS:<FINER>                   110 PS:<VANDERHOOFT>


            The output is given in order of directory numbers, going down
            the page in columns.  Each entry has a directory number and a
            structure name:directory name,  which  may  be  blank  if  no
            directory has been created for that number.

        4.  To get a directory group listing for the public structure  on
            your terminal on narrow paper, type the following commands:

            @ULIST<RET>
            ULIST>DIRECTORY<RET>
            ULIST>NARROW<RET>
            ULIST>BEGIN<RET>
             DONE

            The listing appears on your terminal as follows:

                         USER AND DIRECTORY GROUPS ON STRUCTURE: PS

                            WEDNESDAY, 5 March 87


            THE FOLLOWING GROUPS ARE IN USE:

            1       2       3       2393

            THE HIGHEST DIRECTORY IN USE IS NUMBER: 605

            THE FIRST FREE DIRECTORY NUMBER IS: 60

            THE FOLLOWING DIRECTORIES ARE IN GROUP  1


                                    8-36

                          SCHEDULED SOFTWARE TASKS


            PS:<1FIELD-IMAGE>, PS:<1HURLEY>, PS:<1KIRSCHEN>,
            PS:<1MILLER>,
            PS:<1MONITOR>, PS:<1SOURCES>

            THE FOLLOWING USERS HAVE ACCESS TO GROUP  1

            PS:<BOSACK>, PS:<HALL>, PS:<HELLIWELL>, PS:<HESS>,
            PS:<HURLEY>,
            PS:<KIRSCHEN>


            THE FOLLOWING DIRECTORIES ARE IN GROUP  2

            PS:<ABEL>, PS:<EXERCISER>


            THE FOLLOWING USERS HAVE ACCESS TO GROUP  2

            PS:<ALUSIC>
                                          .
                                          .
                                          .

            THE FOLLOWING USERS ARE WHEELS:

            PS:<HALL>, PS:<HURLEY>, PS:<KIRSCHEN>, PS:<MCLEAN>,
            PS:<MILLER>,
            PS:<SNYDER>

            THE FOLLOWING USERS ARE OPERATORS:

            PS:<OPERATOR>

            THE FOLLOWING USERS HAVE CONFIDENTIAL INFORMATION ACCESS:

            PS:<MCLEAN>

            THE FOLLOWING DIRECTORIES ARE FILES-ONLY:

            PS:<1-UTILITIES>, PS:<1A-EXEC>, PS:<1A-MONITOR>,
            PS:<1A-UTILITIES>,
            PS:<ROOT-DIRECTORY>, PS:<SPOOL>, PS:<SUBSYS>, PS:<SYSTEM>,
            PS:<V-SOURCES>
                                          .
                                          .
                                          .

            ULIST>EXIT<RET>
            @POP<RET>
            OPR>




                                    8-37

                          SCHEDULED SOFTWARE TASKS


                             ----- Error Messages -----

   ? INVALID STRUCTURE NAME GIVEN

        You specified a structure that is not mounted or you omitted the
        colon after the structure name.

   ? ULIST: CANNOT OPEN SPECIFIED FILE

        The file access protection is such that you can not write into
        the file.

   ? ULIST: GARBAGE AT END-OF-COMMAND

        You typed an illegal character within the command or at the end
        of the command.

   ? ULIST: INVALID FILE SPECIFICATION

        The file specification that you typed is not valid.

   ? ULIST: NO SUCH ULIST COMMAND AS "command typed"

        You typed something that is not a ULIST command. Type HELP after
        the prompt to get a list of commands.

   ? ULIST: NOT PRIVILEGED TO READ SYSTEM FILES

        You need OPERATOR or WHEEL capability to read the directory
        information.



   8.8  CHECKING SYSTEM STATUS

   While the system is running, you may have to check on  the  status  of
   certain  jobs,  system  statistics,  or  devices.  the following three
   sections discuss various ways of doing these tasks.



   8.8.1  Determining the Status of Jobs with SYSTAT

   To get a summary of the jobs being used on the system, use the  SYSTAT
   command.   It  tells  you  the  job  number,  the terminal line number
   connected to that job, the program  being  run,  and  the  user.   The
   SYSTAT  command  can  also  be  followed  by an argument to get a more
   detailed summary or a specific part of the summary or  a  summary  for
   another node in a CFS-20 cluster.  For example:

        @SYSTAT n



                                    8-38

                          SCHEDULED SOFTWARE TASKS


   where n is a job number, prints out information for job n only.

        @SYSTAT user

   where user is a user's name,  prints  out  information  for  the  jobs
   logged in by that user only.

        @SYSTAT NODE node

   where node is the name of a remote CFS-20 node.

   See the TOPS-20 User's Guide for more details on the SYSTAT command.

                            ----- Examples -----

        1.  To get a summary of all jobs, type PUSH to OPR> and then type
            SYSTAT.

            OPR>PUSH<RET>

             TOPS-20 Command processor 7(4430)
            @SYSTAT<RET>
|           Thu 8-Mar-90 17:07:11  Up 18:12:29
|           13+10 Jobs   Load av   0.14   0.13   0.14
|  
|            Job  Line Program  User              Origin
|            199   435  MS      BRAITHWAITE       LAT74:2400674(LAT)
|            200   DET  DTRSRV  Not logged in
|            201   DET  RMSFAL  Not logged in
|            202   DET  RMSFAL  Not logged in
|            203   DET  RMSFAL  Not logged in
|            204   DET  RMSFAL  Not logged in
|            207   434  EXEC    MULDOON           LAT175:LAT1757(LAT)
|            209   364  EXEC    WADDINGTON        PMAP::RBW(CTM)
|            210*  437  SYSTAT  TUCKER            LAT473:24112473(LAT)
|            211   440  MS      EKLUND            LAT75:2405275(LAT)
|            212   441  EMACS   PUCHRIK           LAT423:240812423(LAT)
|            213   DET  DETACH  GSCOTT
|            214   DET  DETACH  GSCOTT
|            215   365  EXEC    PUCHRIK           WURST::PUCHRIK(CTM)
|            217   445  OPR     JROSSELL          LAT1:240851(LAT)
|            220   443  EXEC    MULDOON           LAT408:LAT4084(LAT)
|            221   451  EXEC    MULDOON           LAT175:LAT1757(LAT)
|            222   452  EXEC    MULDOON           LAT408:LAT4087(LAT)
|            193   232  PTYCON  OPERATOR
|            194   233  GALAXY  OPERATOR
|            195   234  NEBULA  OPERATOR
|            196   235  UNIVER  OPERATOR
|            197   236  EXEC    OPERATOR
|            198   237  MX      OPERATOR
|            205   240  DTR     OPERATOR
|            206   241  DIU     OPERATOR


                                    8-39

                          SCHEDULED SOFTWARE TASKS


|            208   243  MOUNT   OPERATOR
|            216   244  MOUNT   OPERATOR
            @POP<RET>
            OPR>

        2.  To get a SYSTAT of job 10, type PUSH to OPR> and SYSTAT 10.

            OPR>PUSH<RET>

             TOPS-20 Command processor 7(4430)
|           @SYSTAT 10<RET>
|            217   445  OPR     ROSEL  LAT1:240851(LAT)
            @POP<RET>
            OPR>

        3.  To find out what jobs are running under OPERATOR,  type  PUSH
            to OPR> and SYSTAT OPERATOR.

            OPR>PUSH<RET>

             TOPS-20 Command processor 7(31)
            @SYSTAT OPERATOR<RET>

             0 DET  SYSJOB  OPERATOR
             1 101  PTYCON  OPERATOR
             4 217  OPR     OPERATOR
             7 103  LPTSPL  OPERATOR
             8 104  BATCON  OPERATOR
            @POP<RET>
            OPR>



   8.8.2  Watching System and Job Statistics with WATCH

   The WATCH program allows you  to  periodically  print  TOPS-20  system
   statistics and/or a job summary.  Under any job, type the following:

        1.  ENABLE

        2.  WATCH

        3.  After OUTPUT TO FILE:, type the name of the file  to  contain
            the  output;  it  can be TTY:  if you want the output on your
            terminal.  If you type /H after OUTPUT TO FILE:, you  get  an
            explanation  of  the  WATCH output and another prompt for the
            output file.

        4.  Type YES or NO to the questions PRINT MONITOR STATISTICS  and
            PRINT  JOB  SUMMARY.  If you answer NO to both questions, you
            get the output for load averages only.



                                    8-40

                          SCHEDULED SOFTWARE TASKS


        5.  After TUNE MODE?, type YES or NO.   If  you  type  YES,  only
            users with WHEEL or OPERATOR privileges may request a display
            which  includes  Tune  Mode  statistics  lines  with   column
            headings  on  every  page.   If  you answer NO, all users can
            request a display which include headings and load averages.

        6.  For the TIME PERIOD (MM:SS), type the number of minutes  (mm)
            and  seconds  (ss)  to  specify  a  fixed time period.  Press
            RETURN for a variable time period.  Type ?  for a  help  text
            on  time  periods.   If you requested a variable time period,
            you must press RETURN again whenever you  want  more  output.
            Statistics  are  gathered  over  every fixed or variable time
            period and then output.

                                    NOTE

                  The length of the time  period  actually
                  used   may   not  be  exactly  what  you
                  specified,  because  the   printing   of
                  information  may delay the next sampling
                  period.  Do not make the time period too
                  small,   because  WATCH  itself  uses  a
                  considerable amount  of  time.   A  time
                  period of two minutes is reasonable.


   To stop WATCH from reporting the statistics,  type  two  CTRL/Cs.   To
   stop the WATCH program and the reporting of statistics, type RESET and
   press the RETURN key.  Then, if your output was to a  disk  file,  you
   can PRINT it on the line printer.

   For additional information on the WATCH program, refer to the  TOPS-20
   WATCH document.

                            ----- Example -----

   This example shows the output for one  time  period  of  two  minutes.
   Note  that  you must type CTRL/C twice to exit from WATCH.  Otherwise,
   for this example, WATCH would print a report every two minutes.

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $WATCH<RET>

        WATCH 4(3), /H for help.
        Output to file:/H<RET>

   For a detailed description of the WATCH program, refer to the  TOPS-20
   WATCH document.



                                    8-41

                          SCHEDULED SOFTWARE TASKS


   8.8.3  Getting Other Information

   The system command INFORMATION (ABOUT) has several different arguments
   to  give  you  information  on various system and job parameters.  For
   arguments useful to you as an operator, refer to  the  TOPS-20  User's
   Guide.

                            ----- Examples -----

        1.  To get information about the current system-status:

            OPR>PUSH<RET>

            @INFORMATION (ABOUT) SYSTEM-STATUS<RET>
|            Operator is in attendance
|            Remote logins allowed
|            Local logins allowed
|            Pseudo-terminal logins allowed
|            Internet TCP/IP terminal logins are not allowed
|            DECnet terminal logins allowed
|            LAT terminal logins allowed
|            Console terminal login allowed
|            Accounting is being done
|            Account validation is enabled
|            Working set preloading is disabled
|            Sending of system level zero messages is enabled
|            Sending of system level one messages is enabled
|            Job zero CTY output is enabled
|            Tape-drive allocation is enabled
|            Automatic file-retrieval-waits allowed
|            Maximum offline-expiration is 90 days
|            Scheduler bias-control setting is 11
|            Class scheduling is disabled, batch jobs being run on dregs
|           queue
|            Offline structures timeout interval is 0 minutes and 5
|           seconds
|            Cluster information is enabled
|            Cluster sendalls are enabled
|            Minimum password length is 8 characters
|            Password expiration is 45 days
|            Password dictionary is enabled
|           @












                                    8-42

                          SCHEDULED SOFTWARE TASKS


        2.  To get information about the structure named SNARK: :

            @INFORMATION (ABOUT) STRUCTURE (NAME) SNARK:<RET>
             STATUS OF STRUCTURE SNARK:
             MOUNT COUNT: 1, OPEN FILE COUNT: 0, UNITS IN STRUCTURE: 1
             DOMESTIC
             USERS WHO HAVE MOUNTED SNARK: HESS
             USERS ACCESSING SNARK: HESS
             NO USERS CONNECTED TO SNARK:
            @



   8.9  LISTING USER REMARKS WITH RDMAIL

   To list users' comments that have been mailed  to  REMARKS,  type  the
   following commands:

        1.  PUSH to OPR>.

        2.  ENABLE capabilities.

        3.  Run RDMAIL.

        4.  Type Y to SPECIAL USER.

        5.  Type REMARKS to USER NAME.

        6.  Press RETURN to DATE AND TIME.

        7.  DISABLE capabilities.

        8.  POP to return to OPR>.

   All remarks that have not been read before  from  PS:<REMARKS>MAIL.TXT
   will be output on your terminal.

                                    NOTE

           If some  other  privileged  user  has  run  RDMAIL  on
           PS:<REMARKS> before you, in Step 5 above type the date
           and time you last did this task.












                                    8-43

                          SCHEDULED SOFTWARE TASKS


                            ----- Example -----

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $RDMAIL<RET>

        SPECIAL USER (Y OR N)? Y<RET>

        USER NAME: REMARKS<RET>
        DATE AND TIME  (/H FOR HELP)      
            .
            .
            .
        $DISABLE<RET>
        @POP<RET>
        OPR>

   The comments printed  on  your  terminal  should  be  distributed  and
   answered according to a method established by your system manager.

   Sometimes you might need to perform other functions with  RDMAIL.   If
   you need to read all the remarks from PS:<REMARKS>MAIL.TXT, even those
   that you have listed before, type /A after DATE AND TIME.  If you need
   to read only those remarks created after a certain date and time, type
   after DATE AND TIME:

        mmm dd,yyyy hh:mm
   where:

          mmm = the first three letters of the month

           dd = the number for the day of the month

         yyyy = the year

        hh:mm = hour:minute (equal to 00:01 if omitted after the date)

   Other date formats can be accepted, but they are not recommended.

   To list the headings but not the text of the remarks,  type  date  and
   time, and then /P.  For example:











                                    8-44

                          SCHEDULED SOFTWARE TASKS


        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $RDMAIL<RET>

        SPECIAL USER (Y OR N)? Y<RET>

        USER NAME: REMARKS<RET>
        DATE AND TIME  (/H FOR HELP) SEP 20,1987/P      
           --------
        DATE: 20-SEP-87 20:39
        FROM: MCKIE
        TO: HELLIWELL
        CC: LEWINE,WERME,HESS,REMARKS

        SUBJECT: The EXECs printing of EDIT files.
           --------
        DATE: 22-SEP-87 10:23
        FROM: OSMAN
        TO: MILLER,REMARKS,OSMAN

        SUBJECT: ALLOWING USERS TO STOP SPENDING MONEY ....
           --------
        $DISABLE<RET>
        @POP<RET>
        OPR>

   To list remarks and  pause  between  each  one,  type  date  and  time
   followed by /S.  You are asked to press RETURN to get the next remark.
   You can stop the program with CTRL/C.

   To get help with RDMAIL, type /H after DATE AND TIME.  For example:

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $RDMAIL<RET>

        SPECIAL USER (Y OR N)? Y<RET>

        USER NAME: REMARKS      
        DATE AND TIME  (/H FOR HELP) /H<RET>










                                    8-45

                          SCHEDULED SOFTWARE TASKS


        TYPE IN A DATE AND TIME IN TOPS-20 FORMAT AS FOLLOWS:

                        MMM DD,YYYY HH:MM
        OR
                        MMM DD,YYYY

                THE LATTER CASE WILL ASSUME TIME 00:01.
                (FOR EXAMPLE, A VALID DATE AND TIME IS MAR 16,1987 15:30)

        OR      TYPE AN EMPTY LINE AND GET ALL MESSAGES SINCE THE LAST
                READING OF THE MESSAGE FILE.

        /H PRINT THIS TEXT
        /A TYPES ALL MESSAGES IN THE FILE
        /P FOR PERUSING MESSAGES ONLY
        /S WILL CAUSE RDMAIL TO PAUSE AFTER EACH MESSAGE TYPED
        /M WILL USE THE MESSAGE OF THE DAY FILE FOR MESSAGE TYPE OUT
        /L WILL OUTPUT MESSAGES TO THE LINE PRINTER
        DATE AND TIME  (/H FOR HELP)

                              ----- Hint -----

   Because the file PS:<REMARKS>MAIL.TXT continues to get bigger as users
   MAIL  their  remarks,  you  should periodically RENAME it and save the
   renamed file on magnetic tape with DUMPER.



   8.10  REPORTING SYSTEM ERRORS WITH SPEAR

   SPEAR is a program that selectively lists and  formats  parts  of  the
   system  error  file  <SYSTEM-ERROR>ERROR.SYS  on the system structure.
   You should run it daily for summary information (see Example 1  below)
   and  file  it  for  later  reference  by  your  DIGITAL  Field Service
   Representative.  Then, whenever  a  piece  of  hardware  seems  to  be
   failing,  run  SPEAR  again  and  request  a  detailed report for that
   device.

   To enter reports on users  and/or  devices  into  ERROR.SYS,  use  the
   REPORT  command at OPR command level.  Refer to the TOPS-20 Operator's
   Command Language Reference Manual for a complete  description  of  the
   OPR REPORT command.

   To run SPEAR, type the following to OPR>.

        1.  PUSH

        2.  SPEAR

        3.  Command lines to SPEAR




                                    8-46

                          SCHEDULED SOFTWARE TASKS


        4.  EXIT

        5.  POP

   When SPEAR is started, it prompts with the SPEAR prompt.  At that time
   you  can  type  a  command  line  to  SPEAR.   When SPEAR has finished
   processing one command line, it prompts again with the  SPEAR  prompt,
   so  you  can  give  another  command  line.   Type EXIT to leave SPEAR
   command level.

   To see the SPEAR help file on your terminal, type a "?" to  the  SPEAR
   prompt.

   SPEAR can also process commands from a disk file as well as from  your
   terminal.   This disk file, an indirect command file, is useful if you
   have a command line that you often use.  To make an  indirect  command
   file, create a file with the same command line that you would normally
   type to SPEAR from your terminal.  Then type the following to SPEAR:

        @dev:name.typ

   where dev:  is the location of the file (default is DSK:) and name.typ
   is the name of the indirect command file.

   EXAMPLE

   @SPEAR<RET>
   Welcome to SPEAR for TOPS-20.  Version 2(1114)
   Type "?" for help.

   SPEAR> SUMMARIZE<RET>

   SUMMARIZE mode

        Event file (SERR:ERROR.SYS):<RET>

        Time from (EARLIEST):<RET>

        Time to (LATEST): LATEST<RET>

        Report to (DSK:SUMMAR.RPT):<RET>

   Type <cr> to confirm (/GO):<RET>
   INFO - Summarizing SERR:ERROR.SYS
   INFO - Now sending summary to DSK:SUMMAR.RPT
   INFO - Summary output finished

   SPEAR>EXIT<RET>

   Refer to the TOPS-10/TOPS-20 SPEAR  Manual  for  more  information  on
   SPEAR.



                                    8-47

                          SCHEDULED SOFTWARE TASKS


                                    NOTE

           The arguments in parenthesis are the  default  to  the
           SPEAR program.



   8.11  BACKING UP DISK FILES WITH DUMPER

   To minimize loss of disk files, you should put backup copies of  files
   on  magnetic  tape with DUMPER.  This should be done on a daily basis.
   You have the option of saving either all disk files or only those that
   have  not  been  saved  before  (called  an  incremental save).  It is
   advisable to save all files once a week and to do an incremental  save
   the  other  days.  An incremental save includes those files which have
   not been saved since the last incremental save or  full  save.   Check
   with  your  system  manager  to  make sure that the correct version of
   DUMPER is used to back up files.

   If your  installation  has  structures  other  than  PS:,  the  public
   structure,  be  sure  to  back  up files on those structures too.  Use
   different magnetic tapes for  different  structures,  and  follow  the
   procedure  for  a  full  save  or incremental save for each structure.
   (Refer to the TOPS-20 User Utilities Guide for details on  the  DUMPER
   utility  program.)  If  your installation is part of CFS, you must run
   DUMPER on the processor that has a direct connection to  the  required
   tape drive.

                                  WARNING

           When you are backing up the system structure never use
           a  labeled tape.  The reason for this is if the backup
           tape is the only method you have to BOOT  the  system,
           the  software  components  you  need  to read the tape
           label are not running.

   The following steps explain the DUMPER procedure with OPR  and  DUMPER
   commands.

                                    NOTE

           DUMPER does not work on a 7-track magnetic tape  drive
           (TU71).

   To save all disk files of a structure, do the following:

        1.  Type PUSH to OPR.

        2.  Type ENABLE.

        3.  Type MOUNT TAPE setname:  with the /WRITE-ENABLED switch, the
            /LABEL-TYPE:   switch,  and the /VOLIDS:  switch, the /NOWAIT


                                    8-48

                          SCHEDULED SOFTWARE TASKS


            switch, and any additional switches  desired  for  the  MOUNT
            command.  It is important to give as many volids as you think
            you need to backup all the files you want to save.

        4.  Physically mount and ready a tape that has been assigned  for
            DUMPER backups.

        5.  When MOUNTR replies with the Tape Mount Request and with  the
            acknowledgement  of  the  tape being mounted, press <RET> and
            type POP to return to OPR.

        6.  If it is an unlabeled tape, give the IDENTIFY command to  OPR
            to identify the tape drive to the mount request.

        7.  When MOUNTR replies with Tape Drive Given To Request  number,
            type PUSH to OPR.

        8.  If you want to save files from a structure other than PS:  or
            BS:, type MOUNT STRUCTURE str:.

        9.  After the system has displayed the defined tape drive for the
            setname:, type DUMPER.

       10.  Type the following DUMPER commands:

            TAPE MTn:     or     TAPE setname:
            SAVE /FULL-INCREMENTAL str:

            Structure is the name of the structure for which you did  the
            MOUNT  above,  or  it  is  omitted  along  with  the colon to
            indicate your currently connected structure.

            As DUMPER starts to save files  for  each  directory  on  the
            structure, it prints the structure and directory name.

       11.  If you receive the message:

            [Mounting next tape volume]

            mount another tape as specified in the MOUNT TAPE command  on
            MTn  or  any  available tape drive.  Then press CTRL/C twice,
            POP to OPR, and IDENTIFY the tape drive to the mount request.

       12.  When MOUNTR replies  the  acknowledgment  that  the  tape  is
            mounted,  type PUSH to OPR, and type CONTINUE to continue the
            DUMPER backup process.

       13.  After DUMPER has finished the SAVE, DUMPER prints  two  total
            lines, and you are prompted with the DUMPER> prompt.

       14.  Type EXIT to DUMPER.



                                    8-49

                          SCHEDULED SOFTWARE TASKS


       15.  Type DISMOUNT TAPE MTn:  to rewind and unload the tape.   You
            can  also  type  DISMOUNT TAPE setname:  to rewind and unload
            the tape.

       16.  If you did a MOUNT STRUCTURE above, type  DISMOUNT  STRUCTURE
            str:.

       17.  Type DISABLE.

       18.  Type POP to return to OPR.

       19.  Physically remove the tape(s) from the drive(s).

       20.  Store the magnetic tapes and DUMPER's output to your terminal
            in the place decided upon by your system manager.

                             ----- Hints -----

   If you do not specify enough volids to backup the  mounted  structure,
   the  system prompts you with the following when DUMPER reaches the end
   of the last reel specified in the MOUNT command:

        hh:mm:ss  <n>     --Key In Next Volume Identifier--
                        Supply next volume-id for tape set setname:
                        User username, Job n, Line n
                        Respond with either of:
                          VOLUME volid
                          REFUSE reason

   You must then press <RET>, type POP  to  return  to  OPR,  and  supply
   another  volid  by  giving  the  OPR  command RESPOND nn VOLUME volid.
   Another Tape Mount Request now appears.  You must then mount and ready
   the  tape and IDENTIFY the tape drive to the mount request.  Then PUSH
   and CONTINUE to return to DUMPER and the backup process.

   To save space due to inter-record gaps on the DUMPER  tapes,  you  can
   specify the following DUMPER command before you give the SAVE command:

        SET BLOCKING-FACTOR nn

   This command sets the number of logical records that are blocked  into
   a  single physical record.  The number (nn) must be in a range of 1 to
   15.  The default is 1.  The limits for  the  densities  (BPI)  are  as
   follows:

        1.  Density 200 - 1

        2.  Density 556 - 3

        3.  Density 800 - 4




                                    8-50

                          SCHEDULED SOFTWARE TASKS


        4.  Density 1600 - 10

        5.  Density 6250 - 15

                            ----- Example -----

   Run DUMPER to save all files on structure PS:  on an unlabeled tape.

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ENABLE<RET>
        $MOUNT TAPE DUMPER: /LABEL-TYPE:UNLABELED/WRITE-ENABLED-<RET>
        /VOLIDS:DUMP01,DUMP02/NOWAIT<RET>
        [Waiting for Tape/Structure Mount]

        16:30:00          --Tape Mount Request # 102--
                        Mount Unlabeled volume DUMP01, WRITE-ENABLED
                        User OPERATOR, Job 6, Terminal 1

        16:30:03          --MTA0: Unlabeled tape mounted--
        <RET>
        $POP<RET>
        OPR>IDENTIFY MTA0: REQUEST-ID 102<RET>
        OPR>
        16:32:01          --MTA0: Given To Request 102--
                        Volume DUMP01 now in use by
                        User OPERATOR, Job 6, Terminal 1
        OPR>PUSH<RET>
        [Tape set DUMPER, volume DUMP01 mounted]
        [DUMPER: defined as MT0:]
        $DUMPER<RET>
        DUMPER>TAPE MT0:<RET>
        DUMPER>SET BLOCKING-FACTOR 10<RET>
        DUMPER>SAVE /FULL-INCREMENTAL PS:<RET>
        DUMPER tape # 1, Saturday, 14-Apr-87 1452.  , Volid DUMP01
        PS:<ACARLSON>
        PS:<ACCOUNTS>
        PS:<BAKER>
             .
             .
             .
        PS:<BLISS>
        [Mounting next tape volume]
        16:50:45         --Tape Drive Released By User--
                       MTA0: Volume DUMP01 Being unloaded

        16:51:01         --Tape Mount Request # 103--
                       Mount Unlabeled volume DUMP02, 9-TRACK,
                       WRITE-ENABLEd
                       User OPERATOR, Job 6, Terminal 1



                                    8-51

                          SCHEDULED SOFTWARE TASKS


        16:51:21         --MTA0: Unlabeled tape mounted--

        ^C
         ^
        <CTRL/C><CTRL/C>
        $POP<RET>
        OPR>IDENTIFY MTA0: REQUEST-ID 103<RET>
        OPR>
        16:52:45         --MTA0: Given to Request 103--
                       Volume DUMP02 now in use by
                       User OPERATOR, Job 6, Terminal 1
        OPR>PUSH<RET>
        $CONTINUE<RET>

        DUMPER tape # 2, Saturday, 14-Apr-87 1401.  Volid DUMP02
        PS:<COX>
        PS:<DENNY>
        PS:<ELFSTROM>
             .
             .
             .
        PS:<ZINA>


        Total files dumped = 604
        Total pages dumped = 8835
        DUMPER>EXIT<RET>
        $DISMOUNT TAPE DUMPER:<RET>
        [Tape dismounted, logical name DUMPER: deleted]
        17:15:07         --Tape Drive Released By User--
                       MTA0: Volume DUMP02 Being unloaded
        $POP<RET>
        OPR>

   To do an incremental save of a structure, follow  the  same  steps  as
   described previously for a full save of a structure with the following
   exception:  at DUMPER command level, type

        SAVE /INCREMENTAL:1 str:

   where str:  is the structure name for the incremental save.













                                    8-52

                          SCHEDULED SOFTWARE TASKS


                            ----- Example -----

   Run DUMPER to  do  an  incremental  save  on  structure  MISC:  on  an
   unlabeled tape.

        OPR>PUSH<RET>

         TOPS-20 Command processor 7(31)
        @ENABLE      
        $MOUNT TAPE INCRMT: /WRITE-ENABLED/LABEL-TYPE:UNLABELED-<RET>
        /VOLIDS:DUMP09/NOWAIT<RET>
        [Waiting for Tape/Structure Mount]

        17:18:00          --Tape Mount Request # 112--
                        Mount Unlabeled volume DUMP09, WRITE-ENABLED
                        User OPERATOR, Job 6, Terminal 1

        17:18:25          --MTA2: Unlabeled tape mounted--
        <RET>
        $POP<RET>
        OPR>IDENTIFY MTA2: REQUEST-ID 112<RET>
        OPR>
        17:20:03          --MTA2: Given To Request 112--
                        Volume DUMP09 now in use by
                        User OPERATOR, Job 6, Terminal 1
        OPR>PUSH<RET>

        $mount structure misc<RET>
        [Tape set INCRMT, volume DUMP09 mounted]
        [INCRMT: defined as MT1:]
        $DUMPER<RET>
        DUMPER>TAPE MT1:<RET>
        DUMPER>SAVE/INCREMENTAL:1 MISC:<RET>

        DUMPER tape # 1, Saturday, 14-Apr-87 1206.  , Volid DUMP09

        MISC:<ACCOUNTS>
        MISC:<BARON>
        MISC:<BROWN>
        MISC:<HOVSEPIAN>
        MISC:<OPERATOR>
           .
           .
           .
        MISC:<PALL>
        MISC:<ROLAND>

        Total files dumped = 467
        Total pages dumped = 7721
        DUMPER>EXIT<RET>
        $DISMOUNT TAPE MT1:<RET>
        [Tape dismounted]


                                    8-53

                          SCHEDULED SOFTWARE TASKS


        17:31:52          --Tape Drive Released By User--
                        MTA2: Volume DUMP09 Being unloaded

        $DISMOUNT STRUCTURE MISC:<RET>

        17:32:31          --STRUCTURE DISMOUNTED--
                        Structure MISC: (Alias: MISC) dismounted
        $POP<RET>
        OPR>

                             ----- Hints -----

   If you are saving disk files with DUMPER and the system  crashes,  you
   do  not  have  to start from the beginning after the system is started
   again.  Do the following:

        1.  Leave the tape positioned where it is.

        2.  Type PUSH to OPR>.

        3.  Type ENABLE.

        4.  Type MOUNT TAPE setname:  and specify the same switches  that
            were  specified  for  the tape mount before the system crash,
            but specify new tape volids.

        5.  Type POP to return to OPR and give the  IDENTIFY  command  to
            identify the tape drive to the mount request.  Then type PUSH
            to return to TOPS-20 command level.

        6.  If you are saving files from a structure other than  PS:   or
            BS:, type MOUNT STRUCTURE STR:.

        7.  Type DUMPER.

        8.  Type the following DUMPER commands:

            TAPE MTn:
            INIT <directory>
            SAVE/FULL-INCREMENTAL str: or SAVE /INCREMENTAL:n str:

            where directory is the last directory name output  by  DUMPER
            before  the  system  crashed and structure is the name of the
            structure for which you did the MOUNT above.   You  can  omit
            str:  to indicate your currently connected structure.

        9.  Follow Steps 11 through 20 above.

   If you are restoring files with DUMPER and the system crashes, you can
   use  the same technique stated above.  Simply replace the SAVE command
   and switches with RESTORE and appropriate switches.



                                    8-54

                          SCHEDULED SOFTWARE TASKS


   8.12  ENDING TIMESHARING WITH ^ECEASE

   As soon as you know the next scheduled time to  end  timesharing,  use
   the ^ECEASE command.  Type to OPR>:

        1.  PUSH

        2.  ENABLE

        3.  ^ECEASE (TIMESHARING AT) date time (RESUMING AT) date time

        4.  <RET> to confirm the shutdown

        5.  POP

                            ----- Examples -----

        1.  OPR>PUSH<RET>

             TOPS-20 Command processor 7(31)
            @ENABLE<RET>
            $^ECEASE 8-Feb-87 1900 8-Feb-87 2000<RET>
            CLOYD shut down scheduled for 8-Feb-87 17:05:24
            [Confirm]
            $<RET>
            $POP<RET>
            OPR>

        2.  To cancel a ^ECEASE command, type ^ECEASE and press RETURN.

            OPR>PUSH<RET>

             TOPS-20 Command processor 7(31)
            @ENABLE<RET>
            $^ECEASE<RET>
            [SHUTDOWN CANCELLED]
            $POP<RET>
            OPR>

   In a CFS-20 cluster, a shutdown on one  system  causes  "system  going
   down"  messages to be transmitted to all systems in the cluster at the
   sixty-minute, five-minute, and one-minute marks.  For example, if SYSA
   is shutting down, the following messages appear clusterwide:

   [System SYSA going down in 60 minutes at 1-Dec-87 16:29:22]

   [System SYSA going down in 5 minutes at 1-Dec-87 16:29:22]

   [System SYSA going down in one minute!!]

   Any time you give a ^ECEASE command while other systems in the cluster
   are  accessing  your  disks by means of the MSCP server, the following


                                    8-55

                          SCHEDULED SOFTWARE TASKS


   message is printed on the CTY, as well as any terminal running the OPR
   program, every time the message "System going down in 'n' minutes" has
   a time of 60 minutes or less.

        Check other cluster systems for structure dismount instructions

   Every time you receive this message, any other system  accessing  your
   disks will receive one of the following two messages.

        NODE-NAME going down at 11-Mar-87 08:34:37.
        Before it is shutdown, this system should dismount
        the following structures

        structure-name  structure-name

   or

        NODE-NAME going down at 11-Mar-87 08:34:37.
        No structure dismounting is needed on this system.

   When the time has expired, the operator on the system  being  shutdown
   will receive the following message.

        [Timesharing is over]

        OPERATOR-WAIT FOR THE MESSAGE 'Shutdown Complete' BEFORE
        ENTERING COMMANDS TO PARSER.

        ALSO, MAKE SURE OTHER SYSTEMS IN THE CLUSTER HAVE
        COMPLETED ALL NECESSARY STRUCTURE DISMOUNTS BEFORE THIS
        SYSTEM IS SHUTDOWN.

   At this time, any other system accessing your disks will  receive  one
   of  the  following  two  messages  on  the CTY as well as any terminal
   running the OPR program.

        NODE-NAME has ceased timesharing
        Before it is shutdown this system should dismount the
        following structures:

        structure-name  structure-name

   or

        NODE-NAME has ceased timesharing
        No structure dismounting is needed on this system.

   If there are users accessing  disk  structures  on  the  system  being
   shutdown,  they  should be notified to dismount those structures using
   the DISMOUNT STRUCTURE command.




                                    8-56

                          SCHEDULED SOFTWARE TASKS


   If at any time the operator cancels the shutdown, any  user  accessing
   disks on that system will receive the following message.

        NODE-NAME has canceled its shutdown. It is no longer
        necessary for this system to dismount structures

        structure-name  structure-name

   It should be noted that if no other system is accessing disks  on  the
   system  being  shutdown,  no messages will be printed and the shutdown
   procedures would be the same as a single system shutdown.

   If you also need to power down  the  hardware  after  timesharing  has
   finished, do the following:

        1.  Wait until SHUTDOWN COMPLETE is output on the CTY.

        2.  Type  CTRL/\  (control  backslash)  to  enter   the   console
            processor command language.

        3.  Give  the  SHUTDOWN  command  and  wait  for  the  **HALTED**
            message.

        4.  Unload all tape drives.

        5.  Power down the tape drives.

        6.  Stop all disk drives by  setting  the  START/STOP  switch  to
            STOP.

        7.  Turn off system power by setting the black  power  switch  to
            POWER OFF.






















                                    8-57


























































                                    9-1













                                 CHAPTER 9

                         ERROR RECOVERY PROCEDURES



   While the system is running, unexpected errors may  occur.   Sometimes
   the  system  tries  to  recover,  but other times you may have to take
   corrective action.  This chapter describes some of the errors that you
   may encounter and how to correct them.



   9.1  AUTOMATICALLY RELOADING AND DUMPING THE SYSTEM

   Because there is one monitor (TOPS-20)  for  the  main  processor  and
   another  (RSX-20F) for the console front-end processor, it is possible
   for either one to crash (halt or hang) and for either one  to  restart
   the other.

   When TOPS-20 halts because of a BUGHLT (Section 9.4.2), it is  usually
   reloaded  and started by RSX-20F.  During automatic reloading, RSX-20F
   writes  a  KLERR  entry  containing  information  about  the   central
   processor  at  the  time  of the crash.  Once TOPS-20 is running, this
   KLERR entry is appended to the ERROR.SYS  file  (Section  8.10).   The
   automatic   reloading  process  also  dumps  KL  memory  to  the  file
   <SYSTEM>DUMP.EXE on the system structure or on DMP:   if  your  system
   manager has defined this logical name.  Once TOPS-20 is running again,
   that file is automatically copied to DUMP-version-name.CPY, where name
   is the name of the error and version is the edit number of the monitor
   that was running at the time of the crash.  This file is given  a  new
   generation  number  so that successive memory dumps do not destroy any
   previous ones.

   A message similar to the following is sent to the CTY when the copy is
   done:
        Copying system dump
                from:  STR:<SYSTEM>DUMP.EXE.1
                to:    PS60:<DUMPS>DUMP-12345-KPALVH.CPY.1






                                    9-1

                         ERROR RECOVERY PROCEDURES


   When RSX-20F halts, it is usually reloaded by TOPS-20.  However,  some
   output  for  the  CTY  might  not get printed.  This output includes a
   BUGCHK or BUGINF, PTYCON  output,  and  PROBLEM  ON  DEVICE  messages.
   During   a  reload,  the  front-end  memory  is  dumped  to  the  file
   BS:<SYSTEM>0DUMP11.BIN.n, where n is the file generation  number.   On
   successive  dumps, the generation number is increased so that previous
   dumps are not overwritten.  The  filename,  including  the  generation
   number, is placed into ERROR.SYS (Section 8.10).

   For automatic reload of TOPS-20, the front end assumes the  last  used
   bootstrap  device  and  BOOT.EXB  as  the KL bootstrap.  BOOT.EXB then
   reads in the default monitor, BS:<SYSTEM>MONITR.EXE.

   When a reload occurs, write as much information as possible about  the
   crash in the installation logbook.  Include the following:

        1.  Date and time of the crash

        2.  TOPS-20 or RSX-20F reload

        3.  Name of the BUGHLT, job number, and user name

        4.  Names of the files containing the TOPS-20 monitor  before  it
            was run and the memory dump

   If your system manager or software specialist decides  to  report  the
   crash to DIGITAL, you must provide:

        1.  The information for the crash from the logbook

        2.  A copy of the memory dump and the TOPS-20 monitor  before  it
            was  run.   Use  DUMPER -- NOT  in  interchange  mode -- on a
            9-track tape at 1600 bits/inch (63 rows/mm)

        3.  The CTY output when the crash occurred

        4.  For TOPS-20 crashes, the output  from  SPEAR  containing  the
            KLERR information

                              ----- Hint -----

   As soon as possible, memory dump files should be put on magnetic  tape
   with DUMPER and deleted from disk to free some space.











                                    9-2

                         ERROR RECOVERY PROCEDURES


   9.1.1  Dumping the System for "Continuable" Errors

   In the configuration file, your system manager may have  arranged  for
   BUGINF and BUGCHK errors to generate memory dumps also.  (This feature
   is called "DUMP-ON-BUGCHK.") Dumps for  these  types  of  errors  take
   place  in  a  very  similar  way  as for BUGHLTs:  memory is dumped to
   DUMP.EXE and  then  copied  to  a  .CPY  file.   However,  with  these
   continuable  errors, the DUMP.EXE file is written to one of any number
   of structures you designate as "dumpable," not necessarily the  system
   structure (which is always dumpable).

   To mark a structure as dumpable, give the following command:

   OPR>SET STRUCTURE str:  DUMPABLE

   where:  str is the name of  a  structure  that  is  to  be  considered
   dumpable.

   Later, DUMP.EXE is copied to a .CPY file on DMP:  if that logical name
   is defined or on a different area of the same dumpable structure.



   9.2  MANUALLY RELOADING AND DUMPING THE SYSTEM

   You must manually reload the system when it is time  for  a  scheduled
   reload  or  when  the  system  is  hung  or  looping, for example, not
   responding to users.



   9.2.1  Scheduled Reloads

   For scheduled reloads, you can use the  procedure  given  in  Sections
   4.2.1, 4.2.2, or 4.2.3.  However, if the system is running at the time
   you want to reload, you must:

        1.  Give a ^ECEASE command (Section  8.12)  and  wait  until  the
            system  is  down.  At that time, SHUTDOWN COMPLETE is printed
            on the CTY.

        2.  Type  CTRL/\  (control  backslash)  to  enter   the   console
            processor command language.

        3.  Give the SHUTDOWN command.

        4.  After the **HALTED** message, reload the system.







                                    9-3

                         ERROR RECOVERY PROCEDURES


   9.2.2  Reloads and Dumps for a Hung or Looping System

   Determining whether it is TOPS-20 or RSX-20F that is hung  or  looping
   might  be  difficult.  If you are able to get to the console processor
   command language by typing CTRL/\, RSX-20F is probably okay.  Assuming
   that TOPS-20 is looping, try the following steps:

        1.  Type CTRL/\ to enter the console processor command  language.
            If you do not get to the PARSER, assume the front end is hung
            and proceed with the steps below for a hung  front  end.   If
            you get the PARSER prompt(PAR>), proceed with Step 2.

        2.  Type REPEAT 5;EXAMINE KL to print the current program counter
            (PC)  and  the  current  state of the priority interrupt (PI)
            system five times.  Save this output.

        3.  Type SHUTDOWN.  If you do not  get  the  message  **HALTED**,
            type CTRL/\ ABORT and press the RETURN key.

        4.  Reload via the switch register (Section 4.2.3) to  enter  the
            dialog, and answer BOOT to the first question.

        5.  When BOOT prompts, type /D<RET> to dump KL memory to the file
            BS:<SYSTEM>DUMP.EXE.   Later the file is automatically copied
            to another name.  When the copy is done,  note  the  filename
            printed on the CTY.

        6.  Press RETURN to load BS:<SYSTEM>MONITR.EXE, or type the  name
            of the monitor to be loaded.

        7.  Answer questions in the loading procedure (Section 4.2).

   Assuming the front end is hung, try the following:

        Manually halt the front end by pressing and then raising the HALT
        switch  which is to the right of the switch register.  Wait 10 to
        15 seconds; TOPS-20 may  try  to  reload  the  front  end.   Then
        consider the following three cases.

        1.  If RSX-20F reloaded successfully, and  everything  now  seems
            okay,  report  the  situation  to  your  system  manager  and
            software  specialist.   A  dump  of   front-end   memory   is
            automatically  placed into the file BS:<SYSTEM>0DUMP11.BIN.n,
            where n is the file generation number.  The  filename,  along
            with the generation number, is entered in ERROR.SYS.

        2.  If RSX-20F is reloaded, but the  system  still  seems  to  be
            hung, try the procedure above for TOPS-20 looping.






                                    9-4

                         ERROR RECOVERY PROCEDURES


        3.  If RSX-20F does not reload, for example, you do not  get  the
            following messages:

                 RSX-20F VB16-00 7:40 5-OCT-88

                 [SY0: REDIRECTED TO dev:]
                 [dev: MOUNTED]

            and the console light is on,  TOPS-20  is  probably  looping.
            You  should  then  follow  the  procedure  above  for TOPS-20
            looping.  You could also  wait  about  five  minutes  to  let
            TOPS-20  get  a  BUGHLT,  so that the front end automatically
            reloads  it.   However,  if  RSX-20F  does  not  successfully
            reload, you lose the EXAMINE KL output.  If you let the front
            end reload TOPS-20, once the system is up,  be  sure  to  run
            SPEAR to get KLERR information.

                              ----- Hint -----

   Be sure to log any reloads  in  your  installation's  system  logbook.
   Include the following:

        1.  Any information about the reason for reloading

        2.  When and how the reload was done

        3.  Attachment of EXAMINE KL output, if any

        4.  Whether KL or front-end memory was dumped and to which  files
            they were dumped

   To report the crash to DIGITAL, supply the above information,  a  copy
   of the TOPS-20 monitor before it was run, any memory dumps on magnetic
   tape, and any SPEAR output containing KLERR information.



   9.3  SETTING THE CORRECT DATE AND TIME

   If you notice that  the  date  and  time  printed  by  the  system  is
   incorrect,  immediately  notify  your  system manager.  For accounting
   purposes, he may want you to reload the system.  However, he may  want
   you  to  correct  only the date and time.  You can change the date and
   time with ^ESET DATE-AND-TIME.  If you need to  change  the  date,  be
   sure  you first warn all users via ^ESEND that you are going to change
   the date, because that action may affect their work.

   To correct the date and time, type the following commands:

        1.  PUSH to OPR




                                    9-5

                         ERROR RECOVERY PROCEDURES


        2.  ENABLE your capabilities

        3.  ^ESEND * DATE AND TIME WILL BE SET BACK TO MAKE THEM CORRECT

        4.  ^ESET DATE-AND-TIME date time

        5.  DAYTIME

        6.  POP

   (For valid date and time formats,  see  the  ^ECEASE  command  in  the
   TOPS-20  Operator's  Command Language Reference Manual.  Also, see the
   same manual for more detail on ^ESET and ^ESEND.)

                            ----- Example -----

        OPR>PUSH<RET>

         TOPS-20 Command Processor 7(31)
        @ENABLE (CAPABILITIES)<RET>
        $^ESEND * DATE AND TIME WILL BE SET BACK TO MAKE THEM CORRECT<RET>

        [FROM OPERATOR: DATE AND TIME WILL BE SET BACK TO MAKE THEM CORRECT]
        $^ESET DATE-AND-TIME (TO) 3-MAR-87 1047<RET>
        $DAYTIME<RET>
        $POP<RET>
        OPR>



   9.4  ERROR MESSAGES AND ACTION TO TAKE

   Error messages come from many different sources.  Those from  programs
   are usually documented with the task involving that program.  The next
   eight sections discuss device error messages,  BUGCHKs,  BUGINFs,  and
   BUGHLTs  from  TOPS-20,  HOME  and  BAT  block  messages  from  the KL
   bootstrap  and  from  TOPS-20,  TOPS-20  parity  errors,  DX20   error
   messages,  REAPER  error  messages,  tape handling error messages, and
   bootstrap error messages.



   9.4.1  Device Error Messages

   When problems occur on various devices,  you  receive  on  the  CTY  a
   message  beginning  with  %PROBLEM  ON  DEVICE.  The message continues
   printing every minute until you correct  the  problem.   The  specific
   messages and their corrective actions are given below.






                                    9-6

                         ERROR RECOVERY PROCEDURES


   %PROBLEM ON DEVICE: MTAn, S.N.=s, ACCESS PATH: CHN=c, cont=t, UNI=u

           n = logical unit number
           s = serial number
           c = channel number
        cont = TM02, TM03, or DX20
           t = number of the TM02, TM03, or DX20
           u = physical unit number on the controller

        There is a problem with the magnetic tape drive, logical unit  n.
        Check  if  the drive has lost vacuum, if the tape has run off the
        reel, or if the drive is not on-line.  Warn the  user  if  vacuum
        was lost.

   %PROBLEM ON DEVICE PCDR0

        There is a problem with the card reader.  Check  if  one  of  the
        following error indicator lights is lit:

        1.  READ CHECK

            A card edge is torn, column 0 or 81 is punched, or two  cards
            were  picked  at the same time.  To correct the problem for a
            faulty card, remove the card and press RESET to  restart  the
            reader.  If no cards are faulty, reread the last two cards in
            the output stacker.  If READ CHECK  occurs  for  every  card,
            notify your DIGITAL Field Service Representative.

        2.  PICK CHECK

            A card edge is damaged, webs are torn, or cards  are  stapled
            together.   If  a  card is damaged, remove it and restart the
            reader by pressing RESET.  If no cards are damaged, check for
            excessive  warpage of the card deck or a buildup of ink glaze
            on the picker face.  If webs are torn,  notify  your  DIGITAL
            Field Service Representative.

        3.  STACK CHECK

            Either there is a badly mutilated card or there is a  jam  in
            the  card  track.  To fix the problem, remove the bad card or
            correct the jam and restart the reader by pressing RESET.

        4.  HOPPER CHECK

            Either the input hopper is empty or  the  output  stacker  is
            full.   To  correct  the  problem,  load  the input hopper or
            unload the output stacker.

   %PROBLEM ON DEVICE PLPTn

        There is a problem with  line  printer  unit  n.   Check  if  the


                                    9-7

                         ERROR RECOVERY PROCEDURES


        printer is on-line, has paper, or has any error lights on.

   %PROBLEM ON DEVICE: RP0n, STR=t, S.N.=s, ACCESS PATH: CHN=c, UNI=u

        n = 4, 6, 7, 20, 60 or 81 for the type of disk drive
        t = structure name
        s = serial number
        c = channel number
        u = unit number

        There is a problem with a disk drive.  Check if it is READY or if
        any error lights are on.  If STANDBY is lit, turn the drive power
        OFF and then ON.  If UNSAFE  is  lit,  you  should  contact  your
        DIGITAL  Field  Service  Representative,  as  there  could  be  a
        hardware problem.

                            ----- Example -----

   %PROBLEM ON DEVICE: MTA1, S.N=0024, ACCESS PATH: CHN=0, TM02=5, UNI=2

                                    NOTE

           If the disk drive is on the CI or is served  by  MSCP,
           the  output  will  also  show  what  node the disk was
           connected to.



   9.4.2  BUGCHKs, BUGINFs, and BUGHLTs

   When TOPS-20 encounters certain questionable situations, it  generates
   a  BUGCHK  or BUGINF.  Then, some informational messages are output on
   the CTY, and TOPS-20 continues.  BUGINFs  are  strictly  informational
   messages.   BUGCHKs indicate a problem.  However, they do not halt the
   system.  When TOPS-20 encounters a situation  from  which  it  is  not
   advisable  to  continue,  it  generates  a  BUGHLT.   TOPS-20  is then
   reloaded and restarted by the front end.

   When a BUGCHK is encountered, the following is output on the CTY:

        ********************
        *BUGCHK "name" AT dd-mmm-yy hh:mm:ss
        *message
        *JOB: n, USER: user-name
        *ADDITIONAL DATA: data, data, data, data
        ********************

   The lines beginning with JOB: or ADDITIONAL DATA: may not appear.  The
   system then continues.

   The output is similar for BUGINFs.



                                    9-8

                         ERROR RECOVERY PROCEDURES


                            ----- Example -----

        ********************
        *BUGCHK "P2RAE1" AT 3-MAR-79 13:26:32
        *PHYH2 - RH20 REGISTER ACCESS ERROR READING REGISTER
        *ADDITIONAL DATA: 10005210602, 407415
        ********************

                                    NOTE

                  After a power-fail restart,  the  system
                  prints   BUGCHK   "PWRRES",  the  system
                  continues,  but  all  jobs   that   were
                  attached to a terminal are detached.  If
                  the detached jobs are  not  attached  to
                  within  five  minutes,  they  are logged
                  out.

   When a BUGHLT occurs, the following is output on the CTY.

        %DECSYSTEM-20 NOT RUNNING

        **********
        *BUGHLT "name" at date and time
        *JOB number, User: User name
        **********

   You can find the message corresponding to the  BUGHLT  "name"  in  the
   document,  BUGHLT Documentation.  The message pertaining to the BUGHLT
   is not printed on the CTY.  The front-end then reloads and starts  the
   TOPS-20 monitor.
                            ----- Example -----

        %DECSYSTEM-20 NOT RUNNING

        **********
        *BUGHLT "ILLUUO" AT 11-Dec-87 11:03
        *JOB: 000000000004, USER: JBREWER
        *ADDITIONAL DATA: 304000000003, 000006516407, 000001000000
        **********


        KL HALTED


        KLE>TAKE HALT
        KLE>EX KL
        PC/ 1 043145
        VMA/ 1 043145
        PI ACTIVE: OFF, PI ON: 177, PI HOLD: 000, PI GEN: 000
         OVF  CY0  CY1  FOV  BIS  USR  UIO  LIP  AFI  AT1  AT0  FUF  NDV
               X    X


                                    9-9

                         ERROR RECOVERY PROCEDURES


        KLE> <EOF>
        KLE> <END OF SNAPSHOT>
        KLI -- VERSION VB15-50 RUNNING
        KLI -- PAGE TABLE SELECTED: BOTH
        KLI -- %MOS MEMORY IS ALREADY CONFIGURED

        LOGICAL MEMORY CONFIGURATION.
          ADDRESS  SIZE  INT  TYPE CONTROLLER
         00000000  768K   4   MF20  10
         03000000  768K   4   MF20  11

        KLI -- ALL CACHES ENABLED
        KLI -- CONFIGURATION FILE WRITTEN
        KLI -- BOOTSTRAP LOADED AND STARTED

        BOOT V11.0(315)
        [BOOT: DUMPING] [OK]

          Number of pages written: 5734
          Number of I/O requests: 324
        [BOOT: LOADING] [OK]


        [CHIP MOUNTED]

        [IPALOD: LOADING CI20 MICROCODE VERSION 1.1(733)] [OK]

        System restarting, wait...
        Date and time is: Friday, 11-December-1987 11:09AM
        11:09:01 ***BUGINF KLPLOA*** PHYKLP - CI20 ucode loaded  Job: 0, User:
        OPERATOR  Additional Data:733
        11:09:01 ***BUGINF KLPSTR*** PHYKLP - CI20 started  Job: 0, User:
        OPERATOR
        11:09:02 ***BUGINF KLPOVC*** PHYKLP - Opened virtual circuit
        Additional Data: 14
        11:09:02 ***BUGINF CFCONN*** CFSSRV - CFS connection  Additional Data:
        14, 27777667660, 5664
        11:09:03 ***BUGINF CFDISC*** CFSSRV - CFS disconnect  Additional Data:
        14, 27777667660, 5664
        11:09:04 ***BUGINF CFCONN*** CFSSRV - CFS connection  Additional Data:
        14, 17777727720, 5664
        11:09:05 ***BUGINF KLPOVC*** PHYKLP - Opened virtual circuit
        Additional Data: 10
        Running DDMP


        Copying system dump
                from: CHIP:<SYSTEM>DUMP.EXE.1
                to:   SA25:<DUMPS.CHIP>1646-DUMP.CPY.1

   This printout is followed  by  other  messages  as  in  normal  system
   loading.


                                    9-10

                         ERROR RECOVERY PROCEDURES


   When a crash is reported to DIGITAL, the CTY output similar to that in
   the above example should be saved and sent with the report.

   Whenever the system encounters a BUGCHK beginning with DIR, it  prints
   a  directory  number  after  ADDITIONAL  DATA.  You should then try to
   rebuild that directory's symbol table (Section 9.5.1).  If the rebuild
   fails to correct the problem, proceed with the instructions at the end
   of Section 9.5.1.  It is important to take corrective action  in  this
   case so that files do not get lost.













































                                    9-11

                         ERROR RECOVERY PROCEDURES


                                    NOTE

           When the console front end  crashes,  it  is  reloaded
           automatically and the message [DECSYSTEM-20 CONTINUED]
           is printed.  You do not get a BUGHLT, but you may have
           to retype some of your last input.



   9.4.3  HOME Block or BAT Block Inconsistencies

   When the KL bootstrap is loaded and started,  it  checks  the  primary
   HOME  blocks  on the disk packs for certain information.  It checks if
   the system structure has been mounted  and  if  the  system  structure
   contains all the proper units for the structure.

   If the system structure has not been properly mounted, you may get the
   following error messages from the bootstrap:


   ERROR:      ?DUPL STR UNI

   Reason:     There are two mounted disk packs claiming to have the same
               logical unit number.

   Recovery:   Check to see if you have the proper  disk  packs  mounted.
               If  the  proper disk packs are mounted and the error still
               continues to occur, contact your  software  specialist  or
               DIGITAL Field Service Representative.


   ERROR:      ?HOME BLKS BAD

   Reason:     The logical unit number is out of range.

   Recovery:   Check to see if you have the proper  disk  packs  mounted.
               If  the  proper disk packs are mounted and the error still
               continues to occur, contact your  software  specialist  or
               DIGITAL Field Service Representative.
   ERROR:      ?MISSING UNIT

   Reason:     One or more logical units are missing from the structure.

   Recovery:   Check to see if all the proper disk packs are mounted.  If
               all  the  proper  disk  packs  are  mounted  and the error
               continues to occur, contact your  software  specialist  or
               DIGITAL Field Service Representative.

   After any of the above errors, BOOT prompts again.  To load a  TOPS-20
   monitor, type the monitor filename or press RETURN to get the default.
   If the proper packs are mounted and an  error  still  occurs,  consult
   your software specialist or Field Service Representative.


                                    9-12

                         ERROR RECOVERY PROCEDURES


   9.4.3.1  HOME  Block  Message - Once  the  bootstrap  is  loaded   and
   started,  TOPS-20  also checks the HOME blocks on the disk packs.  The
   following messages may occur.

                        ----- Warning Messages -----

   % BACKUP HOME BLOCK ON "BS" LOGICAL UNIT n IS INCORRECT

        TOPS-20 continues to run using the other HOME block.

   %COPYING PRIMARY HOME BLOCK TO SECONDARY ON BS UNIT n

        Because the secondary HOME block is incorrect, TOPS-20 copies the
        primary HOME block to the secondary HOME block.

   %COPYING SECONDARY HOME BLOCK TO PRIMARY ON BS UNIT n

        Because the primary HOME block is incorrect, TOPS-20  copies  the
        secondary HOME block to the primary HOME block.

   % PRIMARY HOME BLOCK ON "BS" LOGICAL UNIT n IS INCORRECT

        TOPS-20 continues to run using the other HOME block.

                         ----- Error Messages -----

   ERROR:      ?INCONSISTENT SET OF PACKS COMPOSING STRUCTURE BS.

   Reason:     A logical unit number is out of range.

   Recovery:   Be sure you have the proper disk packs  mounted.   If  the
               proper  disk  packs are mounted and the error continues to
               occur, contact your software specialist or  DIGITAL  Field
               Service Representative.


   ERROR:      ?LOGICAL UNIT n MISSING FROM STRUCTURE BS.

   Reason:     One or more logical units are missing from  the  structure
               BS.

   Recovery:   This error could be caused by a hardware problem.  Be sure
               you  have  the  proper  disk packs mounted.  If the proper
               disk packs are mounted and the error continues  to  occur,
               contact  your software specialist or DIGITAL Field Service
               Representative.
   ERROR:      ?LOGICAL UNIT n OF STRUCTURE BS IS WRITE LOCKED.

   Reason:     The switch on the  disk  drive  is  in  the  WRITE  LOCKED
               position.

   Recovery:   Be sure the proper disk pack is mounted, then position the


                                    9-13

                         ERROR RECOVERY PROCEDURES


               switch to the WRITE ENABLED position.


   ERROR:      ?MORE THAN 1 LOGICAL UNIT n IN STRUCTURE BS.

   Reason:     There are two disk packs mounted claiming to have the same
               logical unit number.

   Recovery:   This error could be caused by a hardware problem.  Be sure
               you  have  the  proper  disk packs mounted.  If the proper
               disk packs are mounted and the error continues  to  occur,
               contact  your software specialist or DIGITAL Field Service
               Representative.

   After any of the above errors, you get the message HAVE  THE  PROBLEMS
   MENTIONED  ABOVE  BEEN  CORRECTED  YET:.   If  you  believe  you  have
   corrected them, type Y to continue.

   Once the system succeeds in the HOME block check, it prints:

        [BS MOUNTED]



   9.4.3.2  BAT  Block  Messages - Then  TOPS-20  checks  the  BAT   (bad
   allocation  table)  blocks on the disk packs.  The BAT blocks indicate
   what areas of the disk have been  found  to  be  bad.   The  following
   messages may occur.

                        ----- Warning Messages -----

   %BAT BLOCK FULL ON BS UNIT n

        The monitor continues to run with no space in the  BAT  block  to
        mark  bad  areas  of the disk.  Inform your DIGITAL Field Service
        Representative so that he can  correct  the  problem.   You  then
        should reformat the pack and re-create the file system.

   %BAT BLOCKS DO NOT COMPARE ON BS UNIT n

        The BAT blocks on unit n look valid, but they are not  the  same.
        When  BAT  blocks  are  updated,  the  primary one is done first.
        Therefore, if the system crashes  before  the  secondary  one  is
        updated, they are different.  In this case, the primary BAT block
        is copied into the secondary one.

   %COPYING PRIMARY BAT BLOCKS TO SECONDARY ON BS UNIT n

        See explanation above.

   %COPYING SECONDARY BAT BLOCK TO PRIMARY ON BS UNIT n

        If the primary BAT block is  not  valid,  the  secondary  one  is
        copied to it.
                                    9-14

                         ERROR RECOVERY PROCEDURES


   ?BS UNIT n HAS NO CONSISTENT BAT BLOCKS

        The monitor continues and assumes that the  structure  was  built
        not to have BAT blocks.



   9.4.4  Parity Errors

   When TOPS-20 encounters a  parity  error,  it  prints  out  a  message
   beginning with:

        AR OR ARX PARITY ERROR

   or

        MPE DETECTED BY x, PC=n, y

   where x is a device or APR, n is the PC value, and y is either MONITOR
   or USER.

   Other applicable information for each message is then printed  on  the
   CTY.  The same information is also entered in ERROR.SYS.

   If any of these parity errors occurs, save the  CTY  output  from  the
   errors and notify your DIGITAL Field Service Representative.


                                    NOTE

                  As  memory  parity  errors  occur,   the
                  system   may   decide  not  to  use  the
                  affected memory pages.

                            ----- Examples -----

   The following output shows the information from both types  of  parity
   errors:

        MPE DETECTED BY APR   , PC=000000,,023247, MONITOR
        ERA = 002001,,437564

        SBUS DIAGS

        CNTRLR FNC 0          FNC 1
        000000 006000,,000000 036300,,036012
        000001 006000,,000000 036300,,036005
        000002 006000,,000000 036301,,036012
        000003 006000,,000000 036301,,036005


           LOC    CONTENTS
         01000002 000000,,020120
         01000004 000000,,354140
                                    9-15

                         ERROR RECOVERY PROCEDURES


         01000006 000000,,073302
         01000010 000000,,537122
         01000014 000000,,451660
         01000016 000000,,066330
         01000020 000000,,062313
         01000032 000000,,044730
         01000036 000000,,062500
         01000044 000000,,564734

        122 ERRORS FOUND.
        LOGAND ADR = 000001,,000000
        LOGOR  ADR = 000001,,777776
        LOGAND DATA = 000000,,000000
        LOGOR  DATA = 777777,,777777


        AR OR ARX PARITY ERROR
        PFW= 773000,,401564 MAP WORD= 503001,,437564
        BAD DATA= 000000,,000000
        CORE PAGE 001437 DISABLED



   9.4.5  DX20 Error Messages

   If there is a problem in loading the DX20 at system start-up time, you
   see a message similar to one of the following on the CTY:

        ?CHN:n DX20:m CRAM VERIFY
        GOOD data BAD data XOR data

        ?CHN:n DX20:m WORK MEM VER
        GOOD data BAD data XOR data

                n = the number of the RH20 to which the DX20 is connected
                m = the number of the DX20
             data = an octal number

   If you see a message similar to one of the above, save the message and
   call  your  DIGITAL  Field Service Representative.  The information in
   the message can help him solve the problem.  You can continue  running
   the system, but do not use the DX20.



   9.4.6  Reaper Error Messages

   The following is a list of the error messages that can occur when  you
   run the REAPER program, along with their recovery procedures:





                                    9-16

                         ERROR RECOVERY PROCEDURES


                         ----- Error Messages -----

   ERROR:     BAD PERIOD

   Reason:    There was an non-numeric character in the PERIOD command.

   Recovery:  Correct the PERIOD command and  continue  with  the  REAPER
              program.


   ERROR:     BAD DIRECTORY NAME IN SKIP LIST

   Reason:    A non-existent or incorrect directory name was specified in
              the SKIP command.

   Recovery:  Remove or correct the directory name and continue with  the
              REAPER program.
   ERROR:     SKIP SPACE FULL

   Reason:    You have more than 75 directories in the SKIP list.

   Recovery:  Check to see if you can remove any of the directories  that
              are  currently  in  the  SKIP  list.   If  you  cannot, the
              directory you were trying to add cannot be entered into the
              SKIP list.


   ERROR:     BAD FILESPEC IN ORDER LIST

   Reason:    An incorrect file specification or  separator  was  entered
              into the ORDER command.

   Recovery:  Correct the invalid file specification  and  continue  with
              the REAPER program.


   ERROR:     BAD FILESPEC IN LIST COMMAND

   Reason:    An invalid or incorrect file specification was entered into
              the list command.

   Recovery:  Correct the invalid file specification  and  continue  with
              the REAPER program.


   ERROR:     TAKE FILE NOT FOUND

   Reason:    The file you gave in the TAKE command does not exist.

   Recovery:  First, be sure you are connected to the correct  structure.
              Then make sure you gave the correct filename.



                                    9-17

                         ERROR RECOVERY PROCEDURES


              If both of the above are correct, then the file you gave in
              the TAKE command must have been deleted.  Recreate the TAKE
              file and continue with the REAPER program.



   9.4.7  Tape Handling Error Messages

   This section describes the recovery procedures for the  various  error
   messages that can appear when you are using tapes.  The following list
   of the error messages, the  reason  for  the  error  message  and  the
   recovery procedure.

                         ----- Error Messages -----

   ERROR:     --TAPE WRITE PROTECT ERROR--
              MTAn:  VOLUME VOLID
              order WRITE RING AND REMOUNT TAPE
                   where "order" is either INSERT or REMOVE

   Reason:    A user requested a  volume  to  be  write-enabled  and  the
              volume was mounted write-protected, or vice versa.

   Recovery:  If the volume should be write-protected, remove  the  write
              ring and physically remount the tape.  If the volume should
              be write-enabled, insert  the  write  ring  and  physically
              remount the tape.
   ERROR:     --NO RING IN SCRATCH TAPE--
              UNLOADING DRIVE MTAn:  VOLUME VOLID
              REMOUNT SCRATCH TAPE WITH WRITE RING

   Reason:    A scratch tape was mounted without a write ring.

   Recovery:  Insert a write ring and physically remount the tape.


   ERROR:     --REMOUNT TAPE VOLUME--
              MTAn:  VOLUME VOLID BEING UNLOADED
              REMOUNT VOLUME volid ON density BPI DRIVE

   Reason:    A user requested an unlabeled  tape  to  be  mounted  at  a
              specific  density, and the drive it was mounted on does not
              support that density.

   Recovery:  Remove the tape from the current drive and mount  it  on  a
              drive that supports the specified density.


   ERROR:     --TAPE DRIVE TIMED OUT--
              MTAn:  OPERATION TIMED OUT

   Reason:    A tape input/output request issued by MOUNTR took too  long


                                    9-18

                         ERROR RECOVERY PROCEDURES


              to  execute.   This  is an informational message that could
              indicate a problem with a tape drive or a problem with  the
              software.

   Recovery:  Retry the operation.  If the  error  still  persists,  call
              your DIGITAL Field Service Representative.


   ERROR:     --TAPE POSITIONING ERROR--
              MTAn:  POSITIONING OPERATION FAILED

   Reason:    While trying to position a volume to a specific  file,  the
              monitor  reported  an  error to MOUNTR.  This error message
              could indicate a bad tape or a bad tape drive.

   Recovery:  Retry the operation.  If the  error  still  persists,  call
              your DIGITAL Field Service Representative.


   ERROR:     --TAPE ERROR WRITING LABELS--
              ERROR WRITING LABELS ON MTAn:  VOLUME VOLID

   Reason:    The software encountered an error  while  trying  to  write
              volume  header labels on a tape.  A bad tape drive or a bad
              tape could cause this error.

   Recovery:  There are two recovery procedures for this type  of  error.
              (1)  Mount  the  tape  on another drive and try again.  (2)
              Initialize another volume at the same density,  label-type,
              and VOLID; then use this volume instead of the one that had
              the error.
   ERROR:     --MOUNTR SYSTEM TASK ERROR--
              BAD IPCF MESSAGE RECEIVED FROM component
                   (component = ORION or QUASAR)

   Reason:    MOUNTR received an unrecognized  or  incorrectly  formatted
              IPCF message from either ORION or QUASAR.

   Recovery:  Call your software specialist.


   ERROR:     ?MOUNTR CRASHING, PC=n
              SAVING MOUNTR CORE IMAGE ON FILE <SPOOL> MOUNTR-CRASH.EXE.n

   Reason:    MOUNTR detected an internal error that it could not handle.
              A  copy  of the MOUNTR program at the time of the error has
              been saved in the directory BS:<SPOOL> for analysis.

   Recovery:  Call your software specialist.





                                    9-19

                         ERROR RECOVERY PROCEDURES


   9.4.8  Bootstrap Error Messages

   This section describes the error recovery procedures for  the  various
   error  messages that can appear when you are trying to boot the system
   from disk or tape.  The following are the error messages,  the  reason
   for  the  error  message,  and  the  recovery  procedure.   All of the
   following error messages are preceded by ?BOOT:.

                         ----- Error Messages -----

   ERROR:     HALT

   Reason:    BOOT or MTBOOT halts only if it is unable to determine  how
              much   physical  KL10  memory  is  present.   This  message
              indicates incorrect memory configuration  or  interleaving,
              or  memory  hardware  problems.   This situation should not
              ordinarily occur.

   Recovery:  Reconfigure memory and check that  memory  interleaving  is
              correct.   If  the  error  recurs,  call your DIGITAL Field
              Service Representative.


   ERROR:     ?NO READY TAPE DRIVE AVAILABLE

   Reason:    MTBOOT was not  able  to  find  any  magnetic  tape  drives
              on-line  and ready.  This commonly occurs when the operator
              forgets to press the on-line  switch  on  the  drive  after
              mounting the tape.

   Recovery:  Check that the magnetic tape  drive  is  on-line.   If  the
              error  recurs  when  the  drive  is on-line, it indicates a
              hardware malfunction.   Call  your  DIGITAL  Field  Service
              Representative if the problem persists.
   ERROR:     ?HARD DISK ERROR

   Reason:    A disk hardware error occurred during a  disk  input/output
              transfer.

   Recovery:  Call your DIGITAL Field Service Representative.


   ERROR:     ?HARD TAPE ERROR

   Reason:    A hardware error occurred while MTBOOT tried to  read  from
              magnetic  tape.   MTBOOT  attempts  the  read operation 100
              times before reporting the error.   Any  of  the  following
              three reasons can cause this error:

              1.  A dirty read head on the magnetic tape drive




                                    9-20

                         ERROR RECOVERY PROCEDURES


              2.  A corrupted or damaged magnetic tape

              3.  Hardware problems,  probably  with  the  magnetic  tape
                  drive

   Recovery:  Read the magnetic  tape  on  another  tape  drive  to  help
              determine if the tape or the tape drive is the problem.  If
              the magnetic tape drive is causing  the  error,  clean  the
              tape  drive  heads.   Refer to the instructions in the tape
              drive operator's guide.  If the tape drive still causes the
              error,  it probably indicates a hardware malfunction.  Call
              your DIGITAL Field Service Representative.

              If the magnetic tape is causing the error, use another copy
              of the monitor tape to reload the system.


   ERROR:     ?BAD HOME BLOCK

   Reason:    The Home block on the  structure  that  BOOT  is  currently
              using  is damaged.  This usually indicates severe structure
              damage.

   Recovery:  Use another copy of the structure,  if  available,  rebuild
              the structure, or reinstall the system.


   ERROR:     ?MORE THAN 1 BOOTABLE STRUCTURE FOUND

   Reason:    BOOT found duplicate bootable structures online.

   Recovery:  Place drives with  duplicate  bootable  structures  offline
              until after system startup.


   ERROR:     ?STRUCTURE NOT FOUND:STR:

   Reason:    BOOT  failed  to  find  a  structure,  on  line,  with  the
              structure   name   you   specified,  or  hardware  problems
              prevented BOOT from finding the structure you specified.

   Recovery:  Make sure the disk drive the structure  is  mounted  on  is
              on-line.  If it is on-line, use another copy of BOOT or the
              monitor.  If the problem still occurs,  call  your  DIGITAL
              Field Service Representative.
   ERROR:     ?COMMAND ERROR

   Reason:    BOOT or MTBOOT was not able to decipher the command.   This
              is generally the result of a typing mistake.

   Recovery:  Retype the command.



                                    9-21

                         ERROR RECOVERY PROCEDURES


   ERROR:     ?FILE NOT FOUND:FILESPEC

   Reason:    BOOT failed to find the file you specified.  The file  name
              was  incorrectly  entered,  the  file  does  not  exist, or
              root-directory or the directory you specified to BOOT  does
              not contain the expected format.

   Recovery:  Retype the file name, if that was  incorrectly  typed.   If
              that  is  not  the problem, check to make sure the file has
              not been deleted, or that the directory the file resides in
              is not damaged.


   ERROR:     ?MEMORY REFERENCE FAILED

   Reason:    BOOT  or  MTBOOT  encountered  an  illegal  address.   This
              usually indicates a hardware problem.

   Recovery:  Run the BOOT program again.  If the problem  still  occurs,
              call your DIGITAL Field Service Representative.


   ERROR:     ?FILE NOT IN .EXE FORMAT

   Reason:    BOOT or MTBOOT is currently attempting to load a file  that
              is in an incorrect format.  This message could be caused by
              several reasons.  They are:

               o  the wrong filename was specified

               o  the file could be damaged

               o  the file was generated by CSAVE

               o  the file is not an executable file

   Recovery:  Use another copy of the monitor file.


   ERROR:     ?FILE'S .EXE DIRECTORY IS LONGER THAN 1 PAGE

   Reason:    BOOT found that the .EXE directory was larger than one page
              while dumping.

   Recovery:  Use another copy of the .EXE file.


   ERROR:     IO ERROR - TEXT

   Reason:    A hardware error occurred during an I/O transfer.

   Recovery:  Run the BOOT program again.  If the error still occurs call


                                    9-22

                         ERROR RECOVERY PROCEDURES


              your DIGITAL Field Service Representative.
   ERROR:     ?UNKNOWN SWITCH

   Reason:    You specified an invalid switch.

   Recovery:  Retype the command with the correct switch.


   ERROR:     ?INVALID NUMERIC VALUE

   Reason:    You specified a non-numeric argument to a switch  expecting
              a numeric argument.

   Recovery:  Retype the command with the correct numeric argument.


   ERROR:     ?CANNOT FIND BOOTABLE STRUCTURE

   Reason:    There is no valid bootable structure  on-line  or  hardware
              problems  have  prevented  BOOT  from  finding  a  bootable
              structure.

   Recovery:  Make sure the door on the disk drive is closed, and correct
              disk pack is mounted and on-line.  Try running BOOT several
              times.  If problem still occurs, call  your  DIGITAL  Field
              Service Representative.


   ERROR:     ?NO STRUCTURE ID

   Reason:    The structure you specified is  missing  its  structure  ID
              from its HOME blocks.

   Recovery:  Notify your system manager.  If no person at your site  has
              the  expertise  to  correct this problem, call your DIGITAL
              Software Specialist.


   ERROR:     ?DUMP  ERROR - DUMP.EXE  IS  TO  SMALL:   RECONFIGURE  WITH
              MAKDMP

   Reason:    The pre-allocated file DUMP.EXE is not large enough to hold
              all of the memory pages that the BOOT program is attempting
              to dump.   Either  someone  has  recently  run  MAKDMP  and
              specified  a file size that is too small, or new memory has
              recently been added to the system and DUMP.EXE has not been
              configured to accomodate the new memory.

              The dump you receive could be missing pages.

   Recovery:  Run the MAKDMP program to reconfigure DUMP.EXE.



                                    9-23

                         ERROR RECOVERY PROCEDURES


                                    NOTE

           If none of the above error messages appear on the  CTY
           and  there  is  a  problem with the bootstrap program,
           refer to Section 9.13.



   9.5  RECOVERING THE FILE SYSTEM

   Problems of different degrees  of  severity  can  occur  in  the  file
   system.  The following sections discuss the simple cases of rebuilding
   a  directory  symbol  table  (Section  9.5.1)  and  reconstructing   a
   directory  (Section  9.5.2),  the more complex cases of reconstructing
   the  ROOT-DIRECTORY  (Section  9.5.3)  and  re-creating  a   structure
   (Section  9.5.4),  and the most complex case of re-creating the entire
   file system (Section 9.5.4).



   9.5.1  Rebuilding a Directory Symbol Table with EXPUNGE

   When TOPS-20 processes a BUGCHK, BUGINF, or BUGHLT beginning with DIR,
   and  outputs  the  number of the directory and its structure in SIXBIT
   after ADDITIONAL DATA, try to rebuild the directory symbol table.

                                    NOTE

           For rebuilding directory  number  1  (ROOT-DIRECTORY),
           refer to Section 9.5.3.

   To rebuild a directory symbol table, do the following:

        1.  Look at the two  numbers  after  ADDITIONAL  DATA.   Use  the
            second  number  to  determine the structure for the following
            procedure.  If you are at OPR> command level,  type  PUSH  to
            OPR and type the following commands:

                 RESET<RET>
                 DDT<RET>
                 DDT
                 second number<ESC>6T; PS     <CTRL/C>

            After $6T;, DDT outputs the name of the structure.

        2.  Find  the  directory  name  corresponding  to  the  directory
            number,  that is, the first number after ADDITIONAL DATA.  Do
            this by looking at a numeric ULIST  listing  for  the  proper
            structure.





                                    9-24

                         ERROR RECOVERY PROCEDURES


        3.  Type PUSH to OPR, then type:

                 ENABLE<RET>
                 EXPUNGE str:<directory>,<RET>
                 REBUILD<RET>
                 <RET>
                 POP<RET>

            where structure and directory are names, not numbers.

   Rebuilding the symbol table should eliminate any further BUGs for that
   directory.  If it does not, reconstruct the directory (Section 9.5.2).



   9.5.2  Reconstructing a Directory

   If there was a problem with a directory and the procedures in  Section
   9.5.1  did  not  eliminate  the  problem,  you  must  reconstruct  the
   directory by doing the following:

        1.  Try to save the directory's files with DUMPER.

                                    NOTE

           If the directory is a critical one, for which there is
           no  acceptable  backup,  and you cannot save the files
           with DUMPER, notify a DIGITAL software specialist.  He
           might   be   able  to  recover  most  or  all  of  the
           directory's contents.


        2.  Kill the directory with ^ECREATE and the KILL subcommand.  If
            that  fails, see Section 9.5.2.1 to delete the directory with
            the DELETE command.

        3.  Continue with Section 9.5.2.2 to re-create the directory  and
            restore its files.



   9.5.2.1  Deleting  a  Directory - If  you  must  reconstruct   a   bad
   directory  and  you  cannot  kill it with ^ECREATE, type the following
   commands:

        1.  PUSH to OPR

        2.  ENABLE your capabilities

        3.  DELETE structure:file specification,




                                    9-25

                         ERROR RECOVERY PROCEDURES


                                    NOTE

           Do  not  forget  the  ","  (comma)  after   the   file
           specification if you want to enter subcommand level.

        4.  DIRECTORY

        5.  <RET>

        6.  POP

   Structure is the name of the structure containing the  bad  directory.
   Determine  the file specification by doing the following on a piece of
   paper.

        1.  Write the name of the bad directory.  Some examples might be:

                 <MUMBLE.FOO>
                 <COT>
                 <A.YOW.1>

        2.  If the name of the bad directory does not contain a ".",  use
            "ROOT-DIRECTORY." as a prefix for the name.  For example:

                 <COT> becomes <ROOT-DIRECTORY.COT>

        3.  The name now contains a "." either because it did  originally
            or  because of Step 2.  Scan the name until you find the last
            ".".  Replace the "." with ">".  For example:

                 <MUMBLE.FOO> becomes <MUMBLE>FOO>
                 <ROOT-DIRECTORY.COT> becomes <ROOT-DIRECTORY>COT>
                 <A.YOW.1> becomes <A.YOW>1>

        4.  Replace the final ">" with ".DIRECTORY".  For example:

                 <MUMBLE>FOO> becomes <MUMBLE>FOO.DIRECTORY
                 <ROOT-DIRECTORY>COT> becomes <ROOT-DIRECTORY>COT.DIRECTORY
                 <A.YOW>1> becomes <A.YOW>1.DIRECTORY

   Then type the file specification you obtained at the end of Step 4  in
   the procedure for deleting a directory.

   If you typed the DELETE command and got the message:

        name.DIRECTORY FILE CANNOT BE EXPUNGED BECAUSE IT IS CURRENTLY OPEN

   plan to stop timesharing by doing a ^ECEASE.  After the  downtime  you
   specified in ^ECEASE occurs, type PUSH to OPR.  Then type:

        1.  DELETE str:file specification,



                                    9-26

                         ERROR RECOVERY PROCEDURES


        2.  DIRECTORY

        3.  <RET>

        4.  ^ESET LOGINS ANY

        5.  ^ESET OPERATOR-IN-ATTENDANCE

        6.  PTYCON

        7.  GET SYSTEM:PTYCON.ATO

                            ----- Example -----

   To delete the bad directory <MUMBLE.FOO> on structure PS:.

        OPR>PUSH<RET>
         TOPS-20 Command Processor 7(31)
        @ENABLE (CAPABILITIES)<RET>
        $DELETE PS:<MUMBLE>FOO.DIRECTORY,<RET>
        $$DIRECTORY<RET>
        $$<RET>
        @POP<RET>
        OPR>



   9.5.2.2  Re-Creating a Directory and Restoring Its  Files - After  you
   have  killed  or deleted a directory that needs reconstruction, do the
   following:

        1.  To re-create the directory, run DLUSER  to  load  the  latest
            file you dumped with DLUSER for the structure involved.

        2.  To restore the files of the directory you killed or  deleted,
            use the DUMPER save you just did in Section 9.5.2, Step 1, or
            the most recent DUMPER magnetic tape containing  those  files
            and run DUMPER to restore them.

        3.  If you deleted the  directory,  run  CHECKD  with  the  CHECK
            BITTABLE command and then with the RELEASE command to release
            lost pages.

                                    NOTE

                  Never  run  CHECKD  with   the   RELEASE
                  command    if    a    directory    needs
                  reconstruction.  First, reconstruct  the
                  directory.





                                    9-27

                         ERROR RECOVERY PROCEDURES


   9.5.3  Reconstructing the ROOT-DIRECTORY

   When you get a BUGCHK or  BUGHLT  beginning  with  DIR  that  involves
   directory  number  1,  or  when  you  get  the BUGHLTS BADROT, BADXT1,
   FILIRD, or FILMAP, try reconstructing <ROOT-DIRECTORY>.   Notify  your
   system manager and software specialist of this before you do anything.

   To determine the structure involved, see step 1 of Section 9.5.1.   If
   the   structure   is   not   BS:,  run  CHECKD  with  the  RECONSTRUCT
   ROOT-DIRECTORY command (Section 9.7) and specify the proper structure.
   If  the  structure  is BS:, you must tell the system to use the backup
   <ROOT-DIRECTORY> and rebuild <ROOT-DIRECTORY> by doing the following:

        1.  Type CTRL/\ to enter the PARSER.

        2.  Type SHUTDOWN to the PARSER.  (If SHUTDOWN does not  succeed,
            type ABORT.)

        3.  Mount system floppy A in drive 0.

        4.  Mount system floppy B in drive 1.

        5.  Mount your most recent system backup tape on MTA0.  If you do
            not  have  a  system  backup  tape, use your TOPS-20 Software
            Installation Tape.

        6.  Be sure the front-end HALT switch is in the ENABLE position.

        7.  Set switches 0, 1, and 2 in the switch register.

        8.  Press the switches SW REG and ENABLE simultaneously.

        9.  Type YES to ENTER DIALOG.

       10.  Type YES to RELOAD MICROCODE.

       11.  If your system has cache, you  will  see  RECONFIGURE  CACHE;
            type ALL.

       12.  Type ALL to CONFIGURE KL MEMORY.

       13.  Type MTBOOT to LOAD KL BOOTSTRAP.

       14.  Type NO to WRITE CONFIGURATION FILE.

       15.  Type /L after MTBOOT>.

       16.  Type /G143 after MTBOOT>.

       17.  Type N to DO YOU WANT TO  REPLACE  THE  FILE  SYSTEM  ON  THE
            SYSTEM STRUCTURE.



                                    9-28

                         ERROR RECOVERY PROCEDURES


       18.  TYPE Y to RECONSTRUCT ROOT-DIRECTORY.

       19.  Type the current date and time after ENTER CURRENT  DATE  AND
            TIME.

       20.  Type Y to IS THIS CORRECT if you entered the correct date and
            time.  Otherwise, type N and enter the date and time again.

       21.  Type OTHER after WHY RELOAD.

   Then CHECKD runs and outputs:

        [REBUILDING BIT TABLE]

        [WORKING ON STRUCTURE - BS:]

   The remaining steps and output are the same as in any system reload.

                            ----- Example -----

        PAR>SHUTDOWN
        **HALTED**

        %DECSYSTEM-20 NOT RUNNING

        RSX-20F VB16-00 8:55 5-MAR-88

        [SY0: REDIRECTED TO DX0:]
        [DX0: MOUNTED]
        [DX1: MOUNTED]
        KLI -- VERSION YB15-12 RUNNING
        KLI>YES
        KLI -- KL10 S/N: 2123., MODEL B, 60 HERTZ
        KLI -- KL10 HARDWARE ENVIRONMENT:
                MOS MASTER OSCILLATOR
                EXTENDED ADDRESSING
                INTERNAL CHANNELS
                CACHE
        KLI -- ENTER DIALOG [NO,YES,EXIT,BOOT]?
        KLI>YES<RET>
        KLI -- RELOAD MICROCODE [YES,VERIFY,NO]?
        KLI>YES<RET>
        KLI -- MICROCODE VERSION 2.0 [407] LOADED
        KLI -- RECONFIGURE CACHE [FILE,ALL,YES,NO]?
        KLI>ALL<RET>
        KLI -- CONFIGURE KL MEMORY [FILE,ALL,REVERSE,FORCE,YES,NO]?
        KLI>ALL<RET>
        LOGICAL MEMORY CONFIGURATION
         ADDRESS         SIZE   INT   TYPE   CONTROLLER
        00000000         768K    4    MF20       11
        KLI -- LOAD KL BOOTSTRAP [YES,NO,FILENAME]>?
        KLI>MTBOOT<RET>


                                    9-29

                         ERROR RECOVERY PROCEDURES


        KLI--WRITE CONFIGURATION FILE [YES,NO]
        KLI>NO<RET>
        KLI -- BOOTSTRAP LOADED AND STARTED

        MTBOOT>/L<RET>

        MTBOOT>/G143<RET>

        [FOR ADDITIONAL INFORMATION TYPE "?" TO ANY OF THE FOLLOWING
        QUESTIONS.]

        DO YOU WANT TO REPLACE THE FILE SYSTEM ON THE SYSTEM STRUCTURE?N<RET>

        [BOOT:LOADING] [OK]

        [BS MOUNTED]
        RECONSTRUCT ROOT-DIRECTORY?Y<RET>

        [RECONSTRUCTION PHASE 1 COMPLETED]

        SYSTEM RESTARTING, WAIT...
        ENTER CURRENT DATE AND TIME: 5-MAR-88 10:25<RET>

        YOU HAVE ENTERED MONDAY, 5-MAR-88 10:25AM,
         IS THIS CORRECT (Y,N) Y<RET>
        WHY RELOAD? OTHER<RET>
        [REBUILDING BIT TABLE]

        [WORKING ON STRUCTURE - BS:]
             .
             .
             .



   9.5.4  Re-Creating the File System or a Structure

   You should re-create the file system or a structure only when:

        1.  You have tried reconstructing  BS:<ROOT-DIRECTORY>,  but  the
            file  system or structure is still in such bad shape that the
            system or structure cannot be used, and

        2.  Your system manager has agreed that you should re-create  the
            file system or structure.

   If reconstructing BS:<ROOT-DIRECTORY> did not solve the  problem,  you
   must re-create the file system, that is, both the system structure and
   front-end file system.  (Refer to Section 9.5.4.1.) If  reconstruction
   of  a ROOT-DIRECTORY on any other structure did not succeed in solving
   the  problem,  just  re-create  that  structure.   (Refer  to  Section
   9.5.4.2.)


                                    9-30

                         ERROR RECOVERY PROCEDURES


   9.5.4.1  Re-Creating the System Structure and Front-End File  System -
   You  should  re-create the file system on the system structure only at
   your system manager's request or approval.  This request usually comes
   if the file system is in such bad shape that the system cannot be used
   and reconstruction of  the  <ROOT-DIRECTORY>  failed  to  correct  the
   problem.

   To re-create the file system on the system structure, you need:

        1.  The disk packs your system manager chooses for the  new  file
            system

        2.  The latest system backup tape

        3.  The latest DUMPER magnetic tapes (full and  incremental  save
            sets) of the system structure

        4.  The TOPS-20 Installation Guide

        5.  System floppies A, B, and C

   Then do the following:

        1.  Type CTRL/\.

        2.  Type SHUTDOWN.  (If SHUTDOWN doesn't succeed, type ABORT.)

        3.  Mount system floppy A in drive 0.

        4.  Mount system floppy B in drive 1.

        5.  Mount your latest system backup tape on MTA0.  If you do  not
            have  a  backup  tape, use your TOPS-20 Software Installation
            Tape.

        6.  Follow Steps 11 (Set the Switch Register  to  7)  through  18
            (Type  MTBOOT) in the TOPS-20 Software Installation Guide and
            Step 36 (Type /L) through 63 (Give the DUMPER Command:   TAPE
            MTA0:)  of Chapter 2 in the TOPS-20 KL10 Model B Installation
            Guide.

        7.  After  the  DUMPER>  prompt,  type   RESTORE   (TAPE   FILES)
            BS:<*>*.*.* (TO) <RET>.

        8.  Again, after the DUMPER> prompt, type  RESTORE  (TAPE  FILES)
            BS:<*>*.*.* (TO) <RET>.

        9.  After the DUMPER> prompt, type REWIND <RET>.

       10.  Remove the tape on MTA0, and mount the  first  tape  of  your
            latest full DUMPER save set.



                                    9-31

                         ERROR RECOVERY PROCEDURES


       11.  After the DUMPER> prompt, type CREATE <RET>.

                                    NOTE

           The DUMPER CREATE command obtains its attributes  from
           tape information stored on the backup tape.

       12.  After  the  DUMPER>  prompt,  type   RESTORE   (TAPE   FILES)
            BS:<*>*.*.* (TO) <RET>.

       13.  If there are additional tapes, mount the  next  tape  of  the
            save set.  Then type TAPE MTAn:, where n is the number of the
            drive on which you mounted the next tape to be read.   Repeat
            this step until all tapes of the save set have been read.

       14.  If there are incremental save sets,  you  must  restore  them
            too.  For each save set, repeat Steps 11, 12, and 13.

       15.  Re-create  the  front-end  file  system  by   following   the
            directions   in  Chapter  4  of  the  TOPS-20  KL10  Model  B
            Installation Guide.

       16.  Reload the system using the DISK  and  ENABLE  load  switches
            (Section 4.2.1).



   9.5.4.2  Re-Creating Other Structures - If a structure other than  BS:
   had  problems and <ROOT-DIRECTORY> reconstruction did not fix them, at
   your system manager's request or approval,  you  must  re-create  that
   structure.   Then  restore  its  directories  and  files.  This entire
   procedure can be done during timesharing.  First, be sure you have:

        1.  The disk packs  your  system  manager  chooses  for  the  new
            structure

        2.  The latest DUMPER magnetic tapes (full and  incremental  save
            sets) for that structure

   Then, do the following:

        1.  Type SET STRUCTURE str:  UNAVAILABLE to OPR to prevent  other
            users from MOUNTing the structure.

        2.  Type PUSH to OPR.

        3.  ENABLE your capabilities.

        4.  Follow  the  procedures  in  Section  7.14  to   create   the
            structure.




                                    9-32

                         ERROR RECOVERY PROCEDURES


        5.  Type MOUNT STRUCTURE str: to mount the structure.

        6.  Type DLUSER<RET>.

        7.  Type LOAD SYSTEM:str.TXT  to  restore  directory  parameters.
            You  should  have  previously saved these parameters (Section
            8.6).

        8.  If tape drive allocation is enabled, you must use  the  MOUNT
            command  to have the system assign you a tape drive.  If tape
            drive allocation is disabled, or if the SET TAPE DRIVE  MTAn:
            UNAVAILABLE command is used, you can assign a tape drive with
            the ASSIGN command.

        9.  Mount the first tape of your latest full DUMPER save set  for
            this structure on MTAn.

       10.  Type DUMPER<RET>.

                                    NOTE

                        See Hint below.

       11.  After the DUMPER> prompt, type TAPE MTAn:  (or MTn:,  if  the
            tape  drive is under MOUNTR control) where n is the number of
            the drive you assigned.

       12.  After the DUMPER> prompt, type CREATE<RET>.

                                    NOTE

           The DUMPER CREATE command obtains its attributes  from
           tape information stored on the backup tape.

       13.  After  the  DUMPER>  prompt,  type   RESTORE   (TAPE   FILES)
            str:<*>*.*.* (TO)<RET>.

       14.  If there are additional tapes, mount the  next  tape  of  the
            save  set.   Then,  type TAPE MTAn:, where n is the number of
            the drive on which you mounted the  next  tape  to  be  read.
            Repeat  this  step  until all tapes of the save set have been
            read.

       15.  If there are incremental save sets,  you  must  restore  them
            too.  For each save set, repeat Steps 12, 13, and 14.

       16.  Type POP<RET>.

       17.  Type SET STRUCTURE str:  AVAILABLE  to  OPR  to  allow  other
            users to MOUNT the structure.




                                    9-33

                         ERROR RECOVERY PROCEDURES


                              ----- Hint -----

   If the DUMPER tapes have files with  accounts  not  in  the  installed
   ACCOUNTS-TABLE.BIN  file,  you  must  restore  the tapes while account
   validation is disabled.  To do this:

        1.  Type PUSH to OPR.

        2.  ENABLE your capabilities.

        3.  Stop timesharing with ^ECEASE.

        4.  Edit   n-CONFIG.CMD   to    have    the    command    DISABLE
            ACCOUNT-VALIDATION.    (See   the   TOPS-20   KL10   Model  B
            Installation Guide to edit n-CONFIG.CMD.)

        5.  Type CTRL/\ and SHUTDOWN.

        6.  Reload the system.

        7.  ATTACH to the operator job 1.

        8.  Type PUSH to OPR.

        9.  Type ENABLE and ^ESET NO LOGINS-ALLOWED ANY.

       10.  Follow Steps 10 through 15 above.

       11.  Edit   n-CONFIG.CMD    to    have    the    command    ENABLE
            ACCOUNT-VALIDATION.

       12.  Type CTRL/\ and SHUTDOWN.

       13.  Reload the system.

   Alternatively, you  may  restore  the  files  by  using  your  current
   account,  that  is,  the account set in your last LOGIN or SET ACCOUNT
   command.  However, all files on the structure have that  account.   To
   restore  the  files,  continue  with  Step 11 at the beginning of this
   section (... type TAPE  MTAn: ...),  but  type  ACCOUNT SYSTEM-DEFAULT
   before the RESTORE command in Step 13.



   9.6  DIAGNOSING YOUR SYSTEM FROM A REMOTE LOCATION VIA KLINIK

   To  allow  a  DIGITAL  Field  Service  Representative  or  a  software
   specialist  to  diagnose  a  problem  in  your  system  from  a remote
   location, you must allow access via the KLINIK link.  First, determine
   with the person doing the diagnosis, the following conditions:




                                    9-34

                         ERROR RECOVERY PROCEDURES


        1.  Usage of the link -- a timesharing terminal or remote CTY

        2.  Password, if use is a remote CTY

        3.  Time period to access the KLINIK link

        4.  Highest console mode, if usage is a remote CTY.

   Then type:

        1.  <CTRL/\>

        2.  SET KLINIK

        3.  USER or REMOTE

        4.  Password, if you typed REMOTE above

        5.  Access window open date

        6.  Access window open time

        7.  Access window close date

        8.  Access window close time

        9.  Highest console mode, if you typed REMOTE above

       10.  QUIT

                            ----- Example -----

   This example shows the SET KLINIK command used  to  allow  the  KLINIK
   link  to  be  used  as a remote CTY, to establish the password FGH for
   gaining access, to allow access between the current time and 24  hours
   later, and to allow MAINTENANCE as the highest console mode.

        <CTRL/\>
        PAR>SET KLINIK<RET>
        KLINIK MODE: REMOTE<RET>
        PASSWORD: FGH<RET>
        ACCESS WINDOW OPEN DATE: <RET>
        ACCESS WINDOW OPEN TIME: <RET>
        ACCESS WINDOW CLOSE DATE: <RET>
        ACCESS WINDOW CLOSE TIME: <RET>
        HIGHEST CONSOLE MODE: MAINTENANCE
         KLINIK INACTIVE
         ACCESS WINDOW OPEN: 5-MAR-88 12:47
         ACCESS WINDOW CLOSED: 6-MAR-88 12:47
         KLINIK MODE: REMOTE
         HIGHEST CONSOLE MODE: MAINTENANCE
        PAR>QUIT<RET>


                                    9-35

                         ERROR RECOVERY PROCEDURES


   To terminate an active KLINIK link, type:

        1.  <CTRL/\>

        2.  CLEAR KLINIK

        3.  DISCONNECT

        4.  QUIT

                            ----- Example -----


        <CTRL/\>
        PAR>CLEAR KLINIK<RET>
         KLINIK DISABLED

        KLD -- KLINIK ACCESS TERMINATED BY OPERATOR

        PAR>DISCONNECT<RET>

        KLD -- KLINIK LINE DISCONNECTED

        PAR>QUIT<RET>

                             ----- Hints -----

   To find out what KLINIK parameters have been set, type WHAT KLINIK  to
   the PARSER.

   See the PARSER COMMANDS section of the RSX-20F System Reference Manual
   for more information on CLEAR KLINIK, DISCONNECT, SET KLINIK, and WHAT
   KLINIK.

                         ----- Error Messages -----

   See the PARSER ERROR MESSAGES section of the RSX-20F System  Reference
   Manual.

                        ----- KLINIK Messages -----

   KLD -- KLINIK ACCESS TERMINATED BY OPERATOR

          If the KLINIK link is active and the CLEAR  KLINIK  command  is
          given,  this message is output on the CTY and the remote KLINIK
          terminal.  This indicates that the  KLINIK  access  window  has
          been  closed,  the  KLINIK  link  has  been terminated, and the
          KLINIK parameters have been cleared.

   KLD -- KLINIK DISCONNECT

          This message is  output  on  the  CTY  and  the  remote  KLINIK


                                    9-36

                         ERROR RECOVERY PROCEDURES


          terminal after you give the DISCONNECT command to the PARSER to
          terminate KLINIK access and hang up the modem.

   KLR -- KLINIK LINE CONNECTED TO RSX-20F MODE LIMIT c

          This message is output on the CTY  and  on  the  remote  KLINIK
          terminal  when  the  remote KLINIK user specifies REMOTE KLINIK
          MODE during the KLINIK link access procedure.  The MODE LIMIT c
          is  MAINTENANCE,  PROGRAMMER,  or OPERATOR as you specified for
          HIGHEST CONSOLE MODE in the SET KLINIK command.
   KLR -- KLINIK LINE CONNECTED TO TOPS-20

          This message is output on the CTY  and  on  the  remote  KLINIK
          terminal  when a remote KLINIK user is trying to gain access to
          the KLINIK link in USER KLINIK MODE.   You  can  then  use  the
          remote KLINIK terminal for timesharing on TOPS-20.

   KLR -- KLINIK LOGON TIMEOUT -- LOGON ABORTED
   KLD -- KLINIK LINE DISCONNECTED

          If you specified REMOTE KLINIK MODE  in  the  last  SET  KLINIK
          command  and  the remote KLINIK user can not supply the correct
          password in five attempts within two minutes, this  message  is
          output  on  the CTY and the remote KLINIK terminal.  The remote
          KLINIK user must dial  again  and  go  through  the  validation
          sequence again to try to gain KLINIK access.

   KLR -- KLINIK RING - KLINIK WINDOW CLOSED

          This message is printed  on  the  CTY  and  the  remote  KLINIK
          terminal  when a remote user tries to gain access to the KLINIK
          link but the access window is closed or not defined.

   KLR -- KLINIK RING -- VALIDATING ACCESS

          If you specified REMOTE KLINIK MODE  in  the  last  SET  KLINIK
          command and a remote user has just dialed to try to gain access
          to the KLINIK link, this message is printed on the CTY.

   SAV -- *DIAG* -- KLINIK LINE ACTIVE IN USER MODE

          This message is printed on the CTY and  on  the  remote  KLINIK
          terminal  if  RSX-20F is reloaded and the KLINIK link is active
          in user mode.

   SAV -- *DIAG* -- KLINIK LINE ACTIVE IN REMOTE MODE
   SAV -- *DIAG* -- KLINIK LINE CONNECTED TO SYSTEM CONSOLE

          This message is printed  on  the  CTY  and  the  remote  KLINIK
          terminal  if  RSX-20F is reloaded and the KLINIK link is active
          in remote mode.



                                    9-37

                         ERROR RECOVERY PROCEDURES


   SAV -- *FATAL* -- PROTOCOLS NOT RUNNING

          There may be a serious software or hardware problem.   However,
          first try to reload the system.



   9.7  CORRECTING DISK SPACE WITH CHECKD

   CHECKD is run automatically at system load time when certain  problems
   are found on the system structure.  CHECKD is also run when you answer
   YES to the RUN CHECKD question at system STARTUP time.

   Type the following commands to run the CHECKD program  during  regular
   timesharing.

        1.  PUSH to OPR

        2.  ENABLE your capabilities

        3.  CHECKD

        4.  Commands to CHECKD terminated by a <RET>

        5.  EXIT command to CHECKD

        6.  POP

                                  CAUTION

           Before you run CHECKD on BS:, be sure  that  you  have
           only  one  structure  named  BS:   on the disk drives.
           Otherwise, there can be confusion over which structure
           is used.

           If your system has two structures named  BS:  on-line,
           where  one  is  just spinning and the other is already
           recognized by the system,  (that  is  mounted  as  the
           system  structure)  and you want to run CHECKD on BS:,
           CHECKD chooses the structure that  is  just  spinning.
           If  CHECKD does not find a BS:  that is just spinning,
           it uses the already recognized system structure.

   Some CHECKD commands should not be used if there are other users using
   the structure.  These commands are:

        1.  CHECK BITTABLE

        2.  REBUILD

        3.  RECONSTRUCT INDEX-TABLE



                                    9-38

                         ERROR RECOVERY PROCEDURES


        4.  RECONSTRUCT ROOT-DIRECTORY

        5.  SCAN

   If there are other users on the structure and the structure is BS:, do
   a  ^ECEASE  and  wait for the message SHUTDOWN COMPLETE before running
   CHECKD.  If the structure is other than BS:, turn  to  Section  7.11.3
   before running CHECKD.

   If you do not specify a structure in a  CHECKD  command,  CHECKD  uses
   your  connected  structure.   Note  that  at  any time while CHECKD is
   processing directories, you can type CTRL/A to find out  the  name  of
   the directory currently being checked.

   The following commands can be given to CHECKD.


   CHECK BITTABLE (CONSISTENCY OF) str:

                                    NOTE

           Perform CHECK BITTABLE on BS:  at system startup  time
           by  answering  YES  to  CHECKD.  Never issue the CHECK
           BITTABLE command during regular timesharing.

        This command causes the structure's bit  table,  which  indicates
        what  disk  space  is  used, to be checked against the disk space
        that each file  on  the  structure  claims  to  have  used.   Any
        discrepancies  are  listed on your terminal, and the addresses of
        lost pages are written into the file str:<dir>str-LOST-PAGES.BIN,
        where  str  and  dir  are your connected structure and directory.
        This command also executes the CHECK DIRECTORY command to CHECKD.
        (See Section 9.7.1 for more detail on CHECK BITTABLE.)
                                    NOTE

             If you see in the error report any  messages  with
             MULTIPLY   ASSIGNED   DISK  ADDRESS  (meaning  the
             address is used  by  more  than  one  file),  take
             immediate  action.   Refer  to the SCAN command in
             CHECKD (later in this section),  and  perform  the
             steps discussed there.


   CHECK DIRECTORY (CONSISTENCY OF) str:

        This command checks the validity of certain information  in  each
        directory  on  the  structure.   If  an error occurs, the monitor
        rebuilds  the  symbol  table  on  the  specified  structure   and
        recomputes  the amount of disk space used for directories needing
        such action.  If a symbol table is being rebuilt, CHECKD outputs:

             % REBUILDING SYMBOL TABLE FOR structure:<directory>


                                    9-39

                         ERROR RECOVERY PROCEDURES


        If the rebuild is successful, CHECKD then outputs [OK] at the end
        of the message.  Otherwise, it outputs [FAILED].


   CREATE (NEW FILE SYSTEM FOR) str:

        This command creates the file structure according  to  parameters
        that you specify to the questions asked by CHECKD.


   DISABLE
   ENABLE Enables or disables one of the following features.

        AUTOMATIC STARTUP
             Marks the structure  as  the  primary  public  structure  at
             system startup time.  The serial number of the CPU for which
             this is the primary public structure is requested.

        BAT-BLOCK-DELETE
             Allows a verification pass of the  disk  to  delete  entries
             from  the  BAT BLOCKs.  If this feature is disabled, entries
             will only be added.

        ECC-ERROR-MAPPING
             Controls whether ECC errors will be added to the BAT  blocks
             during a verification pass on the disk.  This includes pages
             for which the first attempt to  read  the  page  with  error
             correction  enabled  failed,  but  one  of  the  following 7
             retries was successful.  It is strongly suggested that  this
             switch be ENABLED.

        LARGE DIRECTORIES
             Controls whether directories may  contain  huge  amounts  of
             files  or  not.   Use DISABLE to guarantee that a particular
             structure can be used  on  small  and  large  systems.   Use
             ENABLE  to  allow  directories to grow large on a structure.
             Note that if a directory grows large, the structure will  no
             longer be usable on a small system.

        SOFT-ERROR-MAPPING
             Controls whether soft errors will be added to the BAT blocks
             during  a  verification  pass  on the disk.  Soft errors are
             defined as failure to read the disk without  ECC  correction
             or system error recovery (reading with offset).
        WRITE-VERIFICATION (OF) DATA
             Controls read after write verification of pages  written  to
             the  data space on a disk.  Note that using this feature may
             cause serious performance problems.

        WRITE-VERIFICATION (OF) SWAPPING
             Controls read after write verification of pages  written  to
             the  swapping space on a disk.  Note that using this feature


                                    9-40

                         ERROR RECOVERY PROCEDURES


             may cause serious performance problems.

        PASSWORD-ENCRYPTION
             Controls whether passwords are encrypted or not.


   EXIT (TO MONITOR)

        This command returns you to system command level.


   HELP

        This command prints out a help text.


   LIMIT (NUMBER OF FILES PER DIRECTORY ON) str:

        This command limits the number of  directories  and  files  on  a
        structure.  It also guarantees that if the structure is used on a
        2040S or 2060, it can later be used on a 2040 or 2050.   However,
        the  command  disallows  the 2040S or 2060 feature of adding more
        directories and files than a 2040 or 2050 can support.


   REBUILD (BIT TABLE OF) str:

        This command is for use by your software specialist.  It  is  not
        recommended  for  operator  use.   It causes the bit table on the
        specified structure to be completely rebuilt.

                                    NOTE

                  No one should  be  using  the  structure
                  when   REBUILD  is  used.   Also,  if  a
                  directory   needs   reconstruction,   it
                  should  be  reconstructed before REBUILD
                  is used.


   RECONSTRUCT INDEX-TABLE (OF) str:

        This command is for use by your software specialist.  It  is  not
        recommended  for  operator  use.   This command repairs a damaged
        index  table  file  (str:<ROOT-DIRECTORY>INDEX-TABLE.BIN).   This
        command  cannot  be  used  during timesharing and should never be
        used on your system structure.


   RECONSTRUCT ROOT-DIRECTORY (OF) str:

        This  command  reconstructs  <ROOT-DIRECTORY>  on  the  specified


                                    9-41

                         ERROR RECOVERY PROCEDURES


        structure.

                                      NOTE

                Do  not   use   this   command   to   reconstruct
                <ROOT-DIRECTORY>  on  the system structure.  (See
                Section 9.5.3.)


   RELEASE (LOST PAGES FROM) file specification (FOR) str:

        This command allows you to free lost pages while other users  are
        on  the system.  When CHECKD reports lost pages, you should first
        resolve any errors indicated by CHECKD (Section  9.7.1)  and  run
        CHECKD  again  with  CHECK  BITTABLE  to  see if errors are gone.
        Then, run CHECKD under <OPERATOR> and use  this  command.   Press
        RETURN   for   the   file  specification  to  indicate  the  file
        str:<dir>str-LOST-PAGES.BIN.n,  where  str  and  dir   are   your
        connected structure and directory, and n is the latest generation
        of the file.  You may also type the name of the file.

        Then, after you EXIT from CHECKD, type:

   EXPUNGE

        to expunge all generations of the file.

                                    NOTE

                  If  a  directory  needs  reconstruction,
                  reconstruct   it  and  issue  the  CHECK
                  BITTABLE command  before  you  ever  use
                  RELEASE.

                  Use the RELEASE command  with  only  the
                  most  current  generation  of  the  lost
                  pages file.


   SCAN (FOR DISK ADDRESSES IN) file specification (FOR) str:

        This command scans the structure  for  addresses  listed  in  the
        specified  file.   Instead  of  specifying  a file containing the
        addresses, you can type TTY:<RET>, type  addresses  separated  by
        <RET>,  and  end  with  CTRL/Z.   The  output  from  the  command
        indicates which files contain the disk addresses specified.  This
        command  is  especially  important  if the CHECK BITTABLE command
        outputs  a  message  indicating  that  an  address  is   multiply
        assigned.

        Use the SCAN command  when  there  are  no  other  users  on  the
        structure  involved.  Therefore, whenever CHECKD finds a multiply


                                    9-42

                         ERROR RECOVERY PROCEDURES


        assigned address on BS:, you should do the following as  soon  as
        possible.  (If the structure is not BS:, remove the structure and
        then follow Steps 4 through 6 below.)

        1.  Type PUSH to OPR.

        2.  ENABLE your capabilities.

        3.  Give the ^ECEASE command  to  stop  timesharing  as  soon  as
            possible.

        4.  Run CHECKD.

        5.  Give the SCAN command to  CHECKD  and  specify  the  multiply
            assigned  address/addresses  as indicated above.  When CHECKD
            finds an address for which it  is  searching,  it  outputs  a
            message  like  the  error  report at the beginning of Section
            9.7.1.  The error field contains  FOUND  DISK  ADDRESS.   For
            each  file  in  which  CHECKD  found an address, it outputs a
            summary line of the form:

                 n SEARCH ADDRESSES FOUND.

        6.  After CHECKD outputs the names of the  files  containing  the
            multiply  assigned address/addresses, try to copy each of the
            files involved to another directory (perhaps  PS:<OPERATOR>).
            (Do  not use RENAME on the original files.)  Then, delete the
            original files, using the FORGET subcommand to  DELETE.   For
            example:

                 $DELETE filespec1,filespec2,<RET>
                 $$FORGET<RET>
                 $$<RET>
                 $

        7.  Type ^ESET LOGINS ANY.

        8.  Run PTYCON.

        9.  Type GET SYSTEM:PTYCON.ATO.

       10.  Using MAIL or SEND, notify the owners of  the  deleted  files
            and discuss salvaging their files either from the copy, if it
            was successful, or from a DUMPER tape.

   UNLIMIT (NUMBER OF FILES PER DIRECTORY ON) str:

        This command allows a 2040S or 2060 to create on a structure more
        directories  and  files than a non-2060 can support.  The command
        is used to allow this feature on a structure that was  previously
        limited (the LIMIT command was given for the structure).



                                    9-43

                         ERROR RECOVERY PROCEDURES


                             ----- Hints -----

   When CHECKD is run automatically at system load time because  of  disk
   problems  or  when  you  answer YES to the RUN CHECKD question, CHECKD
   performs the CHECK BITTABLE and CHECK DIRECTORY functions.  You should
   answer  YES  to  the  RUN CHECKD question periodically, perhaps once a
   day, and  always  after  a  disastrous  hardware  failure.   When  the
   standard  PTYCON.ATO  file  is used, one of the operator jobs runs the
   CHECK DIRECTORY function of CHECKD immediately  after  the  system  is
   reloaded.

                          ----- Requirement -----

   OPERATOR or WHEEL capability must be enabled and the CTRL/C capability
   set.

                         ----- Error Messages -----

   ERROR:     ?CHECKD:  STRUCTURE NOT FOUND

   Reason:    CHECKD could not find the structure you specified.

   Recovery:  Be sure you have the proper disk packs mounted and  reissue
              the command.


   ERROR:     ?INVALID COMMAND CONFIRMATION

   Reason:    You pressed a character other than the RETURN  key  at  the
              end of the command.

   Recovery:  Reissue the command and execute the command by pressing the
              RETURN key.


   ERROR:     ?JSYS ERROR:  message

   Reason:    A JSYS that CHECKD was executing failed.

   Recovery:  Refer to the TOPS-20 Monitor Calls Reference Manual for the
              message.


   ERROR:     ?NOT A CHECKD COMMAND

   Reason:    The command that you typed to CHECKD is not a valid  CHECKD
              command.

   Recovery:  Reissue the correct command.


   ERROR:     WHEEL OR OPERATOR CAPABILITY REQUIRED


                                    9-44

                         ERROR RECOVERY PROCEDURES


   Reason:    You tried to run the CHECKD  program  without  OPERATOR  or
              WHEEL capability.

   Recovery:  If you are a privileged  user,  enable  your  capabilities;
              otherwise,  use  a  job  logged  in  under OPERATOR, (which
              should have operator capability) type ENABLE, and rerun the
              CHECKD program.



   9.7.1  Reports from CHECK BITTABLE

   When CHECKD finds  errors  during  the  CHECK  BITTABLE  function,  it
   outputs error reports in the format:



        error(including address n): page type
        SUMMARY FOR FILE file
        m    error type
        - - - - - - -

   Pay close attention to the error portion of the report, and  take  any
   action indicated in the explanation for that error.  The page-type and
   error-type  information  is  for  your  software  specialist,   system
   manager, or owner of the file.

   CHECKD first checks special system blocks, then  swapping  space,  and
   finally  file  pages.   If  an  error occurs in checking the first two
   types of disk usage, the error report includes for each  disk  address
   in error only the first line of the error report format.

   The possible errors output in  a  report  are  discussed  first.   The
   following  conventions  are used in the list of those errors and their
   explanations below:

           n = the number of a sector; the sector is a location on a disk
               pack  relative  to  the beginning of a structure (also the
               number to use in the SCAN command to CHECKD)

        page = four consecutive sectors or the  minimum  allocation  unit
               for disk space

                               ----- Error Messages -----

   ERROR:     DISK ADDRESS n MARKED IN BAT BLOCKS

   Reason:    A page used by the TOPS-20 file system is marked in the BAT
              (bad  allocation  table)  blocks.   This means a hard error
              occurred on this page.

   Recovery:  Try to copy the file.   Then  delete  the  file  using  the


                                    9-45

                         ERROR RECOVERY PROCEDURES


              DELETE  command  with  the  FORGET subcommand.  Notify your
              system manager or the owner of the file that the data in  a
              page  may  have been in error.  If the copy was successful,
              try recovering the file.  Otherwise, recover the file  from
              the most recent backup tape.


   ERROR:     DISK ADDRESS n NOT IN BIT TABLE

   Reason:    A page used by the file system was not assigned in the  bit
              table.

   Recovery:  CHECKD corrects this error automatically.


   ERROR:     ILLEGAL DISK ADDRESS n

   Reason:    CHECKD found a disk address too large for the size  of  the
              structure.

   Recovery:  Try to copy the file.   Then  type  ENABLE  and  press  the
              RETURN  key.  Delete the file using the DELETE command with
              the FORGET subcommand.  Notify your system manager  or  the
              owner  of the file that data in the file may have contained
              errors.  If the copy was  successful,  try  recovering  the
              file.   Otherwise,  recover  the  file from the most recent
              backup tape.


   ERROR:     MULTIPLY ASSIGNED DISK ADDRESS n

   Reason:    CHECKD found a page that was already assigned.  This  means
              two or more files are using the same disk address or a file
              is uing a disk address previously  assigned  to  a  special
              file system block or to the swapping space.

   Recovery:  Use the CHECKD command SCAN to indicate which files contain
              the  disk  address  specified.   (Refer to the SCAN command
              Section 9.7 to resolve this problem.)

   If any of the preceding errors occur, CHECKD also outputs a page type.
   This  indicates  the  usage of the page containing the disk address in
   error.  The page types are:

        FILE PAGE n
        LONG FILE PAGE TABLE
        PAGE TABLE
        SPECIAL SYSTEM BLOCKS
        SWAPPING SPACE

   If CHECKD has reported errors for a file, it then outputs:



                                    9-46

                         ERROR RECOVERY PROCEDURES


        SUMMARY FOR FILE file

   where file is a complete file specification.  CHECKD follows this with
   summary  lines containing each type of error that has occurred for the
   file, and how many times the error occurred.  Note that one error  can
   sometimes  cause  two  summary  lines.  The error types in the summary
   are:

        ASSIGNED PAGES MARKED IN BAT BLOCKS
        DISK READ ERRORS
        FAULTY ADDRESSES IN LONG FILE PAGE TABLE
        FAULTY ADDRESSES IN PAGE TABLE
        FAULTY LONG FILE PAGE TABLE ADDRESSES IN FDB
        FAULTY PAGE TABLE ADDRESSES IN FDB
        FILE ADDRESSES NOT IN BIT TABLE
        ILLEGAL ADDRESSES
        LONG FILE PAGE TABLES UNREADABLE
        MULTIPLY ASSIGNED ADDRESSES
        PAGE TABLES UNREADABLE

   The last summary line for a file is followed by line of dashes.   Then
   other error reports may follow.

   Once CHECKD has finished checking all the files, it  outputs  a  final
   summary of page counts as follows:

        LOCAL COUNT OF FILE PAGES: i
        LOCAL COUNT OF OVERHEAD PAGES: j
        LOCAL COUNT OF USED PAGES: k

        SYSTEM COUNT BEFORE CHECKD: l
        SYSTEM COUNT AFTER CHECKD: m

   In the above final summary:

        i = number of pages used for data
        j = number of pages used for overhead for the structure; includes
            special system blocks, swapping pages, and overhead pages for
            files
        k = number of pages that CHECKD found to be used
        l = number of pages that the  system  indicated  as  used  before
            CHECKD was run
        m = number of pages that  the  system  indicated  as  used  after
            CHECKD was run

   If there are no errors, i plus j should equal k, and m minus k  should
   equal  lost  pages (discussed later in this section).  If m is greater
   than l, CHECKD found one or more pages that were used but not assigned
   in  the  system  bit  table.   CHECKD assigns them, and m reflects the
   count.  During the last part of the CHECK  BITTABLE  function,  CHECKD
   compares  a  bit  table  it  created with the system bit table for the
   appropriate structure.  CHECKD then compares information  in  the  two


                                    9-47

                         ERROR RECOVERY PROCEDURES


   tables.   If  page  counts disagree, or if the system bit table says a
   page is not used but CHECKD says it is used, CHECKD outputs:

        ?BIT TABLES INCONSISTENT AT CYLINDER n

   Cylinder n is an area on a disk pack.  This message  indicates  either
   an  error  in  CHECKD  or  the monitor or that someone else is running
   CHECKD which they should not be.

   If the system bit table says that a page is used but CHECKD says it is
   not used, CHECKD counts the page as a lost page.  It then outputs:

        THERE ARE n LOST PAGES
        ADDRESSES ARE IN FILE file

   where n is the number of lost pages found and file is the name of  the
   file containing the addresses of those pages.  The file name is of the
   form  str:<dir>str-LOST-PAGES.BIN.n,  where  str  and  dir  are   your
   currently  connected  structure and directory.  If the file is written
   at system load time, it is BS:<OPERATOR>BS-LOST-PAGES.BIN.n.

   If CHECKD reported an illegal disk address or a multiply assigned disk
   address,  it  does  not  write  the lost page addresses in a file.  It
   outputs:

        %SUPPRESSED WRITING OF LOST PAGES FILE , TOO MANY ERRORS

   If you get this message, correct the errors and run  CHECKD  with  the
   CHECK  BITTABLE function again to get a lost-pages file.  It should be
   noted that the structure remains mounted with the alias name of CHECKD
   even  though  the  SHOW  STATUS  DISK-DRIVES  command  will  show  the
   structure mounted with its actual name and no indication  that  it  is
   still mounted as CHECKD.

   To regain disk space counted as lost pages, see the RELEASE command to
   CHECKD (Section 9.7).

   If there are no lost pages, CHECKD outputs:

        THERE ARE NO LOST PAGES

   If CHECKD finds certain directory inconsistencies which  cause  it  to
   try rebuilding a directory symbol table, it outputs:

        % REBUILDING SYMBOL TABLE FOR str:<directory>

   If the rebuild is successful,  CHECKD  outputs  [OK].   Otherwise,  it
   outputs [FAILED].  It is normal for CHECKD to occasionally rebuild the
   symbol table for <ROOT-DIRECTORY> to account for the space used when a
   directory expands by a page.

   If the rebuild fails, you should try to save,  with  DUMPER,  all  the


                                    9-48

                         ERROR RECOVERY PROCEDURES


   files  in  the  directory  involved.   Then  follow  the procedures in
   Sections 9.5.2.1 and 9.5.2.2.  After that, discuss salvaging the files
   with their owners.

   If you get any of the following messages from CHECKD, perform the same
   procedure  as when a rebuild fails.  In the messages, str:<dir> is the
   structure and directory name of the inconsistent directory.

        ACTBAD: ILLEGAL FORMAT FOR ACCOUNT BLOCK IN DIRECTORY str:<dir>

        DR0CHK: ILLEGAL FORMAT FOR PAGE 0 IN DIRECTORY str:<dir>

        EXTBAD: ILLEGAL FORMAT FOR EXTENSION BLOCK IN DIRECTORY str:<dir>

        FDBBAD: ILLEGAL FORMAT FDB IN DIRECTORY str:<dir>

        NAMBAD: ILLEGAL FORMAT FOR NAME BLOCK IN DIRECTORY str:<dir>

        OPENF FAILED ON DIRECTORY str:<dir> - SKIPPED

        RCDIR FAILED ON DIRECTORY str:<dir> - SKIPPED

        UNSBAD: ILLEGAL FORMAT FOR ACCOUNT BLOCK IN DIRECTORY str:<dir>

                            ----- Examples -----

     1. RUN CHECKD? Y<RET>
        [CHECKING FILE CONSISTENCY]

        [WORKING ON STRUCTURE - BS:]

        DISK ADDRESS 4 MARKED IN BAT BLOCKS: SPECIAL SYSTEM BLOCKS
        - - - - - - -
        DISK ADDRESS 443264 MARKED IN BAT BLOCKS: SWAPPING SPACE
        DISK ADDRESS 444574 MARKED IN BAT BLOCKS: SWAPPING SPACE
        - - - - - - -
        DISK ADDRESS 220754 MARKED IN BAT BLOCKS: FILE PAGE 50
        SUMMARY FOR FILE BS:<FIELD-IMAGE>COBOL.EXE.4
        1    ASSIGNED PAGES MARKED IN BAT BLOCKS
        - - - - - - -
        % REBUILDING SYMBOL TABLE FOR BS:<ROOT-DIRECTORY> [OK]
        DISK ADDRESS 1350340 MARKED IN BAT BLOCKS: FILE PAGE 1
        SUMMARY FOR FILE BS:<TOTTON>XPL.PAT.1
        1    ASSIGNED PAGES MARKED IN BAT BLOCKS
        - - - - - - -
        LOCAL COUNT OF FILE PAGES: 129711
        LOCAL COUNT OF OVERHEAD PAGES: 15858
        LOCAL COUNT OF USED PAGES: 145569

        SYSTEM COUNT BEFORE CHECKD: 146671
        SYSTEM COUNT AFTER CHECKD: 146671



                                    9-49

                         ERROR RECOVERY PROCEDURES


        THERE ARE 1086 LOST PAGES
        ADDRESSES ARE IN FILE PS:<OPERATOR>PS-LOST-PAGES.BIN.1


     2. DISK ADDRESS 220754 MARKED IN BAT BLOCKS: FILE PAGE 50
        SUMMARY FOR FILE PS:<FIELD-IMAGE>COBOL.EXE.4
        1    ASSIGNED PAGES MARKED IN BAT BLOCKS
        - - - - - - -
        MULTIPLY ASSIGNED DISK ADDRESS 1403114: FILE PAGE 2762
        SUMMARY FOR FILE PS:<RMSQA-TEST>FOOREL1..4
        1    FAULTY ADDRESSES IN PAGE TABLE
        1    MULTIPLY ASSIGNED ADDRESSES
        - - - - - - -

        MULTIPLY ASSIGNED DISK ADDRESS 261534: FILE PAGE 52

        SUMMARY FOR FILE PS:<RMSQA-TEST>RMSSYM.UNV.14
        1    FAULTY ADDRESSES IN PAGE TABLE
        1    MULTIPLY ASSIGNED ADDRESSES
        - - - - - - -
        % REBUILDING SYMBOL TABLE FOR PS:<ROOT-DIRECTORY> [OK]
        DISK ADDRESS 1350340 MARKED IN BAT BLOCKS: FILE PAGE 1
        SUMMARY FOR FILE PS:<UNSUPPORTED>TV.EXE.7
        1    ASSIGNED PAGES MARKED IN BAT BLOCKS
        - - - - - - -

        LOCAL COUNT OF FILE PAGES: 125793
        LOCAL COUNT OF OVERHEAD PAGES: 15216
        LOCAL COUNT OF USED PAGES: 141007

        SYSTEM COUNT BEFORE CHECKD: 141149
        SYSTEM COUNT AFTER CHECKD: 141149

        THERE ARE 137 LOST PAGES
        % SUPPRESSED WRITING OF LOST PAGES FILE , TOO MANY ERRORS



   9.8  RESTARTING PROGRAMS UNDER SYSJOB

   When you receive a fatal error message  on  the  CTY  from  a  program
   running under SYSJOB, you must restart it by giving commands to SYSJOB
   via the ^ESPEAK command.  The format of the message follows:











                                    9-50

                         ERROR RECOVERY PROCEDURES


        ** SYSJOB: SUBJOB CRASHED, DATA FOLLOWS: **
          n process state AT m  date time
          Jsys error:message
          FORK ACS:  a  b  c  d

              n = number of the process
        process = name of the process, e.g., INFO
          state = CRASHED or HALTED
              m = PC value
           abcd = content of accumulators 1 to 4

   Also, if you type the SYSJOB  STATUS  command  via  ^ESPEAK  (see  the
   TOPS-20  Operator's Command Language Reference Manual) and there is no
   entry for a program normally run under SYSJOB, you must  restart  that
   program.

   The following programs run as processes under SYSJOB:

        1.  INFO

        2.  ORION

        3.  QUASAR

        4.  MOUNTR

        5.  MAILER

        6.  MAPPER

        7.  LPTSPL

        8.  CDRIVE

        9.  SPRINT

   To restart a program under SYSJOB, type the following commands:

        1.  PUSH to OPR

        2.  ENABLE your capabilities

        3.  ^ESPEAK

        4.  RUN SYS:program

        5.  CTRL/Z

        6.  POP

                                    NOTE

           Programs running under SYSJOB must be restarted in the
           same order as they are in the SYSJOB.RUN file.
                                    9-51

                         ERROR RECOVERY PROCEDURES


                            ----- Example -----

        OPR>PUSH<RET>
         TOPS-20 Command Processor 7(31)
        @ENABLE<RET>
        $^ESPEAK<RET>
         [PLEASE TYPE SYSJOB COMMANDS - END WITH ^Z]
        RUN SYS:INFO
        <CTRL/Z>
        $POP<RET>
        OPR>

                             ----- Hints -----

   If you restart  QUASAR,  you  must  also  restart  all  spoolers,  for
   example,  MOUNTR,  CDRIVE,  LPTSPL,  BATCON,  and SPRINT (if they were
   previously running).  To restart ORION, you must restart all OPRs.  To
   do this simply run OPR and type any OPR command.



   9.8.1  GALAXY Crash Recovery Procedures

   GALAXY programs may stop performing useful work for one of the reasons
   listed  below.   When  a  program  stops  processing, this stoppage is
   referred to as a "crash".  This section describes how you can  recover
   from a GALAXY program crash.

   Reasons for program crashes are:

        1.  A monitor call (JSYS) that should not fail  takes  the  error
            return and an error occurs.

        2.  An error is  detected  by  the  built-in  consistency  checks
            within the various components of GALAXY and an error occurs.

        3.  An undetected  error  eventually  causes  an  illegal  memory
            reference and an error occurs.

   You should take one of the following steps should a  GALAXY  component
   (program)  crash.   It  is  assumed that GALAXY is running as multiple
   forks under SYSJOB.  When a GALAXY components crashes, the core  image
   of  the  component  is  written  in the SPOOL:  area.  The filename is
   XXXXXX-YYY-CRASH.EXE where:

        XXXXXX - is the name of  the  component  that  crashed,  such  as
                 BATCON or ORION.

        YYY - the 3-character error name.





                                    9-52

                         ERROR RECOVERY PROCEDURES


   Table 9-1:  GALAXY Component Crash Recovery Procedures

   ______________________________________________________________________

     Component                             Recovery
   ______________________________________________________________________

     LPTSPL            If LPTSPL crashes, it will  automatically  restart
                       the jobs which were being processed at the time of
                       the crash from the page  number  recorded  in  the
                       last  checkpoint.  At the CTY, issue the following
                       commands:

                       ^ESPEAK
                       STATUS
                       ^Z

                       Now, using the process number specified for LPTSPL
                       in  the  STATUS  display,  kill off all the LPTSPL
                       processes using the SYSJOB PURGE  command.   There
                       is  one  PURGE  command  required  for each LPTSPL
                       process running under SYSJOB.

                       ^ESPEAK
                       PURGE <fork number>
                       PURGE <fork number>
                       ^Z

                       Now, restart all  the  LPTSPL  jobs  under  SYSJOB
                       using  the  SYSJOB  RUN command.  There is one RUN
                       command required for each line printer you want to
                       start.

                       ^ESPEAK
                       RUN SYS:LPTSPL
                       RUN SYS:LPTSPL
                       ^Z

                       The  line  printer  spooler(s)  is  now  ready  to
                       process   user   requests   again.   If  required,
                       re-issue the OPR START commands to restart the LPT
                       processing.


     CDRIVE            If CDRIVE crashes, all jobs currently  being  read
                       from the card reader will be lost and will have to
                       be  restarted.   To  restart  CDRIVE,  issue   the
                       following commands:

                       ^ESPEAK
                       KILL CDRIVE
                       RUN SYS:CDRIVE


                                    9-53

                         ERROR RECOVERY PROCEDURES


                       ^Z

                       The card reader spooler is now ready to read cards
                       again.    If  required,  re-issue  the  OPR  START
                       commands to restart the CDR processing.

     SPRINT            If SPRINT crashes, it can be  restarted  without
                       loss  of  data.   To  restart  SPRINT, issue the
                       following commands:

                       ^ESPEAK
                       KILL SPRINT
                       RUN SYS:SPRINT
                       ^Z

                       The card reader  interpreter  is  now  ready  to
                       start  processing  spooled card decks again.  No
                       OPR commands are necessary  (or  available)  for
                       controlling SPRINT.


     SPROUT            If SPROUT  crashes,  all  jobs  currently  being
                       processed  are  restarted  from the beginning of
                       the current file.  To restart SPROUT, issue  the
                       following commands:

                       ^ESPEAK
                       KILL SPROUT
                       RUN SYS:SPROUT
                       ^Z

                       The card punch/plot  spooler  is  now  ready  to
                       start   processing   user  requests  again.   If
                       required, re-issue the  OPR  START  commands  to
                       restart the CDP/PLT processing.


     ORION             If ORION crashes, the  only  indication  of  the
                       crash will be the dump which gets printed on the
                       CTY.  After ORION is restarted, all OPR programs
                       running  at  that  time will automatically reset
                       the OPR/ORION link with the first command  typed
                       to   the   OPRs.    The   first   command   that
                       re-establishes the OPR/ORION link will be lost.

                       Any DN60 termination remote stations  should  be
                       shut  down  and  restarted.   To  restart ORION,
                       issue the following commands:

                       ^ESPEAK
                       KILL ORION
                       RUN SYS:ORION


                                    9-54

                         ERROR RECOVERY PROCEDURES


                       ^Z

                       The operator controller program is now ready  to
                       process  OPR  commands and route messages to the
                       appropriate processors.


     OPR               If OPR crashes, just restart it ($R OPR).

     BATCON            If  BATCON  crashes,  first  display  the  batch
                       stream  status  from  OPR.  For all active batch
                       streams, issue a LOGOUT  command  for  each  job
                       running  under batch.  Logging the jobs off will
                       not delete the queue entry.  The batch job  will
                       be restarted when BATCON is restarted.  When all
                       active batch jobs have been  logged  out,  issue
                       the following commands to restart it:

                       ^ESPEAK
                       KILL BATCON
                       RUN SYS:BATCON
                       ^Z

                       The batch controller is  now  ready  to  process
                       user  requests again.  If required, re-issue the
                       OPR  START  commands  to   restart   the   batch
                       processing.


     QUASAR            If  QUASAR  crashes,  user  requests  for  queue
                       services  will  not be lost.  QUASAR maintains a
                       queue on BS:<SPOOL> which contains copies of all
                       outstanding user requests.  Restarting QUASAR is
                       a problem, however.   QUASAR  also  maintains  a
                       list  of  all  running  GALAXY  processors.   If
                       QUASAR is restarted, it no  longer  knows  about
                       the  rest  of  the  GALAXY spoolers.  To restart
                       QUASAR, first determine  what  batch  jobs  were
                       running  at  the  time of the crash and log them
                       out.  Next,  issue  the  following  commands  to
                       restart QUASAR:

                       ^ESPEAK
                       KILL QUASAR
                       RUN SYS:QUASAR
                       ^Z

                       The request controller is now ready  to  process
                       user requests again.  However, since QUASAR does
                       not know about any  running  spoolers,  ALL  the
                       spoolers  must  also be restarted.  In addition,
                       you must restart MOUNTR,  the  mountable  device


                                    9-55

                         ERROR RECOVERY PROCEDURES


                       processor.   Follow  the  instructions above for
                       restarting  the  following  spoolers:    LPTSPL,
                       BATCON, CDRIVE, SPRINT, SPROUT.

                       Assuming  that  MOUNTR  is  also  running  under
                       SYSJOB,  issue the following commands to restart
                       it:

                       ^ESPEAK
                       KILL MOUNTR
                       RUN SYS:MOUNTR
                       ^Z

                       After the spoolers and MOUNTR are restarted, you
                       must run OPR and give the TAKE command using the
                       SYSTEM.CMD file and any other command files used
                       for  system  startup.   This will restart normal
                       GALAXY processing.


     NEBULA            If NEBULA  crashes,  cluster  GALAXY  activities
                       such  as  remote  SHOWs  and  DISMOUNTs  will be
                       disallowed.  Issue  the  following  commands  to
                       restart NEBULA:

                       ^ESPEAK
                       KILL NEBULA
                       RUN SYS:NEBULA ^Z


     LISSPL            If LISSPL crashes, remote cluster printing  will
                       be  disallowed.  Issue the following commands to
                       restart LISSPL:

                       ^ESPEAK
                       KILL LISSPL
                       RUN SYS:LISSPL ^Z
   ______________________________________________________________________


   If you were trying to run MAIL and you received a message from  SYSJOB
   indicating a problem with MAILER or INFO, restart MAILER or INFO.



   9.9  HUNG CONSOLE TERMINAL

   If you are trying to type at the CTY and no characters  are  printing,
   do the following:

        1.  Be sure the terminal is plugged in.



                                    9-56

                         ERROR RECOVERY PROCEDURES


        2.  Be sure the CTY has paper.  If it  does  not,  replenish  the
            paper supply.  If you still get no characters printed, switch
            the terminal to LOCAL and then back to line.

        3.  Check the fuse on the vertical panel under the keyboard.

        4.  Try the terminal in LOCAL.

        5.  Be sure it is ON LINE and set for the correct speed.

        6.  See if CTRL/\ (control backslash) gets you into  the  console
            processor  command language.  If it does, type QUIT or CTRL/Z
            to return to TOPS-20.

        7.  Check to see if other terminals are working.

   If you continue to still have  problems,  notify  your  DIGITAL  Field
   Service Representative.



   9.10  MEMORY CONFIGURATION FAILED

   When memory is being configured, it is possible  to  receive  a  fatal
   error message in the form of:

        KLI--?FATAL MEMORY CONFIGURATION ERROR-CODE "XXX"
        where "xxx" = the diagnostic error code

   If this error occurs, KLI asks you if you  want  to  configure  memory
   again.   Type  FORCE  and  press  the  RETURN key.  If the error still
   persists, call your DIGITAL Field Service Representative.



   9.11  TOPS-20 MONITOR NOT FOUND

   If you are loading the  system  using  the  KL  bootstrap  that  reads
   TOPS-20  from  disk and, after the message KLI -- BOOTSTRAP LOADED AND
   STARTED, you get:

        ?FIL NOT FND

   the bootstrap was not able to find on disk the  TOPS-20  monitor  that
   you  specified.  Unless you specified a name after a BOOT> prompt, the
   file not found was BS:<SYSTEM>MONITR.EXE.

   Consider the following:

        1.  If you specified a nondefault monitor name, be sure you typed
            the correct directory name and filename.



                                    9-57

                         ERROR RECOVERY PROCEDURES


        2.  Be sure you have loaded a bootstrap that loads a monitor from
            disk.

        3.  Be sure the appropriate disk packs are mounted and  that  the
            drives are on-line.

        4.  If you wanted the default monitor, you must try  to  load  it
            from  magnetic  tape  (Section  4.3.2) using your most recent
            system  backup  tape  (Section  4.1.6.1).   Either  the  file
            BS:<SYSTEM>MONITR.EXE  has been destroyed on the disk or some
            other problem possibly a hardware  error,  has  affected  the
            file system.

        5.  If the system comes up for timesharing  after  you  load  the
            monitor from magnetic tape, chances are that only the monitor
            file on disk was bad.  You should restore a good copy of  the
            monitor from a DUMPER tape to BS:<SYSTEM>.

        6.  If the system does not come up for timesharing, it is  likely
            that  there are problems with the file system.  First consult
            your software specialist.  He may  want  to  investigate  the
            situation     before    recommending    reconstructing    the
            ROOT-DIRECTORY or the lengthy procedure  of  re-creating  the
            file system.



   9.12  PS NOT FOUND

   During a system reload, if you see the message:

        PS NOT FOUND. WHAT IS THE NAME OF THE SYSTEM STRUCTURE?

   the system was not able to find a structure named PS:.  You must  then
   type  the  name  of  the  structure  that  is  going  to be the system
   structure.  As long as the TOPS-20  monitor  continues  to  run,  that
   structure  will  be  known  as  PS:.  It will not be recognized by its
   original name that you typed in answer to the question.  Note that the
   system  structure  must  have swapping space, usually a front-end file
   system,  an  appropriately  installed  <SYSTEM>  and   <SUBSYS>,   and
   directories to allow users to log in.

                            ----- Example -----

   To designate the structure 2136: as the system structure when  PS: was
   not found:

        PS NOT FOUND. WHAT IS THE NAME OF THE SYSTEM STRUCTURE? 2136

        [2136 MOUNTED AS PS]




                                    9-58

                         ERROR RECOVERY PROCEDURES


   9.13  BOOTSTRAP LOAD FAILED

   If the bootstrap failed to load during a  system  reload,  you  should
   zero memory and then try to reload again.  This is sometimes necessary
   after a power failure but should occur infrequently.  If  the  problem
   continues, call your DIGITAL Field Service Representative.

   To zero or clear memory, type the following at the CTY.

        1.  <CTRL/\>

        2.  ABORT

        3.  SET CONSOLE PROGRAMMER

        4.  ZERO 0>address

            where address is the maximum memory address on your system

                            ----- Example -----

        <CTRL/\>
        PAR>ABORT<RET>
        PAR%SET CONSOLE PROGRAMMER<RET>
         CONSOLE MODE: PROGRAMMER
        PAR%ZERO 0>777777<RET>
        PAR%



   9.14  MANUALLY RELOADING THE DX20

   The DX20 is usually started when you load the system.   At  that  time
   the BOOT or MTBOOT program loads and starts the microcode in the DX20.
   However, in  the  following  situations,  you  must  reload  the  DX20
   manually:

        1.  If the DX20 has been taken off-line for maintenance  and  you
            do not want to reload the entire system to reload the DX20

        2.  If you are told to load a specific DX20 microcode  file  that
            is different from the one BOOT or MTBOOT would load

        3.  If you have users complaining that none of  the  TU70  series
            magnetic  tape  drives  or  RP20  disk  drives  on a DX20 are
            working

        4.  If the DX20 loses power

   To manually reload the DX20, type the following commands:




                                    9-59

                         ERROR RECOVERY PROCEDURES


        1.  PUSH to OPR

        2.  ENABLE your capabilities

        3.  DX20LD

        4.  SYS:DXMCA (for tape) or SYS:DXMCE (for RP20 disks)

        5.  /E

        6.  POP

   The above steps reset the DX20, load the microcode file  SYS:DXMCA.ADX
   or  SYS:DXMCE.ADX,  verify  the  microcode,  start  it,  and exit from
   DX20LD.
                            ----- Example -----

        OPR>PUSH<RET>
         TOPS-20 Command Processor 7(31)
        @ENABLE<RET>
        $DX20LD<RET>
        FILE: SYS:DXMCA<RET>

        DX20 SELECTED:    RH20=2  DX20=0
                MICROCODE LOADED
                MICROCODE VERIFIED
                MICROCODE VERSION  1 (0)
                DX20 STARTED AT ADDRESS 1
        FILE: /E<RET>
        $POP<RET>
        OPR>

   The preceding steps and example show the most common  use  of  DX20LD.
   However,  there  are switches in DX20LD for specific functions.  After
   FILE:, the DX20LD prompt, you can type a command line in the form of a
   file specification followed by switches and <RET>.

   The file specification for the DX20 microcode is  SYS:DXMCA.ADX.   The
   default  directory  is  your  connected  directory.  Note that neither
   recognition nor the help facility (typing ?) is available in DX20LD.

   After a command line is processed or an error occurs,  DX20LD  prompts
   again for another command line.

   The DX20LD switches and their functions are:

        /C        If you specify a DX20 microcode  file  before  /C,  the
                  DX20  memory  is  cleared  and the microcode is loaded,
                  verified, and started.  If you do not specify  a  file,
                  only DX20 memory is cleared.

        /D:CD     The functions specified are done on RH20 controller  c,


                                    9-60

                         ERROR RECOVERY PROCEDURES


                  DX20  d,  where c and d are octal numbers.  If you omit
                  /D, DX20LD looks for a DX20.  If only one is found,  it
                  is  used.   However,  if more than one is found, DX20LD
                  outputs an error message which says to use /D.

        /E        DX20LD exits to TOPS-20 command level.

        /L        The file specified is loaded into the DX20.

        /R        Specifies DX20 for RP20 disk drives.

        /S:N      The DX20 is started at location  n  in  the  microcode,
                  where  n  is  an  octal  number.   The default starting
                  address is 1.

        /T        Specifies DX20 for TU70 tape drives.

        /V        The DX20 memory is verified against the file specified.
                  Do  this  verification  only  after  loading and before
                  starting the DX20.

   You can use the switches in combination.  However, if you  use  /L  or
   /V,  the  functions  of only the specified switches are performed.  If
   you specify a file and /C or /S without /L or /V, the file  is  loaded
   into  the  DX20  and  verified,  and  the  functions  of the specified
   switches are performed.  If you do not use any switches, the  DX20  is
   reset and the file you specified is loaded, verified, and started.

                          ----- Requirement -----

   OPERATOR, WHEEL, or MAINTENANCE capability must be enabled

                         ----- Error Messages -----

   ERROR:     ?1ST CHARACTER IN DATALINE WRONG

   Reason:    The first character in the line of data DX20LD  reads  from
              SYS:DXMCA.ADX  must  be  a  semicolon,  a  W,  or a C.  You
              probably entered the wrong filename.  If the  filename  was
              entered correctly, the file is probably corrupted.

   Recovery:  Retype the filename correctly.  If the  error  recurs,  use
              another copy of SYS:DXMCA.ADX.


   ERROR:     ?2ND CHARACTER IN DATALINE WRONG

   Reason:    The character which follows a C or W in the first  position
              in the line of data DX20LD reads from SYS:DXMCS.ADX must be
              a space.  If the file name was entered correctly, the  file
              is probably corrupted.



                                    9-61

                         ERROR RECOVERY PROCEDURES


   Recovery:  Retype the file name.  If the  error  recurs,  use  another
              copy of SYS:DXMCA.ADX.


   ERROR:     ?CHECKSUM ERROR IN DATALINE

   Reason:    The checksum  DX20LD  computed  on  the  line  of  data  in
              SYS:DXMCA.ADX  does not match the checksum in SYS:DXMCA.ADX
              for  that  line  of  data.   The  .ADX  file  is   probably
              corrupted.

   Recovery:  Use another copy of SYS:DXMCA.ADX.


   ERROR:     ?COLON ILLEGAL FOR SWITCH

   Reason:    The switch you specified does not accept a colon.

   Recovery:  Retype the command or file name and switches correctly.


   ERROR:     ?COMMAND STRING TOO LONG

   Reason:    The command line you typed is too long.  It  must  be  less
              than 100 characters.

   Recovery:  Type a command line that is less than 100 characters long.


   ERROR:     ?CRAM PARITY ERROR DURING VERIFICATION

   Reason:    You specified the switch /V and a parity error occurred  in
              the DX-20 during the verification procedure.

   Recovery:  Call your DIGITAL Field Service Representative.


   ERROR:     ?CRAM VERIFICATION - NO MATCH

   Reason:    You  specified  the  /V  switch,  and  the  disk  file  you
              specified  did  not match the file in the DX20 CRAM memory.
              The filename specified was wrong, or the data in  the  DX20
              is incorrect.

   Recovery:  Retype the correct filename and  switches.   If  the  error
              recurs, use another copy of SYS:DXMCA.ADX.


   ERROR:     ?/D SWITCH REQUIRES AN OCTAL NUMBER

   Reason:    You did not use octal numbers after the /D switch.



                                    9-62

                         ERROR RECOVERY PROCEDURES


   Recovery:  Retype the file name, the /D switch, and the octal  numbers
              of the RH controller and the DX20 you want to use.


   ERROR:     ?FORMAT ERROR IN DATALINE

   Reason:    The data words in the file you specified are  delimited  by
              carriage returns; they should be delimited by commas.

   Recovery:  Retype the file name.  If the  error  recurs,  use  another
              copy of SYS:DXMCA.ADX.


   ERROR:     ?ILLEGAL SWITCH

   Reason:    The switch you specified is not a valid switch for DX20LD.

   Recovery:  Retype the file name and correct switch.


   ERROR:     ?INVALID SWITCH (2ND CHARACTER MUST BE A SPACE OR A COLON)

   Reason:    You must type a space or a colon  after  typing  the  first
              letter  of  the switch.  For example, you cannot use /VE to
              verify; you must use /V.

   Recovery:  Retype the file name and the correct switch.


   ERROR:     ?  JSYS ERROR:  FILE DOES NOT EXIST

   Reason:    The file you specified does not exist.  Perhaps  you  typed
              the  wrong  file  name.  The standard file specification to
              use is SYS:DXMCA.ADX.  If you do not specify a  file  type,
              the default is .ADX.

   Recovery:  Retype the correct file name.


   ERROR:     ?  JSYS ERROR:  WHEEL, OPERATOR, OR MAINTENANCE  CAPABILITY
              REQUIRED

   Reason:    You must have WHEEL, OPERATOR,  or  MAINTENANCE  capability
              enabled to run DX20LD.

   Recovery:  Log  in  to  <OPERATOR>,   which   should   have   OPERATOR
              capability.  Type ENABLE, then run DX20LD.


   ERROR:     ?MORE THAN ONE DX20 FOUND - USE /D SWITCH

   Reason:    If your system has more than one DX20, you must use the  /D


                                    9-63

                         ERROR RECOVERY PROCEDURES


              switch to specify the DX20 number.

   Recovery:  Retype the file name, the /D switch, and the octal  numbers
              of the RH controller and the DX20 you want to use.


   ERROR:     ?NO DX20 WAS FOUND

   Reason:    DX20LD could not find a DX20.  Either the hardware  is  not
              connected  to the system, or hardware problems exist in the
              DX20 or the RH20.

   Recovery:  If the  error  recurs,  call  your  DIGITAL  Field  Service
              Representative.


   ERROR:     ?SPECIFIED DEVICE IS NOT A DX20

   Reason:    The RH20 you specified does not have a DX20.   Perhaps  you
              typed the wrong controller (RH20) number.

   Recovery:  Retype the file name and  the  /D  switch  with  the  octal
              numbers of the RH controller and DX20 you want to use.


   ERROR:     ?SPECIFIED RH20 DOES NOT EXIST

   Reason:    The RH20 you specified in the /D  switch  does  not  exist.
              Perhaps you typed the wrong controller number.

   Recovery:  Retype the file name and  the  /D  switch  with  the  octal
              numbers  of the RH controller and the DX20 you want to use.
              If the  error  recurs,  call  your  DIGITAL  Field  Service
              Representative.


   ERROR:     ?TOO MANY WORDS IN DATALINE

   Reason:    The data in the .ADX file you specified contains more  than
              32  words.   You  typed the wrong file name, or the file is
              corrupted.

   Recovery:  Retype the file name.  If the  error  recurs,  use  another
              copy of SYS:DXMCA.ADX.


   ERROR:     ?/V OR /L SWITCH WITH NO FILE NAME SPECIFIED

   Reason:    You used a /V or a /L switch and did not specify  the  name
              of  a file.  You must specify the name of an .ADX file when
              you use the /V or /L switches.



                                    9-64

                         ERROR RECOVERY PROCEDURES


   Recovery:  Type the file name and the /V or /L switch.


   ERROR:     ?WORKING MEMORY VERIFICATION - NO MATCH

   Reason:    You used the /V switch and the file you specified  did  not
              match what was in the working section of DX20 memory.  This
              could happen if you verify the contents of the  DX20  after
              you load the .ADX file and start to execute it.

   Recovery:  Verify the contents of the DX20 after loading the .ADX file
              but before executing it.










































                                    9-65

                         ERROR RECOVERY PROCEDURES


              .





















































                                    9-66

                                        


                                   INDEX



               -A-                     Argument (Cont.)
                                         DRIVE, 7-62
   Abbreviations                         DUMPER RESTORE, 7-44
     reload, 4-23                        FILE-RETRIEVAL-MESSAGES, 5-15
   ABORT, 6-15                           IMMEDIATELY, 6-6
     output-device command, 6-66         LCP-MESSAGES, 5-15
     output-device switches, 6-66        MOUNT-MESSAGES, 5-15
     response, 7-64                      NCP-MESSAGES, 5-15
     switches, 6-15                      NO-OPR-INTERVENTION, 6-4
   ABORT PRINTER command, 6-42           NO-REMOVAL, 7-58
   ABORT PRINTER switches, 6-42          NODE, 5-16
   ABORT READER command, 6-52            PAPER-TAPE-PUNCH-MESSAGES, 5-16
   Account request                       PLOTTER-MESSAGES, 5-16
     user, 8-19                          PRINTER-MESSAGES, 5-16
   Account validation                    READER-MESSAGES, 5-16
     changing data, 8-7                  REMOVAL, 7-60
     entering date, 8-5                  SCRATCH, 7-21
   AFTER CURRENT-REQUEST argument,       STOP BATCH-STREAM, 6-6
       6-6                               STOP output-device, 6-58
   AFTER EVERY-REQUEST argument, 6-6     SYSTEM-MESSAGES, 5-16
   Aliases                               USER-MESSAGES, 5-16
     printer, 6-27                       VERBOSE, 8-26
   ALIGN PRINTER command, 6-34         ASSIGN command, 7-15
   Aligning                            Autobaud detection, 7-87
     line printer forms, 6-34          Automatic volume recognition,
   /ALL switch, 7-68, 7-71                 7-18
   ALL-MESSAGES argument, 5-15         AVR, 7-18
   .ALP filespec, 6-31
   ANSI label, 7-7                                 -B-
   Archive/virtual disk system, 7-24
   Archived files                      Backing up files, 8-48
     retrieving, 7-36                  BACKSPACE PRINTER, 6-35
   Archiving                           BACKSPACE PRINTER switches, 6-35
     files, 7-23                       Backspacing
     individual files, 7-24              line printer forms, 6-35
     multiple files, 7-24              BAT block
   Argument                              inconsistencies, 9-12
     AFTER CURRENT-REQUEST, 6-6          messages, 9-14
     AFTER EVERY-REQUEST, 6-6          Batch
     ALL-MESSAGES, 5-15                  responsibilities, 6-3
     BATCH-MESSAGES, 5-15                software tasks, 6-1
     BUGINF-MESSAGES, 5-15               system components, 6-1
     CARD-PUNCH MESSAGES, 5-15         Batch class, 7-3
     CD-RDR-INTERPRETER-MSGS, 5-15     Batch jobs
     CHANNEL, 7-62                       canceling, 6-15
     CONTROLLER, 7-62                    controlling, 6-10
     DECNET-EVENT-MESSAGES, 5-15         examining, 6-11
     DECNET-LINK-MESSAGES, 5-15          holding, 6-14


                                  Index-1

                                        


   Batch jobs (Cont.)                  Canceling (Cont.)
     releasing, 6-14                     mount requests, 7-22, 7-61
     requeuing, 6-16                     output-device jobs, 6-66
   Batch requests                        printer jobs, 6-42
     deleting, 6-17                    Card
     modifying, 6-16                     $JOB, 6-2
   Batch streams                       Card readers, 2-7
     continuing, 6-6                     continuing, 6-50
     controlling, 6-3                    controlling, 6-48
     displaying status, 6-9              controlling jobs, 6-52
     shutting down, 6-7                  shutting down, 6-51
     starting, 6-5                       starting, 6-49
     stopping, 6-6                       stopping, 6-50
   BATCH-MESSAGES argument, 5-15       CARD-PUNCH, 6-53
   BATCON program, 5-1, 6-2            CARD-PUNCH MESSAGES argument,
   Bias-control setting, 7-3               5-15
   BOOT, 4-9                           CD-RDR-INTERPRETER-MSGS argument,
     loading with, 4-19                    5-15
   Boot structure, 4-26                CD11 controller, 2-8
   BOOT.EXB file, 4-14, 4-19, 9-1      CD20 models, 2-8
   Bootstrap                           CDRIVE program, 4-27, 5-1, 6-2
     error messages, 9-12, 9-20        Central processors, 2-3
     failed, 9-59                      Centralized logging facility, 7-6
   BS-LOST-PAGES.BIN.n, 4-24           CFCONN BUGINF, 4-33
   BS:, 4-26                           CFS, 5-6
   BS: parameters                        configuration, 2-3
     dumping, 8-21                       connection, 4-33
   BS:<ACCOUNTS>, 7-93                   dismounting structures, 7-57
   BS:<SPOOL>, 9-52                      printers, 5-6
   BS:<SYSTEM>0DUMP11.BIN file, 9-1      requirements, 2-3
   BUGCHK output, 9-8                    system start-up, 4-32
   BUGCHK-MESSAGES argument, 5-15      Channel
   BUGCHKs, 9-8                          CI20, 2-4
   BUGHLT output, 9-9                    RH20, 2-4
   BUGHLTs, 9-8                        CHANNEL argument, 7-62
   BUGINF-MESSAGES argument, 5-15      Channel controller
   BUGINFs, 9-8                          DX20, 7-4
   BUILD command, 8-21                 Channel number, 7-5
   .BWR files, 1-1                     Channels
                                         data, 2-4
               -C-                     Characteristics
                                         line printer, 2-7
   CANCEL BATCH-REQUEST command,       CHECK BITTABLE reports, 9-45
       6-17                            CHECKD CREATE command, 7-77
   CANCEL device-REQUEST command,      CHECKD program, 4-24, 7-78, 9-38
       6-68                              caution, 9-38
   CANCEL MOUNT-REQUEST command,         commands, 9-39
       7-22, 7-62                        error messages, 9-44
   CANCEL PRINTER-REQUEST command,     CHKPNT COPY command, 7-94
       6-44                            CHKPNT program, 7-92
   Canceling                           CI port
     batch jobs, 6-15                    setting available, 7-63


                                  Index-2

                                        


   CI port (Cont.)                     Command (Cont.)
     setting unavailable, 7-63           ENABLE LOGFILES, 6-48
   CI20, 2-4, 4-32                       ENABLE OUTPUT-DISPLAY, 5-14
   Class                                 ENABLE PRINT-LOGFILES, 6-48
     batch, 7-3                          ENABLE QUEUE-REQUESTS, 6-3
     number, 7-3                         ENABLE SEMI-OPR, 5-21
   Class scheduling status, 7-3          ENABLE-LOGGING, 7-6
   CLOSE-LOG command, 7-6                ^EPRINT, 8-26, 8-28
   Cluster, 5-6                          ^ESET DATE-AND-TIME, 9-5
     ending timesharing, 8-56            ^ESET LOGINS-ALLOWED, 8-2
     LCP commands, 5-8                   ^ESET OPERATOR-IN-ATTENDANCE,
     OPR commands, 5-8                       8-2
     printers, 6-19                      ^ESPEAK, 9-50
   /CLUSTER-NODE: switch, 5-6            FORWARDSPACE PRINTER, 6-36
   ? Command, 5-9                        HOLD BATCH-JOBS, 6-14
   Command                               HOLD output-device, 6-65
     ?, 5-9                              HOLD PRINTER-JOBS, 6-40
     ABORT, 6-15                         IDENTIFY, 7-20, 7-21, 7-37
     ABORT output-device, 6-66           INFORMATION, 8-42
     ABORT PRINTER, 6-42                 INFORMATION ARCHIVE-STATUS,
     ABORT READER, 6-52                      7-24
     ALIGN PRINTER, 6-34                 INFORMATION SYSTEM-STATUS, 8-2
     ASSIGN, 7-15                        LOGOUT, 7-90
     BUILD, 8-21                         MODIFY BATCH-REQUEST, 6-16
     CANCEL BATCH-REQUEST, 6-17          MODIFY output-device, 6-67
     CANCEL device-REQUEST, 6-68         MODIFY PRINTER-REQUEST, 6-44
     CANCEL MOUNT-REQUEST, 7-22,         MOUNT STRUCTURE, 7-50
         7-62                            NEXT BATCH-STREAM, 6-17
     CANCEL PRINTER-REQUEST, 6-44        NEXT output-device, 6-68
     CHECKD CREATE, 7-77                 OPR HELP, 5-12
     CHKPNT COPY, 7-94                   OPR PUSH, 5-4
     CLOSE-LOG, 7-6                      RDMAIL, 7-86
     CONTINUE, 6-6                       RECONSTRUCT ROOT-DIRECTORY,
     CONTINUE output-device, 6-59            9-28
     CONTINUE PRINTER, 6-22              RELEASE BATCH-JOBS, 6-14
     CONTINUE READER, 6-50               RELEASE output-device, 6-65
     CTRL/H, 5-4                         REPORT, 8-46
     /D, 9-4                             REQUEUE BATCH-STREAM, 6-16
     DEFINE, 5-10                        RESPOND, 7-81
     DIRECTORY MAIL.CPY, 8-4             RETRIEVE, 7-36
     DISABLE AUTO-VOL-RECG, 7-19         SEND, 7-22, 7-83
     DISABLE SEMI-OPR, 5-21              SEND BATCH-STREAM, 6-7
     DISABLE-LOGGING, 7-6                SET BLOCKING FACTOR, 8-50
     DISMOUNT STRUCTURE, 7-53            SET DIRECTORY, 8-21
     DLUSER LOAD, 8-23                   SET DISK-DRIVE AVAILABLE, 7-62
     DUMPER INCREMENTAL, 8-52            SET DISK-DRIVE UNAVAILABLE,
     DUMPER RESTORE, 7-44                    7-62
     DUMPER SAVE, 8-50                   SET INITIALIZE, 7-7
     ^ECEASE, 8-55                       SET JOB SCHEDULER-CLASS, 7-2
     ^ECREATE, 8-10, 8-26                SET KLINIK, 9-35
     ENABLE AUTO-VOL-RECG, 7-19          SET ONLINE, 7-5
     ENABLE BROADCAST-MESSAGES, 5-17     SET PORT CI UNAVAILABLE, 7-63


                                  Index-3

                                        


   Command (Cont.)                     Communication (Cont.)
     SET PORT NI AVAILABLE, 7-76         software, 5-5
     SET PORT NI UNAVAILABLE, 7-75     Components
     SET PRINTER, 6-19                   GALAXY, 5-1
     SET PRINTER FORMS-TYPE, 6-29      CONFIG.CMD file, 4-26, 7-18
     SET SCHEDULER CLASS, 7-1          Configuration
     SET STRUCTURE EXCLUSIVE, 7-57       CFS, 2-3
     SET STRUCTURE SHARED, 7-57        2060 configuration, 2-2
     SET TAPE-DRIVE AVAILABLE, 7-23    Configuration error
     SET TAPE-DRIVE UNAVAILABLE,         memory, 9-57
         7-23                          Console processor, 2-4
     SHOW BROADCAST-MESSAGES, 5-18     Console terminal
     SHOW CONFIGURATION, 7-71            hung, 9-56
     SHOW OPERATORS, 5-19              CONTINUE command, 6-6
     SHOW PARAMETER, 6-8               CONTINUE output-device command,
     SHOW PARAMETERS output-device,        6-59
         6-60                          CONTINUE PRINTER command, 6-22
     SHOW PARAMETERS PRINTER, 6-23     CONTINUE READER command, 6-50
     SHOW QUEUES BATCH-JOBS, 6-11      Continuing
     SHOW QUEUES device-jobs, 6-63       card readers, 6-50
     SHOW QUEUES MOUNT-REQUESTS,         line printers, 6-22
         7-76                            output devices, 6-59
     SHOW QUEUES PRINTER-JOBS, 6-38    Controller
     SHOW SCHEDULER, 7-3                 CD11, 2-8
     SHOW STATUS, 6-9                    HSC-50, 2-4, 2-9
     SHOW STATUS DISK-DRIVES, 7-68       RH11, 2-9
     SHOW STATUS output-device, 6-61     RH20, 2-9
     SHOW STATUS PRINTER, 6-25           TM02, 2-9
     SHOW STATUS STRUCTURE, 7-56,        TM03, 2-9
         7-71                            TX02, 2-4
     SHOW STATUS TAPE-DRIVE, 7-15      CONTROLLER argument, 7-62
     SHUTDOWN, 6-5, 6-7, 9-3           Controller number, 7-5
     SHUTDOWN output-device, 6-59      CONTROLLER SELECT switch, 4-5,
     SHUTDOWN PRINTER, 6-22                4-14
     SHUTDOWN READER, 6-51             Controllers
     SPEAR SUMMARIZE, 8-47               data, 2-4
     START, 6-7                        Controlling
     START output device, 6-58           batch jobs, 6-10
     START PRINTER, 6-21                 card reader jobs, 6-52
     START READER, 6-49                  card readers, 6-48
     STOP BATCH-STREAM, 6-6              line printer forms, 6-29
     STOP output-device, 6-58            line printer jobs, 6-38
     STOP PRINTER, 6-21                  line printers, 6-18
     STOP READER, 6-50                   other output devices, 6-52
     SUPPRESS PRINTER, 6-37              scheduler, 7-1
     SYSJOB STATUS, 9-51               Counter
     SYSTAT, 7-90                        program, 9-4
     UNDELETE MAIL.CPY, 8-4            CR10-E model, 2-8
   Commands                            CR10-F model, 2-8
     reprinting, 5-11                  CTRL/\, 9-4
   Communication                       CTRL/A, 8-23
     front-ends, 5-5                   CTRL/H, 5-4, 5-9


                                  Index-4

                                        


   CTRL/R, 5-9                         DISABLE-LOGGING command, 7-6
   CTRL/U, 5-9                         Disk drives
   CTRL/Z, 6-7                           displaying status, 7-68
   CTY output, 1-2                       setting available, 7-62
                                         setting unavailable, 7-62
               -D-                     Disk pack
                                         loading from, 4-5
   /D command, 9-4                     Disk packs, 2-8
   Data channel                          2060, 2-8
     DX20, 2-4                           2040S, 2-8
   Data channels, 2-4                  2060 disk packs, 2-8
   Data controllers, 2-4               Disk serial numbers
   Date/time                             displaying, 7-70
     setting, 4-23, 9-5                Disk space
   DAVFU, 6-32                           correcting, 9-38
   DDMP program, 4-26                    increasing, 7-27
   DDT program, 3-2                    DISK switch, 4-1
   DECmail/MS system, 7-81             Disk system
   DECNET-EVENT-MESSAGES argument,       archive/virtual, 7-24
       5-15                            Disk usage
   DECNET-LINK-MESSAGES argument,        getting, 7-92
       5-15                              reporting, 7-94
   DEFINE ALIAS command, 6-27          Disks
   DEFINE command, 5-10                  floppy, 2-5
   Deleting                            Dismount requests
     batch requests, 6-17                answering, 7-53
     output-device requests, 6-68      DISMOUNT STRUCTURE command, 7-53
     printer requests, 6-44            Dismounting structures
   Device error messages, 9-6            CFS, 7-57
   Device unit number, 7-5             Displaying
   Devices                               batch stream parameters, 6-8
     peripheral, 2-5                     batch stream status, 6-9
   Devices on-line                       disk drive status, 7-68
     setting, 7-4                        disk serial numbers, 7-70
   devtyp, 6-55                          line printer parameters, 6-22
   Directories                           line printer status, 6-24
     adding, 8-9, 8-11                   output-device parameter, 6-60
     deleting, 8-17, 9-25                output-device status, 6-61
     information, 8-26                   scheduler status, 7-3
     re-creating, 9-27                   structure status, 7-71
     reconstructing, 9-25                tape drive status, 7-15
   DIRECTORY MAIL.CPY command, 8-4     DLUSER program, 8-21, 9-27
   Directory names                       commands, 8-24
     changing, 8-14                      error messages, 8-25
   Directory parameters                  LOAD command, 8-23
     changing, 8-13, 8-14                using, 8-23
     dumping, 8-21                     .DOC files, 1-1
     listing, 8-26                     DQS printers, 5-6, 6-19
   Directory symbol table              DRIVE argument, 7-62
     rebuilding, 9-24                  DUMP-ON-BUGCHK, 9-3
   DISABLE AUTO-VOL-RECG command,      DUMP.EXE file, 9-1
       7-19                            Dumpable structure, 9-3


                                  Index-5

                                        


   DUMPER, 3-2                         Error messages (Cont.)
     blocking-factor default, 8-50       device, 9-6
     tape densities, 8-50                DLUSER, 8-25
   DUMPER /FULL-INCREMENTAL switch,      DX20, 9-16, 9-61
       8-49                              MAIL, 8-5
   DUMPER full save, 8-48                OPR, 5-20
   DUMPER INCREMENTAL command, 8-52      REAPER, 9-16
   DUMPER program, 7-24, 7-32, 7-43,     tape, 9-18
       8-48                              ULIST, 8-38
     restriction, 8-48                 Error-type information, 9-45
   DUMPER RESTORE arguments, 7-44      ERROR.SYS file, 8-46, 9-1
   DUMPER RESTORE command, 7-44        Errors
   DUMPER SAVE command, 8-50             reporting, 8-46
   Dumping, 9-3                        <ESC> feature, 5-9
     automatically, 9-1                ^ESET DATE-AND-TIME command, 9-5
     BS: parameters, 8-21              ^ESET LOGINS-ALLOWED command, 8-2
     directory parameters, 8-21        ^ESET OPERATOR-IN-ATTENDANCE
   DX20, 7-4                               command, 8-2
     data channel, 2-4                 ^ESPEAK command, 9-50
     error messages, 9-16, 9-61        Examining
     manually loading, 9-59              batch jobs, 6-11
     microcode loading, 4-7              mount requests, 7-76
     recovery procedures, 9-61           output-device jobs, 6-62
   DX20:A, 4-7                           printer queues, 6-38
   DX20:B, 4-7                         Examining output-device jobs,
   DX20LD program, 9-60                    6-62
   DX20LD switches, 9-60               Exceeding TIME-LIMITS parameter,
                                           6-5
               -E-                     EXEC, 3-1
    
   EBCDIC label, 7-7                               -F-
   ^ECEASE command, 8-55
   ^ECREATE command, 8-10, 8-26        Fault light, 4-2
   EDIT program, 3-2                   File
   EDT-20 program, 3-2                   BOOT.EXB, 4-14, 4-19, 9-1
   ENABLE AUTO-VOL-RECG command,         BS:<SYSTEM>0DUMP11.BIN, 9-1
       7-19                              CONFIG.CMD, 7-18
   ENABLE OUTPUT-DISPLAY command,        DUMP.EXE, 9-1
       5-14                              ERROR.SYS, 8-46, 9-1
   ENABLE QUEUE-REQUESTS command,        formsname.ALP, 6-34
       6-3                               LOST-PAGES.BIN, 9-48
   ENABLE switch, 4-1                    LPFORM.INI, 6-19, 6-30
   ENABLE-LOGGING command, 7-6           MAIL.TXT, 8-3
   ENQ% monitor call, 7-58               MTBOOT.EXB, 4-14
   ^EPRINT command, 8-26, 8-28           n-CONFIG.CMD, 4-26
   Error                                 n-PTYCON.ATO, 4-26
     continuable, 9-3                    n-SETSPD.EXE, 4-26
     parity, 9-15                        ORION log buffer, 7-6
     recovery procedures, 9-1            ORION-SYSTEM-LOG, 7-6
   Error messages                        REAPER.LIST, 7-31
     bootstrap, 9-12, 9-20               SPFORM.INI, 6-54, 6-55
     CHECKD, 9-44                        SYS:DXMCA, 9-60


                                  Index-6

                                        


   File (Cont.)                                    -G-
     SYSJOB.RUN, 8-3, 9-51
     SYSTAP.CTL, 8-22                  GALAXY
     SYSTAP.LOG, 8-22                    recovery procedures, 9-52
     SYSTAP.LPT, 8-22                  GALAXY components, 5-1
     SYSTEM.CMD, 6-4                   GALGEN, 6-20
     SYSTEM:str.TXT, 8-22
     USERS.TXT, 8-31
   File system recovery, 9-24                      -H-
   FILE-RETRIEVAL-MESSAGES argument,
       5-15                            HALT switch, 9-4
   Files                               HALTED message, 9-3
     archiving, 7-23                   Halting front-end, 9-4
     backing up, 8-48                  Hardware tasks, 1-3
     .BWR, 1-1                         Header labels
     .DOC, 1-1                           standard, 7-7
     .HLP, 1-1                         Helping users, 7-87
     .MEM, 1-1                         .HLP files, 1-1
     migrating, 7-32                   HOLD BATCH-JOBS command, 6-14
     restoring, 7-43, 9-27             HOLD output-device command, 6-65
     types, 1-1                        HOLD PRINTER-JOBS command, 6-40
   Files-only directories              Holding
     adding, 8-12                        batch jobs, 6-14
   FILES-ONLY subcommand, 8-12           output-device jobs, 6-64
   Floppy disks, 2-5                     printer jobs, 6-40
     loading from, 4-9                 Home block
   FLOPPY switch, 4-1                    inconsistencies, 9-12
   FORCE response, 7-64                  messages, 9-13
   Format                              HSC-50 controller, 2-4, 2-9
     LPFORM.INI, 6-30                  Hung
     SET INITIALIZE, 7-7                 console terminal, 9-56
     SPFORM.INI, 6-55                    system, 9-4
   formname, 6-55
   Formsname.ALP file, 6-34
   FORWARDSPACE PRINTER command,
       6-36                                        -I-
   FORWARDSPACE PRINTER switches,
       6-36                            IDENTIFY command, 7-20, 7-21,
   Forwardspacing                          7-37
     line printer forms, 6-36          IMMEDIATELY argument, 6-6
   /FREE switch, 7-68                  Incremental save, 8-52
   Front-end                           INFO program, 4-27
     communication, 5-5                Information
     halting, 9-4                        directory, 8-26
     memory, 2-5                         getting user/system, 8-42
     processor, 2-4                    INFORMATION ARCHIVE-STATUS
     re-creating file system, 9-31         command, 7-24
   Full save                           INFORMATION command, 8-42
     DUMPER, 8-48                      INFORMATION SYSTEM-STATUS command,
                                           8-2
                                       Initializing tapes, 7-7
                                       Instruction set, 2-3


                                  Index-7

                                        


               -J-                     Line printer (Cont.)
                                         LP14-V, 2-6
   $JOB card, 6-2                        LP14-W, 2-6
   Job statistics, 8-40                  output to tape, 6-45
   Jobs                                  priority, 6-20
     canceling output-device, 6-66       shutting down, 6-22
     releasing output-device, 6-65       starting, 6-20
     requeuing output-device, 6-66       stopping, 6-21
   Jobs's scheduling class               suppressing carriage control,
     changing, 7-2                           6-37
                                       Link
               -K-                       KLINIK, 9-35
                                       LINK program, 3-2
   KILL subcommand, 8-17               LISSPL program, 5-1, 6-2
   KLERR, 9-1                          LIST subcommand, 8-26
   KLINIK, 9-34                        Load switches, 4-1
   KLINIK link, 9-35                   Loading
   KLINIK messages, 9-36                 from disk pack, 4-3, 4-5
   KLINIT, 4-3                           from floppy disks, 4-9
   KLPOVC BUGINF, 4-33                   from switch register, 4-14
                                         system, 4-3
               -L-                       system automatically, 9-1
                                         TOPS-20 monitor, 4-19
   Label                                 with BOOT, 4-19
     ANSI, 7-7                           with MTBOOT, 4-20
     EBCDIC, 7-7                       LOCAL locator, 6-58
     TOPS-20, 7-7                      Local printers, 6-19
   Labeled tapes                       Locator
     mounting, 7-19, 7-20                LOCAL, 6-58
   Languages, 3-1                        REMOTE, 6-58
   LAT printers, 5-6, 6-19             :locator, 6-55
   LCP-MESSAGES argument, 5-15         Logbook
   Light                                 system, 1-2
     fault, 4-2                        Logging out users, 7-90
   Line printer, 2-5                   Login structure, 8-9
     aligning forms, 6-34              Logins-allowed
     backspacing forms, 6-35             setting, 8-1
     characteristics, 2-7              LOGOUT command, 7-90
     checking, 4-2                     Looping system, 9-4
     continuing, 6-22                  LOST-PAGES.BIN file, 9-48
     controlling, 6-18                 LP05-V line printer, 2-5
     controlling forms, 6-29           LP05-W line printer, 2-5
     controlling jobs, 6-38            LP07 line printer, 2-6
     displaying parameters, 6-22       LP10-J line printer, 2-6
     displaying status, 6-24           LP10-K line printer, 2-6
     forwardspacing forms, 6-36        LP14-V line printer, 2-6
     identification, 2-6               LP14-W line printer, 2-6
     LP05-V, 2-5                       LP200, 2-6
     LP05-W, 2-5                       LP20A, 2-5
     LP07, 2-6                         LP20B, 2-5
     LP10-J, 2-6                       LP20C, 2-6
     LP10-K, 2-6                       LP20D, 2-6


                                  Index-8

                                        


   LP20F, 2-6                          MODIFY PRINTER-REQUEST command,
   LP20H, 2-6                              6-44
   LPFORM.INI file, 6-19, 6-30         Modifying
   LPFORM.INI format, 6-30               batch requests, 6-16
   LPFORM.INI switches, 6-31             output-device requests, 6-67
   LPTSPL program, 4-27, 5-1, 6-2        printer requests, 6-44
                                       Monitor
                                         missing, 9-57
               -M-                     MONITR.EXE, 4-7
                                       Mount requests
   Magnetic tapes, 2-9                   answering, 7-47
   MAIL program, 7-84, 8-3               canceling, 7-22, 7-61
     error messages, 8-5                 examining, 7-76
   MAIL.TXT file, 8-3                    handling, 7-14
   MAILER program, 4-27                MOUNT STRUCTURE command, 7-50
   MAKVFU.DOC, 6-29                    MOUNT-MESSAGES argument, 5-15
   MAKVFU.HLP, 6-29                    Mountable structures, 8-11
   MAPPER program, 4-27                /MOUNTED switch, 7-69, 7-71
   MB20 memory, 2-4                    Mounting
   .MEM files, 1-1                       labeled tapes, 7-19, 7-20
   Memory                                structures, 7-50
     configuration error, 9-57           unlabeled tapes, 7-21
     front-end, 2-5                    MOUNTR program, 4-27, 5-1
     interleaving, 2-4                 MS program, 7-81
     MB20, 2-4                         MSCP server, 8-56
     MF20, 2-4                         MTBOOT
     MG20, 2-4                           loading with, 4-20
     ranges, 2-4                       MTBOOT.EXB file, 4-14
   Message
     HALTED, 9-3
     PROBLEM ON DEVICE, 9-7
     SHUTDOWN COMPLETE, 9-3
   Messages                                        -N-
     BAT block, 9-14
     BUGCHK-MESSAGES, 5-15             NCP-MESSAGES argument, 5-15
     home block, 9-13                  NEBULA program, 5-1, 5-13, 6-2
     KLINIK, 9-36                      NEXT BATCH-STREAM command, 6-17
     ORION, 5-13                       NEXT output-device command, 6-68
     ORION to OPR, 5-13                NI port
   MF20 memory, 2-4                      setting available, 7-75
   MG20 memory, 2-4                      setting unavailable, 7-75
   Microcode loading                   NO-OPR-INTERVENTION argument, 6-4
     DX20, 4-7                         NO-REMOVAL argument, 7-58
   Microfiche output, 6-45             NODE argument, 5-16
   Migrated files                      /NODE switch, 5-5
     retrieving, 7-36                  /NOTAPE-INFORMATION, 7-45
   Migrating                           Number
     files, 7-32                         channel, 7-5
   MODIFY BATCH-REQUEST command,         class, 7-3
       6-16                              controller, 7-5
   MODIFY output-device command,         device unit, 7-5
       6-67                              request, 7-21


                                  Index-9

                                        


               -O-                     PAPER-TAPE-PUNCH-MESSAGES
                                           argument, 5-16
   Operator                            Parameter
     duties, 1-2                         exceeding TIME-LIMITS, 6-5
     multiple, 5-9                       OPR-INTERVENTION, 6-4
     notebook, 1-2                       PRIORITY-LIMITS, 6-4
     remote station, 5-5                 TIME-LIMITS, 6-4
     tasks, 1-2                        Parameters
     unprivileged, 1-3, 5-21             displaying batch stream, 6-8
   Operator command language, 5-1        displaying output-device, 6-60
   Operator coverage                     setting batch-stream, 6-4
     timesharing with, 4-30              setting line printer, 6-19
     timesharing without, 4-31           tape, 2-10
   Operator-in-attendance              Parity errors, 9-15
     setting, 8-1                      /PAUSE switch, 6-34
   OPR, 5-1, 6-2                       Peripheral devices, 2-5
     commands, 5-10                    PLEASE, 3-2
     controlling messages, 5-14        PLEASE program, 5-1, 7-81
     controlling messages in CFS-20    PLEASE requests
         cluster, 5-17                   answering, 7-81
     error messages, 5-20              PLOTTER, 6-53
     exiting, 5-4                      PLOTTER-MESSAGES argument, 5-16
     HELP command, 5-12                PLT:, 6-56
     multiple jobs, 5-9, 5-10          Power switches, 4-1
     PUSH command, 5-4                 Powering up the system, 4-2
     recognition, 5-4                  Printer aliases, 6-27
     running, 5-2                      Printer jobs
   OPR-INTERVENTION parameter, 6-4       canceling, 6-42
   ORION, 4-27, 5-4, 6-2                 deleting requests, 6-44
     messages, 5-13                      holding, 6-40
     to OPR messages, 5-13               modifying requests, 6-44
   ORION log buffer file, 7-6            releasing, 6-41
   ORION-SYSTEM-LOG file, 7-6            requeuing, 6-43
   Output device jobs                    specifying printers, 6-48
     examining, 6-62                   Printer queues
   Output devices                        examining, 6-38
     continuing, 6-59                  PRINTER-MESSAGES
     setting, 6-53                       argument, 5-16
     shutting down, 6-59               Printers
     starting, 6-58                      CFS, 5-6
     stopping, 6-58                      cluster, 6-19
   Output-device jobs                    DQS, 5-6, 6-19
     examining, 6-62                     LAT, 6-19
     holding, 6-64                       line, 2-5
   Output-device status                  local, 6-19
     displaying, 6-61                    remote, 6-19
   OUTPUT-DISPLAY switches, 5-16         terminal, 6-19
                                       Priority
               -P-                       line printer, 6-20
                                       PRIORITY-LIMITS parameter, 6-4
   Page-type information, 9-45         PROBLEM ON DEVICE message, 9-7
   PAPER-TAPE-PUNCH, 6-53              PROCEED response, 7-64


                                  Index-10

                                        


   Processor                           Public structure, 8-9
     central, 2-3                      PWRES BUGCHK, 9-9
     console, 2-4
     front-end, 2-4                                -Q-
   Program
     BATCON, 5-1, 6-2                  QUASAR program, 4-27, 5-1, 6-2
     BOOT, 4-9                         Question mark, 5-10
     CDRIVE, 4-27, 5-1, 6-2
     CHECKD, 4-24, 7-78, 9-38                      -R-
     CHKPNT, 7-92
     DDMP, 4-26                        RA60
     DDT, 3-2                            tape drives, 2-4
     DLUSER, 8-21, 9-27                  word capacity, 2-8
     DUMPER, 3-2, 7-24, 7-32, 7-43,    RA81
         8-48                            tape drives, 2-4
     DX20LD, 9-60                        word capacity, 2-8
     EDIT, 3-2                         RAM, 6-32
     EDT-20, 3-2                       RDMAIL, 7-86, 8-43
     INFO, 4-27                          /A switch, 8-44
     LINK, 3-2                           /M switch, 8-4
     LISSPL, 5-1, 6-2                    /P switch, 8-44
     LPTSPL, 4-27, 5-1, 6-2              switches, 8-46
     MAIL, 7-84, 8-3                   Re-constructing ROOT-DIRECTORY,
     MAILER, 4-27                          9-28
     MAPPER, 4-27                      Re-creating
     MOUNTR, 4-27, 5-1                   directories, 9-27
     MS, 7-81                            front-end-file system, 9-31
     NEBULA, 5-1, 6-2                    structures, 9-30, 9-32
     OPR, 6-2                            system structures, 9-31
     ORION, 4-27, 5-4, 6-2             Read check, 9-7
     PLEASE, 3-2, 5-1, 7-81            READER-MESSAGES argument, 5-16
     PTYCON, 3-2                       REAPER, 7-27
     QUASAR, 4-27, 5-1, 6-2              commands, 7-27
     RDMAIL, 8-43                        error messages, 9-16
     REAPER, 7-27                        error recovery procedures, 9-16
     SORT/MERGE, 3-2                   REAPER.LIST file, 7-31
     SPEAR, 8-46                       /REASON switch, 6-16, 7-22
     SPRINT, 4-27, 5-1, 6-2            Rebuilding
     SPROUT, 5-1, 6-2                    directory symbol table, 9-24
     SYSJOB, 4-26                      Recognition, 5-10
     SYSTAT, 8-38                        OPR, 5-4
     TV, 3-2                           RECONSTRUCT ROOT-DIRECTORY
     ULIST, 8-30, 9-24                     command, 9-28
     USAG20, 7-92                      Reconstructing
     USAH20, 7-92                        directory, 9-25
     WATCH, 3-2, 8-40                  Recovery procedures
   Program counter, 9-4                  DX20, 9-61
   PS:<REMARKS>MAIL.TXT, 8-43            GALAXY, 9-52
   PS:<SYSTEM-ERROR>, 8-46               tape, 9-18
   PS:<SYSTEM>, 8-3                    Register
   PTYCON program, 3-2                   switch, 4-1
   PTYCON.ATO file, 4-26               RELEASE BATCH-JOBS command, 6-14


                                  Index-11

                                        


   RELEASE output-device command,      Save
       6-65                              incremental, 8-52
   RELEASE PRINTER-JOBS commands,      Scheduler status
       6-41                              displaying, 7-3
   Releasing                           Scheduling
     batch jobs, 6-14                    changing class, 7-1
     output-device jobs, 6-65            next batch request, 6-17
     printer jobs, 6-41                SCRATCH argument, 7-21
   Reload abbreviations, 4-23          SEMI-OPERATOR privilege, 1-3,
   Reloading systems                       5-21
     manually, 9-3                     SEND BATCH-STREAM command, 6-7
   Reloads                             SEND command, 7-22, 7-83
     scheduled, 9-3                    Server
   Remote                                MSCP, 8-56
     operator control, 5-5             SET BLOCKING FACTOR command, 8-50
     printers, 6-19                    SET DIRECTORY command, 8-21
     station operator, 5-5             SET DISK-DRIVE AVAILABLE command,
   REMOTE locator, 6-58                    7-62
   REMOVAL argument, 7-60              SET DISK-DRIVE UNAVAILABLE
   /REPEAT-COUNT switch, 6-34              command, 7-62
   REPORT command, 8-46                SET INITIALIZE command, 7-7
   Request number, 7-21                SET INITIALIZE format, 7-7
   REQUEUE BATCH-STREAM command,       SET INITIALIZE switches, 7-8
       6-16                            SET JOB SCHEDULER-CLASS command,
   Requeuing                               7-2
     batch jobs, 6-16                  SET KLINIK command, 9-35
     output-device jobs, 6-66          SET ONLINE command, 7-5
     printer jobs, 6-43                SET PORT CI UNAVAILABLE command,
   RESPOND command, 7-81                   7-63
   Response                            SET PORT NI AVAILABLE command,
     ABORT, 7-64                           7-76
     FORCE, 7-64                       SET PORT NI UNAVAILABLE command,
     PROCEED, 7-64                         7-75
   RETRIEVE command, 7-36              SET PRINTER command, 6-19
   Retrieving                          SET PRINTER FORMS-TYPE command,
     archived files, 7-36                  6-29
     migrated files, 7-36              SET PRINTER switches, 6-19
   RH11 controller, 2-9                SET SCHEDULER CLASS command, 7-1
   RH20 channel, 2-4                   SET STRUCTURE EXCLUSIVE command,
   RH20 controller, 2-9                    7-57
   ROOT-DIRECTORY                      SET STRUCTURE SHARED command,
     re-constructing, 9-28                 7-57
   RP06 word capacity, 2-8             SET TAPE-DRIVE AVAILABLE command,
   RP07 word capacity, 2-8                 7-23
   RP20 word capacity, 2-8             SET TAPE-DRIVE UNAVAILABLE
   RSX-20F, 3-1                            command, 7-23
                                       SETSPD.EXE file, 4-26
                                       Setting
               -S-                       batch-stream parameters, 6-4
                                         bias-control, 7-3
   2040S configuration, 2-1              devices on-line, 7-4
   2040S disk packs, 2-8                 line printer parameters, 6-19


                                  Index-12

                                        


   Setting (Cont.)                     Software (Cont.)
     output devices, 6-53                tasks, 1-3
     tape drives available, 7-23       SORT/MERGE program, 3-2
     tape drives unavailable, 7-23     SPEAR, 8-46
   /SHORT switch, 6-10                   program defaults, 8-47
   SHOW ALIAS command, 6-28              SUMMARIZE command, 8-47
   SHOW CONFIGURATION command, 7-71    SPEAR report, 4-23
   SHOW PARAMETER command, 6-8         SPFORM.INI file, 6-54, 6-55
   SHOW PARAMETERS output-device       SPFORM.INI format, 6-55
       command, 6-60                   SPFORM.INI switches, 6-56
   SHOW PARAMETERS PRINTER command,    SPRINT program, 4-27, 5-1, 6-2
       6-23                            SPROUT program, 5-1, 6-2
   SHOW QUEUES BATCH-JOBS command,     START command, 6-7
       6-11                            START output device command, 6-58
   SHOW QUEUES BATCH-JOBS switches,    START PRINTER command, 6-21
       6-11                            START READER command, 6-49
   SHOW QUEUES device-job switches,    Start-up questions, 4-22
       6-63                            Starting
   SHOW QUEUES device-jobs command,      batch streams, 6-5
       6-63                              card readers, 6-49
   SHOW QUEUES MOUNT-REQUESTS            hardware system, 4-1
       command, 7-76                     line printers, 6-20
   SHOW QUEUES PRINTER-JOBS command,     output devices, 6-58
       6-38                            Statistics
   SHOW QUEUES PRINTER-JOBS switches,    job, 8-40
       6-39                              system, 8-40
   SHOW SCHEDULER command, 7-3           tune mode, 8-40
   SHOW STATUS command, 6-9            STOP
   SHOW STATUS DISK-DRIVES command,      command default, 6-6
       7-68                            STOP BATCH-STREAM arguments, 6-6
   SHOW STATUS output-device command,  STOP BATCH-STREAM command, 6-6
       6-61                            STOP output-device arguments,
   SHOW STATUS PRINTER command, 6-25       6-58
   SHOW STATUS STRUCTURE command,      STOP output-device command, 6-58
       7-56, 7-71                      STOP output-device default, 6-58
   SHOW STATUS TAPE-DRIVE command,     STOP PRINTER command, 6-21
       7-15                            STOP PRINTER default, 6-21
   SHOW STATUS TAPE-DRIVE switches,    STOP PRINTER switches, 6-21
       7-15                            STOP READER command, 6-50
   SHUTDOWN command, 6-5, 6-7, 9-3     STOP READER default, 6-50
   SHUTDOWN COMPLETE message, 9-3      STOP READER switches, 6-50
   SHUTDOWN output-device command,     /STOP switch, 6-34
       6-59                            Stopping
   SHUTDOWN PRINTER command, 6-22        batch streams, 6-6
   SHUTDOWN READER command, 6-51         card readers, 6-50
   Shutting down                         line printers, 6-21
     batch streams, 6-7                  output devices, 6-58
     card readers, 6-51                Structure
     line printers, 6-22                 boot, 4-26
     output devices, 6-59                login, 4-26
   Software                              system, 4-26
     communication, 5-5


                                  Index-13

                                        


   Structure name                      Switch register (Cont.)
     invalid, 7-52                       loading from, 4-14
   Structure status                    Switches
     displaying, 7-71                    ABORT, 6-15
   /STRUCTURE-ID switch, 7-50            ABORT output-device, 6-66
   Structures                            ABORT PRINTER, 6-42
     creating, 7-77                      BACKSPACE PRINTER, 6-35
     dumpable, 9-3                       DX20LD, 9-60
     login, 8-9                          FORWARDSPACE PRINTER, 6-36
     mountable, 8-11                     load, 4-1
     mounting, 7-50                      LPFORM.INI, 6-31
     public, 8-9                         OUTPUT-DISPLAY, 5-16
     re-creating, 9-30, 9-32             power, 4-1
     removing, 7-55                      RDMAIL, 8-46
     system, 2-3                         SET INITIALIZE, 7-8
   Subcommand                            SET PRINTER, 6-19
     FILES-ONLY, 8-12                    SHOW QUEUES BATCH-JOBS, 6-11
     KILL, 8-17                          SHOW QUEUES device-job, 6-63
     LIST, 8-26                          SHOW QUEUES PRINTER-JOBS, 6-39
   SUPPRESS PRINTER, 6-37                SHOW STATUS TAPE-DRIVE, 7-15
     default, 6-37                       SPFORM.INI, 6-56
     switches, 6-37                      STOP PRINTER, 6-21
   SW REG switch, 4-1                    STOP READER, 6-50
   Switch                                SUPPRESS PRINTER, 6-37
     /ALL, 7-68, 7-71                  SYS:DXMCA file, 9-60
     /CLUSTER-NODE, 5-6, 7-50          SYS:SYSTEM.CMD, 5-2
     CONTROLLER SELECT, 4-5, 4-14      SYSJOB program, 4-26
     /DESTINATION-NODE, 5-6            SYSJOB programs
     DISK, 4-1                           restarting, 9-50
     DUMPER /FULL-INCREMENTAL, 8-49    SYSJOB STATUS command, 9-51
     ENABLE, 4-1                       SYSJOB.RUN file, 8-3, 9-51
     FLOPPY, 4-1                       SYSTAP.CTL file, 8-22
     /FREE, 7-68                       SYSTAP.LOG file, 8-22
     HALT, 9-4                         SYSTAP.LPT file, 8-22
     /MOUNTED, 7-69, 7-71              SYSTAT program, 7-90, 8-38
     /NODE, 5-5, 5-6                   System
     /PAUSE, 6-34                        hung, 9-4
     RDMAIL /A, 8-44                     looping, 9-4
     RDMAIL /M, 8-4                    System block, 4-32
     RDMAIL /P, 8-44                   System errors
     /REASON, 6-16, 7-22                 reporting, 8-46
     /REPEAT-COUNT, 6-34               System loading, 4-3
     /SHORT, 6-10                      System statistics, 8-40
     /STOP, 6-34                       System status
     /STRUCTURE-ID, 7-50                 checking, 8-38
     SW REG, 4-1                       System structure, 2-3, 4-26
     SYSTEM-OFF, 4-1                     missing, 9-58
     SYSTEM-ON, 4-1                      re-creating, 9-31
     TX03/TX05, 2-4                    System usage
     /UNMOUNTED, 7-71                    getting, 7-92
   Switch register, 4-1                SYSTEM-DATA.BIN, 7-93
     definitions, 4-15                 SYSTEM-MESSAGES argument, 5-16


                                  Index-14

                                        


   SYSTEM-OFF switch, 4-1              TM03 controller, 2-9
   SYSTEM-ON switch, 4-1               TOPS-20 label, 7-7
   SYSTEM.CMD file, 6-4                Trailer labels
   SYSTEM:str.TXT file, 8-22             standard, 7-7
                                       TU45 characteristics, 2-9
               -T-                     TU45 tape drive, 2-9
                                       TU70 characteristics, 2-9
   Tape densities                      TU70 tape drive, 2-9
     DUMPER, 8-50                      TU71 characteristics, 2-9
   Tape drive                          TU71 tape drive, 2-9
     RA60, 2-4                         TU72 characteristics, 2-9
     RA81, 2-4                         TU72 tape drive, 2-9
     TU45, 2-9                         TU77 characteristics, 2-9
     TU70, 2-9                         TU77 tape drives, 2-9
     TU71, 2-9                         TU78/79 characteristics, 2-10
     TU72, 2-9                         TU78/79 tape drives, 2-10
     TU77, 2-9                         Tune mode statistics, 8-40
     TU78/79, 2-10                     TV program, 3-2
   Tape drive status                   TX02 controller, 2-4
     displaying, 7-15                  TX03/TX05 switch, 2-4
   Tape drives available               Types
     setting, 7-23                       file, 1-1
   Tape drives unavailable
     setting, 7-23                                 -U-
   Tape error messages, 9-18
   Tape output                         ULIST
     from line printer, 6-45             error messages, 8-38
   Tape parameters, 2-10               ULIST commands, 8-31
   Tape recovery procedures, 9-18      ULIST defaults, 8-31
   /TAPE-INFORMATION, 7-45             ULIST program, 8-30, 9-24
   Tapes                               UNDELETE MAIL.CPY command, 8-4
     initializing, 7-7                 UNIBUS, 2-5
     magnetic, 2-9                     Unlabeled tapes
   Tasks                                 mounting, 7-21
     batch software, 6-1               /UNMOUNTED switch, 7-71
     hardware, 1-3                     Unprivileged operator, 1-3, 5-21
     operator, 1-2                     USAG20 program, 7-92
     software, 1-3                     USAG20.CHG, 7-94
   Terminal, 2-10                      USAH20 program, 7-92
     dedicating a, 5-3                 User account request, 8-19
     descriptions, 2-11                User names
     printers, 6-19                      deleting, 8-17
     supported, 2-11                   User remarks
   TGHA, 4-21                            listing, 8-43
   TIME-LIMITS default, 6-5            USER-MESSAGES argument, 5-16
   TIME-LIMITS parameter, 6-4          USERS.TXT file, 8-31
   Timesharing                         Utilities, 3-2
     ending, 8-55
     readying system for, 4-26                     -V-
     with operator coverage, 4-30
     without operator coverage, 4-31   VERBOSE argument, 8-26
   TM02 controller, 2-9                Vertical format unit, 2-7


                                  Index-15

                                        


   VFU, 2-7                                        -W-
   Virtual circuit, 4-32
   VMS                                 WATCH program, 3-2, 8-40
     printers, 5-6                     Word capacity
   Volume label                          RA60, 2-8
     standard, 7-7                       RA81, 2-8
   Volume recognition                    RP06, 2-8
     automatic, 7-18                     RP07, 2-8
                                         RP20, 2-8













































                                  Index-16