Trailing-Edge
-
PDP-10 Archives
-
BB-PBQUB-BM_1990
-
7-documentation/op_guide.mem
There is 1 other file named op_guide.mem in the archive. Click here to see a list.
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
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