Trailing-Edge
-
PDP-10 Archives
-
tops10v704_docc
-
10,7/docupd/opgd.mem
Click 10,7/docupd/opgd.mem to
see without markup as text/plain
There is 1 other file named opgd.mem in the archive. Click here to see a list.
TOPS-10 Operator's Guide
| Electronically Distributed
|
|
|
| This guide gives the computer operator a
| task-oriented reference for using the TOPS-10
| operating system. This guide supercedes the
| TOPS-10 Operator's Guide published in October
| 1988. The part number for that guide,
| AA-H283CB-TB, is obsolete.
Operating System: TOPS-10 Version 7.04
Software: GALAXY Version 5.1
digital equipment corporation maynard, massachusetts
| TOPS-10 Software Update Tape No. 03, September 1990
First Printing, July 1980
Revised, April 1986
Revised, October 1988
| Revised, September 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 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 1980, 1986, 1988, 1990 Digital Equipment Corporation.
All Rights Reserved.
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
CONTENTS
PREFACE
CHAPTER 1 THE SYSTEM OPERATOR
1.1 RESPONSIBILITIES . . . . . . . . . . . . . . . . . 1-i
1.2 DUTIES . . . . . . . . . . . . . . . . . . . . . . 1-i
1.2.1 Hardware-Related Duties . . . . . . . . . . . . 1-2
1.2.2 Software-Related Duties . . . . . . . . . . . . 1-2
1.3 DOCUMENTATION . . . . . . . . . . . . . . . . . . 1-3
1.3.1 Supplied by DIGITAL . . . . . . . . . . . . . . 1-3
1.3.2 Supplied by Your Installation . . . . . . . . . 1-3
1.3.3 CTY Output Logbook . . . . . . . . . . . . . . . 1-5
CHAPTER 2 HARDWARE FAMILIARIZATION
2.1 OVERVIEW . . . . . . . . . . . . . . . . . . . . . 2-1
2.2 CENTRAL PROCESSORS . . . . . . . . . . . . . . . . 2-1
2.3 MEMORY SYSTEMS . . . . . . . . . . . . . . . . . . 2-2
2.4 FRONT-END PROCESSORS (KL SYSTEMS) . . . . . . . . 2-3
2.5 FLOPPY DISKS . . . . . . . . . . . . . . . . . . . 2-4
2.6 DECtapes . . . . . . . . . . . . . . . . . . . . . 2-4
2.7 THE MICROPROCESSOR (KS SYSTEMS) . . . . . . . . . 2-4
2.8 PERIPHERAL DEVICES . . . . . . . . . . . . . . . . 2-4
2.8.1 Overview of Peripheral Device Maintenance . . . 2-5
2.8.2 Line Printers . . . . . . . . . . . . . . . . . 2-5
2.8.3 Card Readers/Punches . . . . . . . . . . . . . . 2-6
2.8.4 DECtapes . . . . . . . . . . . . . . . . . . . . 2-7
2.8.5 Disk Packs . . . . . . . . . . . . . . . . . . . 2-7
2.8.6 Magnetic Tapes . . . . . . . . . . . . . . . . . 2-8
2.8.7 Plotters . . . . . . . . . . . . . . . . . . . . 2-9
2.8.8 Terminals . . . . . . . . . . . . . . . . . . . 2-9
2.8.8.1 Hardcopy Terminals . . . . . . . . . . . . . . 2-9
2.8.8.2 CRT Display Terminals . . . . . . . . . . . 2-10
2.8.9 Remote Stations . . . . . . . . . . . . . . . 2-10
CHAPTER 3 SOFTWARE OVERVIEW
3.1 OPERATING SYSTEMS . . . . . . . . . . . . . . . . 3-1
3.2 LANGUAGES . . . . . . . . . . . . . . . . . . . . 3-1
3.2.1 MACRO Assembler . . . . . . . . . . . . . . . . 3-1
3.2.2 Compilers . . . . . . . . . . . . . . . . . . . 3-2
3.2.3 Interpreters . . . . . . . . . . . . . . . . . . 3-2
3.3 UTILITIES AND OTHER SOFTWARE . . . . . . . . . . . 3-3
iii
CHAPTER 4 STARTING THE KS10 CENTRAL PROCESSOR
4.1 SWITCHES AND LIGHTS . . . . . . . . . . . . . . . 4-1
4.2 POWERING UP THE SYSTEM . . . . . . . . . . . . . . 4-3
4.3 LOADING THE SYSTEM USING DEFAULT PARAMETERS . . . 4-4
4.3.1 Powering Up and Loading from Disk . . . . . . . 4-4
4.3.2 Reloading the Monitor from Disk . . . . . . . . 4-5
4.3.3 Powering Up and Loading from Magnetic Tape . . . 4-6
4.4 LOADING THE SYSTEM USING NONDEFAULT PARAMETERS . . 4-7
4.4.1 Loading from Disk and Changing Parameters . . . 4-8
4.4.2 Loading from Magnetic Tape and Changing
Parameters . . . . . . . . . . . . . . . . . . . 4-8
4.4.3 Loading the Monitor from a Nondefault File . . 4-10
4.5 ANSWERING MONITOR STARTUP QUESTIONS . . . . . . 4-10
CHAPTER 5 STARTING THE KL10 CENTRAL PROCESSOR
5.1 SWITCHES AND LIGHTS . . . . . . . . . . . . . . . 5-2
5.2 POWERING UP THE SYSTEM . . . . . . . . . . . . . . 5-7
5.3 FAMILIARIZING YOURSELF WITH RSX-20F . . . . . . . 5-7
5.3.1 Using the PARSER . . . . . . . . . . . . . . . . 5-7
5.3.2 Using KLINIT . . . . . . . . . . . . . . . . . . 5-8
5.4 LOADING THE SYSTEM USING DEFAULT PARAMETERS . . 5-10
5.4.1 Loading RSX-20F from Disk . . . . . . . . . . 5-10
5.4.2 Reloading the Monitor from Disk . . . . . . . 5-12
5.4.3 Loading RSX-20F from Floppy Disks . . . . . . 5-12
5.4.4 Loading RSX-20F from DECtape . . . . . . . . 5-14
5.5 LOADING THE SYSTEM USING NONDEFAULT PARAMETERS . 5-15
5.5.1 Loading RSX-20F Using the Switch Register . . 5-16
5.5.2 Loading from Magnetic Tape . . . . . . . . . 5-20
5.5.3 Loading the Monitor from a Nondefault File . . 5-21
5.6 ANSWERING MONITOR STARTUP QUESTIONS . . . . . . 5-22
5.7 LOADING A COMMUNICATIONS FRONT END . . . . . . . 5-24
5.7.1 Loading with BOOT11 over a DL10 . . . . . . . 5-25
5.7.2 Loading with DTELDR over a DTE20 . . . . . . . 5-27
5.8 LOADING THE DX10 OR DX20 DATA CHANNEL . . . . . 5-28
5.9 RUNNING SYMMETRIC MULTIPROCESSING (SMP) SYSTEMS 5-31
5.9.1 Loading and Starting an SMP System . . . . . . 5-32
5.9.2 Restarting a Nonpolicy CPU (SMP Systems Only) 5-35
CHAPTER 6 THE OPERATOR INTERFACE, OPR
6.1 INTRODUCTION TO OPR . . . . . . . . . . . . . . . 6-1
6.2 RUNNING OPR . . . . . . . . . . . . . . . . . . . 6-1
6.2.1 Starting OPR . . . . . . . . . . . . . . . . . . 6-2
6.2.2 Exiting from OPR . . . . . . . . . . . . . . . . 6-2
6.2.3 Issuing OPR Commands to/from ANF-10 Remote
Stations . . . . . . . . . . . . . . . . . . . . 6-3
6.2.4 Multiple Operators on the System . . . . . . . . 6-3
6.3 OPR COMMAND FEATURES . . . . . . . . . . . . . . . 6-3
iv
6.3.1 Listing Available Commands . . . . . . . . . . . 6-4
6.3.2 Using ESCape Recognition . . . . . . . . . . . . 6-5
6.3.3 Reprinting Faulty Commands . . . . . . . . . . . 6-6
6.3.4 Getting Help . . . . . . . . . . . . . . . . . . 6-6
6.3.5 Line Continuation . . . . . . . . . . . . . . . 6-7
6.4 CONTROLLING ORION TO OPR MESSAGES . . . . . . . . 6-8
6.5 OPR ERROR MESSAGE DESCRIPTIONS . . . . . . . . . 6-10
CHAPTER 7 GALAXY SOFTWARE TASKS
7.1 CONTROLLING SYSTEM EVENTS . . . . . . . . . . . . 7-4
7.1.1 Closing the ORION Log File . . . . . . . . . . . 7-6
7.1.2 Scheduling System Shutdown . . . . . . . . . . . 7-6
7.1.3 Controlling Usage Accounting . . . . . . . . . . 7-7
7.1.4 Executing Command Files . . . . . . . . . . . . 7-7
7.2 BATCH RESPONSIBILITIES . . . . . . . . . . . . . . 7-8
7.3 CONTROLLING BATCH STREAMS . . . . . . . . . . . . 7-9
7.3.1 Setting Parameters . . . . . . . . . . . . . . . 7-9
7.3.2 Starting Batch Streams . . . . . . . . . . . . 7-10
7.3.3 Stopping Batch Streams Temporarily . . . . . . 7-11
7.3.4 Continuing Batch Streams . . . . . . . . . . . 7-11
7.3.5 Shutting Down Batch Streams . . . . . . . . . 7-12
7.3.6 Sending Messages . . . . . . . . . . . . . . . 7-12
7.3.7 Displaying Batch Stream Parameters . . . . . . 7-13
7.3.8 Displaying Batch Stream Status . . . . . . . . 7-14
7.4 CONTROLLING FAL STREAMS . . . . . . . . . . . . 7-15
7.4.1 Defining FAL Accessibility . . . . . . . . . . 7-16
7.4.2 Setting Parameters . . . . . . . . . . . . . . 7-16
7.4.3 Starting FAL Streams . . . . . . . . . . . . . 7-17
7.4.4 Stopping FAL Streams Temporarily . . . . . . . 7-17
7.4.5 Continuing FAL Streams . . . . . . . . . . . . 7-18
7.4.6 Shutting Down FAL Streams . . . . . . . . . . 7-18
7.4.7 Displaying FAL Stream Parameters . . . . . . . 7-18
7.4.8 Displaying FAL Stream Status . . . . . . . . . 7-19
7.5 CONTROLLING NQC STREAMS . . . . . . . . . . . . 7-19
7.5.1 Setting Parameters . . . . . . . . . . . . . . 7-20
7.5.2 Starting NQC Streams . . . . . . . . . . . . . 7-20
7.5.3 Stopping NQC Streams Temporarily . . . . . . . 7-20
7.5.4 Continuing NQC Streams . . . . . . . . . . . . 7-21
7.5.5 Shutting Down NQC Streams . . . . . . . . . . 7-21
7.5.6 Displaying NQC Stream Parameters . . . . . . . 7-22
7.5.7 Displaying NQC Stream Status . . . . . . . . . 7-22
7.6 CONTROLLING BATCH JOBS . . . . . . . . . . . . . 7-22
7.6.1 Examining the Batch Queue . . . . . . . . . . 7-23
7.6.2 Holding Batch Jobs . . . . . . . . . . . . . . 7-24
7.6.3 Releasing Batch Jobs . . . . . . . . . . . . . 7-25
7.6.4 Aborting Running Batch Jobs . . . . . . . . . 7-26
7.6.5 Requeuing Batch Jobs . . . . . . . . . . . . . 7-27
7.6.6 Modifying Batch Requests . . . . . . . . . . . 7-27
7.6.7 Deleting Batch Requests . . . . . . . . . . . 7-28
7.7 CONTROLLING THE LINE PRINTER . . . . . . . . . . 7-29
v
7.7.1 Setting Line Printer Parameters . . . . . . . 7-29
7.7.2 Using the LPFORM.INI File . . . . . . . . . . 7-31
7.7.3 Using the LPFONT.INI File . . . . . . . . . . 7-35
7.7.4 Starting the Line Printer . . . . . . . . . . 7-35
7.7.5 Stopping the Line Printer Temporarily . . . . 7-36
7.7.6 Continuing the Line Printer . . . . . . . . . 7-36
7.7.7 Shutting Down the Line Printer . . . . . . . . 7-37
7.7.8 Displaying Line Printer Parameters . . . . . . 7-37
7.7.9 Displaying Line Printer Status . . . . . . . . 7-38
7.8 CONTROLLING FORMS ON THE LINE PRINTER . . . . . 7-39
7.8.1 Aligning Forms . . . . . . . . . . . . . . . . 7-41
7.8.2 Backspacing Forms . . . . . . . . . . . . . . 7-42
7.8.3 Forwardspacing Forms . . . . . . . . . . . . . 7-43
7.8.4 Suppressing Carriage Control . . . . . . . . . 7-44
7.9 CONTROLLING LINE PRINTER JOBS . . . . . . . . . 7-45
7.9.1 Examining the Printer Queue . . . . . . . . . 7-45
7.9.2 Holding Line Printer Jobs . . . . . . . . . . 7-47
7.9.3 Releasing Line Printer Jobs . . . . . . . . . 7-48
7.9.4 Canceling Line Printer Jobs . . . . . . . . . 7-48
7.9.5 Requeuing Line Printer Jobs . . . . . . . . . 7-49
7.9.6 Modifying Line Printer Requests . . . . . . . 7-50
7.9.7 Deleting Line Printer Requests . . . . . . . . 7-50
7.9.8 Specifying the next Line Printer Job . . . . . 7-51
7.10 SENDING PRINTER OUTPUT TO MAGNETIC TAPE . . . . 7-52
7.11 CONTROLLING LAT DEVICES . . . . . . . . . . . . 7-55
7.11.1 Setting Parameters . . . . . . . . . . . . . . 7-56
7.11.2 Resetting Parameters . . . . . . . . . . . . . 7-56
7.11.3 Starting LAT Activity . . . . . . . . . . . . 7-57
7.11.4 Stopping LAT Activity . . . . . . . . . . . . 7-58
7.11.5 Changing LAT Counters . . . . . . . . . . . . 7-58
7.11.6 Displaying LAT Activity . . . . . . . . . . . 7-58
7.12 CONTROLLING THE CARD READER . . . . . . . . . . 7-59
7.12.1 Starting the Card Reader . . . . . . . . . . . 7-60
7.12.2 Stopping the Card Reader . . . . . . . . . . . 7-60
7.12.3 Continuing the Card Reader . . . . . . . . . . 7-61
7.12.4 Shutting Down the Card Reader . . . . . . . . 7-61
7.12.5 Displaying Card Reader Status . . . . . . . . 7-62
7.12.6 Canceling a Card Reader Job . . . . . . . . . 7-62
7.13 CONTROLLING CARD PUNCH, PAPERTAPE PUNCH, AND
PLOTTERS . . . . . . . . . . . . . . . . . . . . 7-63
7.13.1 Setting Output Device Parameters . . . . . . . 7-64
7.13.2 Using the SPFORM.INI File . . . . . . . . . . 7-66
7.13.3 Starting Output Devices . . . . . . . . . . . 7-68
7.13.4 Stopping Output Devices . . . . . . . . . . . 7-69
7.13.5 Continuing Output Devices . . . . . . . . . . 7-70
7.13.6 Shutting Down Output Devices . . . . . . . . . 7-70
7.13.7 Displaying Output Device Parameters . . . . . 7-71
7.13.8 Displaying Output Device Status . . . . . . . 7-71
7.14 CONTROLLING JOBS ON OUTPUT DEVICES . . . . . . . 7-72
7.14.1 Examining the Queues . . . . . . . . . . . . . 7-73
7.14.2 Holding Jobs . . . . . . . . . . . . . . . . . 7-75
7.14.3 Releasing Jobs . . . . . . . . . . . . . . . . 7-75
vi
7.14.4 Canceling Jobs . . . . . . . . . . . . . . . . 7-76
7.14.5 Requeuing Jobs . . . . . . . . . . . . . . . . 7-77
7.14.6 Modifying Requests . . . . . . . . . . . . . . 7-77
7.14.7 Deleting Requests . . . . . . . . . . . . . . 7-78
7.14.8 Specifying the NEXT Job . . . . . . . . . . . 7-78
7.15 GALAXY CRASH RECOVERY PROCEDURES . . . . . . . . 7-79
CHAPTER 8 SCHEDULED SOFTWARE TASKS
8.1 UPDATING THE MESSAGE OF THE DAY . . . . . . . . . 8-1
8.2 UPDATING THE ACCOUNTING FILE WITH REACT . . . . . 8-2
8.3 CONTROLLING USAGE ACCOUNTING . . . . . . . . . . . 8-2
8.4 MAINTAINING SYSTEM CATALOG FILES . . . . . . . . . 8-4
8.5 SAVING ACCOUNTING FILES . . . . . . . . . . . . . 8-4
8.6 SAVING GRIPE FILES . . . . . . . . . . . . . . . . 8-5
8.7 RIDDING THE SYSTEM OF DETACHED JOBS . . . . . . . 8-5
8.8 BACKING UP THE SYSTEM (DAILY) . . . . . . . . . . 8-6
8.9 BACKING UP THE SYSTEM (WEEKLY) . . . . . . . . . . 8-7
8.10 REFRESHING FILE STRUCTURES . . . . . . . . . . . . 8-8
8.11 ANALYZING SYSTEM FILE STRUCTURES WITH DSKLST . . . 8-9
8.12 OBTAINING DISK ERROR INFORMATION WITH DSKRAT . . . 8-9
CHAPTER 9 UNSCHEDULED SOFTWARE TASKS
9.1 CONTROLLING THE ORION LOG FILE . . . . . . . . . . 9-1
9.2 DUAL PATH ACCESS TO MAGTAPE . . . . . . . . . . . 9-2
9.3 INITIALIZING TAPES . . . . . . . . . . . . . . . . 9-2
9.4 HANDLING MAGTAPE MOUNT REQUESTS . . . . . . . . . 9-7
9.4.1 Displaying Tape Drive Status . . . . . . . . . . 9-8
9.4.2 Controlling Tape Drive Volume Recognition (AVR) 9-10
9.4.3 Handling Labeled Tapes with AVR Enabled . . . 9-11
9.4.4 Handling Labeled Tapes with AVR Disabled . . . 9-12
9.4.5 Handling Unlabeled Tapes . . . . . . . . . . . 9-12
9.4.6 Dismounting Tapes . . . . . . . . . . . . . . 9-14
9.4.7 Canceling Tape Mount Requests . . . . . . . . 9-15
9.4.8 Setting Tape Drives Available or Unavailable . 9-15
9.5 HANDLING FILE STRUCTURE AND DISK-DRIVE TASKS . . 9-16
9.5.1 Answering Structure Mount Requests . . . . . . 9-17
9.5.2 Mounting a Structure with MOUNT . . . . . . . 9-20
9.5.3 Controlling Structure Dismount Requests . . . 9-21
9.5.3.1 Locking and Unlocking Structures . . . . . . 9-21
9.5.3.2 Removing a Structure with DISMOUNT . . . . . 9-22
9.5.4 Canceling Structure Mount Requests . . . . . . 9-25
9.5.5 Displaying Structure Status . . . . . . . . . 9-25
9.5.6 Displaying Disk Drive Status . . . . . . . . . 9-27
9.5.7 Controlling Structure Recognition . . . . . . 9-29
9.5.8 Controlling Disk Drive Volume Recognition . . 9-29
9.6 EXAMINING TAPE/DISK MOUNT REQUESTS IN THE QUEUE 9-30
9.7 CONTROLLING SYSTEM LISTS . . . . . . . . . . . . 9-32
9.7.1 Displaying System Lists . . . . . . . . . . . 9-32
vii
9.7.2 Modifying System Lists . . . . . . . . . . . . 9-33
9.8 RESTORING DISK FILES WITH BACKUP . . . . . . . . 9-33
9.9 COMMUNICATING WITH THE USERS . . . . . . . . . . 9-36
9.9.1 Answering PLEASE Messages with OPR . . . . . . 9-36
9.9.2 Talking to a User with SEND . . . . . . . . . 9-37
9.10 REPORTING ERRORS WITH OPR . . . . . . . . . . . 9-39
9.11 DOWN-LINE LOADING ANF-10 REMOTE STATIONS . . . . 9-39
9.11.1 Running NETLDR Automatically . . . . . . . . . 9-40
9.11.2 Running NETLDR Manually . . . . . . . . . . . 9-40
9.12 CONTROLLING ANF-10 REMOTE STATIONS . . . . . . . 9-42
9.12.1 Starting and Shutting Down a Node . . . . . . 9-43
9.12.2 Displaying Node Status . . . . . . . . . . . . 9-44
9.12.3 Routing Device Output between Nodes . . . . . 9-44
9.12.4 Displaying the Routing Table . . . . . . . . . 9-46
9.13 STOPPING AND RESTARTING KS10 COMMUNICATIONS . . 9-46
9.14 RECONFIGURING SYSTEM HARDWARE . . . . . . . . . 9-47
9.14.1 Adding System Hardware . . . . . . . . . . . . 9-48
9.14.2 Configuring System Hardware . . . . . . . . . 9-49
9.14.3 Removing System Hardware . . . . . . . . . . . 9-49
9.14.4 Controlling System Hardware . . . . . . . . . 9-50
9.14.5 Shutting Down the System . . . . . . . . . . . 9-51
9.14.6 Stopping the System . . . . . . . . . . . . . 9-51
9.14.7 Suspending a System . . . . . . . . . . . . . 9-52
CHAPTER 10 ERROR RECOVERY ON THE KS10 CENTRAL PROCESSOR
10.1 RECOVERING FROM A MICROPROCESSOR CRASH . . . . . 10-2
10.2 RECOVERING FROM A MONITOR CRASH . . . . . . . . 10-3
10.2.1 Automatically Dumping and Reloading the Monitor 10-4
10.2.2 Manually Dumping and Reloading the Monitor . . 10-5
10.3 RECOVERING FROM A HUNG OR LOOPING SYSTEM . . . . 10-6
10.4 COPYING CRASH DATA . . . . . . . . . . . . . . . 10-7
10.5 RECOVERING FROM STOPCODES (MONITOR ERROR STOPS) 10-8
10.5.1 Identifying DEBUG Stopcodes . . . . . . . . . 10-9
10.5.2 Identifying JOB Stopcodes . . . . . . . . . . 10-9
10.5.3 Identifying STOP Stopcodes . . . . . . . . . . 10-10
10.5.4 Identifying CPU Stopcodes . . . . . . . . . . 10-10
10.5.5 Identifying HALT Stopcodes . . . . . . . . . . 10-11
10.5.6 Identifying INFO and EVENT Stopcodes . . . . . 10-11
10.6 RECOVERING FROM PARITY AND NXM ERRORS . . . . . 10-11
10.7 RESTARTING A HUNG CONSOLE TERMINAL (LA36) . . . 10-13
10.8 FINDING A MISSING MONITOR FILE . . . . . . . . . 10-13
10.9 ALLOWING SYSTEM DIAGNOSIS WITH KLINIK . . . . . 10-14
10.10 RECOVERING FROM KS10 HALT-STATUS CODES . . . . . 10-16
10.11 MICROPROCESSOR ERROR MESSAGES . . . . . . . . . 10-17
10.12 RECOVERING FROM ENVIRONMENTAL ERRORS . . . . . . 10-22
CHAPTER 11 ERROR RECOVERY ON THE KL10 CENTRAL PROCESSOR
11.1 RECOVERING FROM A KL10 CRASH . . . . . . . . . . 11-2
viii
11.2 RECOVERING FROM A MONITOR CRASH . . . . . . . . 11-6
11.2.1 Automatically Dumping and Reloading the Monitor 11-7
11.2.2 Manually Dumping and Reloading the Monitor . . 11-8
11.3 SYSTEM ERROR RECOVERY . . . . . . . . . . . . . 11-9
11.4 COPYING CRASH DATA . . . . . . . . . . . . . . . 11-10
11.5 RECOVERING FROM STOPCODES (MONITOR ERROR STOPS) 11-11
11.5.1 Identifying DEBUG Stopcodes . . . . . . . . . 11-12
11.5.2 Identifying JOB Stopcodes . . . . . . . . . . 11-12
11.5.3 Identifying STOP Stopcodes . . . . . . . . . . 11-13
11.5.4 Identifying CPU Stopcodes . . . . . . . . . . 11-14
11.5.5 Identifying HALT Stopcodes . . . . . . . . . . 11-15
11.5.6 Identifying INFO and EVENT Stopcodes . . . . . 11-16
11.6 RECOVERING FROM ERRORS DETECTED BY THE PARSER . 11-16
11.7 RECOVERING FROM ERRORS DETECTED BY KLINIT . . . 11-27
11.7.1 KLINIT Operator-Dialog Error Message . . . . . 11-27
11.7.2 KLINIT Warning Messages . . . . . . . . . . . 11-28
11.7.3 KLINIT System Error Messages . . . . . . . . . 11-28
11.8 RECOVERING FROM PARITY AND NXM ERRORS . . . . . 11-41
11.9 RECOVERING FROM BAD MEMORY . . . . . . . . . . . 11-43
11.9.1 Setting Memory Off-Line . . . . . . . . . . . 11-43
11.9.2 Reconfiguring Memories . . . . . . . . . . . . 11-43
11.10 RESTARTING A HUNG CONSOLE TERMINAL (LA36) . . . 11-44
11.11 FINDING A MISSING MONITOR FILE . . . . . . . . . 11-45
11.12 RECOVERING FROM FRONT-END PROCESSOR ERRORS . . . 11-45
11.12.1 Recovering from DTE20-Interfaced Error . . . . 11-46
11.12.2 Recovering from DL10-Interfaced Errors . . . . 11-47
11.13 RECOVERING FROM DATA CHANNEL ERRORS . . . . . . 11-48
11.14 ALLOWING SYSTEM DIAGNOSIS WITH KLINIK . . . . . 11-49
11.14.1 KLINIK Informational Messages . . . . . . . . 11-50
11.14.2 KLINIK Error Messages . . . . . . . . . . . . 11-51
11.15 RECOVERING FROM ENVIRONMENTAL ERRORS . . . . . . 11-52
11.16 SPLITTING AN SMP SYSTEM . . . . . . . . . . . . 11-54
11.17 ADDING PROCESSORS AND MEMORY TO SMP SYSTEMS . . 11-57
11.18 FAULT CONTINUATION (WARM RESTART) . . . . . . . 11-59
APPENDIX A SYSTEM DUMPING AND RELOADING PROCEDURES
A.1 BOOT ERROR MESSAGES . . . . . . . . . . . . . . . A-1
A.2 BOOT ERROR CODES . . . . . . . . . . . . . . . . . A-4
A.3 SYSTEM DUMP LIST . . . . . . . . . . . . . . . . . A-4
A.4 THE CRSCPY PROGRAM . . . . . . . . . . . . . . . . A-5
A.4.1 Action Commands . . . . . . . . . . . . . . . . A-6
A.4.2 Status-Setting Commands . . . . . . . . . . . . A-7
A.4.3 Report-Selection Commands . . . . . . . . . . . A-8
APPENDIX B KS10 MICROPROCESSOR CONSOLE PROGRAM AND COMMANDS
B.1 MICROPROCESSOR CONSOLE PROGRAM . . . . . . . . . . B-1
B.2 COMMON CONSOLE COMMANDS . . . . . . . . . . . . . B-2
B.3 MICROPROCESSOR COMMANDS . . . . . . . . . . . . . B-3
ix
B.3.1 Boot Commands . . . . . . . . . . . . . . . . . B-4
B.3.2 Enable/Disable Commands . . . . . . . . . . . . B-5
B.3.3 Examine Commands . . . . . . . . . . . . . . . . B-6
B.3.4 Mark/Unmark Microcode Commands . . . . . . . . . B-7
B.3.5 Miscellaneous Commands . . . . . . . . . . . . . B-7
B.3.6 Read CRAM Commands . . . . . . . . . . . . . . . B-8
B.3.7 Select Device Commands . . . . . . . . . . . . . B-8
B.3.8 Set and Deposit Commands . . . . . . . . . . . . B-9
B.3.9 Start/Stop Clock Commands . . . . . . . . . . B-10
B.3.10 Start/Stop Microcode Commands . . . . . . . . B-11
B.3.11 Start/Stop Program Commands . . . . . . . . . B-11
APPENDIX C PARSER
C.1 ENTERING AND EXITING THE PARSER . . . . . . . . . C-1
C.2 PARSER COMMAND SYNTAX . . . . . . . . . . . . . . C-2
C.3 PARSER CONSOLE MODES . . . . . . . . . . . . . . . C-4
C.4 PARSER HELP FACILITY . . . . . . . . . . . . . . . C-5
C.5 PARSER COMMANDS . . . . . . . . . . . . . . . . . C-6
APPENDIX D KLINIT OPERATOR DIALOG
D.1 KLINIT OPERATOR DIALOG RULES . . . . . . . . . . . D-1
D.2 ANSWERING KLINIT OPERATOR DIALOG QUESTIONS . . . . D-2
APPENDIX E SAVING AND RESTORING DISK FILES WITH BACKUP
E.1 BACKUP FEATURES . . . . . . . . . . . . . . . . . E-1
E.2 BACKUP COMMANDS . . . . . . . . . . . . . . . . . E-2
E.2.1 Action Commands . . . . . . . . . . . . . . . . E-3
E.2.2 Status-Setting Commands . . . . . . . . . . . . E-4
E.2.3 Tape-Positioning Commands . . . . . . . . . . . E-8
E.2.4 Runtime Commands . . . . . . . . . . . . . . . E-10
E.3 BACKUP EXAMPLES . . . . . . . . . . . . . . . . E-12
E.3.1 Console User Examples . . . . . . . . . . . . E-12
E.3.1.1 Saving a User's Disk Area . . . . . . . . . E-12
E.3.1.2 Restoring Selected Files . . . . . . . . . E-12
E.3.1.3 Renaming Files as They are Transferred . . E-12
E.3.2 Operator Tasks . . . . . . . . . . . . . . . . E-13
E.3.2.1 Saving the Entire Disk . . . . . . . . . . . E-13
E.3.2.2 Recovering from a System Crash . . . . . . . E-14
E.3.3 Saving Only Recently Created or Modified Files E-14
E.3.4 Restoring Only Recently Accessed Files . . . . E-15
E.4 OBTAINING DIRECTORIES OF BACKUP TAPES . . . . . E-15
E.5 COMPARING TAPE AND DISK FILES . . . . . . . . . E-16
E.6 CHECKPOINTING LARGE FILES . . . . . . . . . . . E-17
E.7 BACKUP MESSAGES . . . . . . . . . . . . . . . . E-18
E.7.1 Informational Messages . . . . . . . . . . . . E-18
E.7.2 Operator Messages . . . . . . . . . . . . . . E-18
x
E.7.3 Fatal Error Messages . . . . . . . . . . . . . E-19
E.7.4 Warning Messages . . . . . . . . . . . . . . . E-22
E.8 BACKUP TAPE FORMAT . . . . . . . . . . . . . . . E-28
E.8.1 Tape Record Types . . . . . . . . . . . . . . E-28
E.8.2 Standard Record Format . . . . . . . . . . . . E-29
E.8.3 Non-data Blocks . . . . . . . . . . . . . . . E-31
E.8.4 Locations in T$LBL Record . . . . . . . . . . E-36
E.8.5 Locations in T$BEG, T$END, T$CON Records . . . E-37
E.8.6 Locations in T$UFD Record . . . . . . . . . . E-38
E.8.7 Locations in T$FIL Record . . . . . . . . . . E-38
APPENDIX F FAMILIARIZING YOURSELF WITH TGHA (1091 SYSTEMS ONLY)
F.1 SYSTEM STARTUP . . . . . . . . . . . . . . . . . . F-1
F.2 RUNNING TGHA MANUALLY . . . . . . . . . . . . . . F-2
INDEX
FIGURES
1-1 Sample System Logbook Page . . . . . . . . . . . . 1-5
5-1 Reading Path for Chapter 5 . . . . . . . . . . . . 5-2
5-2 RSX-20F Loading Choices . . . . . . . . . . . . . 5-4
5-3 Monitor Loading Choices . . . . . . . . . . . . . 5-4
5-4 Role Switching . . . . . . . . . . . . . . . . . 5-32
7-1 The GALAXY System . . . . . . . . . . . . . . . . 7-2
11-1 Conceptual Diagram of Splitting the System . . . 11-54
TABLES
4-1 Load Switches . . . . . . . . . . . . . . . . . . 4-1
4-2 REMOTE DIAGNOSIS Switch Positions . . . . . . . . 4-2
4-3 Indicator Lights . . . . . . . . . . . . . . . . . 4-2
5-1 Load Switches . . . . . . . . . . . . . . . . . . 5-5
5-2 Indicator Lights . . . . . . . . . . . . . . . . . 5-6
5-3 Switch-Register Switch Definitions . . . . . . . 5-17
5-4 BOOT11 Switches . . . . . . . . . . . . . . . . 5-26
5-5 DTELDR Switches . . . . . . . . . . . . . . . . 5-28
5-6 DX10 BOOTDX Switches . . . . . . . . . . . . . . 5-29
5-7 DX20 BOOTDX Switches . . . . . . . . . . . . . . 5-30
7-1 GALAXY Components . . . . . . . . . . . . . . . . 7-3
7-2 LPFORM.INI Switches . . . . . . . . . . . . . . 7-31
7-3 SPFORM.INI Switches For All Device Types . . . . 7-66
7-4 SPFORM.INI Switches For Plotter Devices Only . . 7-67
7-5 GALAXY Component Crash Recovery Procedures . . . 7-81
9-1 SET TAPE-DRIVE INITIALIZE Switches . . . . . . . . 9-3
xii
PREFACE
The TOPS-10 Operator's Guide is a task-oriented reference guide for
operating KS10-based TOPS-10 systems (DECSYSTEM-2020), and KL10-based
TOPS-10 systems (1090, 1091 with core memory, 1091 with MOS memory,
1095, and 1099). This guide is written for experienced TOPS-10
operators.
This guide covers the following topics:
o System Familiarization
o Device Operation and Maintenance
o System Startup
o Software Tasks
o Error-Recovery Procedures
This guide uses the following conventions:
CTY means console terminal.
TTY means terminal.
<RET> means press the RETURN key.
<ESC> means press the ESCAPE key.
<CTRL/character> means hold the CTRL key down while
you type the character indicated.
underscore indicates anything that you type.
The term "-10 series hardware" represents all hardware systems that
run TOPS-10 software.
xiii
Operating procedures unique to particular CPUs are described in the
following chapters: Chapters 4 and 10 pertain to the KS10, and
Chapters 5 and 11 pertain to the KL10 central processor. Sections
5.9, 5.9.2, and 11.16 refer only to SMP systems. You may want to
remove the chapters that do not apply to your system.
For current information on the RSX-20F PARSER commands, please refer
to the TOPS-10/TOPS-20 RSX-20F System Reference Manual.
For current information on which devices are supported for this
version of the TOPS-10 monitor, please contact your Field Service
Center for a copy of the TOPS-10 Software Product Description.
xiv
CHAPTER 1
THE SYSTEM OPERATOR
1.1 RESPONSIBILITIES
As a TOPS-10 operator, your primary responsibilities are to keep the
system running and to respond to user requests. Therefore, you must
be familiar with all of the resources available to your system, know
how to use them, and be able to recognize potential problems.
You must know how to:
o Communicate with both the microprocessor and the central
processor (if you have a KS system)
o Communicate with RSX-20F, which is a program that controls
the console PDP-11, and its central processor(s) (if you have
a KL system)
o Work with the TOPS-10 command language, including a text
editor
o Do everything listed in the next two sections
You are responsible for:
o Documenting system activities for operators on the next shift
o Logging a permanent record of system availability,
maintenance, and downtime
1.2 DUTIES
Your duties can be classified into two categories:
o Hardware-related
1-1
THE SYSTEM OPERATOR
o Software-related
You may perform these duties on a regular schedule, on an "on call"
basis, or on an emergency basis.
1.2.1 Hardware-Related Duties
Your hardware-related duties include:
o Maintaining the system devices and the computer room
o Replenishing consumable supplies such as paper forms
o Servicing user requests to mount magnetic tapes or disk
packs, and so forth
If the hardware malfunctions, you must return the device that failed
to normal operation as quickly as possible. This can mean either
removing any damaged or foreign material or calling your Field Service
representative.
Whenever there is a problem, you must be able to:
o Assess the extent of the problem and take appropriate action
o Make an entry in the system logbook
o Fill out a hardware error form
1.2.2 Software-Related Duties
Your software-related duties include:
o Responding promptly to user requests
o Assigning devices
o Running system accounting and control tasks specified by the
system administrator
Whenever there is a problem, you must be able to:
o Assess the extent of the problem and take appropriate action
o Make an entry in the system logbook
o Fill out a Software Error Report (SER) form
1-2
THE SYSTEM OPERATOR
1.3 DOCUMENTATION
There are a number of documents available to make your
responsibilities and duties easier. You should have access to the
ones mentioned here. Some are for one-time reading, others are for
reference, and still others are for you to document pertinent system
information.
1.3.1 Supplied by DIGITAL
In addition to this guide, the following publications, included in the
TOPS-10 Software Notebook set, provide additional information for the
system operator.
o TOPS-10 Operator's Command Language Reference Manual
o TOPS-10 Software Installation Guide
o TOPS-10 Operating System Commands Manual
o TOPS-10 User Utilities Manual
o TOPS-10/TOPS-20 Operator's Hardware Device and Maintenance
Guide
1.3.2 Supplied by Your Installation
The documentation that your installation supplies usually includes an
operator's notebook and a system logbook. Often, this documentation
also includes a set of operating procedures tailored specifically for
your installation.
The operator's notebook is the most practical means for shift-to-shift
communication among system operators, and between an operator and the
system manager. The operator's notebook provides a permanent message
center for efficient system operations.
You should read the turnover entries as you begin your shift. These
entries may include scheduled system downtime, new software to try,
problems encountered on previous shifts, warnings on potential
intermittent malfunctions, and specific instructions for work to be
processed on your shift.
At the end of your shift, you should enter the same type of
information for the next shift operator. If you are a non-prime-shift
operator and the system manager works prime shift, the operator's
notebook allows you to communicate with him.
1-3
THE SYSTEM OPERATOR
The system logbook is the prime source of information about the
system. (See Figure 1-1.) Operators, system programmers, system
managers, software support personnel, and Field Service engineers all
use the system logbook. You must check this log when you report for
work, and update the log throughout your shift.
System logbook entries include:
o All monitor loads and reloads, with reasons for reloading
o All hardware and software problems, with symptoms and device
identification
o All system shutdowns
To make it easy to identify the items, you can write hardware entries
on the left-hand pages and software entries on the right-hand pages.
1-4
THE SYSTEM OPERATOR
____________________________________________________________________
| |
| PAGE__________ |
|____________________________________________________________________|
| |
| SYSTEM LOG DATE__________ |
|____________________________________________________________________|
| | | | | | | |
| | R | | | | | |
| | E | | | F/S | | |
| | L | | MONITOR OR | A | | |
| | O | | HARDWARE | T | DEVICE | |
| TIME | A | NAME | MAINTENANCE | T | OR | ENTRY |
| | D | | ACTIVITY | N | PROGRAM | |
|______|___|______|_____________|_____|_________|____________________|
| | | | | | | |
|______|___|______|_____________|_____|_________|____________________|
| | | | | | | |
|______|___|______|_____________|_____|_________|____________________|
| | | | | | | |
|______|___|______|_____________|_____|_________|____________________|
| | | | | | | |
|______|___|______|_____________|_____|_________|____________________|
| | | | | | | |
|______|___|______|_____________|_____|_________|____________________|
| | | | | | | |
|______|___|______|_____________|_____|_________|____________________|
| | | | | | | |
|______|___|______|_____________|_____|_________|____________________|
| | | | | | | |
|______|___|______|_____________|_____|_________|____________________|
Figure 1-1: Sample System Logbook Page
Your installation may generate a tailored set of operating procedures
based upon your installation's specific hardware configuration and the
software in use. You can divide such operating procedures into
sections for your scheduled tasks. This would provide you with a
compact, easily referenced run book, which would also be helpful in
training new operators.
1.3.3 CTY Output Logbook
In addition to making entries in the operator's notebook and the
system logbook, you should retain and file the system console (CTY)
output or log. This chronological record of system events can be very
helpful in tracking down intermittent system problems.
1-5
2-1
CHAPTER 2
HARDWARE FAMILIARIZATION
2.1 OVERVIEW
To improve your understanding of the system, this chapter briefly
describes the -10 series hardware.
You can use the TOPS-10 operating system with all of the -10 series
hardware systems. The hardware components of these systems are very
similar. The amount and type of available memory, the type of data
channels, the type of processor, or the number and type of peripherals
are some of the factors that determine the system.
The 1099 systems are multiple-processor systems, that have Symmetric
Multiprocessing (SMP) features. The SMP features provide the
capability of attaching and sharing memory and I/O devices between
central processor units in symmetric configurations. The system uses
a single copy of the monitor that can handle more than one job at a
time.
The -10 series hardware that you will be operating falls into five
general categories: central processors, memory systems, front-end
processors or microprocessors, peripherals, and remote stations.
2.2 CENTRAL PROCESSORS
Your -10 series system has either a KL10E, KL10R, KL10B, KL10D, or
KS10 central processor. Each is described below.
The KL10E, which directs the operation of the 1091 system, and the
KL10R, which directs the operation of the 1095 system, contains:
o A microcoded instruction set (399 instructions)
o A high-speed 2K cache memory
2-1
HARDWARE FAMILIARIZATION
o Fast integrated-circuit general-purpose registers
o Virtual memory capability
o A console terminal (CTY)
The KL10R is the 60 Hertz domestic version of the KL10E, a 50 Hertz
international model.
The KL10B, KL10D or KL10R central processors, which direct the entire
operation of 1090 and 1099 systems, offer the same features and
functions as the KL10E plus the following:
o Up to eight integrated high-speed data channels (RH20s)
o Up to three integrated communications processor channels
(DTE20s); a fourth DTE20 is used to interface the
Console/Diagnostic processor
The central processor, internal memory and mass storage controllers
are combined in two cabinets.
The KS10 central processor, which directs the entire operation of 2020
systems, contains:
o A microcoded instruction set (396 instructions)
o A high-speed cache memory
o Fast integrated circuit general-purpose registers
o Interrupt and trap facilities
o Virtual memory capability
The central processor, internal MOS memory, mass-storage controllers,
and peripheral controllers are combined in one cabinet.
2.3 MEMORY SYSTEMS
Types of memory storage units available for the -10 series hardware
systems include: MF10, MG10, or MH10 core memory; MS10, MF20, or MG20
MOS memory; and MB20 or MA20 internal memory.
The KL Central Processor supports:
o MF10 - core memory
o MG10 - core memory
2-2
HARDWARE FAMILIARIZATION
o MH10 - core memory
o MB20/MA20 - internal memory
o MF20 - MOS memory
o MG20 - MOS memory
The KS10 Central Processor supports:
o MS10 - MOS memory
2.4 FRONT-END PROCESSORS (KL SYSTEMS)
The PDP-11 based console/diagnostic processor is also referred to as a
console front-end (CFE). The console front-end handles:
o Line printers
o Card readers
o Floppy disks
o Terminals
o Console functions
o Microcode loading
o Memory configuration
o System startup
o System fault continuation
o Diagnostics
The console front end is in the cabinet to the left of the cabinets
containing the central processor, internal memory, and mass-storage
controllers. The PDP-11 interfaces to KL processors through the DTE
(Digital Ten-to-Eleven) interface. The front-end memory consists of
28K of 18-bit words (16 data bits and 2 parity bits).
Additional PDP-11 based front-end processors, referred to as
communications front ends, can be attached to the KL10B or D
processors through the integrated DTE20 interface or DL10 data
channel. On the KL10E and KL10R they are attached through the
integrated DTE20. Communications front ends provide the facilities
for supporting interactive terminals and unit record remote stations.
They can be attached locally through direct electrical connections or
2-3
HARDWARE FAMILIARIZATION
remotely through dedicated or dial-up telephone lines.
The DN87 front-end provides synchronous line protocol to support
remote stations such as the DN80 series and the DN92. They attach to
the processors through the DL10 data channel. The DN87, DN87S, and
DN20 front ends provide synchronous and/or asynchronous protocol to
support remote stations, depending upon the line options selected.
The DN87 attaches to the KL10B or D through the DL10 communication
channel. The DN20 or DN87S attach to the KL10B, KL10D, KL10E, and
KL10R through the integrated DTE20 interface.
2.5 FLOPPY DISKS
Three floppy disks are distributed with each new version of the
TOPS-10 software for all 1091 and 1095 systems. Their main functions
include loading and starting the PDP-11 and the KL10. They also run
diagnostics that pertain to the front-end processor.
2.6 DECtapes
Three DECtapes are distributed with each new version of the TOPS-10
software for all 1090 systems. Their main functions include loading
and starting the PDP-11 and the KL10. They also run diagnostics that
pertain to the front-end processor.
2.7 THE MICROPROCESSOR (KS SYSTEMS)
The microprocessor on the KS system (2020) is a single microprogrammed
chip, which is a complete central processing unit. The microprocessor
handles console functions, diagnostics, microcode-loading and system
startup.
2.8 PERIPHERAL DEVICES
Peripheral devices include line printers, card readers, DECtape
drives, disk packs and drives, magnetic tape devices, plotters,
terminals, and remote stations. The TOPS-10/TOPS-20 Operator's
Hardware Device and Maintenance Guide details the operation and
maintenance of the peripheral devices.
2-4
HARDWARE FAMILIARIZATION
2.8.1 Overview of Peripheral Device Maintenance
NOTE
If you have misplaced the operator's manual enclosed
with the peripheral device you wish to operate and
maintain, contact your Field Service representative
for complete information on operation, maintenance,
and safety measures.
Because most equipment operates more efficiently if it is kept clean,
a cleaning procedure is documented in the Device and Maintenance
Guide. Here are some general rules for cleaning. You should have the
following cleaning supplies available:
o 91% isopropyl alcohol
o Lint-free wipers
o Spray cleaner
o Vacuum cleaner with rubber or plastic attachments, which can
blow air as well as take in air
o Cotton-tipped applicators
o Soft suede brush
You should clean the exterior of all equipment weekly. Vacuum all
outside surfaces including cabinet tops. Use spray cleaner on all
vertically exposed surfaces except around switches.
In general, do not clean the interior of any equipment unless so
directed in the Device and Maintenance Guide; your Digital Field
Service representative does that job. Specific instructions for
cleaning line printers and magnetic tape drives are given in the
Device and Maintenance Guide.
Always be careful not to bump or change the position of any switches;
this could cause the system or the device to crash. Likewise, when
you are cleaning the exterior of any disk drives, be careful not to
jar the equipment; this could cause a serious hardware head crash.
Lastly, if you ever have any problem or doubts concerning the cleaning
procedure for a device, consult your Field Service representative.
2.8.2 Line Printers
Each system requires at least one line printer. The following line
2-5
HARDWARE FAMILIARIZATION
printers are available:
o LP05
o LP07
o LP10
o LP14
o LP26/27
o LP29
o LN01/03 laser printer
All the line printers are 132-column devices, and have either a 64- or
96-character print set. Those with the 96-character print set have
uppercase and lowercase characters. LP10 printers have a Vertical
Format Unit (VFU), which consists of a carriage control tape. The VFU
controls paper motions in the printer. All other models have a
Direct-Access Vertical Format Unit, or DAVFU, which is controlled by
software (see Section 7.7).
2.8.3 Card Readers/Punches
Card readers are mainly used in batch processing. Card readers are
input devices only. The following card readers and punches are
available:
o The CR10-D table model card reader, which processes 1000
cards per minute.
o The CR10-E console card reader, which processes 1200 cards
per minute.
o The CR10-F table model card reader, which processes 300 cards
per minute.
o The CP10-D card punch, which processes 100 cards per minute.
Card readers are interfaced to the central processor through the BA10
controller on 1070, 1077, 1080, 1090, and 1099 systems; card punches
are interfaced through the CP10-D controller. On 1091, 1095, and 2020
systems, the card readers are interfaced through the CD20 controller.
2-6
HARDWARE FAMILIARIZATION
2.8.4 DECtapes
The TU56 DECtape drive is a bi-directional, random access, magnetic
tape storage device available on the 1070, 1077, 1080, 1090, and 1099
systems. Each TU56 is a dual tape transport, and, up to 4 of the dual
drives can be attached to each TD10-C DECtape controller.
2.8.5 Disk Packs
Disk storage allows rapid transfer of data in and out of main memory.
At least one disk must be dual-ported on the KL10 system so that the
front-end computer and the central processor can both access the
information on the disk. Each CPU in an SMP system requires a disk
dual-ported from the CPU to the front-end.
The following kinds of disk packs are available:
o The RP02 disk pack, which has a 5-million word capacity.
o The RP03 disk pack, which has a 10-million word capacity.
o The RS04 fixed-head disk pack, which has a 4-million word
(16-bit word) capacity.
o The RP04 disk pack, which has a 20-million word capacity.
o The RP06 disk pack, which has a 40-million word capacity.
o The RM03 disk pack, which has a 15-million word capacity.
o The RP20 disk pack, which has a 107.5-million word capacity
per spindle.
o The RP07 disk pack, which has a 111-million word capacity.
o The RA60 removable disk pack, which has a 46-million word
capacity.
o The RA81 non-removable disk pack, which has a 102-million
word capacity.
All words are 36 bits unless noted otherwise.
The drives for these packs provide error detection and correction
hardware as well as high-speed access and transfer rates.
On 1090, 1091, 1095, and 1099 systems, the RP04, RP06, or RP07 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
2-7
HARDWARE FAMILIARIZATION
controller.
On 1090, 1091, 1095, and 1099 systems the RP20 disk drive has an RH20
integrated controller and a data channel connected to a DX20
programmed device adapter. The DX20 is connected to an RP20 disk
controller. If the disk is dual-ported, the main processor accesses
the disk drive through the RH20.
On the KS system, the RP06 or RM03 disk drives have an RH11 integrated
controller and data channel for access by the central processor.
On 1090, 1095 and 1099 systems, the RP04, RP06, or RS04 disk drives
have an RH10 integrated controller and DF10 data channel for access by
the central processor. The RP02 and RP03 disk drives have an RP10
integrated controller and a DF10 data channel.
RP04, RP06, RP07, and RP20 disk drives are available with a dual-port
option. This option allows a disk drive to be accessed over either of
two paths. In the KL series processors, for example, an RP04 or RP06
dual-ported disk drive can contain files to be accessed by both the
main processor and the console front-end processor. A dual-ported
RP07 or RP20 disk drive can only be accessed by the main processor.
For KL SMP systems, disk drives may be dual-ported across CPUs.
Dual-ported disks decrease overhead and increase availability and
performance.
The RA60 and RA81 disk drives can be dual-ported between two HSC-50
controllers. These controllers can be connected to different KL10
CPUs in an SMP system. This provides fail-safe capability in the case
that one CPU crashes.
2.8.6 Magnetic Tapes
The following magnetic tape systems and drives are available:
TE10 TU16 TU40
TU41 TU45 TU70
TU71 TU72 TU77
TU78/79
All magnetic tape drives are either 7- or 9-track drives. They can
handle one of the following groups of variable recording densities:
o 200, 556, or 800 bits per inch (BPI)
o 800 or 1600 BPI
2-8
HARDWARE FAMILIARIZATION
o 1600 or 6250 BPI
Recording speeds vary from drive to drive, but fall in the range of 45
to 200 inches per second.
On KL systems, the TU45 and TU77 are interfaced through a TM02 or TM03
controller to an RH20 integrated controller. The TU70, TU71, and TU72
are interfaced to an RH20 through a DX20 and TX02 or they are
interfaced to a DX10 through a TX01 or TX02. The TU78/79 is
interfaced to channels (RH11, RH20) through a TM78 controller housed
in the master TU78/79 tape drive.
On KS systems, the TU45 is interfaced to an RH11 integrated controller
and data channel through a TM02 or TM03 controller.
2.8.7 Plotters
The following plotters are available:
o The XY10-A plotter with .01 inch, .005 inch, or .1 millimeter
step size at 18,000 steps per minute, and using 12-inch-wide
paper.
o The XY10-B plotter with .01 inch step size at 12,000 steps
per minute or .005 inch or .1 millimeter step size at 18,000
steps per minute, and using 31-inch-wide paper.
2.8.8 Terminals
The operator and each timesharing user interacts with the system
through a terminal. You will generally use a hardcopy terminal as the
operator's terminal to start, stop, load, and continue the system and
user programs. Using a hardcopy terminal provides you with a printed
record of all your interactions with the system and the users. This
is especially useful when there is a problem with the system. Users
interact with the system through either a hardcopy or a video
terminal. Several terminals can be used as operator's terminals, set
to receive messages from certain types of system resources (see
Section 6.4). The CTY is also a hardcopy terminal, useful for
recording system events. These listings can provide information vital
to solving puzzling system crashes.
2.8.8.1 Hardcopy Terminals - Hardcopy terminals include:
o LA36 DECwriter II
2-9
HARDWARE FAMILIARIZATION
o LA35RO (Recieve Only) DECwriter
o LA37APL DECwriter
o LA120 DECwriter
o LA180 DECprinter
2.8.8.2 CRT Display Terminals - CRT display terminals include:
o VT50 and VT50H video terminals
o VT52 video terminal
o VT61 video terminal
o VT100 video terminal
o VT102 video terminal
o VT220 video terminal
o VT240 video terminal
o VT330 video terminal
o VT340 video terminal
For a complete list of hardcopy and video terminals supported by the
software, type:
HELP *
One piece of information returned by HELP * is a list of terminal
types.
2.8.9 Remote Stations
The following remote stations are used in TOPS-10 ANF-10 network
configurations:
o The DN80 series remote stations that can provide remote job
entry facilities (DN80), remote terminal facilities (DN81),
or a combination of both (DN82).
o The DN92 remote station, which can be configured in
combinations of terminal lines and a card reader and/or a
line printer. DN92 is not supported on 2020 systems.
2-10
HARDWARE FAMILIARIZATION
o The DN200 remote station, which can be configured in
combinations of terminal lines and a card reader and/or a
line printer.
o The DN20 remote station is a PDP-11 based processor that can
run communications functions for either ANF-10 or DECnet-10.
For information about ANF-10, refer to the TOPS-10 ANF-10 Networks
Software Installation Guide.
For information about DECnet-10, refer to the DECnet-10/PSI System
Manager's and Operator's Guide.
2-11
3-1
CHAPTER 3
SOFTWARE OVERVIEW
The -10 series software falls into three general categories:
operating systems, languages, and utilities.
3.1 OPERATING SYSTEMS
The main operating system for the -10 series hardware is called the
TOPS-10 monitor. It supports timesharing, batch processing, real
time, and remote communications.
The RSX-20F operating system runs in the console/diagnostic processor
on KL systems. It aids the central processor and TOPS-10 in handling
system tasks such as system loading, console communications, and
diagnostic functions.
3.2 LANGUAGES
The TOPS-10 monitor supports three types of translators used in
symbolic language programming: assemblers, compilers, and
interpreters.
3.2.1 MACRO Assembler
MACRO is the symbolic assembler program used on TOPS-10. It is
device-independent; input and output devices can be selected at run
time and may vary from run to run. MACRO also contains capabilities
that allow the user to replace commonly-used sequences of instructions
with a single statement.
3-1
SOFTWARE OVERVIEW
3.2.2 Compilers
The compilers on TOPS-10 include ALGOL, COBOL, BLISS, and FORTRAN.
The ALGOrithmic Language, ALGOL, is a scientific language designed for
the solution of computational processes, or algorithms. TOPS-10 ALGOL
is composed of the ALGOL compiler for the translation of the source
code and the ALGOL object-time system that provides I/O services, a
library of mathematical functions, and control of system resources.
The COmmon Business Oriented Language, COBOL, is an industry-wide data
processing language designed for business applications. Its
English-like statements are easily learned and result in
self-documenting programs. TOPS-10 COBOL includes the COBOL compiler;
an object-time system, LIBOL; a source library maintenance program; a
COBOL checkout and debugging program, COBDDT; and ancillary programs.
BLISS is a middle-level language, providing both a substantial class
of higher level facilities while permitting access to hardware
features and producing high-quality object code. It is intended for
use as a system implementation language.
The FORmula TRANslator language, FORTRAN, is a widely used,
procedure-oriented language designed and primarily used for solving
scientific problems. TOPS-10 FORTRAN-10 includes the FORTRAN-10
compiler; an object-time system, FOROTS; and a FORTRAN checkout and
debugging program, FORDDT.
3.2.3 Interpreters
The interpreters include APL, CPL, and BASIC. APL (A Programming
Language) is a completely conversational system especially suited for
handling numeric and character array-structured data. However, it is
also intended for use as a general data processing language.
CPL is an interpreter supporting a subset of the draft ANSI PL/I
language. CPL supports the following classes of PL/I built-in
functions: arithmetic, mathematical, string array, storage control
and pseudo-variables.
The Beginner's All-purpose Symbolic Instruction Code, BASIC, is an
easy to learn problem-solving language, particularly suited to a
timesharing environment. BASIC contains its own editing facilities.
The language includes statements covering matrix computations,
advanced string-handling capabilities, mathematical functions, and the
generation of user-defined functions.
3-2
SOFTWARE OVERVIEW
3.3 UTILITIES AND OTHER SOFTWARE
TOPS-10 provides many utilities, including text editors, text
processors, file manipulators, maintenance programs, and monitor
support programs. These programs are called Commonly Used System
Programs (CUSPs):
BACKUP A system program to save disk files on magnetic tape, and
later to restore any or all of the files back to disk (see
Appendix E).
DDT The Dynamic Debugging Technique used for the on-line
checkout and updating of programs (see the TOPS-10 DDT-10
Manual).
DIRECT DIRECT is a CUSP used to list user directories from disk,
magnetic tape, and DECtape. Through the use of DIRECT, a
user may at any time determine, from a terminal or batch
job, the files existing in the user directory (see the
TOPS-10 Operating System Commands Manual).
GALAXY A group of programs that can control user requests for
devices, accounting, and batch jobs, as well as the system
unit record devices (see Chapter 7).
LINK-10 A linking loader to merge independently-compiled object
files into one executable program (see the TOPS-10 LINK
Reference Manual).
OPR The operator's command interface, which allows communication
with various parts of the monitor and the GALAXY system (see
the TOPS-10 Operator's Command Language Reference Manual).
OPSER A service program that allows you to control multiple
subjobs from a single terminal (see the TOPS-10 Operator's
Command Language Reference Manual).
PIP A file interchange program to selectively transfer files
from one type of media to another and concurrently perform
limited editing and directory manipulation. PIP functions
are performed by monitor commands like DELETE and COPY (see
the TOPS-10 User Utilities Manual).
RUNOFF A text processing program that produces a final formatted,
paged, right-justified output from an edited file with
appropriate RUNOFF commands (see the TOPS-10 User Utilities
Manual).
TECO A character-oriented text editor with the ability to edit
any source document without requiring special formatting
(see the TOPS-10 User Utilities Manual).
3-3
4-1
CHAPTER 4
STARTING THE KS10 CENTRAL PROCESSOR
4.1 SWITCHES AND LIGHTS
Before you start the DECSYSTEM-2020, you must become familiar with the
switches and lights on the cabinet.
Four rocker switches and one key switch are located on the top right
corner of the front panel. Just above them are the four indicator
lights.
The rocker switches are load switches. They are labeled BOOT, LOCK,
RESET, and POWER. To set any of these switches to ON, press the top
half of the switch. Table 4-1 lists the load switches and their
functions.
Table 4-1: Load Switches
______________________________________________________________________
Switch Function
______________________________________________________________________
BOOT Boots the system from either the default device or the
last selected device.
LOCK Disables the BOOT and RESET switches and prevents the
console program from recognizing a CTRL/backslash.
RESET Starts the system without beginning the boot
procedure.
POWER Supplies power to the system and automatically loads
the system from the default device 30 seconds after
being switched from 0 to 1. The "1" next to the
switch means that it is on; the "0" means that it is
off.
______________________________________________________________________
4-1
STARTING THE KS10 CENTRAL PROCESSOR
The key switch on the right is the REMOTE DIAGNOSIS switch. This is a
3-position key switch that controls access to the KLINIK remote
diagnosis facility. (See Chapter 11 for more information on KLINIK.)
You can remove the key with the switch set to any of the three
positions.
Table 4-2 lists the REMOTE DIAGNOSIS switch positions and their
functions. Your system manager should tell you which setting to use.
Table 4-2: REMOTE DIAGNOSIS Switch Positions
______________________________________________________________________
Position Function
______________________________________________________________________
DISABLE Prohibits access to the system through the KLINIK
link.
PROTECT Allows access to the system through the KLINIK link,
but only if the password entered from the link matches
the password previously entered by the operator.
ENABLE Allows access to the system through the KLINIK link.
______________________________________________________________________
There are four indicator lights above the switches. Table 4-3
describes each of the indicator lights.
Table 4-3: Indicator Lights
______________________________________________________________________
Light Condition Explanation
______________________________________________________________________
STATE ON The microprocessor has successfully
loaded the microcode and is up and
running, but the TOPS-10 operating
system is not yet running.
OFF The microprocessor has stopped.
BLINKING The microprocessor has successfully
loaded the monitor. The monitor is in
the timesharing state, and is exchanging
dialog with the console program in the
4-2
STARTING THE KS10 CENTRAL PROCESSOR
microprocessor. During input and output
to the CTY, the blinking slows down.
FAULT ON The system is malfunctioning. This can
(during mean that there is an error in device
system selection or that there is a
loading) microprocessor fault. Make sure the
disk or magnetic tape is mounted on
drive 0. Try to reload. If the reload
fails, call your Field Service
representative.
ON The microprocessor has stopped. Try
(during to reload. If the reload fails, call
timesharing) your Field Service representative.
OFF The microprocessor is operating
normally.
POWER ON The central processor is powered up.
OFF The central processor is powered down.
REMOTE ON The KLINIK link has been enabled.
OFF The KLINIK link cannot be accessed.
______________________________________________________________________
4.2 POWERING UP THE SYSTEM
Before you power up the system, turn on the console terminal (CTY).
Make sure that it is online, and has paper. Make sure that the
following peripheral devices are powered up. If they are not, see the
TOPS-10/TOPS-20 Operator's Hardware Device and Maintenance Guide for
procedures.
o Line printers
o Magnetic-tape drives
o Disk drives
To power up the system, press the POWER switch on the CPU to the ON
position. The POWER light will go on. If you do not type <CTRL/C>
within 30 seconds, the system will begin the automatic boot procedure
from disk. (See Section 4.3.1 for more information on the automatic
boot procedure.)
4-3
STARTING THE KS10 CENTRAL PROCESSOR
4.3 LOADING THE SYSTEM USING DEFAULT PARAMETERS
Before you begin to load the DECSYSTEM-2020, make sure that:
o All hardware and software is properly installed.
o The disk packs are mounted properly.
o The LOCK switch is off.
If you are installing the system for the first time, or installing a
new version of the software, see the TOPS-10 Software Installation
Guide.
The default parameters for loading the system are:
o UBA1 is the UNIBUS adapter for disk.
o UBA3 is the UNIBUS adapter for magnetic tape.
o RHBASE 776700 is the address of RH11 controller for disk.
o RHBASE 772440 is the address of RH11 controller for magnetic
tape.
o Unit 0 is the disk drive and magnetic-tape drive.
o DSK:SYSTEM.EXE[1,4] is the monitor file.
NOTE
The unit number is the only parameter you can change.
You can use the default parameters to load the system either from disk
(Section 4.3.1) or from magnetic tape (Section 4.3.3). To use
nondefault parameters to load the system, see Section 4.4.
To reload the monitor from disk pack when the monitor is already
running, see Section 4.3.2.
After you answer the monitor startup questions described in Section
5.6, INITIA may print a few lines on the CTY. The INITIA program
automatically starts the jobs you always want to run at system
startup, and initializes terminal characteristics. See the TOPS-10
Software Installation Guide for more information on INITIA.
4.3.1 Powering Up and Loading from Disk
To load the system from disk using the default parameters do the
following:
4-4
STARTING THE KS10 CENTRAL PROCESSOR
1. Press the POWER switch to the ON position. The POWER light
goes on, the microprocessor prints its ROM code and version
number on the CTY, and the system automatically boots. To
stop the automatic boot procedure, type CTRL/C on the CTY
within 30 seconds of pressing POWER. If you receive the
message, "?NXM", on the CTY, you can ignore it.
2. Press RETURN where indicated in the following sample dialog:
KS10 CSL.V4.2 Microprocessor ROM code and version
number.
BT AUTO This message prints 30 seconds after
power-up.
BOOT V#(#) BOOT version number.
BOOT><RET> Press RETURN to load the default monitor
from the file DSKB:SYSTEM.EXE[1,4].
Immediately after the system prints BT AUTO, the
microprocessor starts the boot procedure from disk unit 0.
The system then assumes all of the default parameters. If
the CTY does not print the BOOT prompt, the automatic boot
procedure has failed. If that happens, check the disk to
make sure it is properly mounted. If no hardware problem is
apparent, the default parameters may be incorrectly set.
To remedy this situation, follow the steps in Section 4.4.1
to reset the default parameters, or the steps in Section
4.3.3 to load the monitor from magnetic tape.
When the monitor has been loaded into memory, the monitor
startup questions begin. If the system does not print the
first monitor startup question (Why reload: ), BOOT sends an
error message. (For explanations of BOOT messages, see
Appendix A.)
3. Answer the monitor startup questions described in Section
5.6.
4.3.2 Reloading the Monitor from Disk
To reload the monitor from disk when the monitor is already running,
halt timesharing and reload the monitor. To do this, perform the
following steps:
1. Make sure the POWER light is on. (See Section 4.3.1.)
4-5
STARTING THE KS10 CENTRAL PROCESSOR
2. Type the following commands:
.RUN OPR<RET> Run the OPR program.
OPR>SET KSYS +0:05<RET> This halts timesharing in five
minutes.
To change the amount of time,
see the SET KSYS command in the
Operator's Command Language
Reference Manual.
OPR>EXIT<RET> Exit the OPR program.
3. Wait five minutes before proceeding and then perform the
following steps on the CTY.
.^\ENABLED Type CTRL/backslash (shown here
as ^\) to communicate with the
microprocessor. CTRL/backslash
does not echo on the CTY.
KS10>SHUT<RET> Type SHUT and press RETURN to
shut down the system.
KS10>USR MOD The CTY automatically enters
user mode.
BOOT>DSKB:<RET> Type DSKB: and press RETURN to
load the default monitor from
the file DSKB:SYSTEM.EXE[1,4].
[Loading from DSKB:SYSTEM.EXE[1,4]]
BOOT reloads the monitor.
When the monitor has been loaded into memory, the monitor
startup questions begin.
4. Answer the monitor startup questions described in Section
5.6.
4.3.3 Powering Up and Loading from Magnetic Tape
Before you load the system from magnetic tape with the default
parameters, make sure that:
o All of the software is on magnetic tape. If it is not, see
Section 4.3.1.
4-6
STARTING THE KS10 CENTRAL PROCESSOR
o The magnetic tape is mounted on tape-drive unit 0. If it is
not, see the TOPS-10/TOPS-20 Operator's Hardware Device and
Maintenance Guide for instructions.
To load the system from magnetic tape using default parameters, do the
following:
1. Make sure the POWER light is on. If the light is not on,
press POWER to the ON position and type CTRL/C within 30
seconds. If you do not type CTRL/C within 30 seconds, the
system begins the automatic boot procedure from disk.
Section 4.3.1 explains the automatic boot procedure.
2. Make sure a bootstrap tape, such as the distributed
installation tape, is mounted on drive 0.
3. Type everything that is underscored in the following sample
dialog:
KS10>MT<RET> Type MT and then press RETURN.
KS10>USR MOD The CTY enters user mode.
BOOT V#(##) BOOT version number.
BOOT><RET> Press RETURN to load the default
monitor from the file
DSKB:SYSTEM.EXE[1,4].
See Appendix B for information on the KS10 microprocessor
commands. When the monitor has been loaded into memory, the
monitor startup questions begin.
4. Answer the monitor startup questions described in Section
5.6.
4.4 LOADING THE SYSTEM USING NONDEFAULT PARAMETERS
Before you begin to load the DECSYSTEM-2020 using nondefault
parameters, make sure that:
o All hardware and software is properly installed.
o The disk packs are mounted properly.
o The LOCK switch is off.
If you are installing the system for the first time, refer to the
TOPS-10 Software Installation Guide.
4-7
STARTING THE KS10 CENTRAL PROCESSOR
4.4.1 Loading from Disk and Changing Parameters
To load from a disk mounted on a drive other than unit 0, perform the
following steps:
1. Make sure the POWER light is on. If the light is not on,
press POWER to the ON position and type CTRL/C within 30
seconds. If you do not type CTRL/C within 30 seconds, the
system will begin the automatic boot procedure. (See Section
4.3.1 for more information on the automatic boot procedure.)
2. Make sure the disk pack is mounted on the drive you want.
3. Type everything that is underscored in the following sample
dialog. When you press RETURN to answer a question, the
system assumes the default value.
KS10>DS<RET> Type DS then press RETURN.
>>UBA?<RET> Which UBA is the drive controller
attached to? Press RETURN.
>>RHBASE?<RET> What is the RH11 base address? Press
RETURN.
>>UNIT?n<RET> Type the disk-drive unit number (n)
and press RETURN. Currently, UNIT is
the only parameter that you may
change.
KS10>BT<RET> Type BT and press RETURN.
BOOT V#(#) BOOT version number.
BOOT><RET> Press RETURN to load the default
monitor from the file
DSKB:SYSTEM.EXE[1,4].
When the monitor has been loaded into memory, the monitor
startup questions begin. If the system does not print the
first monitor startup question, BOOT prints an error message.
See Appendix A for information about BOOT error messages.
4. Answer the monitor startup questions described in Section
5.6.
4.4.2 Loading from Magnetic Tape and Changing Parameters
To load from a magnetic-tape drive other than drive 0, perform the
4-8
STARTING THE KS10 CENTRAL PROCESSOR
following steps:
1. Make sure the POWER light is on. If the light is not on,
press POWER to the ON position and type CTRL/C within 30
seconds. If you do not type CTRL/C within 30 seconds, the
system will begin the automatic boot procedure from the disk.
(See Section 4.3.1 for details on the automatic boot
procedure.)
2. Make sure the monitor tape is mounted on the magnetic-tape
drive you want. The default drive is 0.
3. Type everything that is underscored in the following sample
dialog. When you press RETURN to answer a question, the
system assumes the default value.
KS10>MS<RET> Type MS and press RETURN.
>>UBA?<RET> Which UBA is the drive controller
attached to? Press RETURN.
>>RHBASE?<RET> What is the RH11 base address? Press
RETURN.
>>TCU?<RET> What is the tape-controller unit
number? Press RETURN. Your system
may print UNIT. UNIT and TCU both
refer to the tape-controller unit
number.
>>DENS?<RET> What is the tape density? The tape
density depends on the type of drive
you have. (See Chapter 3 for more
information about tape densities.)
Press RETURN.
>>SLV?n<RET> What is the slave? Type the number
(n) that is on the outside of the
magnetic-tape drive and press RETURN.
KS10>MT<RET> Type MT and press RETURN.
KS10>USR MOD The CTY enters user mode.
BOOT V#(#) BOOT version number.
BOOT><RET> Press RETURN to load the default
monitor from the magnetic tape.
When the monitor has been loaded into memory, the monitor
startup questions begin.
4-9
STARTING THE KS10 CENTRAL PROCESSOR
4. Answer the monitor startup questions described in Section
5.6.
4.4.3 Loading the Monitor from a Nondefault File
To load a monitor from a file other than DSKB:SYSTEM.EXE[1,4], perform
the following steps:
1. Load the system as usual from disk (see Sections 4.3.1 and
4.4.1) or magnetic tape (see Sections 4.3.3 and 4.4.2). When
the CTY prints the bootstrap program prompt (BOOT>) perform
Step 2.
2. Type the monitor name (for example, NEWMON.EXE) or a complete
file specification and then press RETURN. Everything that
you type is underscored in the following example:
BOOT>NEWMON.EXE<RET> This is an example of using BOOT to
load the monitor from disk or magnetic
tape.
When the monitor has been loaded into memory, the monitor
startup questions begin.
3. Answer the monitor startup questions described in Section
5.6.
4.5 ANSWERING MONITOR STARTUP QUESTIONS
When you have loaded the microcode, the bootstrap program, and the
monitor, you can start timesharing by answering the questions in the
monitor startup dialog. Section 5.6 briefly describes the startup
dialog. See the TOPS-10 Software Installation Guide for a detailed
discussion of the dialog.
4-10
CHAPTER 5
STARTING THE KL10 CENTRAL PROCESSOR
This chapter contains step-by-step instructions for loading and
starting a KL system. Sections 5.1 through 5.8 apply to both
single-processor and Symmetric Multiprocessing (SMP) systems.
Sections 5.9 through 5.9.2 apply to SMP systems only.
To load and start a single-processor system, perform the following
steps:
1. Power up the system. (See Section 5.2.)
2. Load the RSX-20F front-end file system. (See Section 5.3.)
3. Load the monitor and start the central processor (CPU). (See
Section 5.4 or Section 5.5.)
4. Answer the monitor startup questions. (See Section 5.6.)
5. Load the communications front end (if any).
To load and start an SMP system, perform the following steps:
1. Read Section 5.9, which defines the terms policy and
nonpolicy CPU.
2. Power up the system. (See Section 5.2.)
3. Load the RSX-20F front-end file system on each nonpolicy CPU
from disk or DECtape using the switch register. (See Section
5.5.1)
4. Load the RSX-20F front-end file system, the bootstrap
program, and the monitor on the policy CPU. Do not answer
the monitor startup questions at this time. (See Section
5.9.1.)
5. Start each nonpolicy CPU. (See Section 5.9.1.)
5-1
STARTING THE KL10 CENTRAL PROCESSOR
6. Answer the monitor startup questions at the CTY that is
attached to the policy CPU. (See Section 5.6.)
7. Load any communications front ends.
At nearly every step there are choices that you must make about how
you want the system to start. For example, there are at least four
ways to load RSX-20F, and two ways to load the monitor. To help you
make these choices and to help you find the sections that are of
interest to you, see Figures 5-1 through 5-3.
START
|
v
See Sections
5.1 through 5.3
|
v YES See Sections
Do you have an SMP system?-------> 5.9.1 and 5.9.2
| NO
v
See Figures
5-2 and 5-3
|
v
End
Figure 5-1: Reading Path for Chapter 5
5.1 SWITCHES AND LIGHTS
Before you start your system, become familiar with the switches and
lights on the cabinets.
On all systems except the 1091, six rocker switches are located in the
middle of the front panel. Just to the right of them are the two
indicator lights.
On the 1091, six rocker switches are located on the top left corner of
the front panel. To the right of the rocker switches are the two
power switches. Just above the rocker switches are the two indicator
lights.
5-2
STARTING THE KL10 CENTRAL PROCESSOR
START
|
v
+---------------------+
| Do you want to load | YES
| from magtape? |--------------+
+---------------------+ |
|NO |
| |
v v
+---------------------+ +-------------------+
| Do you want to load | YES | [1] Load with |
| with non-defaults? |----->| switch register |
+---------------------+ +-------------------+
|NO |
| |
| v
| +--------------+ +---------------+
+------------------>| Is bootstrap | YES | [3] Load |
| on disk? |---->| from disk |
+--------------+ +---------------+
|NO |
| v
| END
v
+--------------+ +---------------+
| Do you have | YES | [4] Load |
| a 1091? |---->| from floppies |
+--------------+ +---------------+
|NO |
| v
| END
v
+--------------+
| [2] Load |
| from DECtape |
+--------------+
|
v
END
When you are tracing through this flowchart, if you pass through:
[1] and [2], load from DECtape using the switch
register. (See Section 5.5.1)
[1] and [3], load from disk using the switch
register. (See Section 5.5.1)
[1] and [4], load from floppies using the switch
register. (See Section 5.5.1)
5-3
STARTING THE KL10 CENTRAL PROCESSOR
[2], load from DECtape. (See Section 5.4.4)
[3], load from disk. (See Section 5.4.1)
[4], load from floppies. (See Section 5.4.3)
Figure 5-2: RSX-20F Loading Choices
START
|
|
v
Did you load Do you want
RSX-20F with YES to load from YES
the SW/REG?------------->magnetic tape?--------->See Section 5.5.2
| | |
|NO |NO |
----------------------------->|<----------------------------
|
v
Do you want to load Press RETURN
the default monitor to answer the
from the file YES bootstrap program
SYSTEM.EXE? ----------->prompt.
|NO |
| |
v v
See Section 5.5.3 END
|
|
END
Figure 5-3: Monitor Loading Choices
All systems have four load switches grouped together on the left front
panel. They are, from left to right, SW/REG, DISK, DECTAPE or FLOPPY,
and ENABLE/DISABLE. When you press the top half of a load switch, it
is ON. Table 5-1 lists the load switches and their functions.
5-4
STARTING THE KL10 CENTRAL PROCESSOR
Table 5-1: Load Switches
______________________________________________________________________
Switch Function
______________________________________________________________________
SW/REG Loads the front end according to the contents of the
switch register.
DISK Loads the front end from a disk pack.
DECTAPE (All systems except 1091) Loads the front end from
DECtapes mounted on the PDP-11 DECtape drives.
FLOPPY (1091 only) Loads the front end from floppy disks.
ENABLE/ Enables loading from any load switch.
DISABLE
______________________________________________________________________
There are two power switches. The black switch, which is labeled
POWER ON and POWER OFF, normally supplies or cuts power to the system.
The red switch, which is labeled EMERGENCY POWER OFF, cuts the power
in an emergency such as fire.
NOTE
Only your Field Service representative can restore
power after you press the red switch.
There are two indicator lights labeled FAULT and POWER. Table 5-2
explains these lights.
5-5
STARTING THE KL10 CENTRAL PROCESSOR
Table 5-2: Indicator Lights
______________________________________________________________________
Light Condition Explanation
______________________________________________________________________
FAULT ON The system is malfunctioning. This can
(during indicate one of the following faults:
system o A circuit breaker was tripped.
loading) o A cabinet door is open.
o The system is overheating.
o There is an air flow problem.
If the POWER light is not blinking, one
of the above faults will cause a power
failure.
If you cannot correct the fault, call
your Field Service representative.
ON The central processor has stopped. Try
(during to reload. If the reload fails, call
timesharing) your Field Service representative.
OFF The central processor is operating
normally.
POWER ON The central processor is powered up.
OFF The central processor is powered down.
BLINKING A Field Service representative at your
installation may have set OVERRIDE. Do
not run the system with OVERRIDE set.
OVERRIDE prevents the processor from
powering down if it overheats. Call
your Field Service Representative.
If the FAULT light is on and the POWER
light is blinking, then the system may
continue to run.
______________________________________________________________________
The switch register contains 18 switches that represent bit settings.
These switches, numbered 17 through 0 from left to right, set certain
values when you load from the switch register. To set a switch, lift
it up. See Section 5.5.1 for more information on the switch register.
5-6
STARTING THE KL10 CENTRAL PROCESSOR
5.2 POWERING UP THE SYSTEM
Before you power up the system, turn on the console terminal (CTY).
Make sure that it is on line and has paper. If you have an SMP
system, there is a CTY for each CPU. Turn on each CTY, making sure
that it is online and has paper.
Make sure that the peripheral devices, as follows, are powered up.
o Line printers
o Magnetic-tape drives
o Disk drives
If they are not, see the appropriate chapters in the TOPS-10/TOPS-20
Operator's Hardware Device and Maintenance Guide for instructions.
To power up the system, press the black power switch to the POWER ON
position.
NOTE
If the FAULT light is on, the system will not power up
unless OVERRIDE is set. (See Table 5-2.)
5.3 FAMILIARIZING YOURSELF WITH RSX-20F
The PDP-11 front end has its own front-end file system and front-end
monitor. The front-end monitor is RSX-20F. To avoid confusion with
the TOPS-10 monitor, this manual refers to the RSX-20F monitor as
"RSX-20F" and the TOPS-10 monitor as "the monitor." (See the
TOPS-10/TOPS-20 RSX-20F System Reference Manual for complete
information on RSX-20F.)
The RSX-20F command language processor, the PARSER, allows you to
communicate with front-end programs such as KLINIT. KLINIT is the
program that initializes the KL10 central processor. The RSX-20F
software must reside on a disk drive that is connected to both the
PDP-11 and KL10. The front-end file structure cannot reside on an
RP07 or an RP20.
Section 5.3.1 is a brief discussion of the PARSER and how to use it.
Section 5.3.2 is a brief discussion of KLINIT and its operator dialog.
5.3.1 Using the PARSER
The PARSER allows you to communicate with RSX-20F.
5-7
STARTING THE KL10 CENTRAL PROCESSOR
To enter the PARSER, type CTRL/backslash (^\). (CTRL/backslash does
not echo on the CTY.) The PARSER then prints one of the following
prompts and waits for you to type a command:
PAR> The KL10 is running (that is, the KL10 clock is running
and the KL10 run flip-flop is on).
PAR% The KL10 microcode is in a halt loop (that is, the KL10
clock is running, but the KL10 run flip-flop is off).
PAR# The KL10 clock is stopped and the KL10 is not running (the
KL10 run flip-flop is off).
NOTE
If the PARSER displays the PAR# prompt during
timesharing, you must reload the system or restart the
central processor.
To exit from the PARSER, type QUIT.
For more information on the PARSER, see the TOPS-10/TOPS-20 RSX-20F
System Reference Manual.
5.3.2 Using KLINIT
KLINIT is the KL10 initialization program. By default KLINIT performs
the following steps:
o Selects the MCA25 page table. (MCA25 systems only.)
o Loads the KL10 microcode.
o Configures cache memory as specified in the configuration
file, KL.CFG.
o Enables all caches.
o Configures KL10 memory as specified in KL.CFG.
o Configures all internal core memory.
o Configures all of the external memory modules.
o Configures up to 4-way memory interleaving.
o Sets the external-memory bus mode for optimal performance.
o Configures all MOS memory (1091 systems only).
5-8
STARTING THE KL10 CENTRAL PROCESSOR
o Configures all memory blocks for controller n, where n is the
current controller number.
o Loads the bootstrap specified in the KL.CFG file. If there
is no KL.CFG file, KLINIT uses the default bootstrap, which
loads the monitor from the default file, DSK:SYSTEM.EXE[1,4].
o Writes a new KL.CFG file that contains the current
configuration and load parameters.
o Exits from KLINIT.
The configuration of your system may cause KLINIT to skip certain
steps. KLINIT performs only the steps that are appropriate for your
system. If you have SW/REG set to OFF, KLINIT performs default
actions. If you want to change any default parameters or actions, set
SW/REG to ON.
The KLINIT operator dialog is a series of questions preceded by
"KLI --". To enter the KLINIT operator dialog after you have loaded
RSX-20F, do the following:
1. Set at least Switches 0, 1, and 2 in the switch register.
(See Section 5.5.1 for more information on switch-register
settings.)
2. Press the SW/REG and ENABLE load switches simultaneously.
3. Type YES and press RETURN when KLINIT prints the following
question on the CTY:
KLI -- ENTER DIALOG [NO, YES, EXIT, BOOT]? YES<RET>
To enter the KLINIT operator dialog when RSX-20F is already running,
type everything that is underscored in the following dialog:
^\ Type CTRL/backslash, (not
echoed) to communicate
with the PARSER.
PAR>MCR KLINIT<RET> Type MCR KLINIT and press
RETURN to load KLINIT.
KLI -- ENTER DIALOG [NO, YES,EXIT,BOOT]?YES<RET>
Type YES and press RETURN
to enter the KLINIT
operator dialog.
See Appendix D for detailed information on answering the KLINIT dialog
questions.
5-9
STARTING THE KL10 CENTRAL PROCESSOR
5.4 LOADING THE SYSTEM USING DEFAULT PARAMETERS
Before you begin to load the system, make sure that:
o All hardware and software is properly installed.
o The disk packs are mounted properly.
If you are installing the system for the first time, or installing a
new version of the software, see the TOPS-10 Software Installation
Guide.
The default parameters for loading the system are:
1. Unit 0 is the default disk or magnetic-tape drive.
2. DSK:SYSTEM.EXE[1,4] is the default monitor file.
3. KLINIT performs the default operations described in Section
5.3.2.
If you want to use nondefault parameters to load the system, see
Section 5.5.
You can load RSX-20F from one of the following:
1. Disk pack (all systems). (See Section 5.4.1.)
2. Floppy disks (1091 systems only). (See Section 5.4.3.)
3. DECtapes (all systems except 1091). (See Section 5.4.4.)
To load the monitor from magnetic tape, see Section 5.5.2.
5.4.1 Loading RSX-20F from Disk
Before you load RSX-20F from disk using the default parameters, make
sure that:
o The POWER light is on. If it is not, perform the steps
listed in Section 5.2.
o The hardware and software are properly installed. If they
are not, see the TOPS-10/TOPS-20 Operator's Hardware Device
and Maintenance Guide for instructions.
o The disk pack that contains RSX-20F is mounted on a
dual-ported disk drive. If it is not, see the
TOPS-10/TOPS-20 Operator's Hardware Device and Maintenance
Guide for instructions.
5-10
STARTING THE KL10 CENTRAL PROCESSOR
o The disk pack is mounted on disk-drive unit 0. If it is not,
see Section 5.5.1.
To load RSX-20F from disk, do the following:
1. Press the ENABLE half of the ENABLE/DISABLE Load switch and
the DISK Load switch at the same time. This causes RSX-20F
to load from the disk on drive 0, and causes KLINIT to load.
2. Type everything that is underscored in the following sample
dialog:
RSX-20F VE##-## hh:mm dd-mmm-yy RSX-20F version and
creation time and date.
[SY0: REDIRECTED TO DB0:] DB0: is the system device
[DB0: MOUNTED] for the RSX-20F tasks.
KLI -- VERSION VA##-##RUNNING KLINIT prints this and
KLI -- KL10 S/N: 1026., MODEL B, 60 HERTZ the following lines.
KLI -- KL10 HARDWARE ENVIRONMENT:
MCA25 CACHE PAGER
EXTENDED ADDRESSING
INTERNAL CHANNELS
CACHE
KLI--SELECT PAGE TABLE [FILE,BOTH,O,1]
KLI>BOTH<RET>
KLI--PAGE TABLE SELECTED:BOTH
KLI -- MICROCODE VERSION #.#[###] LOADED
KLI -- ALL CACHES ENABLED
LOGICAL MEMORY CONFIGURATION.
ADDRESS SIZE INT TYPE CONTROLLER
00000000 1024K 4 DMA20 4
KLI -- CONFIGURATION FILE WRITTEN
KLI -- BOOTSTRAP LOADED AND STARTED KLINIT has loaded and
started BOOT.
BOOT V#(#) BOOT version number.
BOOT><RET> Press RETURN to load the
default monitor from the
file DSKB:SYSTEM.EXE[1,4].
When the monitor has been loaded into memory, the monitor startup
questions begin. (See Section 5.6.) If the system does not print the
first monitor startup question, BOOT prints an error message. (See
5-11
STARTING THE KL10 CENTRAL PROCESSOR
Appendix A for more information about BOOT messages.)
If KLI -- followed by a message prints on the CTY before the BOOT
version number, see Chapter 11.
5.4.2 Reloading the Monitor from Disk
To reload the monitor from disk when the monitor is already running,
first halt timesharing, and then reload the monitor. To do this,
perform the following steps:
1. Make sure the POWER light is on. If the light is not on, see
Section 5.4.1.
2. Type everything that is underscored in the following sample
dialog:
.ENTER OPR<RET>
OPR>SET KSYS NOW<RET>
OPR>EXIT<RET>
^\ Type CTRL/backslash (not
echoed) to communicate with
the PARSER.
PAR>SHUT<RET> Type SHUT and press RETURN
to shut down the system.
DECSYSTEM-10 NOT RUNNING The monitor has stopped.
BOOT>DSKB:<RET> Type DSKB: and press
RETURN to load the default
monitor from the file
DSKB:SYSTEM.EXE[1,4].
[Loading from DSKB:SYSTEM.EXE[1,4]] BOOT is now reloading the
monitor.
When the monitor has been loaded into memory, the monitor
startup questions begin.
3. Answer the monitor startup questions described in Section
5.6.
5.4.3 Loading RSX-20F from Floppy Disks
Before you load RSX-20F from floppy disks using the default
parameters, make sure that:
5-12
STARTING THE KL10 CENTRAL PROCESSOR
o The POWER light is on. If it is not, see Section 5.2.
o All of the software is on floppies. If it is not, see
Section 5.4.1.
o Floppy A, which contains BOOT, is mounted on Unit 0, the left
unit. If it is not, mount Floppy A on Unit 0.
o Floppy B is mounted on Unit 1, the right unit. If it is not,
mount Floppy B on Unit 1.
To load RSX-20F from floppy disks using the default parameters, do the
following:
1. Press the ENABLE half of the ENABLE/DISABLE load switch and
the FLOPPY load switch at the same time.
This causes RSX-20F to load from floppies and causes KLINIT
to load.
2. Type everything that is underscored in the following sample
dialog:
RSX-20F VE##-## hh:mm dd-mmm-yy RSX-20F version and
creation time and date.
[SY0: REDIRECTED TO DX0:] DX0 is the system device
[DX0: MOUNTED] for the RSX-20F tasks.
KLI -- VERSION VA##-## RUNNING KLINIT prints this and
KLI --KL10 S/N: 2136., MODEL B, 60 HERTZ the following lines.
KLI -- KL10 HARDWARE ENVIRONMENT:
MCA25 CACHE PAGER Appears only if your system
has MCA25 hardware.
MOS MASTER OSCILLATOR
EXTENDED ADDRESSING
INTERNAL CHANNELS
CACHE
KLI -- SELECT PAGE TABLE [FILE, BOTH, 0, 1]
KLI>BOTH<RET>
KLI -- PAGE TABLE SELECTED:BOTH
KLI -- MICROCODE VERSION #.# [###] LOADED
KLI -- ALL CACHES ENABLED
KLI -- % MOS MEMORY IS ALREADY CONFIGURED
LOGICAL MEMORY CONFIGURATION.
ADDRESS SIZE INT TYPE CONTROLLER
00000000 128K 4 MA20 0 & 1
00400000 768K 4 MF20 11
5-13
STARTING THE KL10 CENTRAL PROCESSOR
KLI -- CONFIGURATION FILE WRITTEN
KLI -- BOOTSTRAP LOADED AND STARTED KLINIT has loaded and
started BOOT.
BOOT V#(##) BOOT version number.
BOOT><RET> Press RETURN to load the
default monitor from the
file DSKB:SYSTEM.EXE[1,4].
When the monitor has been loaded into memory, the monitor
startup questions begin. If the system does not print the
first monitor startup question, there is a problem with BOOT.
See Appendix A for an explanation of the BOOT messages.
3. To start timesharing, answer the monitor startup questions
described in Section 5.6.
If KLI messages are printed on your CTY before the BOOT version
number, see Chapter 11. KLINIT only prints messages that are
applicable to your system's configuration.
5.4.4 Loading RSX-20F from DECtape
Before you load RSX-20F from DECtape using the default parameters,
make sure that:
o The POWER light is on. If it is not, see Section 5.2.
o All of the software is on DECtape. If it is not, see Section
5.4.1.
o The DECtape is mounted properly on unit 0. If it is not, see
Section 5.5.1.
To load RSX-20F from DECtape using the default parameters, perform the
following steps:
1. Press the ENABLE half of the ENABLE/DISABLE load switch and
the DECTAPE load switch at the same time.
This causes RSX-20F to load from the DECtape on unit 0 and
causes KLINIT to load.
2. Type everything that is underscored in the following sample
dialog:
RSX-20F VA##-## hh:mm dd-mmm-yy RSX-20F version and
creation time and date.
[SY0: REDIRECTED TO DT0:] DT0 is the system device
5-14
STARTING THE KL10 CENTRAL PROCESSOR
[DT0: MOUNTED for the RSX-20F tasks.
KLI -- VERSION VA##-## RUNNING KLINIT prints this and
KLI -- KL10 S/N: 1026., MODEL B, 60 HERTZ the next 14 lines.
KLI -- KL10 HARDWARE ENVIRONMENT:
MCA25 CACHE PAGER
EXTENDED ADDRESSING
INTERNAL CHANNELS
CACHE
KLI -- SELECT PAGE TABLE [FILE,BOTH,0,1]
KLI>BOTH<RET>
KLI -- PAGE TABLE SELECTED:BOTH
KLI -- MICROCODE VERSION #.#[###] LOADED
KLI -- % NO FILE - ALL CACHE BEING CONFIGURED
KLI -- ALL CACHES ENABLED
KLI -- % NO FILE - ALL MEMORY BEING CONFIGURED
LOGICAL MEMORY CONFIGURATION.
ADDRESS SIZE INT TYPE CONTROLLER
00000000 1024K 4 DMA20 4
KLI -- CONFIGURATION FILE WRITTEN
KLI -- BOOTSTRAP LOADED AND STARTED KLINIT has loaded and
started BOOT.
BOOT V#(##) BOOT version number.
BOOT><RET> Press RETURN to load the
default monitor from the
file DSKB:SYSTEM.EXE[1,4].
When the monitor has been loaded into memory, the monitor
startup questions begin. If the system does not print the
first monitor startup question, BOOT prints an error message.
(For explanations of BOOT messages, see Appendix A.)
3. Answer the monitor startup questions described in Section
5.6.
If a KLI message is printed on your CTY before the BOOT version
number, see Chapter 11.
5.5 LOADING THE SYSTEM USING NONDEFAULT PARAMETERS
Before you begin to load the system using nondefault parameters, make
sure that:
5-15
STARTING THE KL10 CENTRAL PROCESSOR
o The hardware and software are properly installed.
o The disk packs are mounted properly.
If you are installing the system for the first time, or installing a
new version of the software, see the TOPS-10 Software Installation
Guide.
The default parameters for loading the system are:
o Unit 0 is the default disk or magnetic-tape drive.
o DSK:SYSTEM.EXE[1,4] is the default monitor file.
o KLINIT performs its default operations. (See Section 5.3.2.)
You must enter the KLINIT dialog if you want to change a default
parameter or action. The KLINIT operator dialog allows you to:
o Configure cache or memory.
o Load a bootstrap program that does not reside in the BOOT.EXB
file.
o Load from a disk pack, floppy, or DECtape that is not mounted
on unit 0.
The file specification of the default monitor is DSKB:SYSTEM.EXE[1,4].
To load a default monitor other than DSKB:SYSTEM.EXE[1,4], you do not
have to enter the KLINIT operator dialog. Instead, see Section 5.5.3
to load the monitor.
After you answer the monitor startup question, INITIA may print a few
lines on the CTY. INITIA is a system program that automatically:
o Starts those jobs that you always want to run at system
startup.
o Initializes terminal characteristics.
Whether or not your system runs INITIA at system startup is determined
when the monitor is generated. See the TOPS-10 Software Installation
Guide for more information on INITIA.
5.5.1 Loading RSX-20F Using the Switch Register
To load RSX-20F from disk, floppy, or DECtape using the switch
register, perform the following steps:
5-16
STARTING THE KL10 CENTRAL PROCESSOR
1. Set (lift up) Switch 0 to enable the other switches in the
switch register.
2. Set any other switches in the switch register that you want.
See Table 5-3 for an explanation of each switch setting.
3. Press the ENABLE half of the ENABLE/DISABLE load switch and
the SW/REG load switches at the same time.
This causes RSX-20F to access the disk drive (Switch 7 on) or
the DECtape drive or floppy disk (Switch 7 off) with the unit
number specified in Switches 8 through 10. KLINIT is loaded
and enters the KLINIT operator dialog. At this point, if you
want to load the monitor from a magnetic tape, see Section
5.5.2.
4. Answer the monitor startup questions described in Section
5.6.
Table 5-3: Switch-Register Switch Definitions
______________________________________________________________________
Switch* Setting Explanation
______________________________________________________________________
0 ON Enables the other switches in the switch
register. Set this bit.
1 and 2 OFF Loads RSX-20F as if it were being loaded as
described in Section 5.4, except that you
can specify the unit number of the bootstrap
device in Switches 8 through 10.
1 and 2 ON Loads RSX-20F, and loads and starts KLINIT.
Usually, you should set these switches.
1 or 2 ON Loads RSX-20F, but does not communicate with
the central processors.
3 to 6 OFF Not used. Do not set these switches.
7 OFF Designates the floppy disk (for 1091) or
DECtape (for all systems except 1091) as the
bootstrap device. The front-end files on
these floppy disks are used for system
loading.
7 ON Designates a disk pack mounted on a
5-17
STARTING THE KL10 CENTRAL PROCESSOR
dual-ported disk drive as the bootstrap
device.
8 to 10 ON Specifies in binary the unit number of the
bootstrap device (0 to 7). For example, no
switches set indicate unit 0, Switch 8 set
indicates unit 1, Switch 9 set indicates
unit 2, Switches 8 and 9 set indicate unit
3, Switch 10 set indicates unit 4, Switches
8 and 10 set indicate unit 5, and Switches 9
and 10 set indicate unit 6.
11 to 14 OFF Not used. Do not set.
15 OFF Retries an operation 10 times when an I/O
error occurs during bootstrapping. Usually,
you should set this switch on.
15 ON Retries an operation indefinitely when an
I/O error occurs during bootstrapping.
Usually, you should set this switch on.
16 to 17 OFF Not used. Do not set these switches.
______________________________________________________________________
*Switches are numbered 17 to 0 from left to right.
----- Examples -----
Example 1 shows what prints on your CTY when you load from disk pack
with Switches 0, 7, 8, and 9 set ON. Example 2 shows what prints on
your CTY when you load from disk pack with Switches 0, 1, 2, and 7 set
ON. See Table 5-3 for an explanation of each switch setting.
1. Loading from Disk Pack with Switches 0, 7, 8 and 9 set ON. If
you set Switches 0, 7, 8, and 9, the following dialog prints on
the CTY. Everything that you must type is underscored. (This is
only an example.)
RSX-20F VE##-## hh:mm dd-mmm-yy RSX-20F version and
creation time and date.
[SY0: REDIRECTED TO DB3:] DB3 is the system device
[DB3: MOUNTED] for the RSX-20F tasks.
KLI -- VERSION VE##-## RUNNING KLINIT prints this and
KLI -- KL10 S/N: 2136., MODEL B, 60 HERTZ the following lines.
KLI -- KL10 HARDWARE ENVIRONMENT: (MCA25 systems only)
MCA25 CACHE PAGER
5-18
STARTING THE KL10 CENTRAL PROCESSOR
MOS MASTER OSCILLATOR (Prints on 1091 only)
EXTENDED ADDRESSING
INTERNAL CHANNELS
CACHE
KLI -- SELECT PAGE TABLE [FILE, BOTH, 0, 1]
KLI>BOTH<RET>
KLI -- PAGE TABLE SELECTED:BOTH
KLI -- MICROCODE VERSION #.#[###] LOADED
KLI -- ALL CACHES ENABLED
LOGICAL MEMORY CONFIGURATION.
ADDRESS SIZE INT TYPE CONTROLLER
00000000 1024K 4 DMA20 4
KLI -- CONFIGURATION FILE WRITTEN
KLI -- BOOTSTRAP LOADED AND STARTED
BOOT V#(##) BOOT version number.
BOOT><RET> Press RETURN to load the
default monitor from the
file DSKB:SYSTEM.EXE[1,4].
Why reload: SCHED This is the first monitor
startup question. (See
Section 5.6 for more
information on answering
monitor startup questions.)
2. Loading from Disk Pack with Switches 0, 1, 2, and 7 set ON. If
you set switches 0, 1, 2, and 7, the following sample dialog
prints on the CTY. Everything that you must type is underscored.
See Appendix D for more information on answering KLINIT
questions. (This is only an example.)
RSX-20F VA##-## hh:mm dd-mmm-yy RSX-20F version and
creation time and date.
[SY0: REDIRECTED TO DB0:] DB0 is the system device
[DB0: MOUNTED] for the RSX-20F tasks.
KLI -- VERSION VA##-## RUNNING
KLI -- ENTER DIALOG [NO,YES,EXIT,BOOT]?
KLI>YES<RET>
KLI -- KL10 S/N: 1026., MODEL B, 60 HERTZ
KLI -- KL10 HARDWARE ENVIRONMENT:
MCA25 CACHE PAGER (Printed on MCA25 systems
only.)
5-19
STARTING THE KL10 CENTRAL PROCESSOR
EXTENDED ADDRESSING
INTERNAL CHANNELS
CACHE
KLI -- SELECT PAGE TABLE [FILE, BOTH, 0, 1]
KLI>BOTH<RET>
KLI -- PAGE TABLE SELECTED:BOTH
KLI -- RELOAD MICROCODE [YES,VERIFY,FIX,NO]?
KLI>YES<RET>
KLI -- MICROCODE VERSION #.#[###]LOADED
KLI -- RECONFIGURE CACHE [FILE,ALL,YES,NO]?
KLI>ALL<RET>
KLI -- ALL CACHES ENABLED
KLI -- CONFIGURE KL MEMORY [FILE,ALL,REVERSE,YES,NO]?
KLI>ALL<RET>
LOGICAL MEMORY CONFIGURATION.
ADDRESS SIZE INT TYPE CONTROLLER
00000000 1024K 4 DMA20 4
KLI -- LOAD KL BOOTSTRAP [FILE,YES,NO,FILENAME]?
KLI>YES<RET>
KLI -- WRITE CONFIGURATION FILE [YES,NO]?
KLI>YES<RET>
KLI -- CONFIGURATION FILE WRITTEN
KLI -- BOOTSTRAP LOADED AND STARTED
BOOT V#( #) BOOT version number.
BOOT><RET> Press RETURN to load the
default monitor from the
file DSKB:SYSTEM.EXE[1,4].
Why reload: SCHED This is the first monitor
startup question. (See
Section 5.6 for more
information on answering
monitor startup questions.)
5.5.2 Loading from Magnetic Tape
Before you load the monitor from a magnetic tape, make sure that:
o The magnetic tape that contains the monitor is mounted on
drive 0. If it is not, mount it on any drive, but remember
to tell BOOT which drive you mounted it on. To do this, type
the controller type and drive number in the command as shown
in Section 5.5.3.
5-20
STARTING THE KL10 CENTRAL PROCESSOR
o BOOT is on disk, floppy, or DECtape. If it is not, you
cannot load from magnetic tape.
To load the monitor from magnetic tape, do the following:
1. Perform the steps listed in Section 5.5.1.
2. Type everything that is underscored in the following sample
dialog:
KLI -- LOAD KL BOOTSTRAP [YES,NO,FILENAME]?
KLI>filename.ext<RET> Type the name of the file
that is the magnetic-tape
bootstrap program, BOOT.
KLI -- WRITE CONFIGURATION FILE [YES,NO]? Type YES or NO to answer
KLI>YES<RET> this question.
KLI -- CONFIGURATION FILE WRITTEN This line prints if you
answered YES above.
KLI -- BOOTSTRAP LOADED AND STARTED
BOOT V# ( #) BOOT version number.
BOOT><RET> Press RETURN to load the
default monitor from the
file DSKB:SYSTEM.EXE[1,4]
on tape drive 0 of a TM10
controller.
When the monitor has been loaded into memory, the monitor
startup questions begin.
Answer the monitor startup questions described in Section 5.6.
5.5.3 Loading the Monitor from a Nondefault File
To load the monitor from a file that has been saved with a file
specification other than the default, DSKB:SYSTEM.EXE[1,4], do the
following:
1. Load the system as usual. (See Sections 5.4 through 5.5.2.)
When the bootstrap program prompt (BOOT>) prints on the CTY,
perform Step 2.
2. Type the monitor name (for example, NEWMON.EXE) and press
RETURN. Everything that you type is underscored in the
following sample dialogs:
BOOT>NEWMON.EXE<RET> This is an example of
using BOOT to load the
monitor from disk pack,
5-21
STARTING THE KL10 CENTRAL PROCESSOR
floppy, or DECtape.
To specify a nondefault
file on magtape, instead
of pressing RETURN, type:
BOOT>dev:filename.ext[ppn]/controller:drivenumber
where controller is:
/TM02:n for TU45 and TU77 tape drives.
/TM03:n for TU45 and TU77 tape drives.
/TM10:n for TU10, TU40, and TU41 tape drives.
/TM78:n for TU78/79 tape drives.
/TX01:n for TU70, TU71, and TU72 tape drives on DX10.
/TX02:n for TU72 tape drives.
/DX20:n for TU7x tape drive n on DX20.
When the monitor has been loaded into memory, the monitor
startup questions begin.
Answer the monitor startup questions described in Section 5.6.
5.6 ANSWERING MONITOR STARTUP QUESTIONS
After you load RSX-20F, the bootstrap program, and the monitor, start
timesharing by answering the questions in the monitor startup dialog.
See the TOPS-10 Software Installation Guide for a detailed discussion
of each of the questions in this section.
The following is a sample dialog. Everything that you must supply is
underscored.
TOPS-10 704 Development dd-mm-yy System name and monitor
creation date.
Why reload: SCHED<RET> Type reason for reload.
You may type one of the following words and press RETURN to
tell the monitor why you want to reload the system. (For
example, PM means Preventive Maintenance, CM means Corrective
Maintenance, and SA means Stand Alone.) You may want to
follow your answer to the Why reload: question with a
comment. To do this, before you press RETURN, type a
semi-colon (;) followed by a comment and then press RETURN.
Your answer and any comment is stored in the system error
file and reported by SPEAR.
CM NEW PM
HALT NXM POWER
HARDWARE OPR SA
5-22
STARTING THE KL10 CENTRAL PROCESSOR
HUNG OTHER SCHED
LOOP PARITY STATIC
If you do not reply to this question within 60 seconds, the
system assumes OTHER, and prompts you for a comment. If you
type /H in reply to this question, the system prints a list
of valid responses.
Date: OCT 19<RET> Type the date.
The date must be the current day and month. You may
abbreviate the month as long as it is still unique. You may
specify the year, however, it is optional. If you omit the
year, the system assumes the year in which the monitor was
created.
If you type a date or time that is before the last crash or
the monitor creation date, the system prints either:
%Specified date is prior to last crash.
Last crash date: Apr-14-88 09:12:45
Specified date: Mar-6-88
Is this correct? (Y or N)N<RET>
Please type today's date as MON-DD(-YY)
May 6<RET>
or
%Specified date is prior to monitor creation date.
Creation date: Jan-11-88 09:14:00
Is this correct? (Y or N)N<RET>
Please type today's date as MON-DD(-YY)
May 6<RET>
Time: 1728<RET> Type time using 24-hour
clock.
The time must be based on a 24-hour clock. For example, 1:30
p.m. is 13:30. Use of seconds field and colons is optional.
CAUTION
If you type the date or time incorrectly, you
may cause files to be accidentally deleted
when the file system is backed up. To reset
these values, see the OPR commands SET SYSTEM
DATE and SET SYSTEM DAYTIME in the TOPS-10
Operator's Command Language Reference Manual.
Startup option: QUICK<RET> Type the startup option.
Type one of the following words and press RETURN to tell the monitor
5-23
STARTING THE KL10 CENTRAL PROCESSOR
how you want to start the system. The valid answers to the startup
option question fall into two categories:
1. Those that change disk parameters:
CHANGE
DESTROY
LONG
REFRESH
UNITID
For more information, refer to the ONCE dialog in the TOPS-10
Software Installation Guide.
2. Those that start the monitor without changing any parameters:
GO
NOINITIA
QUICK
Normally, reply QUICK.
5.7 LOADING A COMMUNICATIONS FRONT END
Each system can have more than one front end connected to its central
processors. The front end that you (the operator) use is called a
console front end. Other front ends are called communications or
network front ends. The central processors in a network are called
hosts. Every processor is called a node.
There are four types of communications front ends:
1. DN87, which is loaded with the BOOT11 program over a DL10
interface. (See Section 5.7.1.)
2. DN85, which is loaded with the BOOT11 program over a DL10
interface. (See Section 5.7.1.)
3. DN20, which is loaded with the DTELDR program over a DTE20
interface. (See Section 5.7.2.)
4. DN87S, which is loaded with the DTELDR program over a DTE20
interface. (See Section 5.7.2.)
You can automatically load (and reload) a communications front end by
including the appropriate commands in your OPR.ATO file. For example,
to automatically reload a communications front end that is interfaced
over DTE2, include the following commands in your OPR.ATO file:
5-24
STARTING THE KL10 CENTRAL PROCESSOR
:SLOG<RET> Log in a subjob.
:DEF DTE=<RET> Call it DTE.
DTE-R DTELDR<RET> Load and start DTELDR for
this subjob.
DTE-/INIT:2<RET> Start communicating with
this DN87S node.
DTE-/RELOAD:2/NODUMP<RET> Load (default) DTEL02.BIN
over DTE2 and suppress
the dump.
DTE-/AUTO<RET> Set for automatic reload.
5.7.1 Loading with BOOT11 over a DL10
To load a communications front end over a DL10, use BOOT11. This
program should be available on DSKB:[1,2] or on SYS:, the system
library.
To run BOOT11, type everything that is underscored in the following
sample dialog:
.R BOOT11<RET> Run BOOT11.
File:<RET>
Press RETURN
"PDP-11 started BOOT11 has started the
communications front end.
NOTE
You must specify the port number if more than one
PDP-11 is interfaced over a DL10 on your host.
Table 5.4 lists the BOOT11 switches. For more information on the
BOOT11 switches, see the BOOT11 specification in the TOPS-10 Software
Notebooks.
5-25
STARTING THE KL10 CENTRAL PROCESSOR
Table 5-4: BOOT11 Switches
______________________________________________________________________
Switch Explanation
______________________________________________________________________
/CLEAR:n Zeroes PDP-11 memory from location 0 to n-1. To zero
front-end memory before you load BOOT11, use /CLEAR
with the /LOAD or /START switch. If you omit :n,
this switch clears all memory.
/DUMP:n Dumps front-end memory, starting at octal location n,
into the specified host system's file. If you omit
:n, BOOT11 assumes 0.
/END:n Ends a dump at address N-1. If you omit :n, BOOT11
assumes all memory.
/HELP Types the BOOT11 help file.
/IMAGE Reads the front-end load file in an unpacked form.
When your system reads from a paper-tape reader, it
automatically sets the /IMAGE switch.
/LOAD:n Loads the front-end from the specified host processor
file and sets the starting address at octal n. (Do
not use the /START switch with /LOAD.) If you omit
:n, BOOT11 defaults to the starting address of the
file that you loaded.
/PORTNO:n Performs the specified operation on front-end Port
Number n, where n is from 0 through 7.
/START:n (Default switch.) Loads the front end from the host
processor file and starts the front end at octal
location n. If you omit :n, BOOT11 defaults to the
starting address of the file that you loaded. (If
the loaded file's starting address is an odd number,
use the /LOAD switch instead of /START.)
______________________________________________________________________
5-26
STARTING THE KL10 CENTRAL PROCESSOR
The following is an example of clearing the PDP-11 on Port Number 2,
and loading and starting a program called DN87.BIN.
.R BOOT11<RET> Run BOOT11.
File:DN87.BIN/CLEAR/START/PORTNO:2<RET>
Type the file
specification and
switches to load and
start the communications
front end.
"Clearing PDP-11 BOOT11 prints these four
"PDP-11 loading messages to report on
"PDP-11 loaded its progress.
"PDP-11 started
5.7.2 Loading with DTELDR over a DTE20
To load a communications front end over a DTE20, use DTELDR. This
program should be available on DSKB:[1,2] or on SYS:, the system
library.
To run DTELDR, type the following command. At the * prompt, type the
file specification of the .BIN file. The default file specification
is assumed if you just press RETURN. The default is DSKB:DTELxy.BIN,
where x=CPU number, and y=DTE number. DTE number 0 is reserved for
the console front end.
.R DTELDR<RET> Run DTELDR.
*dev:filename.ext[ppn]/switch<RET>
You may include one or more switches after the prompt.
Table 5-5 lists some common DTELDR switches.
5-27
STARTING THE KL10 CENTRAL PROCESSOR
Table 5-5: DTELDR Switches
______________________________________________________________________
Switch Explanation
______________________________________________________________________
/AUTO Reloads a crashed front end automatically with its
default file.
/HELP Displays the DTELDR help file.
/IMAGE The .BIN file is in image mode.
/NODUMP Suppresses the automatic dumping of PDP-11 memory
before loading a file.
/NOLOG Suppresses error logging when loading a front end.
/RELOAD:xy Reloads the specified file and starts the primary
protocol.
/PROTOCOL:prototype
Starts the front end with the specified protocol
type.
______________________________________________________________________
See the DTELDR help file and the DTELDR specification in the TOPS-10
Software Notebooks for more information on DTELDR and its switches.
For more information on loading communications front ends, see the
TOPS-10 ANF-10 Networks Software Installation Guide.
5.8 LOADING THE DX10 OR DX20 DATA CHANNEL
To operate the TU70-series magnetic tape drives, load the microcode
into the DX10 or DX20 data channel. In addition, if you have an RP20
disk system, load the microcode for the RP20 disk system into its DX20
data channel. To load the microcode, run OPR and use the CONFIG
command, LOAD, as shown below:
.R OPR
OPR>ENTER CONFIG
CONFIG>LOAD MTA
CONFIG>
14:14:59 CONFIG -- LOAD microcode --
Microcode loaded on CPU0, device 554, unit 0
5-28
STARTING THE KL10 CENTRAL PROCESSOR
CONFIG>
The bootstrap program BOOTDX, which runs under timesharing, loads
(and, in the case of DX10, dumps) programs from the TOPS-10 disk file
system into the PDP-8A (for DX10) or the DX20 microprocessor. These
programs must be in PDP-8A (for DX10) or DX20 microprocessor
image-mode file format. Normally, BOOTDX resides in the SYS: area.
To run BOOTDX, type the following command. At the prompt, press
RETURN to load the DX10 default file using the default switches,
SYS:DXMPA.BIN/START/UNIT:0. Type /DX20 to load the tape DX20 default
file, SYS:DXMCA.ADX. Type /DX20:RP20 to load the RP20 default file
SYS:DXMCD.ADX. To specify a different file, type
dev:filename.ext/switches and press RETURN.
.R BOOTDX<RET> Run BOOTDX.
File:/switch<RET>
You may include one or more switches at the prompt. Table 5-6 lists
the DX10 BOOTDX switches.
Table 5-6: DX10 BOOTDX Switches
______________________________________________________________________
Switch Explanation
______________________________________________________________________
/CLEAR:n Clears memory from 0 to n-1. (Default is 10000.)
/CPU:n Selects CPU on which DX10 exists. (Default is CPU0.)
/DUMP:n* Specifies start address of dump. (Default is 0.)
/DX10 Identifies device as DC10.
/END:n* Specifies dump address+1. (Default is 10000.)
/HELP Prints help text.
/LOAD:n** Loads DX10 and sets start address but does not start
DX10. (Default is 200 octal.)
/START:n** Loads and starts DX10 at address n. (Default is 200
octal.)
/UNIT:n Selects DC10 unit, 0 or 1 <= n. (Default is 0.)
______________________________________________________________________
5-29
STARTING THE KL10 CENTRAL PROCESSOR
* /DUMP or /END causes BOOTDX to ignore /LOAD and /START.
** /LOAD and /START are mutually exclusive.
The following is an example of loading and starting the BOOTDX
bootstrap program, clearing PDP-8A memory, loading the file DXMPA.BIN
or DXMPA.A8 from SYS:, and starting the PDP-8A at location 200 octal.
.R BOOTDX<RET>
File:SYS:/CLEAR/START<RET>
"Clearing DX-10
"DX-10 loading
"DX-10 loaded
"DC-10 started
Table 5-7 lists the DX20 BOOTDX switches.
Table 5-7: DX20 BOOTDX Switches
______________________________________________________________________
Switch Explanation
______________________________________________________________________
/CLEAR:n Clears memory from 0 to n-1. (Default is all
memory.)
/CPU:n Selects CPU on which DX20 exists. (Default is CPU0.)
/DX20:n Identifies device as DX20 with controller n. n may
be TX02 or RP20. (Default is TX02.)
/HELP Prints help text.
/LOAD:n* Loads DC20 and sets start address but does not start
DX20. (Default is 1.)
/START:n* Loads and starts DX20 at address n. (Default is 1.)
/TYPE:n Specifies that DX20 must have device type n; that is,
low-order 6 bits of Massbus register 6. (Default is
60 octal for TX02 controller, 61 octal for RP20
controller).
/UNIT:nm** Selects DX20 unit m on RH20 n. (Default is 00.) R is
assumed to be 0 if only a single number is specified.
______________________________________________________________________
5-30
STARTING THE KL10 CENTRAL PROCESSOR
* /LOAD and START are mutually exclusive.
** If /UNIT is not specified, BOOTDX searches for another DX20 on
the system that meets all other restrictions.
The following is an example of loading and starting the BOOTDX
bootstrap program, clearing the KMC-11 memory, loading the DXMCA.ADX
file from SYS:, and starting the DX20 on a TX02 controller at address
1 on CPU1.
.R BOOTDX<RET>
File:SYS:/CLEAR/DX20/CPU:1/START<RET>
DX20 selected: RH20=3 DX20=0
"Clearing DX20
"DX20 started
Micro code version 1(0)
The following is an example of manually loading and starting BOOTDX,
clearing the microprocessor memory, loading the DXMCD.ADX file from
SYS:, and starting the DX20 on an RP20 controller at address 1 on
CPU1.
.R BOOTDX<RET>
File:SYS/CLEAR/DX20:RP20/CPU:1/START<RET>
DX20 Selected: RH20=4 DX20=0
" Clearing DX20
" DX20 started
Micro code version #(#)
5.9 RUNNING SYMMETRIC MULTIPROCESSING (SMP) SYSTEMS
The remainder of this chapter applies only to Symmetric
Multiprocessing (SMP) systems. SMP is supported for KL processors
only.
A Symmetric Multiprocessing (SMP) system has multiple central
processing units (CPUs), which are numbered sequentially starting from
CPU0. An SMP system has symmetric software. This means that each CPU
can perform computation and I/O. However, an SMP system does not
necessarily have symmetric hardware. For example, one CPU may have
two tape controllers, while another CPU has only one.
Each CPU communicates with you through its own console terminal (CTY).
Therefore, if an error occurs on CPU1, the error message that tells
you about that error is printed on the CTY that is attached to CPU1.
The CPU that you load, which is also the first CPU that you start, is
5-31
STARTING THE KL10 CENTRAL PROCESSOR
called the Policy or Boot CPU. All other CPUs are called Nonpolicy or
Nonboot CPUs.
Although any CPU can be the Policy CPU, your system administrator
should tell you which one to use.
If the Policy CPU crashes, and it does not automatically restart, one
of the Nonpolicy CPUs assumes the role of the Policy CPU. This is
called role switching. (See Figure 5-6.)
Before Role Switching After Role Switching
_________________________ _________________________
| | | |
| CPU0 CPU1 | | CPU0 CPU1 |
| ______ _______ | | ______ _______ |
| | Boot | |Nonboot| | | | Boot | |Nonboot| |
| | CPU | | CPU | | | | CPU | | CPU | |
| |______| |_______| | | |______| |_______| |
|_____|___________|_______| |_____|____________|______|
| | | |
__|___ ___|___ __|___ ___|____
| Load | | | | | | Reload |
| here | | | | | | here |
|______| |_______| |______| |________|
CTY CTY CTY CTY
Figure 5-4: Role Switching
When role switching occurs, the following message prints on the CTY
that is connected to the new Policy CPU:
CPUx Has Assumed the Role of Policy CPU at <date/time>
No special procedures are required to operate the Policy CPU.
5.9.1 Loading and Starting an SMP System
To load and start an SMP system, perform the following steps:
1. Make sure that each CPU has its own RSX-20F front-end
software on DECtapes or disks that are accessible to its
front-end processor.
2. Perform the following steps on each nonpolicy CPU:
a. Set Switches 0, 1, and 2 in the switch register. This
allows you to enter the KLINIT operator dialog.
5-32
STARTING THE KL10 CENTRAL PROCESSOR
b. Set any desired additional switches in the switch
register. (See Table 5-3 for a description of each
switch in the switch register.)
c. Press the ENABLE and SW/REG load switches at the same
time.
d. Type everything that is underscored in the following
sample dialog on the CTY:
RSX-20F VA##-## hh:mm dd-mmm-yy RSX-20F version and
creation time and date.
[SY0: REDIRECTED TO DB0:] DB0 is the system device
[DB0: MOUNTED] for the RSX-20F tasks.
KLI -- VERSION VA##-## RUNNING
KLI -- ENTER DIALOG [NO,YES,EXIT,BOOT]?
KLI>YES<RET>
KLI -- KL10 S/N: 1026., MODEL B, 60 HERTZ
KLI -- KL10 HARDWARE ENVIRONMENT:
MCA25 CACHE PAGER
EXTENDED ADDRESSING
INTERNAL CHANNELS
CACHE
KLI--SELECT PAGE TABLE [FILE, BOTH, O, 1]
KLI>BOTH<RET>
KLI--PAGE TABLE SELECTED:BOTH
KLI -- RELOAD MICROCODE [YES,VERIFY,FIX,NO]?
KLI>YES<RET>
KLI -- MICROCODE VERSION #.#[###]LOADED
KLI -- RECONFIGURE CACHE [FILE,ALL,YES,NO]?
KLI>ALL<RET>
KLI -- ALL CACHES ENABLED
KLI -- CONFIGURE KL MEMORY [FILE,ALL,REVERSE,YES,NO]?
KLI>ALL<RET>
LOGICAL MEMORY CONFIGURATION.
ADDRESS SIZE INT TYPE CONTROLLER
00000000 1024K 4 DMA20 4
KLI -- LOAD KL BOOTSTRAP [FILE,YES,NO,FILENAME]?
KLI>NO<RET>
KLI -- WRITE CONFIGURATION FILE [YES,NO]?
KLI>YES<RET>
KLI -- CONFIGURATION FILE WRITTEN
KLI -- EXIT [YES,RESTART]?
KLI>YES<RET>
CTRL/\ Type CTRL/backslash to
5-33
STARTING THE KL10 CENTRAL PROCESSOR
communicate with the
PARSER.
PAR%RESET<RET> Type RESET and press
RETURN to ensure that the
processor is in a known
state. Do not type
anything else now.
Continue with Step 3.
3. Go to the Policy CPU.
4. Perform the following steps on the Policy CPU.
a. Set Switches 0, 1, and 2 in the switch register. This
allows you to enter the KLINIT operator dialog.
b. Set any desired additional switches in the switch
register. (See Table 5-3 for a description of each
switch in the switch register.)
c. Press the ENABLE and SW/REG load switches at the same
time.
5. Type everything that is underscored in the following sample
dialog on the CTY:
RSX-20F VA##-## hh:mm dd-mmm-yy RSX-20F version and
creation time and date.
[SY0: REDIRECTED TO DB0:] DB0 is the system device
[DB0: MOUNTED] for the RSX-20F tasks.
KLI -- VERSION VA##-## RUNNING
KLI -- ENTER dialog [NO,YES,EXIT,BOOT]?
KLI>YES<RET>
KLI -- KL10 S/N: 1026., MODEL B, 60 HERTZ
KLI -- KL10 HARDWARE ENVIRONMENT:
MCA25 CACHE PAGER
EXTENDED ADDRESSING
INTERNAL CHANNELS
CACHE
KLI--SELECT PAGE TABLE [FILE, BOTH, O, 1]
KLI>BOTH<RET>
KLI--PAGE TABLE SELECTED:BOTH
KLI -- RELOAD MICROCODE [YES,VERIFY,FIX,NO]?
KLI>YES<RET>
KLI -- MICROCODE VERSION #.#[###] LOADED
KLI -- RECONFIGURE CACHE [FILE,ALL,YES,NO]?
5-34
STARTING THE KL10 CENTRAL PROCESSOR
KLI>ALL<RET>
KLI -- ALL CACHES ENABLED
KLI -- CONFIGURE KL MEMORY [FILE,ALL,REVERSE,YES,NO]?
KLI>ALL<RET>
LOGICAL MEMORY CONFIGURATION.
ADDRESS SIZE INT TYPE CONTROLLER
00000000 1024K 4 DMA20 4
KLI -- LOAD KL BOOTSTRAP [FILE,YES,NO,FILENAME]?
KLI>YES<RET>
KLI -- WRITE CONFIGURATION FILE [YES,NO]?
KLI>YES<RET>
KLI -- CONFIGURATION FILE WRITTEN
KLI -- BOOTSTRAP LOADED AND STARTED
BOOT V#(##)<RET> BOOT version number.
BOOT<RET> Press RETURN to load the
default monitor from
DSKB:SYSTEM.EXE[1,4].
Why reload: Do not type anything else
now. Continue with Step
6.
6. Go to the CTY of the first Nonpolicy CPU.
7. Type J 400 and press RETURN. When the CPU number is printed
on its CTY, then that CPU has started.
8. Repeat Steps 6 and 7 for each nonpolicy CPU.
9. Go to the CTY of the Policy CPU.
10. Answer the monitor startup questions.
5.9.2 Restarting a Nonpolicy CPU (SMP Systems Only)
To restart one of the Nonpolicy CPUs on an SMP system, perform the
following steps:
1. Make sure the Policy CPU is running.
2. Go to the Nonpolicy CPU that you want to restart.
3. Make sure that the Nonpolicy CPU has its own RSX-20F
front-end software on disk or DECtapes that are accessible to
its front-end processor.
5-35
STARTING THE KL10 CENTRAL PROCESSOR
4. Press ENABLE and DISK, DECTAPE, or SW/REG, depending on how
you want to load the front end.
5. Type everything that is underscored in the following sample
dialog:
RSX-20F VA##-## hh:mm dd-mmm-yy RSX-20F version and
creation time and date.
[SY0: REDIRECTED TO DB0:] DB0 is the system device
[DB0: MOUNTED] for the RSX-20F tasks.
KLI -- VERSION VA##-## RUNNING
KLI -- ENTER DIALOG [NO,YES,EXIT,BOOT]?
KLI>YES<RET>
KLI -- KL10 S/N: 1026., MODEL B, 60 HERTZ
KLI -- KL10 HARDWARE ENVIRONMENT:
MCA25 CACHE PAGER
EXTENDED ADDRESSING
INTERNAL CHANNELS
CACHE
KLI--SELECT PAGE TABLE [FILE, BOTH, O, 1]
KLI>BOTH<RET>
KLI--PAGE TABLE SELECTED:BOTH
KLI -- RELOAD MICROCODE [YES,VERIFY,FIX,NO]?
KLI>NO<RET>
KLI -- RECONFIGURE CACHE [FILE,ALL,YES,NO]?
KLI>NO<RET>
KLI -- CONFIGURE KL MEMORY [FILE,ALL,REVERSE,YES,NO]?
KLI>NO<RET>
KLI -- LOAD KL BOOTSTRAP [FILE,YES,NO,FILENAME]?
KLI>NO<RET>
KLI -- WRITE CONFIGURATION FILE [YES,NO]?
KLI>NO<RET>
KLI -- EXIT [YES,RESTART]?
KLI>YES<RET>
CTRL/\ Type CTRL/backslash,
which is not echoed, to
communicate with the
PARSER.
PAR>RESET<RET> Type RESET and press
RETURN to ensure that the
processor is in a known
state.
PAR%J 400<RET> Type J 400 and press
RETURN to start the
Nonpolicy CPU.
5-36
STARTING THE KL10 CENTRAL PROCESSOR
[CPUn] The Nonpolicy CPU has
started.
RZ357A KL 1026/1042 14:01:19 TTY471 system 1026/1042
Connected to Node KL1026(26) Line # 471
DSKC: KL1026 System disk DSKC
DSKB: KL1026 System Disk DSKB
Please LOGIN
. The CPU is now ready for
timesharing.
NOTE
You must enter the KLINIT dialog and answer NO to all
of the questions to restart a non-Policy CPU in an SMP
system. If you attempt to circumvent this process,
RSX-20F does not set parity stops.
5-37
6-1
CHAPTER 6
THE OPERATOR INTERFACE, OPR
6.1 INTRODUCTION TO OPR
The Operator Command Language (OPR) allows you to communicate with the
programs that make up the GALAXY batch system. These programs are:
o QUASAR, the nucleus of the GALAXY and mountable device
allocation systems
o BATCON, the batch job controller
o LPTSPL, the line printer spooler
o CDRIVE, the card reader spooler
o SPROUT, the card punch, paper tape punch, and plotter spooler
o SPRINT, the card reader input driver
o PULSAR, the label processor for tapes and structures
o NEBULA, the router of output jobs to remote systems
In addition, you use OPR to communicate with programs requesting
operator action, such as the PLEASE program, and with users on the
system.
The program that receives the OPR commands and communicates with all
the other system programs is ORION. ORION also logs messages in the
operator's log file, OPERAT.LOG. The OPR program also provides the
command interface to the NCP, LCP, and CONFIG programs.
6.2 RUNNING OPR
To run OPR, you must have one of the following privileges. (See your
system manager to obtain these privileges if you do not already have
6-1
THE OPERATOR INTERFACE, OPR
them.) The REACT program is used to set the privilege level for each
user.
o SYSTEM operator privileges, which enable you to control
devices and tasks on the host system and on any remote nodes.
o HOST operator privileges, which enable you to control devices
and tasks at your local host system only.
o REMOTE operator privileges, which enable you to control
devices and tasks only at the ANF-10 remote station node
where you are located.
The tasks in this chapter and in following chapters assume that you
have more than one terminal available to perform them. If you have
more than one terminal available to you, you may want to dedicate one
terminal to running only OPR, and use another terminal for other
tasks, for example, running BACKUP.
The following sections explain how to start and exit from OPR.
6.2.1 Starting OPR
To start OPR, type the following:
.R OPR<RET>
OPR>
If your installation has more than one terminal assigned to its
operators, you can run separate OPR jobs from different terminals.
All OPR jobs work the same way. ORION, OPR's controlling program, can
handle an unlimited number of OPR jobs.
6.2.2 Exiting from OPR
To exit from OPR, press <CTRL/Z> or type EXIT. OPR returns your job
to monitor command level. The period prompt (.) indicates that you
are at monitor command level. For example:
OPR>EXIT<RET>
.
For a complete description of all OPR commands, their arguments,
keywords, and switches, see the TOPS-10 Operator's Command Language
Reference Manual.
6-2
THE OPERATOR INTERFACE, OPR
6.2.3 Issuing OPR Commands to/from ANF-10 Remote Stations
The system operator at the host system has control of all jobs and
devices at all nodes in the network system. If you are a Remote
Station Operator, you can control only the devices at your remote
station. In addition, you have complete control over all active jobs
and jobs queued for devices at your node. All your commands default
to your location or node. Some OPR commands, however, include the
/NODE switch which enables you to send commands to other nodes in the
network. The /NODE switch is available with many of the OPR commands
described in later sections of this manual. The /NODE switch allows
you to specify the logical identifier of any remote station or any
node in the network system. The format of the /NODE switch is:
/NODE:node-id
where the node-id is the number or the name of the remote station.
6.2.4 Multiple Operators on the System
You can have more than one OPR job running on the same operating
system. ORION keeps track of each OPR job and sends the appropriate
acknowledgement messages to the OPR job that sent the command.
If you have networking software at your installation, messages sent to
a node from a user (with the SEND OPR monitor command) are sent to all
OPR jobs running on the node.
You can enable or disable messages displayed at each terminal running
OPR. This allows you to assign different OPR terminals to different
devices. See Section 6.4 for information on controlling OPR message
output.
6.3 OPR COMMAND FEATURES
OPR has features that enable you to:
o List available commands
o Use ESCape recognition
o Obtain help text
o Reprint faulty commands
o Continue long command lines
The following sections describe these command features in detail.
6-3
THE OPERATOR INTERFACE, OPR
In addition, other CTRL/character commands, such as CTRL/R, CTRL/U,
and CTRL/W, function at OPR command level as they do at monitor
command level.
NOTE
These OPR command features are not applicable when OPR
is a subjob of OPSER.
6.3.1 Listing Available Commands
To list all available OPR commands, type a question mark (?) to the
OPR> prompt. You can type ? whenever you need help with an OPR
command. For example:
o When you type ? while entering a command, OPR lists command
keywords, arguments, or switches for the OPR command and then
redisplays your OPR command up to the point where you typed
the ?.
o When you type ? after the OPR> prompt, OPR lists the
available commands.
o When you type ? after an OPR command, OPR lists the keywords
to that command.
o When you type ? after the keyword, OPR lists the values,
arguments, and/or switches to that keyword.
o When you type ? after an entire OPR command, OPR displays
the message "Confirm with carriage return", redisplays your
entire command, and waits for you to press the RETURN key.
----- Example -----
After you have started OPR and the system displays the OPR> prompt,
type ?.
.R OPR <RET>
OPR>? one of the following:
ABORT ALIGN BACKSPACE CANCEL CLOSE
CONTINUE DEFINE DISABLE DISMOUNT ENABLE
ENTER EXIT FORWARDSPACE HELP HOLD
IDENTIFY LOCK MODIFY MOUNT NEXT
PUSH RECOGNIZE RELEASE REPORT REQUEUE
RESPOND RESTRICT ROUTE SEND SET
SHOW SHUTDOWN START STOP SUPPRESS
TAKE UNLOCK UNRESTRICT WAIT
6-4
THE OPERATOR INTERFACE, OPR
or one of the following
CATALOG CONFIG LCP NCP QUOTA
OPR>
NOTES
The DEFINE command is valid only if your installation
has IBM communications software. The TOPS-10 IBM
Emulation/Termination Manual describes the DEFINE
command.
The NCP command applies only if your installation uses
DECnet software. See the TOPS-10 DECnet-10 System
Manager's and Operator's Guide for more information
about NCP.
The LCP command applies only if your installation uses
LAT software. See the Local Area Transport Network
Manager's Guide for more information about LCP.
6.3.2 Using ESCape Recognition
ESCape recognition helps you to enter commands by:
o Enabling you to type shortened versions of commands
o Providing guide words that prompt you for more information
You can press the ESCape key as soon as you have typed enough
characters to uniquely identify a command to OPR. The number of
characters necessary for OPR to accept the command varies and requires
some experimentation on your part.
NOTE
The terminal bell rings when you press the ESCape key
if you have not typed enough characters to uniquely
identify a command. If this happens, type another
character and press the ESCape key. Continue to do
this until the characters you have typed identify a
specific command.
The following example illustrates the ESCape recognition feature:
----- Example -----
6-5
THE OPERATOR INTERFACE, OPR
1. Type the ABORT command.
2. Press the ESCape key to display the ABORT guide words.
OPR>ABORT<ESC>(current job on) BATCH-STREAM<ESC>(stream number)
0<RET>
10:37:21 Batch-Stream 0 -- Abort request queued --
OPR>
10:37:42 Batch-Stream 0 -- End --
Job TBUILD Req 145 for HURLEY [33,2623]
OPR>
6.3.3 Reprinting Faulty Commands
When you issue a correct command to OPR, OPR passes the command to
ORION. If the command is incorrect, OPR displays 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.
To use the <CTRL/H> feature do the following:
1. Press <CTRL/H> to redisplay the command up to the point where
the error occured.
2. Enter the correct information.
----- Example -----
OPR>FORWARDSPACE PRINTER 0 /PAGES:3) <RET>
? First nonspace character is not a digit
OPR> <CTRL/H> FORWARDSPACE PRINTER 0 /PAGES:30 <RET>
OPR>
13:25:04 Printer 0 -- Forwardspaced 30 Pages --
OPR>
6.3.4 Getting Help
The OPR HELP command provides information about specific commands.
When you type HELP, followed by an OPR command name, OPR displays the
command's function and its format, keywords, arguments, and switches.
6-6
THE OPERATOR INTERFACE, OPR
The following example illustrates the HELP feature:
----- Example -----
If you specify HELP RELEASE, OPR displays the function, format,
keywords, and arguments of the RELEASE command.
OPR>HELP RELEASE <RET>
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>
6.3.5 Line Continuation
Commands to OPR are often long and cumbersome, especially if you use
ESCape recognition. The OPR program enables you to continue a command
on the next line. To continue a command line, type a hyphen (-)
before you press <RET>. This prevents OPR from processing the line
until it reaches a <RET> that is not preceded by a hyphen.
For example, the following command line uses line continuation:
OPR>SET TAPE-DRIVE MTA3: INITIALIZE /LABEL-TYPE:ANSI- <RET>
/OWNER:[31,5723]/TAPE-DISPOSITION:HOLD/VOLUME-ID:TAPE01 <RET>
OPR>
6-7
THE OPERATOR INTERFACE, OPR
6.4 CONTROLLING ORION TO OPR MESSAGES
OPR displays two types of messages: messages from OPR and messages
from ORION. The following types of ORION messages are displayed on
your terminal:
o Error messages showing that ORION does not have the
appropriate devices, streams, nodes, or jobs to process a
command
o Messages from jobs that start processing in a stream or on a
device
o Messages from jobs that end processing in a stream or on a
device
o Messages specifying actions you must take for various
devices, streams, or jobs
o Results of TAKE command files
The first eight characters of the message is the time stamp. ORION
time-stamps each OPR command it accepts and executes, as well as all
error messages.
In the following example, ORION displays the time (in hours, minutes,
and seconds) that it accepted and executed the SET PRINTER command.
OPR>SET PRINTER 0 FORMS-TYPE NARROW <RET>
12:00:00 Printer 0 -- Set Accepted --
ORION displays error messages in the same format. In the following
example, ORION acknowledges the SHOW MESSAGES command by displaying
the information message shown below:
OPR>SHOW MESSAGES <RET>
12:00:00 -- No Outstanding Messages --
When a particular job starts to process in a batch stream or on a
device, ORION displays a message to notify you that the stream or
device is active. For example, ORION displays the following message
when a job named TEST begins to process in batch stream 0 for user
ZINA:
hh:mm:ss Batch-stream 0 -- Begin --
Job TEST Req #274 for ZINA [27,1234]
OPR>
Likewise, when a particular job ends processing, ORION displays a
6-8
THE OPERATOR INTERFACE, OPR
message to notify you that the stream or device is not active and the
job has completed. For example, ORION displays the following message
when the job named TEST ends the process in batch stream 0 for user
ZINA.
hh:mm:ss Batch-stream 0 -- End --
Job TEST Req #274 for ZINA [27,1234]
OPR>
You may want to control the types of messages displayed at your
terminal. For example, if you have multiple terminals running OPR,
you can set the OUTPUT-DISPLAY to suit the needs of each OPR job. To
control OPR message output, enter the ENABLE or DISABLE command
followed by the keyword, OUTPUT-DISPLAY, and one or more of the
following arguments:
ALL-MESSAGES displays all operator, system, user, and error
messages on your OPR terminal. ALL-MESSAGES
is the default.
BATCH-MESSAGES displays messages generated during batch job
processing.
CARD-PUNCH-MESSAGES
displays messages generated by card-punch
jobs.
CARD-READER-INTERPRETER-MESSAGES
displays messages generated by card reader
jobs or batch jobs submitted with the /READER
switch.
CATALOG-MESSAGES displays messages generated by changes to the
system catalog.
CONFIG-MESSAGES displays messages generated by changes to the
system configuration.
EVENT-MESSAGES displays messages generated by special events
such as billing file closure, ORION log file
closure, scheduled system shutdown, or Usage
accounting file closure. See the SHOW QUEUES
EVENTS command for more information on these
event types.
FAL-MESSAGES displays messages generated during network
file access requests.
LCP-MESSAGES displays messages generated by the LAT Control
6-9
THE OPERATOR INTERFACE, OPR
Program.
MOUNT-MESSAGES displays messages generated when users request
tape and structure mounts and dismounts.
NCP-MESSAGES displays messages generated by the DECnet
Network Control Program.
NQC-MESSAGES displays messages generated by the Network
Queue Controller.
PAPER-TAPE-PUNCH-MESSAGES
displays messages generated by
paper-tape-punch jobs.
PLOTTER-MESSAGES displays messages generated by plotter jobs.
PRINTER-MESSAGES displays messages generated by line printer
jobs.
QUOTA-MESSAGES displays messages generated by changes to the
system catalogs.
READER-MESSAGES displays messages generated by card reader
jobs.
USER-MESSAGES displays messages generated when users make
requests to you through the PLEASE program.
The ENABLE and DISABLE commands also have the following switches. If
you do not specify one of these switches with one of the above
arguments, the system assumes all three types of messages.
/INFORMATION-MESSAGES
/JOB-MESSAGES
/OPR-ACTION-MESSAGES
For more information about these commands and switches see the TOPS-10
Operator's Command Language Reference Manual.
6.5 OPR ERROR MESSAGE DESCRIPTIONS
OPR error messages are also displayed on your terminal. All OPR error
messages begin with "?" and are followed by the message explaining the
error. Note that "?" does not represent a fatal error in OPR, as it
does in some other system programs.
When you receive an error message, you can type <CTRL/H> to retype
your OPR command up to the point where you entered the incorrect
6-10
THE OPERATOR INTERFACE, OPR
keyword, switch, or value and specify the correct input to the
command. See the TOPS-10 Operator's Command Language Reference Manual
for a complete list of OPR error messages, their causes, and how to
recover from them.
6-11
7-1
CHAPTER 7
GALAXY SOFTWARE TASKS
This chapter explains the relationships among the GALAXY programs and
the devices they operate. It explains how to use the GALAXY system to
control the following:
o Scheduled system events
o Batch streams
o NQC streams
o FAL streams
o Batch jobs
o Card punch jobs
o Card reader jobs
o Line printer jobs
o Paper-tape-punch jobs
o Plotter jobs
Figure 7-1 and Table 7-1 on the following pages explain the components
of the GALAXY system.
7-1
GALAXY SOFTWARE TASKS
_________ _____
| |___| OPR |
| ORION | |_____|
| | _____
| |___| OPR |
|_________| |_____|
|
________ ____|____ ________ ______
| | | |___________| |___| LPTx |
| QUEUE |_____| QUASAR |________ | LPTSPL | |______|
| | | |______ | | | ______
| | | |____ | | | |___| LPTy |
| | | |__ | | | |________| |______|
|________| |_________| | | | |
| | | | |
________ ____|____ | | | | ________
| DISKS |_____| | | | | | | |
|________| | PULSAR | | | | |__| SPRINT |
| TAPES | | | | | | | |
|________| | | | | | | |
|_________| | | | |________|
| | | |
____|____ | | | ________ ______
| | | | | | |___| CDRx |
| MONITOR | | | |____| CDRIVE | |______|
| | | | | | ______
| | | | | |___| CDRy |
|_________| | | |________| |______|
| |
| | ________ ______
| | | |___| PTYO |
| |______| BATCON | |______|
| | | ______
| | |___| PTYn |
| |________| |______|
|
| ________ ______
| | |___| PTP |
|________| SPROUT | |______|
| | ______
| |___| PLT |
|________| |______|
| ______
|_______| CDP |
|______|
Figure 7-1: The GALAXY System
7-2
GALAXY SOFTWARE TASKS
Table 7-1: GALAXY Components
______________________________________________________________________
Program Function
______________________________________________________________________
BATCON the batch controller, is the 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 those that allow you to control batch
job processing.
CDRIVE are responsible for the card reader input. CDRIVE reads
SPRINT 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 those that allow you to
control card reader processing.
LPTSPL the line printer spooler, is a program that can drive up
to 8 local and remote printers per spooler per node.
LPTSPL processes print requests that include those
submitted with the PRINT command, spooled requests
generated by user programs, and batch log files. QUASAR
selects jobs to be printed according to a variety of
parameters. The OPR commands that have PRINTER as an
argument are those that allow you to control line
printer processing.
NEBULA sends output jobs to remote systems using the
Distributed Queue Service (DQS) protocol.
OPR allows you to communicate with the various system
components and with the users requesting jobs on the
devices controlled by these components. This chapter
describes the OPR commands that accomplish these tasks.
For more information about OPR see the TOPS-10
Operator's Command Language Reference Manual.
ORION is the interface between OPR and all other components.
ORION logs each OPR command it receives, and passes the
command to the appropriate program.
PULSAR the tape label and disk structure processor, is the
program that handles the reading and writing of tape
labels.
7-3
GALAXY SOFTWARE TASKS
The mountable device allocation (MDA) system is composed
of QUASAR and PULSAR. The MDA system is a set of
functions within these two programs that control
mountable devices (tapes and disks). To place a device
under control of MDA , set it to be AVAILABLE.
QUASAR the queue manager, is the heart of the spooling system.
It is responsible for scheduling all jobs entered into
the spooler and mount queues.
QUEUE is a program which enables you to interact with the
GALAXY batch and spooling subsystem. QUEUE supports the
full set of commands used for entering batch jobs,
printing, punching or plotting files, allocating and
mounting devices and showing the status of system
queues.
SPROUT handles all the output requests other than line printer
requests. SPROUT is the:
o card punch
o paper-tape punch
o plotter spooler
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 those that enable you to control the
output processing on these devices.
______________________________________________________________________
7.1 CONTROLLING SYSTEM EVENTS
OPR allows you to control certain system activities known as "events".
These events are:
o Billing file closure (BILCLS)
o Scheduled system shutdown (KSYS)
o ORION log file closure (OPRFIL)
o Command file execution (TAKFIL)
o USAGE file closure (USGFIL)
To display the items in the EVENT queue, type the SHOW QUEUES EVENTS
command.
7-4
GALAXY SOFTWARE TASKS
OPR>SHOW QUEUES EVENTS<RET>
OPR>
15:30:39 -- System Queues Listing --
Event Queue:
Type Req# Expiration Description
-------- ------ ------------------ --------------------------------
BILCLS 227 1-Oct-87 16:59:59 Prime time rates end
USGFIL 334 1-Oct-87 23:59:30 Usage file closure
OPRFIL 335 2-Oct-87 0:00:00 ORION log file closure
BILCLS 543 2-Oct-87 7:59:59 Discount rates end
* KSYS 41 7-Oct-87 0:00:59 Debug new monitor
There are 5 events in the queue (1 in progress)
OPR>
The commands that control system events allow you to include a time
and date argument. These commands are:
o CLOSE To close the log file.
o SET KSYS To set a system shutdown.
o SET USAGE To close the accounting file.
o TAKE To execute commands in a file.
o CANCEL To cancel a pre-set event.
OPR uses the following conventions for the time and date arguments:
hh:mm:ss stands for hours, minutes and seconds. dd-mmm-yy stands for
day, month, year. DAY is a day of the week.
NOW causes the event to occur immediately.
+hh:mm:ss schedules the event to occur in the number of
hours from the current time as specified by
hh:mm:ss. (Specifies a relative time for the
event to occur.)
hh:mm:ss schedules the event to occur at the time
specified by hh:mm:ss. (Specifies an absolute
time for the event to occur.)
dd-mmm-yy:hh:mm:ss schedules the event to occur on the date and
time specified by dd-mmm-yy:hh:mm:ss.
DAILY hh:mm:ss schedules the event to occur every day at the
time specified by hh:mm:ss.
EVERY "DAY" hh:mm:ss schedules the event to occur every week on the
day and time you specify. DAY specifies a
particular day of the week.
7-5
GALAXY SOFTWARE TASKS
7.1.1 Closing the ORION Log File
To close the current ORION log file, rename it, and create a new log
file, use the CLOSE command. You can close the ORION log file
immediately or specify a date and time.
----- Example -----
Use the CLOSE command to close the ORION log file and open a new log
file automatically.
OPR>CLOSE LOG NOW<RET>
OPR>
15:10:33 --Event OPRFIL queued, request #426--
OPR>
15:10:34 --Log file DSKA:OPERAT.LOG[3,3] renamed to DSKA:OPERAT.001[3,3]--
OPR>
7.1.2 Scheduling System Shutdown
To set a time for timesharing to end use the SET KSYS command. You
may need to stop timesharing so that maintenance or stand-alone tasks
can be performed.
----- Example -----
Set the KSYS time to midnight for 21-Nov-88.
OPR>SET KSYS 21-NOV-88:00:00:00<RET>
OPR>
16:24:21 -- Event job KSYS queued, request 53 --
OPR>
Display the event queue to check the pending KSYS time.
OPR>SHOW QUEUES EVENTS<RET>
OPR>
16:25:37 -- System Queues Listing --
Event Queue:
Type Req# Expiration Description
-------- ------ ------------------ -----------------------
BILCLS 24 19-Nov-88 16:59:59 Prime time rates end
USGFIL 44 19-Nov-88 23:59:30 Usage file closure
OPRFIL 38 20-Nov-88 0:00:00 ORION log file closure
BILCLS 15 20-Nov-88 7:59:59 Discount rates end
7-6
GALAXY SOFTWARE TASKS
* KSYS 53 21-Nov-88 0:00:00
There are 4 events in the queue (1 in progress)
7.1.3 Controlling Usage Accounting
To control the usage accounting system during system operation, use
the SET USAGE command. SET USAGE BILLING-CLOSURE specifies that all
session entries be closed at a given time and SET USAGE FILE-CLOSURE
specifies that the current usage file be closed and renamed, and that
a new usage file be opened.
----- Example -----
Close the billing sessions for the change between first and second
shift.
OPR>SET USAGE BILLING-CLOSURE 16:30<RET>
13:21:27 --Will close billing sessions at 15-Jul-88 16:29:59--
OPR>
At 16:30 (4:30 PM), or shortly thereafter, the following message
appears on the OPR terminal.
OPR>
16:34:22 -- Message from the Accounting System --
Session entries written for all jobs
OPR>
7.1.4 Executing Command Files
To automatically execute the commands in a command file, use the TAKE
command. Typically a command file contains commands that perform a
series of related tasks.
----- Example -----
Specify a time for the TEST.CMD file to be executed.
OPR>TAKE DSK:TEST.CMD 20-NOV-88:12:00:00<RET>
OPR>
16:40:56 -- Event job TAKFIL queued, request 162 --
7-7
GALAXY SOFTWARE TASKS
OPR>
Display the event queue to check that the TAKE command was properly
queued.
OPR>SHOW QUEUES EVENTS<RET>
OPR>
16:41:08 -- System Queues Listing --
Event Queue:
Type Req# Expiration Description
------ --- ------------------ ------------------------
BILCLS 24 19-Nov-88 16:59:59 Prime time rates end
USGFIL 44 19-Nov-88 23:59:30 Usage file closure
OPRFIL 38 20-Nov-88 0:00:00 ORION log file closure
BILCLS 15 20-Nov-88 7:59:59 Discount rates end
TAKFIL 162 20-Nov-88 12:00:00 Time-of-day OPR command file
* KSYS 103 21-Nov-88 0:00:00 Timesharing will end
There are 6 events in the queue (1 in progress)
OPR>
7.2 BATCH RESPONSIBILITIES
The batch system increases the efficiency of the system by processing
jobs that do not require human interaction. Your batch
responsibilities are to:
o Start batch streams
o Set parameters for batch streams and parameters
o Adjust the parameters, if necessary
o Service action requests from user jobs
o Maintain peripheral devices
o Examine the queues periodically and modify the requests if
necessary.
If users are submitting batch jobs on card decks, your system manager
should tell you:
o Where the decks must be placed for submission
o When the decks are read
7-8
GALAXY SOFTWARE TASKS
o Where and when the decks and output are returned to users
7.3 CONTROLLING BATCH STREAMS
You must start the batch streams before the batch system can process
batch requests. In addition, you must check to see that
QUEUE-REQUESTS are enabled. Issue the PRINT or SUBMIT commands to
verify that QUEUE-REQUESTS are enabled. If QUEUE-REQUESTS are
disabled, the system responds with a message stating that they are
disabled. The following example illustrates the ENABLE QUEUE-REQUESTS
command.
OPR>ENABLE QUEUE-REQUESTS<RET>
OPR>
7.3.1 Setting Parameters
Normally, the SYSTEM.CMD file starts a defined number of batch streams
automatically at system start-up. However, you might start an
additional batch stream when there are many batch jobs waiting in the
queue. Batch stream parameters limit the use of a stream to requests
that meet a particular set of criteria. The default batch stream
parameters are:
o ATTRIBUTE BATCON
o MEMORY-LIMITS 0:512
o OPR-INTERVENTION
o PRIORITY-LIMITS 1:63
o TIME-LIMITS 0:600
The ATTRIBUTE parameter enables you to specify whether the batch
stream uses BATCON or SITGO to process jobs. Use SITGO when you need
a batch processor that contains a fast, batch-oriented FORTRAN
compiler.
The MEMORY-LIMITS parameter specifies the memory requirements of batch
jobs in the batch stream. MEMORY-LIMITS is expressed in terms of the
number of memory pages a batch job needs in order to process. Only
batch jobs with memory requirements within the specified range can run
in the stream.
The OPR-INTERVENTION parameter enables users to pass messages to you
7-9
GALAXY SOFTWARE TASKS
through the batch job. For example, a user might send a message
requesting you to mount a tape. To disable the OPR-INTERVENTION
parameter set the parameter to NOOPR-INTERVENTION. With
NOOPR-INTERVENTION in effect, the system automatically logs out batch
jobs that request operator intervention.
The PRIORITY-LIMITS parameter enables you to specify the priorities
for a batch stream or a range of batch streams. The default limits
are from 1 to 63. The greater the number, the higher the priority.
If you set a batch stream to have a priority limit of 31:41, the
system only processes batch requests submitted with a priority between
31 and 41 (inclusive) in that stream.
The TIME-LIMITS parameter enables you to specify a range of time
limits for batch jobs running in a specified stream. The default
minimum:maximum range is 0:600 minutes. If you set a batch stream to
have time limits from 0 to 5 minutes, the system only processes
requests submitted with a time limit of 5 minutes or less in that
batch stream.
----- Example -----
Set a batch stream for NOOPR-INTERVENTION with a priority limit of 50
and with a time range of 60 to 90 minutes.
OPR>SET BATCH-STREAM 4 NOOPR-INTERVENTION <RET>
OPR>
9:20:55 Batch-stream 4 -- Set Accepted --
OPR>SET BATCH-STREAM 4 PRIORITY-LIMITS 50 <RET>
OPR>
9:21:15 Batch-stream 4 -- Set Accepted --
OPR>SET BATCH-STREAM 4 TIME-LIMITS 60:90 <RET>
OPR>
9:21:40 Batch-stream -- Set Accepted --
OPR>
7.3.2 Starting Batch Streams
After you set the parameters for a particular batch stream or a range
of batch streams, you can start the stream(s). If you do not set any
parameters for the stream, the stream takes the default values. You
can start one or more batch streams at a time.
7-10
GALAXY SOFTWARE TASKS
----- 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:20 Batch-stream 7 -- Startup Scheduled --
OPR>
7.3.3 Stopping Batch Streams Temporarily
To stop a batch stream or a range of batch streams temporarily, 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.
The STOP command has the following optional arguments:
o AFTER CURRENT-REQUEST
o AFTER EVERY-REQUEST
o IMMEDIATELY
The default is to stop processing immediately.
----- Example -----
Stop the processing of a job in batch stream 4 temporarily.
OPR>STOP BATCH-STREAM 4 <RET>
OPR>
11:23:09 Batch-stream 4 -- Stopped --
OPR>
7.3.4 Continuing Batch Streams
Use the CONTINUE command to continue processing a stopped job in a
batch stream or jobs in a range of batch streams.
7-11
GALAXY SOFTWARE TASKS
----- Example -----
Continue processing the job in batch stream 4.
OPR>CONTINUE BATCH-STREAM 4 <RET>
OPR>
11:41:18 Batch-stream 4 -- Continued --
OPR>
7.3.5 Shutting Down Batch Streams
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 occurs when the job is completed, and no new
batch requests are accepted.
To start a batch stream after it has been shut down use the START
command.
----- Example -----
Shut down 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 processing, the
following message appears:
OPR>
13:38:25 Batch-stream 5 -- Shutdown --
OPR>
7.3.6 Sending Messages
To send a message to a job in a batch stream, use the SEND
BATCH-STREAM command. You can specify single-line messages or
multi-line messages. To send multi-line messages do the following:
7-12
GALAXY SOFTWARE TASKS
1. Type SEND BATCH-STREAM.
2. Enter the stream number to which you want the message sent.
3. Press RETURN.
4. Type your message.
5. Press <CTRL/Z> to terminate the SEND command.
----- Example -----
A batch job in batch stream 2 requests a tape mount. After you have
mounted and readied the tape, you SEND a message to the batch stream
to identify the tape volume id to the batch user. You can specify
only one batch stream in the SEND command.
OPR>SEND BATCH-STREAM 2 <RET>
Enter text and terminate with ^Z
THE TAPE VOLUME ID IS 120124.^Z
OPR>
----- Restriction -----
If you send a message to a stream that is not processing a job, you
receive the following error message:
hh:mm:ss Batch-stream n -- Not Active --
7.3.7 Displaying Batch Stream Parameters
To display current batch stream parameters for one or more batch
streams use the SHOW PARAMETERS BATCH-STREAM command. If you do not
specify a stream number or a range of stream numbers, the command
displays all the batch streams.
The SHOW PARAMETERS BATCH-STREAM command displays the following
information for each batch stream:
o The number of the batch stream
o The range of processing minutes set for the batch stream
o The priority range set for the batch stream
7-13
GALAXY SOFTWARE TASKS
o The memory range set for the batch stream
o Whether or not operator intervention has been set for the
batch stream
----- Example -----
Use 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 Core Opr-Intvn
---- ----------- ----- ------- -----------
0 0:10 1:19 1:512 Yes
1 11:30 1:19 1:512 Yes
2 31:480 1:19 1:512 Yes
3 0:11000 20:63 1:512 Yes
OPR>
7.3.8 Displaying Batch Stream Status
To display the status of one or more batch streams use 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 SHOW STATUS BATCH-STREAM command displays the following
information for each batch stream:
o The number of the batch stream
o The current status of the batch stream (idle or active)
o The name of the job currently active in the batch stream, if
a job is running
o The request-id of the job
o The name and PPN of the user who made the job request
o The label last referenced
o The name of program being run
7-14
GALAXY SOFTWARE TASKS
o The runtime, if any
If you only want to see information about idle streams, specify the
/SHORT switch before you press RETURN.
----- Example -----
Use 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 BROWN.E [27,5107]
Job 18 Running MACRO Last Label: MACRO Runtime 0:00:42
2 Idle
3 Active PHYCAL 41 MANUFACTURING [10,1221]
Job 31 Running COBOL Runtime 2:31:27
OPR>
7.4 CONTROLLING FAL STREAMS
FAL, the File Access Listener, provides remote access to the TOPS-10
file system and is an integral part of network communications. FAL
makes network file transfers possible in the following ways:
o It acts as a target for NFT (Network File Transfer) programs
on other DECnet and ANF-10 hosts.
o It determines a user's access privileges to a requested file.
A single FAL job can run multiple FAL streams. Each FAL stream
controls a network connection.
OPR has commands that allow you to:
o Define FAL accessibility.
o Specify the network type with which each FAL stream will
communicate.
7-15
GALAXY SOFTWARE TASKS
o Start FAL stream scheduling.
o Terminate FAL stream scheduling.
o Stop FAL streams temporarily or terminate active FAL streams.
o Continue FAL streams.
o Display the status and network types associated with
specified FAL streams.
For more information about OPR commands that control FAL streams,
refer to the Operator's Command Language Reference Manual.
7.4.1 Defining FAL Accessibility
To specify FAL accessibility, use the DEFINE command.
----- Example -----
Use the DEFINE command to specify nodes that may not establish FAL
connections.
OPR>DEFINE FILE-ACCESS REJECTION-LIST SCUD<RET>
OPR>
13:48:53 -- Rejection list defined for all FAL-Streams --
OPR>
7.4.2 Setting Parameters
To specify the network type (DECnet or ANF-10) associated with a
specified FAL stream, use the SET FAL-STREAM command. ANF-10 is the
default network type.
----- Example -----
Use the SET command to define ANF-10 as the network with which FAL
stream 3 will communicate.
OPR>SET FAL-STREAM 3 NETWORK ANF-10<RET>
OPR>
15:16:38 Fal-Stream 3 -- Set Accepted --
OPR>
7-16
GALAXY SOFTWARE TASKS
7.4.3 Starting FAL Streams
To start the scheduling for a FAL stream or range of FAL streams use
the START FAL-STREAM command. Use the START FAL-STREAM command to
restart FAL streams that you stopped with the SHUTDOWN command.
----- Example -----
Use the START FAL-STREAM command to start FAL streams 6 and 7.
OPR>START FAL-STREAM 6:7<RET>
OPR>
13:53:32 FAL-Stream 6 -- Startup Scheduled --
13:53:33 FAL-Stream 7 -- Startup Scheduled --
OPR>
13:53:34 FAL-Stream 6 -- Started --
OPR>
13:53:37 FAL-Stream 7 -- Started --
OPR>
7.4.4 Stopping FAL Streams Temporarily
To temporarily stop a specified FAL stream or range of FAL streams,
use the STOP FAL-STREAM command. To terminate an active FAL stream,
use the ABORT FAL-STREAM command.
----- Examples -----
Use the ABORT FAL-STREAM command to abort FAL stream 0.
OPR>ABORT FAL-STREAM 0<RET>
OPR>
10:48:42 FAL-Stream 0 -- Abort --
Aborting due to operator command
10:48:42 FAL-Stream 0 -- End --
Servicing DECnet node BERTS for user sendlosky
OPR>
Use the STOP FAL-STREAM command to immediately stop FAL stream 6.
OPR>STOP FAL-STREAM 6<RET>
OPR>
15:00:09 FAL-Stream 6 -- Stopped --
OPR>
7-17
GALAXY SOFTWARE TASKS
7.4.5 Continuing FAL Streams
To continue a specified FAL stream or range of FAL streams that you
stopped using the STOP FAL-STREAM command, use the CONTINUE FAL-STREAM
command.
----- Example -----
Use the CONTINUE FAL-STREAM command to continue FAL stream 6.
OPR>CONTINUE FAL-STREAM 6<RET>
OPR>
15:02:33 FAL-Stream 6 -- Continued --
OPR>
7.4.6 Shutting Down FAL Streams
To terminate scheduling for a specified FAL stream or range of FAL
streams, use the SHUTDOWN FAL-STREAM command. The SHUTDOWN FAL-STREAM
command allows the current FAL stream to complete processing, then
terminates the stream and no further FAL streams are processed.
----- Example -----
Use the SHUTDOWN FAL-STREAM command to terminate FAL streams 6 and 7.
OPR>SHUTDOWN FAL-STREAM 6:7<RET>
OPR>
14:03:57 FAL-Stream 6 -- Shutdown --
14:03:57 FAL-Stream 7 -- Shutdown --
OPR>
7.4.7 Displaying FAL Stream Parameters
To display the network type associated with a specified FAL stream,
use the SHOW PARAMETERS FAL-STREAM command.
----- Example -----
Use the SHOW PARAMETERS FAL-STREAM command to display the current
parameters of all FAL streams.
OPR>SHOW PARAMETERS FAL-STREAM<RET>
OPR>
15:09:18 -- System Device Parameters --
7-18
GALAXY SOFTWARE TASKS
FAL STREAM PARAMETERS:
Strm Network
---- -------
0 DECnet
1 DECnet
2 DECnet
3 ANF-10
4 ANF-10
5 ANF-10
6 ANF-10
OPR>
7.4.8 Displaying FAL Stream Status
To display the status of a specified FAL stream or range of FAL
streams, use the SHOW STATUS FAL-STREAM command.
----- Example -----
Use the SHOW STATUS FAL-STREAM command to display the current status
of all FAL streams.
OPR>SHOW STATUS FAL-STREAM<RET>
OPR>
16:22:50 -- System Device Status --
FAL-Stream Status:
Strm Status Node Connect Time Bytes
---- --------------- ------ ------------ -------
0 Idle
1 Idle
2 Idle
3 Active KL1026 00:00:31 54943
Writing DSKB:OPRPAR.MAC[10,6030,GALAXY,ORION] for user send
4 Idle
5 Idle
OPR>
7.5 CONTROLLING NQC STREAMS
The Network Queue Controller (NQC), using the Distributed Queue
Service (DQS) protocol, allows more than one output request to be sent
to an output queue of a remote node at one time.
NQC-Streams control spooling requests for the NEBULA remote queuing
software. Current versions of NEBULA run as internal ORION
applications that are available with the standard monitor distribution
7-19
GALAXY SOFTWARE TASKS
and GALAXY CUSP. To implement remote queuing, your system must be
running DECnet-10 Version 3 and the remote queuing node must be a
VAX/VMS system running DQS Version 1.0 software.
7.5.1 Setting Parameters
To specify a node or the INPUT-STREAM or OUTPUT-STREAM attribute
associated with a specified NQC stream or range of NQC streams, use
the SET NQC-STREAM command.
----- Example -----
Use the SET NQC-STREAM command to specify the OUTPUT-STREAM attribute
to NQC stream 0.
OPR>SET NQC-STREAM 0 ATTRIBUTE OUTPUT-STREAM<RET>
OPR>
14:09:36 NQC-Stream 0 -- Set Accepted --
OPR>
7.5.2 Starting NQC Streams
To start the scheduling for a NQC stream or range of NQC streams use
the START NQC-STREAM command. Use the START NQC-STREAM command to
restart NQC streams that you stopped with the SHUTDOWN command.
----- Example -----
Use the START NQC-STREAM command to start the scheduling for NQC
stream 0.
OPR>START NQC-STREAM 0<RET>
OPR>
14:20:13 NQC-Stream 0 -- Startup Scheduled --
OPR>
7.5.3 Stopping NQC Streams Temporarily
To temporarily stop a specified NQC stream or range of NQC streams,
use the STOP NQC-STREAM command. To terminate an active NQC stream,
use the ABORT NQC-STREAM command.
----- Examples -----
7-20
GALAXY SOFTWARE TASKS
Use the ABORT NQC-STREAM command to abort NQC stream 2.
OPR>ABORT NQC-STREAM 2<RET>
OPR>
12:08:17 NQC-Stream 2 -- Abort --
Aborting due to operator command
12:08:17 NQC-Stream 2 -- End --
Servicing DECnet node CLOYD for user morrill
OPR>
Use the STOP NQC-STREAM command to immediately stop NQC stream 4.
OPR>STOP NQC-STREAM 4<RET>
OPR>
10:11:15 NQC-Stream 4 -- Stopped --
OPR>
7.5.4 Continuing NQC Streams
To continue a specified NQC stream or range of NQC streams that you
stopped using the STOP NQC-STREAM command, use the CONTINUE NQC-STREAM
command.
----- Example -----
Use the CONTINUE NQC-STREAM command to continue NQC stream 1.
OPR>CONTINUE NQC-STREAM 1<RET>
OPR>
12:07:13 NQC-STREAM 1 -- Continued --
OPR>
7.5.5 Shutting Down NQC Streams
To terminate scheduling for a specified NQC stream or range of NQC
streams, use the SHUTDOWN NQC-STREAM command.
----- Example -----
Use the SHUTDOWN NQC-STREAM command to terminate NQC stream 0.
OPR>SHUTDOWN NQC-STREAM 0<RET>
OPR>
14:18:03 NQC-Stream 0 -- Shutdown --
OPR>
7-21
GALAXY SOFTWARE TASKS
7.5.6 Displaying NQC Stream Parameters
To display the INPUT-STREAM or OUTPUT-STREAM attribute associated with
a specified NQC stream or range of streams, use the SHOW
PARAMETERS NQC-STREAM command.
----- Example -----
Use the SHOW PARAMETERS NQC-STREAM command to display the current
parameters of all NQC streams.
OPR>SHOW PARAMETERS NQC-STREAM<RET>
OPR>
11:29:43 -- System Device Parameters --
NQC-Stream Parameters:
Strm Attribute
---- ---------
0 Output
OPR>
7.5.7 Displaying NQC Stream Status
To display the status of a specified NQC stream or range of NQC
streams, use the SHOW STATUS NQC-STREAM command.
----- Example -----
Use the SHOW STATUS NQC-STREAM command to display the current status
of all NQC streams.
OPR>SHOW STATUS NQC-STREAM<RET>
OPR>
15:32:48 -- System Device Status --
NQC-Stream Status:
Strm Status
---- --------------
0 Idle
OPR>
7.6 CONTROLLING BATCH JOBS
Users enter batch jobs into the batch queue with the monitor command,
SUBMIT. This section explains how to control these jobs.
7-22
GALAXY SOFTWARE TASKS
7.6.1 Examining the Batch Queue
Batch queues hold user-submitted batch jobs until the batch system
selects one for execution. To examine batch job queues use the SHOW
QUEUES BATCH-JOBS command.
The SHOW QUEUES BATCH-JOBS command displays the following information
for each job that is waiting or running:
o The name of the batch job
o The request-id number of the batch job
o The scheduled runtime of the batch job
o The name of the user who submitted the batch job
o Any special requirements the user included in the SUBMIT
command line.
The system displays this information whether the batch job is active
(currently running) or not active (not running).
An asterisk (*) to the left of the job name indicates an active job.
The system displays the following information for active jobs:
o The stream in which the job is running
o The job number
o The last control file label encountered by the job
o The runtime used
The SHOW QUEUES BATCH-JOBS has optional switches, including /ALL and
/SHORT. The /ALL switch displays all batch jobs in the queue with
their appropriate column headers, and any switches that the user
specified when the batch job was submitted. If the user did not
specify switches, the /ALL switch displays the default settings of the
SUBMIT switches for the batch job. In addition, the /ALL switch
displays any switches you specified, such as /HOLD. The /SHORT switch
displays only the job name, the request number, the scheduled runtime,
and the user name. The /SHORT switch does not display column headers
or switches.
----- Examples -----
1. Use the SHOW QUEUES BATCH-JOBS command with the /ALL switch
to display the batch jobs in the queue with all their
switches.
7-23
GALAXY SOFTWARE TASKS
OPR>SHOW QUEUES BATCH-JOBS /ALL <RET>
OPR>
13:40:22 -- System Queues Listing --
Batch Queue:
Job Name Req Run Time Core User
-------- ------ -------- ---- -------------------------
* OPSER 330 01:00:00 512 Mike Boucher [30,5664]
In Stream:2 /Uniq:Yes /Restart:No /Assist:Yes
/Output:Log /Batlog:Append /Seq:460
Job 52 Runtime 0:00:00
SAVE 24 00:01:00 200 DPM [10,56]
/After:28-May-82 8:00 /Uniq:No /Restart:No
/Assist:Yes /Output:Error /Batlog:Append
/Seq:3047
SML20 18 00:05:00 200 Hayes, R [10,3354]
/Proc:K26E /Uniq:No /Restart:No /Assist:Yes
/Output:Nolog /Batlog:Append /Seq:102
ACCT 14 00:05:00 200 Mary Marotta [27,5443]
/After:27-May-82 0:00 /Uniq:No /Restart:No
/Assist:Yes /Output:Nolog /Batlog:Super
/Seq:784
There are 4 jobs in the queue (1 in progress)
OPR>
2. Use the SHOW QUEUES BATCH-JOBS command with the /SHORT
switch.
OPR>SHOW QUEUES BATCH-JOBS /SHORT <RET>
OPR>
13:40:45 -- System Queues Listing --
Batch Queue:
* OPSER 330 01:00:00 200 MEIER,B [10,3146]
TWAIT 295 00:01:00 512 [RDH] [226,4563]
SUB15 302 00:05:00 200 ANTHONY [10,5757]
OPR>
7.6.2 Holding Batch Jobs
To prevent a batch job from processing, use the HOLD BATCH-JOBS
command. The HOLD BATCH-JOBS command keeps the current job(s) in the
queue from processing until you use the RELEASE command to free the
job(s). 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:
7-24
GALAXY SOFTWARE TASKS
o The request-id number, to hold a single batch job.
o The PPN for a particular user, to hold all batch jobs
submitted by that user.
o An asterisk (*), to hold all batch jobs submitted by all
users.
NOTE
You cannot HOLD a batch job that is currently active
in a batch stream. Use the ABORT or STOP command to
stop the batch stream that is running the job.
----- Example -----
Use the HOLD BATCH-JOBS command to hold all batch requests for user
SMITH, whose PPN is [10,147].
OPR>HOLD BATCH-JOBS [10,147] <RET>
OPR>
9:01:54 -- 6 Jobs Held --
OPR>
7.6.3 Releasing Batch Jobs
The RELEASE command releases a batch request that has been previously
held with the HOLD command, and reschedules the job processing. To
specify the request you want to RELEASE, supply one of the following:
o A single request-id number to release one request
o A user name to release all requests for that user
o An asterisk (*) to release all requests
----- Restriction -----
You must have one or more batch streams started or in the idle state
to get a batch job processed.
----- Example -----
Use the RELEASE command to reschedule all batch requests that were
previously held.
7-25
GALAXY SOFTWARE TASKS
OPR>RELEASE BATCH-JOBS * <RET>
OPR>
10:38:09 -- 6 Jobs Released --
OPR>
7.6.4 Aborting Running Batch Jobs
To cancel a batch job while it is active, use the ABORT command with
the batch stream number and one or more of the following switches:
o /ERROR-PROCESSING or /NOERROR-PROCESSING,
o /PURGE
o /REASON
The /ERROR-PROCESSING and /NOERROR-PROCESSING switches specify whether
to complete any error recovery procedures that may have been included
in the batch job. By default, if you ABORT a batch job, BATCON does
error processing. The /NOERROR-PROCESSING switch prevents BATCON from
completing error recovery procedures.
The /PURGE switch cancels all output from the batch job, preventing
the log file from being printed.
The /REASON switch allows you to enter one or more lines of text to
explain why you are aborting the batch job.
----- Example -----
Use 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 --Aborted--
Job TEST01 Req #35 for PACELLI [27,4615]
OPR>
11:32:12 Batch-stream 0 --End--
Job TEST01 Req #35 for PACELLI [27,4615]
OPR>
7-26
GALAXY SOFTWARE TASKS
7.6.5 Requeuing Batch Jobs
The REQUEUE command stops a job that is processing and puts the job
back into the batch queue, to be restarted later. A requeued job is
in a HOLD state until it can start running again. To start processing
the job again, use the RELEASE command.
For example, you might want to REQUEUE a batch job that requires
additional structures for its processing, because you do not have any
available disk drives. Thus, you REQUEUE the job to be processed when
the disk drives become available.
You can specify the /REASON switch to explain why you are requeuing
the job.
----- Example -----
Use the REQUEUE command to hold a batch job that, when started,
requested a structure that could not be mounted.
OPR>REQUEUE BATCH-STREAM 2 /REASON: <RET>
Enter text and terminate with ^Z
JOB WILL BE RELEASED LATER WHEN DISK DRIVE BECOMES AVAILABLE ^Z
OPR>
13:21:03 Batch-stream 2 -- REQUEUE command queued --
OPR>
13:21:05 Batch-stream 2 -- End --
Job TAPE01 Req #27 for LATTA [2,134]
OPR>
7.6.6 Modifying Batch Requests
To change the priority of a batch request in the queue use the MODIFY
BATCH-REQUEST command and specify one of the following:
o A single batch request-id number to modify a single request
o A user name to modify all requests by a user
o An asterisk (*) to modify all batch requests in the queue
You must include the PRIORITY keyword, followed by a priority from 1
to 63. You must specify a new PRIORITY number from 1 to 63. The
higher the number, the greater the priority.
----- Example -----
7-27
GALAXY SOFTWARE TASKS
Use the MODIFY command to change the priority of batch request 135 to
63.
OPR>MODIFY BATCH-REQUEST 135 PRIORITY 63 <RET>
OPR>
8:51:21 -- 1 Request Modified --
OPR>
8:52:03 -- Batch-Stream ) -- Begin --
Job SUB15 Req #135 for M.MAROTTA [27,5434]
Control file: DSKB:SUB15.CTL[27,5434]
Log file: DSKB:SUB15.LOG[27,5434]
OPR>
7.6.7 Deleting Batch Requests
To cancel a batch request from the batch queue, use the CANCEL
BATCH-REQUEST command and supply one of the following:
o A single request-id number to cancel one request
o A user name to cancel all requests for that user
o An asterisk (*) to cancel all requests
If you CANCEL a batch request that is active, the batch job is stopped
immediately. In this way the CANCEL command is the same as the ABORT
command. (ABORT is useful with active batch jobs only.) The log file
shows a message indicating that the job was deleted by the operator.
----- Example -----
Cancel batch request 168 from the batch request queue.
OPR>CANCEL BATCH-REQUEST 168 <RET>
OPR>
10:25:11 -- 1 Job Canceled --
OPR>
10:25:29 Batch-Stream 2 --Canceled by Operator [1,2] --
Job IPCUS Req #168 for MORRILL [25,1026]
OPR>
7-28
GALAXY SOFTWARE TASKS
10:25:34 Batch-Stream 2 -- End --
Job IPCUS Req #168 for MORRILL [25,1026]
OPR>
7.7 CONTROLLING THE LINE PRINTER
To process printer requests, the system must have one or more line
printers with the parameters set to allow processing of user 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. See the TOPS-10 Operator's Command
Language Reference Manual for more information about SYSTEM.CMD.
After one or more 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, and should tell
you:
o Where you must put the listings so that users can pick them
up
o When you must distribute them
The following sections describe the OPR commands that enable you to
control the following line printer functions:
o Setting printer parameters
o Stopping a printer
o Continuing a printer job
o Shutting down a printer
o Displaying a printer's parameters
o Displaying a printer's status
7.7.1 Setting Line Printer Parameters
Normally, the SYSTEM.CMD file starts a defined number of line printers
at system start-up. 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 set the parameters for the line
printer with the SET PRINTER command. The parameters you can set are:
7-29
GALAXY SOFTWARE TASKS
o The FORMS-TYPE parameter, which specifies the type of paper
to be used. The name of the form should be the same as the
form name in the LPFORM.INI file. See Section 7.7.2 for more
information about the LPFORM.INI file.
o The LIMIT-EXCEEDED-ACTION parameter, which 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
take one of the following actions:
- ASK the operator what action to take. The operator can
reply with either PROCEED (to continue the print job) or
ABORT (to cancel the print job).
- Always ABORT the print job when the limit has been
exceeded.
- Always PROCEED, ignoring the job limit.
o The PAGE-LIMITS parameter, which specifies the
minimum-to-maximum range of pages allowed to be printed per
job on the line printer. This is checked against the /LIMIT
value on the request.
o The PRIORITY-LIMITS parameter, which 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. But you can change the priority of
a print request with the MODIFY PRINT-REQUESTS command.
These parameters are initially set by your system manager with GALGEN.
(Refer to the TOPS-10 Software 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 change it again, or until the GALAXY system is
restarted.
----- 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-LIMITS 21 <RET>
OPR>
12:01:21 Printer 0 -- Set Accepted --
OPR>SET PRINTER 0 PAGE-LIMITS 1000 <RET>
7-30
GALAXY SOFTWARE TASKS
OPR>
12:01:40 Printer 0 -- Set Accepted --
OPR>
7.7.2 Using 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. The default is NORMAL.
:locator is an optional locator field containing:
ALL all devices (the default)
LPTxxy a specific line printer, where xx
is the node number, and y is the
printer unit number
LOC to specify all local line printers
REM to specify line printers at remote
stations
/switch1... are one or more switches you can use to
describe the way the forms are to be used.
Refer to Table 7-2 for a description of the
available switches.
Table 7-2: 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
7-31
GALAXY SOFTWARE TASKS
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
displays 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 to be printed before each file.
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 displayed on your OPR
terminal at the time the forms and/or print
request are scheduled.
/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 RAM
(DARAM), the system automatically loads it
from the file SYS:name.RAM. If the line
printer does not have a DARAM, the system
notifies you of the need to load your own
RAM program.
For example, if your line printer doesn't
print left and right angle brackets, you
7-32
GALAXY SOFTWARE TASKS
could specify a RAM file that would convert
angle brackets to square brackets in 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 displays 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 to be printed after each file.
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.
If there are no printers that satisfy the print request, the request
will remain in the queue until a printer with the correct forms
becomes available.
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
7-33
GALAXY SOFTWARE TASKS
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, the user receives 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 incorrectly to the user's print request.
Therefore, the LPFORM.INI file should contain unique forms names for
each different type of form. This ensures that the correct forms are
mounted when a user submits a print request. The alternative is to
change the GALGEN parameter and rebuild GALAXY.
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:LPT263/HEADER:1/BANNER:1/TRAILER:0
NORMAL:ALL/HEADER:2/BANNER:2/TRAILER:2
If form NORMAL is on line printer LPT263, it takes the forms
parameters given in the first entry of the LPFORM.INI file shown
above. If form NORMAL is 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
LPT263 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
7-34
GALAXY SOFTWARE TASKS
7.7.3 Using the LPFONT.INI File
The LPFONT.INI file contains a list of font specifications for the
LN01 laser printer. For more information about LN01 font
specifications, see the LN01 Programmer's Reference Manual and the
TOPS-10 Operating System Commands Manual. The following example
illustrates the format for each line in the LPFONT.INI file:
filenm=name1<TAB>name2<TAB>name3
where:
filenm is the name of a file containing a single font
specification. The default file extension is
.SIX.
name1<TAB>name2<TAB>name3
specifies font names. Name1 must be an actual
font name found in the font file. Name2 and
subsequent names can be any name chosen by
your system manager. To access a font you
must specify uppercase or lowercase exactly as
shown in the LPFONT.INI file.
----- Example -----
The following is a brief illustration of font specifications contained
in a LPFONT.INI file.
003665 = 002249L36V010005C VL36TRIUMVIRATEBDITNM
003674 = 002249P36V010004C VP36TRIUMVIRATEBDITCP 36PTBOLD
003675 = 002249P36V010005C VP36TRIUMVIRATEBDITNM
010601 = 002500L06V010001C VL6TIMES
7.7.4 Starting the Line Printer
After you set the parameters for the line printers, you must start the
printer(s) so that print requests can be processed. If you do not set
parameters for the printer, the parameters are those set by your
system manager with GALGEN.
You can start one or more line printers at a time by specifying a unit
number (n) or a range of unit numbers (n:m).
To stop the scheduling of jobs on a line printer, use the SHUTDOWN
command.
7-35
GALAXY SOFTWARE TASKS
----- Example -----
Use the START PRINTER command to start line printer 0.
OPR>START PRINTER 0 <RET>
OPR>
10:11:15 Printer 0 -- Startup Scheduled --
OPR>
7.7.5 Stopping the Line Printer Temporarily
To stop one or more line printers, use the STOP PRINTER command. The
STOP PRINTER command temporarily stops the line printer from
completing its current job. You must use the CONTINUE command
(Section 7.7.6) to allow the line printer to continue printing the
job.
The STOP command has three optional arguments that you can use to
specify when the printer must stop. They are:
o AFTER CURRENT-REQUEST
o AFTER EVERY-REQUEST
o IMMEDIATELY
The IMMEDIATELY argument is the default argument of the STOP command.
See the TOPS-10 Operator's Command Language Reference Manual for a
complete description of these arguments.
----- Example -----
Stop the current job on line printer 2 to change the printer's ribbon.
OPR>STOP PRINTER 2 <RET>
OPR>
18:24:09 Printer 2 -- Stopped --
OPR>
7.7.6 Continuing the Line Printer
Use the CONTINUE command to continue the processing of a print request
on one or more line printers that were temporarily stopped with the
7-36
GALAXY SOFTWARE TASKS
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>
7.7.7 Shutting Down the Line Printer
To prevent the scheduling of further 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 -----
Shut down 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 is displayed:
OPR>
19:22:54 Printer 2 -- Shutdown --
OPR>
7.7.8 Displaying Line Printer Parameters
To display the current parameters for one or more line printers, use
7-37
GALAXY SOFTWARE TASKS
the SHOW PARAMETERS PRINTER command. If you do not specify a single
line printer unit number or a range of unit numbers, the SHOW command
displays information for all line printers on the system.
The SHOW PARAMETERS PRINTER command displays the following information
for each printer:
o The printer unit number
o The page limits set for the line printer
o The type of forms set for the line printer
o The priority range set for the line printer
o The limit-exceeded-action set for the line printer
o The case setting for the line printer (uppercase or
lowercase)
----- Example -----
Use the SHOW PARAMETERS PRINTER command to display the parameters of
all line printers on the system.
OPR>SHOW PARAMETERS PRINTER <RET>
OPR>
13:09:42 -- System Device Parameters --
Printer Parameters:
Unit Page Limits Form Prio Lim-Ex Dev-Chars
---- ------------ ------ ----- ------ ---------
0 0:20000 NORMAL 1:63 Ask Lower
1 0:500 NARROW 1:63 Ask Lower
OPR>
If jobs are waiting in the print queue because they do not meet the
limitations of any line printer, use this command to check the
parameters. After you check the parameters, use the SET PRINTER
command to modify the parameters so that the printer accepts the user
requests.
7.7.9 Displaying Line Printer Status
To display the status of the line printers use the SHOW STATUS PRINTER
command. If you do not specify a line printer unit number or a range
7-38
GALAXY SOFTWARE TASKS
of unit numbers, the command displays information for all line
printers on the system.
The SHOW STATUS PRINTER command displays the following information:
o The printer unit number
o The current status of the printer
o The name of the job currently active on the printer
o The request-id number for the job
o The name and PPN of the user who made the print request
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, specify the /SHORT switch before you
press RETURN.
----- Example -----
Use the SHOW STATUS PRINTER command to display the current status of
all line printers on the system.
OPR>SHOW STATUS PRINTER<RET>
OPR>
13:51:39 -- System Device Status --
Printer Status:
Unit Status Jobname Req# User
---- --------------- ------- ---- ------------------------
0 Active R4PPR2 106 MEIDELL [27,1345]
Started at 13:44:40, printed 142 of 1012 pages
1 Idle
OPR>
7.8 CONTROLLING FORMS ON THE LINE PRINTER
OPR commands enable you to do the following line printer tasks:
7-39
GALAXY SOFTWARE TASKS
o Align printer forms
o Backspace printer forms
o Forwardspace printer forms
o Suppress printer forms
You can use the OPR commands that control printer forms while the line
printer is printing a job, or after you set the line printer off-line.
When you set 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 command allows you to change the type of
forms on the line printer. If you specify a form type that does not
have an entry in the LPFORM.INI file, the forms characteristics
default to:
o /BANNER:2
o /HEADER:2
o /LINES:60
o /VFU:NORMAL
o /WIDTH:132
o /TRAILER:2
These defaults can be set by running GALGEN. Refer to Section 7.7.2
for a complete description of the SYS:LPFORM.INI file and the switches
you can place in it.
When the first 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 only an informational message that appears because the system
reads the LPFORM.INI file when you start a line printer.
The following sections describe how to use each of the commands listed
above.
7-40
GALAXY SOFTWARE TASKS
7.8.1 Aligning Forms
Occasionally, during your daily system operation, you might have to
correct the alignment of special forms for a particular line printer
job. For example, you have loaded payroll checks on the line printer
for your scheduled payroll process and they did not align correctly.
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:NORMAL.ALP
In addition, the ALIGN PRINTER command has three optional switches
that you can specify. These are:
o /PAUSE to change the number of seconds between each
printing of the .ALP file
o /REPEAT-COUNT to change the number of times the .ALP file
is printed.
o /STOP to resume normal printing and stop aligning
forms
When you specify one 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 job.
----- Example -----
Use the ALIGN PRINTER command to align forms for a print request for
payroll checks. The /PAUSE switch was set for 10 seconds and the
/REPEAT-COUNT switch was set for 25 times. 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 [10,3112]
OPR>
7-41
GALAXY SOFTWARE TASKS
Use 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 [10,3112]
OPR>
7.8.2 Backspacing Forms
Occasionally, you might have to backspace a particular file that is
being printed on the line printer, for example, 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:
o /COPIES specifies the number of copies to backspace
o /FILE specifies that the file should be reprinted from
the beginning
o /PAGES specifies the number of pages to be backspaced
When you use the BACKSPACE PRINTER command, LPTSPL 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 in 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.
With the /COPIES switch and the /FILE switch, you do not have to
consider these additional pages.
----- Example -----
Printer 1 has just had a VFU error, which has put the printer off
line. The following messages appear at your console:
OPR>
09:38:18 Printer 1 -- Offline --
OPR>
09:39:39 <12> Printer 1 -- VFU error --
7-42
GALAXY SOFTWARE TASKS
Re-align forms and put on-line
Type 'Respond <number> PROCEED when ready
OPR>
You must now realign the forms on the printer. 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>
09:45:06 Printer 1 -- Backspaced 25 Pages --
OPR>RESPOND 12 PROCEED <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.
7.8.3 Forwardspacing Forms
Occasionally, 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:
o /COPIES specifies the number of copies to be skipped
o /FILE skips one file in the request
o /PAGES specifies the number of pages in the print request
to skip
When you use the FORWARDSPACE PRINTER command, LPTSPL 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 add two or three pages to the value of /PAGES. With the
/COPIES switch and the /FILE switch, you do not have to consider these
additional pages.
7-43
GALAXY 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 file A.TXT
is skipped, and file B.TXT is the first file printed. After the
printer has printed the header and banner pages, give the FORWARDSPACE
PRINTER command for one file.
OPR>
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 skips one file of the print job.
7.8.4 Suppressing Carriage Control
Occasionally, 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 have a 25-page file with one line of text
per page, the SUPPRESS PRINTER command causes all the lines of text to
be printed on one page.
With the SUPPRESS PRINTER command, you can specify one of the
following switches:
o /FILE suppresses blank lines and form feeds for the
current file being printed
o /JOB suppresses blank lines and form feeds for the
entire job
o /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.
----- Example -----
7-44
GALAXY SOFTWARE TASKS
A user's program has caused a print loop. Use 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 [10,2772]
OPR>
7.9 CONTROLLING LINE PRINTER JOBS
The following sections explain the OPR commands that allow you to do
the following line printer tasks:
o Display the printer queue
o Prevent print requests from processing
o Reschedule print requests that were previously held
o Cancel printer jobs
o Requeue a printer job to be processed at a later time
o Change the priority of a print request
o Delete a print request from the queue
o Force the printer to process a particular request immediately
7.9.1 Examining the Printer Queue
When a user issues a request for the printer, the request is placed in
a queue where it waits to be printed. To examine the queues for print
jobs, use the OPR command SHOW QUEUES PRINTER-JOBS.
The SHOW QUEUES PRINTER-JOBS command displays the following
information for each job:
o The name of the print job
o The request-id number of the print job
o The page limit of the print job
7-45
GALAXY SOFTWARE TASKS
o The name and PPN of the user who requested the print job
These four columns of the display appear whether the print job is
active (currently printing) or is inactive (not printing). A job may
be inactive because it is waiting for other jobs with lower limits or
a higher priority. If no other printer requests are running, the job
may be waiting because no printer has the required parameters or
forms.
In addition to the above, if the job is active, the display also shows
the unit number of the printer on which the job is printing, the time
that the print job started, and the total number of pages printed.
The SHOW QUEUES PRINTER-JOBS command has two optional switches: /ALL
and /SHORT. The /ALL switch displays a detailed list of all printer
jobs in the queue, with their appropriate column headers and any
additional switches that the user specified with the PRINT command.
If there were no switches specified, the /ALL switch displays the
default switches of the PRINT command for the printer job. In
addition, the /ALL switch displays any additional characteristics of
the request, for example, if the job is being held. The /SHORT switch
requests a display of the job name, the request number, the scheduled
runtime, and the user name. There are no column headers and there are
no switches displayed on the /SHORT output listing.
The asterisk (*) before the job name column (see examples) indicates
that the job is currently printing.
----- Example -----
1. Use the /ALL switch to display the printer jobs in the queue
with all their switches.
OPR>SHOW QUEUES PRINTER-JOBS /ALL <RET>
OPR>
10:49:07 -- System Queues Listing --
Printer Queue:
Job Name Req# Limit User
-------- ---- ----- ------------------------
* DAILY 11 24 OPERATOR [1,2] On Unit:0
/Seq:3320
Started at 10:47, printed 5 of 24 pages
* TRAP79 12 161 BELANGER [12,5521] On Unit:1
/Seq:3321
Started at 10:44, printed 15 of 161 pages
MF20 13 23 SROBINSON [10,5432] /Seq:3322
WEEKLY 14 17 OPERATOR [1,2] /Seq:3323
SYSERR 15 10 OPERATOR [1,2] /Seq:3324
There are 5 jobs in the queue (2 in progress)
7-46
GALAXY SOFTWARE TASKS
OPR>
2. Use 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 [1,2]
- TRAP79 12 161 BELANGER [12,5521]
MF20 13 23 SROBINSON [10,5432]
WEEKLY 14 17 OPERATOR [1,2]
SYSERR 15 10 OPERATOR [1,2]
OPR>
7.9.2 Holding Line Printer Jobs
To prevent print requests from processing, use the HOLD PRINTER-JOBS
command. When you use this command, the print request in the queue is
held. Any other requests for the line printer are not held and are
processed as soon as a line printer becomes available. You must
specify one of the following with this command:
o The request-id number, which holds a single printer job
o The PPN for a particular user, which holds all printer jobs
queued by that user.
o An asterisk (*), which holds all printer jobs in the queue
NOTE
You cannot HOLD a printer job that is currently being
printed on a line printer.
----- Example -----
Use the HOLD PRINTER-JOBS command to hold all printer requests for
user SMITH, whose PPN is [27,5112].
OPR>HOLD PRINTER-JOBS [27,5112] <RET>
OPR>
9:01:54 -- 6 Jobs Held --
7-47
GALAXY SOFTWARE TASKS
OPR>
7.9.3 Releasing Line Printer Jobs
Use the RELEASE command to allow the printing of a job that has been
previously held with the HOLD command. To specify the job you want to
release, supply one of the following:
o A single request-id number to release one job
o A user name to release all jobs for that user
o An asterisk (*) to release all jobs
----- Example -----
Use the RELEASE command to reschedule all printer jobs that were
previously held.
OPR>RELEASE PRINTER-JOBS * <RET>
OPR>
10:38:09 -- 6 Jobs Released --
OPR>
7.9.4 Canceling Line Printer Jobs
Occasionally, you might have to cancel a printer job while it is
printing. You can use the ABORT command with the printer unit number
and one or more of the following switches:
o /PURGE
o /REASON
The /PURGE switch flushes the entire request 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.
----- Example -----
7-48
GALAXY SOFTWARE TASKS
Use the ABORT command to cancel a printer job because a user has
requested that you do so.
OPR>ABORT PRINTER 1 - <RET>
/REASON:USER REQUEST <RET>
OPR>
11:32:08 Printer 1 -- Aborted --
Job TEST01 Req #35 for JONES [2,187]
USER REQUEST
OPR>
11:32:12 Printer 1 -- End --
Job TEST01 Req #35 for JONES [2,187]
OPR>
7.9.5 Requeuing Line Printer Jobs
Occasionally, you might want to cancel a printer job and then
reschedule it to be printed at a later time. You can use the REQUEUE
command to hold the printer job in its entirety and ABORT its current
printing. This command can be used only when the job is active.
For example, you might want to REQUEUE a printer job that requires
many boxes of forms so that it prints at a later time when fewer users
are requesting printer jobs. Thus, you REQUEUE the job for printing
when the time becomes available.
You can specify the /REASON switch to explain why the job is being
requeued.
----- Example -----
Use 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. ^Z
OPR>
13:21:03 Printer 2 -- Requeued --
Job ARFORM Req #37 for AR.OFFICE [10,2312]
OPR>
7-49
GALAXY SOFTWARE TASKS
13:21:25 Printer 2 -- End --
Job ARFORM Req #37 for AR.OFFICE [10,2312]
OPR>
7.9.6 Modifying Line Printer Requests
To change the priority of a printer request in the queue, use the
MODIFY PRINTER-REQUEST command. To specify the request you want to
modify, supply one of the following:
o A single request-id number to modify one request
o A user name to modify all requests for that user
o An asterisk (*) to modify all requests
You must specify a new PRIORITY number from 1 to 63. The higher the
number, the greater the priority.
----- Example -----
Use the MODIFY command to change the priority of batch request 135 to
63. This causes the request to be the next job processed.
OPR>MODIFY PRINTER-REQUEST 135 PRIORITY 63 <RET>
OPR>
08:51:21 -- 1 Request Modified --
OPR>
7.9.7 Deleting Line Printer Requests
To delete a printer request from the printer queue, use the CANCEL
PRINTER-REQUEST command. To specify the request you want to CANCEL,
supply one of the following:
o A single request-id number to cancel one request
o A user name to cancel all requests for that user
o An asterisk (*) to cancel all requests
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.
7-50
GALAXY SOFTWARE TASKS
----- Example -----
Use 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>
10:26:01 Printer 0 -- Canceled by Operator [1,2] --
Job NEW Req 168 for M.MAROTTA [27,5434]
OPR>
10:26:10 Printer 0 -- End --
Job NEW Req 168 for M.MAROTTA [27,5434]
7.9.8 Specifying the next Line Printer Job
You can force the printer to service a particular request immediately
by using the NEXT command. This command starts the specified print
request immediately after the current request is finished. The NEXT
command does not alter the sequence of other requests in the queue.
You may, for example, have several jobs in the queue which have
requested narrow forms. By giving the NEXT command, you can service
them before restoring normal forms to your printer.
----- Example -----
A user (MORRILL) requests that his print job be moved to the top of
the print queue to be printed when a printer is available. You must
examine the print queue to obtain the request-identification number
for his print request. Then you use the NEXT command to place his
request next in the queue.
OPR>SHOW QUEUES PRINTER<RET>
OPR>
11:35:43 -- System Queues Listing --
Printer Queue:
Job Name Req Limit User
-------- ------ ------- --------------------------------
* BREAK 14 200 KOVALCIN, D [10,4635] On Unit:0
Started at 11:30:44, printed 20 of 200 pages
MAIL 145 35 MAROTTA, M [27,5555]
SNOOPY 10 65 MORRILL [443,2520]
/After:29-MAY-88 12:00
7-51
GALAXY SOFTWARE TASKS
There are 3 jobs in the queue (1 in progress)
OPR>NEXT PRINTER 0 REQUEST-ID 10<RET>
OPR>
11:36:17 Printer 0 -- NEXT request #10 scheduled --
OPR>
7.10 SENDING PRINTER OUTPUT TO MAGNETIC TAPE
You can send output to another device (such as magnetic tape) instead
of a line printer with the OPR command, START PRINTER nn
/DEVICE:MTAn:.
The advantages for doing this are:
o When your line printers are down due to a hardware problem,
you can spool the output to tape and then copy this output on
a system where the printer(s) is not down.
o When you want to microfiche the output, you can send the
output to tape instead of printing it on the line printer.
o 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 MTxn: UNAVAILABLE <RET>
where x is the tape controller identification and n is the
tape drive number. (Refer to Chapter 9 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, so that the tape is
write-enabled.
3. Type to OPR:
HOLD PRINTER-JOBS * <RET>
to hold all printer job requests in the printer(s) queue.
(Refer to Section 7.9.2.)
7-52
GALAXY SOFTWARE TASKS
4. Type to OPR:
START PRINTER nn /DEVICE:MTxn: <RET>
where nn is a line printer unit number other than the
printers already in use, and MTxn is the tape drive number.
5. If you are to print a type of form other than that used 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 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 MTxn: AVAILABLE <RET>
to make the tape drive available for user tape mount
requests.
----- 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.^Z
OPR>
7:52:19 Device MTA0 -- Set Unavailable --
7-53
GALAXY SOFTWARE TASKS
OPR>HOLD PRINTER-JOBS * <RET>
OPR>
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>
OPR>
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[2,147]
OPR>
7:58:29 Printer 2 -- End --
Job DAILY Req #11 for PAYROLL [2,147]
OPR>
7:59:01 Printer 2 -- Begin --
Job WEEKLY Req #12 for PAYROLL [2,147]
OPR>
.
.
.
OPR>
8:09:10 Printer 2 -- End --
Job YEARLY Req #20 for PAYROLL [2,147]
OPR>SHUTDOWN PRINTER 2 <RET>
OPR>
8:10:12 Printer 2 -- Shutdown --
OPR>SET TAPE-DRIVE MTA0: AVAILABLE<RET>
7-54
GALAXY SOFTWARE TASKS
OPR>
8:12:30 Device MTA0 -- Set Available --
OPR>
7.11 CONTROLLING LAT DEVICES
The LAT Control Program (LCP), a subset of OPR, allows you to control
and monitor LAT (local area transport) activity. A LAT device allows
simultaneous connections to services offered by one or more processors
in a local area network.
To enter LCP, use the OPR command, ENTER, as follows:
OPR>ENTER LCP<RET>
LCP>
To exit LCP and return to OPR command level, use the RETURN command as
follows:
LCP>RETURN<RET>
OPR>
LCP commands allow you to:
o Clear LAT parameters.
o Set LAT parameters.
o Show all outgoing active or pending LAT connections and
provide information about requests waiting to be connected to
application terminals.
o Change various counter settings to zero.
The commands that control LAT devices are:
o CLEAR - Resetting parameters
o SET - Setting parameters
o SHOW - Displaying parameters
o START - Starting LAT activity
o STOP - Stopping LAT printers
7-55
GALAXY SOFTWARE TASKS
o ZERO - Clearing LAT counters
Another command, the DEFINE NODE command lets you define a destination
on a LAT server.
For more information about these commands see the TOPS-10 Operator's
Command Language Reference Manual.
7.11.1 Setting Parameters
The LCP SET command allows you to specify various LAT Control Program
parameters, as shown below.
o GROUPS - Specifies group numbers
o IDENTIFICATION - Specifies host identification
o MAXIMUM ACTIVE-CIRCUITS - Sets number of active circuits
o MAXIMUM SESSIONS - Sets number of LAT terminals
o MULTICAST-TIMER - Sets message interval
o NUMBER - Specifies host identification
o RETRANSMIT TIMER - Sets retransmission interval
o RETRANSMIT LIMIT - Sets retransmission limit
o SERVICE-NAME - Specifies services offered
----- Example -----
Use the SET command to set to 10 the maximum number of active circuits
that can exist at a node.
LCP>SET MAXIMUM ACTIVE-CIRCUITS 10<RET>
LCP>
15:16:38 LCP -- Set Accepted --
LCP>
7.11.2 Resetting Parameters
The LCP CLEAR command allows you to reset the following parameters set
by the SET command. Note that you cannot clear parameters for
NODE-NAME, or host NUMBER.
7-56
GALAXY SOFTWARE TASKS
o GROUPS - Clears group setting
o IDENTIFICATION - Clears identification
o MAXIMUM ACTIVE-CIRCUITS - Changes number of active circuits
o MAXIMUM SESSIONS - Resets number of LAT terminals
o MULTICAST-TIMER - Changes message interval
o NUMBER - Specifies host identification
o RETRANSMIT TIMER - Resets retransmission interval
o RETRANSMIT LIMIT - Resets retransmission limit
o SERVICE-NAME - Clears offered services
----- Example -----
Use the CLEAR command to reset the maximum number of active LAT
terminals allowed to connect to the local host.
LCP>CLEAR MAXIMUM SESSIONS<RET>
LCP>
10:28:10 LCP -- Clear Accepted --
LCP>
7.11.3 Starting LAT Activity
To notify all servers that the host is available and set the
LAT-ACCESS-STATE to ON, use the LCP START command.
----- Example -----
Use the START command to make the host available to all terminal
servers.
LCP>START<ESC>(Processing LAT sessions)<RET>
LCP>
9:20:52 LCP -- Start Accepted --
LCP>
7-57
GALAXY SOFTWARE TASKS
7.11.4 Stopping LAT Activity
To terminate all existing LAT terminal sessions and reject any new
connections from servers, use the LCP STOP command.
----- Example -----
Use the STOP command to terminate all existing LAT terminal sessions.
LCP>STOP<ESC>(Processing LAT sessions)<RET>
LCP>
12:22:19 LCP -- Stop Accepted --
LCP>
7.11.5 Changing LAT Counters
To change the counters for the combined LAT server totals to zero, use
the LCP ZERO COUNTERS command. Use the /SERVER switch to specify a
particular LAT server.
----- Example -----
Use the ZERO COUNTERS command to change the counters for the combined
LAT server totals to zero.
LCP>ZERO COUNTERS<RET>
LCP>
22:12:36 LCP -- Zero Accepted --
LCP>
7.11.6 Displaying LAT Activity
The SHOW command displays the following LAT information:
o Dynamic and permanent parameters
o Currently active terminal connections
o Server information
o Counter information
----- Example -----
7-58
GALAXY SOFTWARE TASKS
Use the SHOW command to display the dynamic and permanent LAT
parameters.
LCP>SHOW CHARACTERISTICS<RET>
LCP>
9:27:21 LCP -- Host Characteristics --
LAT Access State: ON
Host Name: KL1026
Host id: RN245A DEC10 TRISMP
Host Number: 110
Retransmit Limit: 60
Retransmit Timer: 1000
Multicast Timer: 30
Groups: 3:4,7,10,14,18,21
Current Maximum
------- -------
Allocated circuits: 3 20
Active circuits: 3 20
Sessions: 6 200
Service name Rating Identification
------------ ------ ---------------------
KL1026 1 RN245A DEC10 TRISMP
LCP>
7.12 CONTROLLING THE CARD READER
To handle a user's request to have card decks read into the system for
batch processing, you must start one (or possibly more) card reader(s)
at your site. The card reader may be automatically started at system
startup 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:
o Where the users place the card decks for submission
o When you load the card decks into the card reader for reading
o When and where you place the card decks and output from the
batch jobs to return to the users
The following sections explain how to use the OPR commands that enable
you to do these card reader tasks:
o Load and read cards through the card reader
o Stop the card reader from processing the current request
7-59
GALAXY SOFTWARE TASKS
o Continue to process a request that was stopped
o Prohibit the scheduling of card reader requests
o Display the status of the card reader
o Cancel a card reader job
7.12.1 Starting the Card Reader
To load and read cards through the card reader, use the START READER
command. Starting the card reader allows card jobs to be scheduled
for processing in the batch system. You can specify one or more unit
numbers with the START command. The SYSTEM.CMD file usually includes
this command.
To stop the scheduling of card batch jobs on a card reader, use the
SHUTDOWN command.
----- Example -----
Use the START READER command to start up card reader 0.
OPR>START READER 0 <RET>
OPR>
10:11:15 Reader 0 -- Startup Scheduled --
OPR>
7.12.2 Stopping the Card Reader
To stop one or more card readers, use the STOP command. This
temporarily STOPS the card reader from processing its current job.
You must use the CONTINUE command to allow the card reader to continue
reading the input job.
The default of the STOP command is IMMEDIATELY.
----- Example -----
Stop the current job on card reader 0 temporarily to fix a card in the
deck that was folded.
OPR>STOP READER 0 <RET>
7-60
GALAXY SOFTWARE TASKS
OPR>
18:24:09 Reader 0 -- Stopped --
OPR>
7.12.3 Continuing the Card Reader
To continue one or more card readers that were temporarily stopped
with the STOP command use the CONTINUE 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>
7.12.4 Shutting Down the Card Reader
To stop 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 shut down.
No further requests will be accepted.
----- Example -----
Shut down card reader 0 while a card deck is still being read into the
system.
OPR>SHUTDOWN READER 0 <RET>
OPR>
19:21:01 Reader 0 -- Shutdown Scheduled --
OPR>
When the card deck has finished being read into the system, the
following message appears:
OPR>
19:22:44 Reader 0 -- Shutdown --
7-61
GALAXY SOFTWARE TASKS
OPR>
7.12.5 Displaying Card Reader Status
To display the status of one or more card readers, use 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:
o The card reader unit number
o The current status of the card reader (either Idle or Active)
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 becomes a
batch request and can be displayed with the SHOW QUEUES BATCH-JOBS
command.
----- Example -----
Use 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>
7.12.6 Canceling a Card Reader Job
Occasionally, you may have to cancel a card job being read, for
example, when a card jam occurs in the card reader. To cancel a card
job, use the ABORT READER command, and specify the reader unit number
that is processing the job.
----- Example -----
7-62
GALAXY SOFTWARE TASKS
Use the ABORT command to cancel a card reader job because of a card
jam.
OPR>ABORT READER 0 <RET>
OPR>
12:32:09 Reader 0 -- Aborted --
OPR>
7.13 CONTROLLING CARD PUNCH, PAPERTAPE PUNCH, AND PLOTTERS
The commands and descriptions in this section are applicable only if
you have the hardware available at your installation.
Other output devices available to users are:
o CARD-PUNCH
o PAPER-TAPE-PUNCH
o PLOTTER
If your installation has one or more of these output devices, you must
set the parameters so that user requests can be processed. If your
installation has these devices, they may be automatically started at
system startup when the SYSTEM.CMD file is executed.
When the output from the card punch, paper tape punch, or plotter has
been completed, you must remove the output and distribute it. Your
system manager should set up the distribution method, which includes:
o When to distribute the output
o Where to put the output so that users can pick it up
The following sections explain the OPR commands that control the card
punch, paper tape punch, and plotter. These commands enable you to do
the following:
o Set the parameters for an output device
o Start output devices
o Stop output devices temporarily
o Continue processing on an output device
o Stop the scheduling of output requests on an output device
7-63
GALAXY SOFTWARE TASKS
o Display output device parameters
o Display the status of an output device
7.13.1 Setting Output Device Parameters
Normally, the SYSTEM.CMD file starts a defined number of output
devices at system startup. The SYSTEM.CMD file may also set
parameters for the output devices. However, you might have to start
an output device when a user requests output from the device. You may
also need to change the default parameters for the output device. The
following are the output device parameters that you can set:
o FORMS-TYPE name
Where "name" is the name of the forms type. The default is
NORMAL and is defined in the SPFORM.INI file for each device
type. Refer to the following section for the description and
use of the SPFORM.INI file.
o LIMIT-EXCEEDED-ACTION action
The "action" 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:
- ASK the operator to RESPOND with either PROCEED to finish
processing the output job or ABORT to cancel the output
job
- Always ABORT the output job when the limit has been
exceeded
- Always PROCEED, ignoring the output limit of the device
o OUTPUT-LIMIT number
The "number" of the OUTPUT-LIMIT parameter refers to the:
- Number of cards for the CARD-PUNCH
- Number of feet for the PAPER-TAPE-PUNCH
- Number of minutes for the PLOTTER
These parameters (all set by GALGEN) default to the following
if they are not included in the SYSTEM.CMD file at system
startup:
7-64
GALAXY SOFTWARE TASKS
- 500 cards for the CARD-PUNCH
- 500 feet for the PAPER-TAPE-PUNCH
- 30 minutes for the PLOTTER
o PRIORITY-LIMITS range
The "range" of the PRIORITY-LIMITS parameter refers to a
range of request priority numbers the output device accepts.
The priority range is 1:63. For example, if an output
request 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 will not be output until you
change the priority range for the device, or the priority of
the request. You can change the priority number of the
request with the MODIFY command (refer to Section 7.14.6).
When you set an output device to change the FORMS-TYPE,
LIMIT-EXCEEDED-ACTION, OUTPUT-LIMIT, or PRIORITY-LIMITS, the change
remains in effect until you change it with the same command, or until
the GALAXY system is reloaded.
----- Examples -----
1. Set the priority limits for the paper tape punch to be a
range of 20:63. This prevents processing of paper tape punch
requests with priority limits under 20 feet.
OPR>SET PAPER-TAPE-PUNCH 0 PRIORITY-LIMITS -<RET>
20:63 <RET>
OPR>
11:34:09 Papertape 0 -- Set Accepted --
OPR>
2. Set the limit exceeded action for the card punch to ignore
the output limit. This allows any card punch request,
regardless of its limit, to be completed on CDP0.
OPR>SET CARD-PUNCH 0 LIMIT-EXCEEDED-ACTION -<RET>
PROCEED <RET>
OPR>
12:23:18 Card-punch 0 -- Set Accepted --
OPR>
7-65
GALAXY SOFTWARE TASKS
7.13.2 Using the SPFORM.INI File
The SPFORM.INI file allows you to automatically set forms parameters
for the card punch, paper tape punch, and plotter on the basis of
device type and 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 device 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 one of
the following:
ALL all devices (the default)
REMOTE all devices at remote stations
/switch1... one or more switches available to you to
describe how the forms are to be used. Refer
to Tables 7-3 and 7-4 for a description of
switches. Table 7-3 describes the switches
that can be used for all the output device
types. Table 7-4 describes the switches that
can be used only for the plotter (PLT).
Table 7-3: SPFORM.INI Switches For All Device Types
______________________________________________________________________
Switch Meaning
______________________________________________________________________
/BANNER specifies whether banner units will be
output at the beginning of the request.
7-66
GALAXY SOFTWARE TASKS
/HEADER specifies whether header units will be
output at the beginning of each file.
/NOTE:xxx The xxx represents text (up to 50
characters) that is printed on the OPR
terminal when the forms are scheduled.
There is no default.
/TRAILER specifies whether trailer units will be
output at the end of each file.
______________________________________________________________________
Table 7-4: 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.
/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-size*nnn=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.
7-67
GALAXY SOFTWARE TASKS
______________________________________________________________________
The form name in SPFORM.INI need not be the actual name of a physical
form; however, it is usually close to the type of form (such as normal
forms, narrow forms, and so forth). When an output 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, the system 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
Suppose that NORM01 forms are currently mounted on the card punch and
a user makes a card 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 (NORM01). 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
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 REMOTE locator applies only if your installation has TOPS-10
ANF-10 network software.
Occasionally, SPROUT may encounter errors while processing the
SPFORM.INI file. For example, it may not be able to find a form type,
or to make a match based on form type and device. If this happens,
SPROUT displays an error message and gives you the option to proceed
with the job, or to requeue it.
7.13.3 Starting Output Devices
Normally, the SYSTEM.CMD file starts a defined number of output
devices at system startup. However, you might have to start an output
device when a user requests output from the device. If you do not set
any parameters for the device, the device uses the default parameters
set by your system manager with GALGEN.
7-68
GALAXY SOFTWARE TASKS
To start an output device, use the START command. You can start one
output device at a time or a range of devices.
----- 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>
7.13.4 Stopping Output Devices
To stop one or more output devices, use the STOP command. This
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:
o AFTER CURRENT-REQUEST
o AFTER EVERY-REQUEST
o IMMEDIATELY
The IMMEDIATELY argument is the default argument of the STOP command.
See the TOPS-10 Operator's Command Language Reference Manual for a
complete description of these arguments.
----- 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 -- STOP command queued --
OPR>
7-69
GALAXY SOFTWARE TASKS
7.13.5 Continuing Output Devices
Use the CONTINUE command to continue processing a 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>
7.13.6 Shutting Down Output Devices
To shut down the scheduling of output requests on an output device or
a range of output devices, use the SHUTDOWN command. If an output
request is currently being processed on the device, the request will
be completed before the output device is shutdown.
To stop the scheduling of jobs on the output device, use the SHUTDOWN
command.
----- Example -----
Shut down paper tape punch 0 while a request is still being output on
it.
OPR>SHUTDOWN PAPER-TAPE-PUNCH 0 <RET>
OPR>
19:21:03 Papertape 0 -- Shutdown Scheduled --
OPR>
When the request on the paper tape punch has completed being output,
the following message appears:
OPR>
19:23:55 Papertape 0 -- Shutdown --
OPR>
7-70
GALAXY SOFTWARE TASKS
7.13.7 Displaying Output Device Parameters
You can display the current output device parameters with the SHOW
PARAMETERS command, where device can be:
o CARD-PUNCH unit-number
o PAPER-TAPE-PUNCH unit-number
o 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:
o The unit number for the output device
o The output limits for the output device
o The type of forms for the output device
o The priority range for the output device
o The limit-exceeded-action for the output device
o The character device type for the output device
----- Example -----
Use 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>
7.13.8 Displaying Output Device Status
You can display the status of an output device or a range of output
7-71
GALAXY SOFTWARE TASKS
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 the specified types of devices on the system.
The output from the SHOW STATUS device command displays the following
for each device:
o The unit number of the output device
o The current status of the output device
o The job name currently active on the output device
o The request-id number of the job
o The name and PPN 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 job name, 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 units output so far. If you
do not need this information with the display of the SHOW STATUS
device command, specify the /SHORT switch.
----- Example -----
Use 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 [2,175]
Started at 13:35:23, punched 687 of 2000 cards
OPR>
7.14 CONTROLLING JOBS ON OUTPUT DEVICES
You can control any spooled output request, including those generated
by batch job processing. OPR commands enable you to do the following
to control jobs on the card punch, paper tape punch, or plotter:
7-72
GALAXY SOFTWARE TASKS
o Examine the queues
o Prevent output requests from processing
o Release previously held requests
o Cancel a job currently processing
o Cancel a job currently processing, and requeue to process at
another time
o Change the priority of an output request
o Delete output requests
7.14.1 Examining the Queues
When a user issues a request to an output device, the request is
placed in a queue where it waits for selection by the system for
processing. To examine the queues for output jobs, use the OPR
command SHOW QUEUES.
The SHOW QUEUES command displays the following information:
o The name of the output job
o The request-id number of the output job
o The output limit of the job
o The name of the user who requested the output
These four columns of the display appear whether the job is active
(currently being processed) or inactive (not being processed).
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 being
processed, the time that the output job started, and the total number
of cards or units processed so far.
The SHOW QUEUES has optional switches, /ALL and /SHORT. The /ALL
switch causes a display of all output jobs in the queue with their
appropriate column headers and any additional switches that were
specified when the user requested the output. If the user did not
specify switches, the /ALL switch displays the default values of those
switches. In addition, the /ALL switch displays any special
characteristics of the output job, such as HOLD. The /SHORT switch
displays only the job name, the request number, the scheduled run
time, and the user name. The /SHORT switch does not display column
headers or switches.
7-73
GALAXY SOFTWARE TASKS
NOTE
The asterisk (*) before the job name column (see
examples) indicates that the job is currently being
processed.
----- Examples -----
1. Use 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 [1,2] On Unit:0 /Seq:3320
Started at 10:47, plotted 25 of 100 units
MF20 19 200 P.TAYLOR [10,2715] /Unit:0
/Seq:3341
MF21 27 590 P.TAYLOR [10,2715] /Unit:0
/Seq:3349
MF22 31 300 P.TAYLOR [10,2715] /Unit:0
/Seq:3355
There are 4 jobs in the queue (1 in progress)
OPR>
2. Use 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 [1,2]
MF20 19 200 P.TAYLOR [10,2715]
MF21 27 590 P.TAYLOR [10,2715]
MF22 31 300 P.TAYLOR [10,2715]
OPR>
7-74
GALAXY SOFTWARE TASKS
7.14.2 Holding Jobs
To prevent output requests from being processed, use the HOLD command.
The HOLD command prevents current jobs in the queue from processing.
Any output requests 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 command:
o The request-id number, to hold a single output job
o The PPN for a particular user, to hold all output requests
queued by that user
o An asterisk (*), to hold all output requeusts queued by all
users
Use the RELEASE command to allow a held job to start again.
NOTE
You cannot HOLD an output job that is currently
active.
----- Example -----
Use the HOLD CARD-PUNCH-JOBS command to hold all card punch requests
for user BROWN, whose PPN is [27,5107].
OPR>HOLD CARD-PUNCH-JOBS [27,5107] <RET>
OPR>
09:01:54 -- 3 Jobs Held --
OPR>
7.14.3 Releasing Jobs
Use the RELEASE command to release an output job that has been
previously held with the HOLD command. To specify the request you
want to release, supply one of the following:
o A single request-id number to release one request
o A user name to release all requests for that user
o An asterisk (*) to release all requests for the same device
type
The RELEASE command reschedules the requests to be processed.
7-75
GALAXY SOFTWARE TASKS
NOTE
You must have one or more output devices started or in
the Idle state to get an output request processed.
----- Example -----
Use the RELEASE command to reschedule all output requests that were
previously held on the card punch.
OPR>RELEASE CARD-PUNCH-JOBS * <RET>
OPR>
10:38:09 -- 3 Jobs Released --
OPR>
7.14.4 Canceling Jobs
Occasionally, you may have to cancel an output job while it is
processing on a device. To cancel an output job that is processing,
use the ABORT command. Supply the device unit number and one of the
following switches:
o /PURGE
o /REASON
The /PURGE switch flushes the entire request from the system when it
is canceled. There are no trailer units processed when the job is
purged.
The /REASON switch allows you to enter one or more lines of text to
explain why the output request was canceled.
----- Example -----
Use 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 -- ABORT command queued --
OPR>
11:40:21 Plotter 0 -- End --
7-76
GALAXY SOFTWARE TASKS
OPR>
7.14.5 Requeuing Jobs
Occasionally, you may want to cancel an output job that is currently
being processed, and reschedule the same job to be processed later.
Use the REQUEUE command to hold the output request and abort its
current output.
For example, you might want to REQUEUE an output request that requires
more forms (cards, paper tape, or plotter paper) than are currently
available at your site. Thus, you REQUEUE the request to be processed
when the forms become available.
----- Example -----
Use the REQUEUE command to hold and cancel an output request 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. ^Z
OPR>
13:21:03 Card-punch 0 -- REQUEUE command queued --
OPR>
13:21:25 Card-punch 0 -- End- -
OPR>
7.14.6 Modifying Requests
To change the priority of an output request in the queue, use the
MODIFY device-REQUEST command, where device can be CARD-PUNCH,
PAPER-TAPE-PUNCH, or PLOTTER. To specify the request you want to
MODIFY, supply one of the following:
o A single request-id number to modify one request
o A user name to modify all requests for that user
o An asterisk (*) to modify all requests in the queue
You must specify a new PRIORITY number from 1 to 63. The higher the
number, the greater the priority.
7-77
GALAXY SOFTWARE TASKS
----- Example -----
Use the MODIFY command to change the priority of
PAPER-TAPE-PUNCH-REQUEST number from 135 to 63. This causes the
request to be the next one processed.
OPR>MODIFY PAPER-TAPE-PUNCH-REQUEST 135 PRIORITY 63 <RET>
OPR>
08:51:21 -- 1 Job Modified --
OPR>
7.14.7 Deleting Requests
To delete an output request from the queue, use the CANCEL
device-REQUEST command, where device can be CARD-PUNCH,
PAPER-TAPE-PUNCH, or PLOTTER. To specify the request you want to
delete, supply one of the following:
o A single request-id number to delete one request
o A user name to delete all requests for that user
o An asterisk (*) to delete all requests for the specified
device type
If you CANCEL an output request that is active, the output is
immediately terminated.
----- Example -----
Use the CANCEL command to CANCEL output request 186 from the card
punch output queue.
OPR>CANCEL CARD-PUNCH-REQUEST 186 <RET>
OPR>
10:25:11 -- 1 Job Canceled --
OPR>
7.14.8 Specifying the NEXT Job
You can force an output queue to schedule a particular request to be
processed immediately by using the NEXT command with CARD-PUNCH,
PAPER-TAPE-PUNCH, or PLOTTER as the keyword. This command starts
7-78
GALAXY SOFTWARE TASKS
processing the request immediately after the current request is
finished. The NEXT command does not alter the sequence of other
requests in the queue.
----- Example -----
A user (MORRILL) requests that his plotter job be moved to the top of
the queue to be processed when a plotter is available. You must
examine the plotter queue to obtain the request-identification number
for his request. Then you use the NEXT command to place his request
next in the queue.
OPR>SHOW QUEUES PLOTTER<RET>
OPR>
11:35:43 -- System Queues Listing --
Plotter Queue:
Job Name Req Limit User
-------- ------ ------- --------------------------------
* GRAPH 14 200 KOVALCIN, D [10,4635] On Unit:0
Started at 11:30:44, plotted 20 of 100 units
MF10 145 35 MAROTTA, M [27,5555]
SNOOPY 10 65 MORRILL [442,2520]
/After:29-MAY-88 12:00
There are 3 jobs in the queue (1 in progress)
OPR>NEXT PLOTTER 0 REQUEST-ID 10<RET>
OPR>
11:36:17 Plotter 0 -- NEXT request #10 scheduled --
OPR>
7.15 GALAXY CRASH RECOVERY PROCEDURES
GALAXY programs may stop performing useful work for one of the reasons
listed below. When a program stops performing, it is said to have
"crashed." This section describes how you can recover from a GALAXY
program crash.
Reasons for program crashes are:
o A monitor call (UUO) takes the error return and a stopcode
occurs.
o An error is detected by the built-in consistency checks
within the various components of GALAXY and a stopcode
occurs.
7-79
GALAXY SOFTWARE TASKS
o An undetected error eventually causes an illegal memory
reference or an address check and a stopcode occurs.
o A hung device condition causes the monitor to halt the
program or, if the program is detached, to put the program
into 'TO' (Terminal Output) state. The hung condition
usually indicates that a device has hardware problems, the
device controller is not functioning, or the CPU failed and
the failure was trapped by PULSAR.
o A component goes into Event-Wait (EW) state for an extended
length of time waiting for an event that is not likely to
occur. In this case, the program hangs in the UUO.
You should take one of the following steps if a GALAXY component
(program) crashes. Step 1 applies to a stopcode error. Step 2
applies to a hardware error, and Step 3 applies to a software error.
1. Attach to the crashed job, and save the crash in DSK:[3,3] as
xxxyyy.zzz, where:
xxx - indicates an abbreviated name of the component, such as
BAT for BATCON, or QSR for QUASAR
yyy - indicates the 3-character stopcode name
.zzz - indicates a 3-digit number (file extension) to
distinguish this file from others.
You must assign the entire six-character file name and
three-character file extension. Your installation should
maintain some form of crash recording method to establish the
naming convention.
After you have saved the crash, restart the component that
stopped, and detach the job.
2. Determine which device caused the monitor to terminate the
program. This can usually be found by checking on the CTY
for a ?HUNG DEVICE xxxx message. The xxxx should contain the
device. If the CPU is hung, the CTY message is ?CPU FAILED
FOR DEVICE xxxx. Next, run OPR and shut the device down
(SHUTDOWN command). A hung device error usually indicates a
hardware problem. Then restart the component, and detach the
job.
3. Check to make sure that ACTDAE is running. If not, perform
the ACTDAE crash recovery procedure described in Table 7-5
below, before continuing. Attach to the component, press
<CTRL/C>, restart the component, and detach the job.
7-80
GALAXY SOFTWARE TASKS
Table 7-5: GALAXY Component Crash Recovery Procedures
______________________________________________________________________
Component Recovery
______________________________________________________________________
ACTDAE If ACTDAE crashes, it can be restarted. However,
the restart may leave some users' jobs hung in
Event-Wait (EW) state. This happens because
messages queued up for ACTDAE will be lost during
the restart. Users will not be able to log in and
log out while ACTDAE is down. LPTSPL, SPROUT,
SPRINT, and QUEUE will hang in Event-Wait state.
Restarting ACTDAE may necessitate restarting other
GALAXY programs to restore full operational
capability. After restarting GALAXY programs,
process ACTDAE crashes using Recovery Step 1
described previously. (ACTDAE tasks are described
in Chapters 8 and 9.)
BATCON If BATCON crashes, first display the batch stream
status from OPR. For all active batch streams,
attach to the job that is running in that stream and
log it out. Logging the jobs out will not delete
the queue request. The batch job will be restarted
when BATCON is restarted. When all active batch
jobs have been logged out, attach to BATCON and
follow Step 1 described previously.
CDRIVE If CDRIVE crashes, all jobs currently being read
into card readers will be lost and will have to be
restarted. Restart CDRIVE and detach the job.
LPTSPL If LPTSPL crashes, it will automatically restart the
jobs that were being processed at the time of the
crash, from the page number recorded in the last
checkpoint. Follow one of the recovery steps
described previously, restart LPTSPL, and detach the
job.
OPR If OPR crashes, follow Step 1 of the recovery
procedures listed previously and restart OPR
(.R OPR). Be sure to start OPR in the same job slot
(that is, the same job number), if you are
restarting OPR without restarting ORION. Do not log
out the job that OPR was running in. Merely attach
to the job, halt it (press <CTRL/C> twice) then type
the monitor command START.
ORION If ORION crashes, it should be restarted in the same
7-81
GALAXY SOFTWARE TASKS
job slot (that is, it must have the same job
number). If DECnet is running, log out the Network
Management Listener (NML). ORION will restart it.
All OPR programs that were running at the time will
automatically reset the OPR/ORION link with the
first command typed to OPR. The first command that
reestablishes the OPR/ORION link will be lost. Any
DN60 Termination remote stations should be shut down
and restarted. (Refer to the TOPS-10 IBM
Emulation/Termination Manual for more information.)
Then follow recovery Step 1 described previously.
PULSAR If PULSAR crashes, users accessing MDA-controlled
tape drives and structures (devices that were
INITIALIZED and AVAILABLE, see Chapter 9) find that
their jobs have entered Event-Wait (EW) state. This
happens because messages queued up for PULSAR are
lost. These user jobs remain in this state after
you restart PULSAR because the restarted PULSAR does
not recognize any requests made before the crash.
Users will have to press <CTRL/C> to the MOUNT
command, DEALLOCATE the tape drive or structure, and
MOUNT it again, if appropriate. You should then
follow Recovery Step 1 described previously.
QUASAR If QUASAR crashes, user requests for
mounts/dismounts involving devices AVAILABLE to the
mountable-device allocation system will be lost. In
addition, programs using the QUEUE. UUO to interface
with QUASAR will hang in Event-Wait (EW) state.
To restart QUASAR, first determine which batch jobs
were running at the time of the crash, attach to
them, and log them out. Then attach to LPTSPL,
BATCON, CDRIVE, SPRINT, PULSAR, ORION, NEBULA and
SPROUT, press <CTRL/C> to each of them, and log them
out. QUASAR crashes should be processed using
Recovery Step 1 described previously. Now restart
QUASAR.
SPRINT If SPRINT crashes, it can be restarted without loss
of data. Follow one of the recovery steps described
previously, restart SPRINT, and detach the job.
SPROUT If SPROUT crashes, all jobs currently being
processed are restarted from the beginning of the
current file. Follow one of the recovery steps
described previously, restart SPROUT, and detach the
job.
______________________________________________________________________
7-82
CHAPTER 8
SCHEDULED SOFTWARE TASKS
This chapter describes the operating tasks that most installations
consider standard (or scheduled). You may be expected to perform some
of these tasks daily or weekly.
8.1 UPDATING THE MESSAGE OF THE DAY
The file SYS:NOTICE.TXT contains messages that are transmitted to
users as they log in. These messages, normally preceded by the date
on which they first appear, are usually brief and contain important
system information. For example, a message may specify the hours that
the system will be operating, the date when the disks will be
refreshed, or mention new system programs.
You can change NOTICE.TXT during the day to warn users of problems on
the system, to notify them of your intention to stop timesharing, or
to direct users to a more lengthy file for additional information.
However, you must be familiar with a text editor to do this.
To change, add, or delete a message in the file NOTICE.TXT, you can
log in under [1,2] and run a text editing program such as TECO.
(Refer to Introduction to TECO and the TECO Reference Manual.)
----- Example -----
In the following example, the operator wants to add a message on April
12th and delete a 3-line message dated March 18th. Remember, this is
only an example. You type everything that is underscored in the
following example:
.R TECO <RET> Run TECO and specify that file
*EBSYS:NOTICE.TXT$EY$$ SYS:NOTICE.TXT is to be updated.
ESCape prints as $.
*IAPR 12 THIS IS AN EXAMPLE <RET> The I command inserts into the file
8-1
SCHEDULED SOFTWARE TASKS
OF A 2-LINE MESSAGE. <RET> everything following it up to the
first ESCape. If the I command is
your first command to TECO, then
TECO makes the insertion at the
beginning of the file. You should
always insert new messages at the
beginning of NOTICE.TXT.
$$ Press the ESCape key twice to end
the insertion.
*SMAR 18$0L3K$$ The S command searches for the text
"MAR 18", which uniquely identifies
the old message, and deletes that
line plus the next two lines.
*EX$$ This command string causes a new
. NOTICE.TXT to be filed and the old
version to be saved as NOTICE.BAK,
and causes you to exit from TECO
and return to monitor level.
8.2 UPDATING THE ACCOUNTING FILE WITH REACT
The REACT program maintains the system authorization file
(SYS:ACTDAE.ACT). It enables you to add, delete, and change user's
LOGIN accounts.
CAUTION
Do not attempt to update the accounting file unless
you are completely familiar with the REACT program.
This program has no safeguards; therefore, a mistake
can have serious consequences.
Please see the TOPS-10 Software Installation Guide, for complete
information about REACT.
8.3 CONTROLLING USAGE ACCOUNTING
Usage accounting provides a method for collecting accounting
information such as CPU time, spooled requests, and disk space used,
by storing this information in the ACT:USAGE.OUT file. Usage
accounting is enabled when you bring your system up and remains
enabled. You cannot turn the usage accounting facility off. Refer to
the TOPS-10/20 USAGE File Specification for more complete information.
The OPR command, SET USAGE, allows you to write usage accounting
8-2
SCHEDULED SOFTWARE TASKS
information to the ACT:USAGE.OUT file from a temporary file. There
are two methods that can be used to do this with the SET USAGE
command.
1. Specify the BILLING-CLOSURE keyword with a time argument
(hh:mm).
2. Specify the FILE-CLOSURE keyword with one of the following
arguments:
o hh:mm (hours and minutes)
o DAILY hh:mm
o EVERY day hh:mm (where day is the name of a day in the
week)
o NOW
o mm-dd-yy hh:mm (where mm is the numeric month, dd is the
numeric day, and yy is the numeric year)
o /NO-SESSION-ENTRIES
Refer to the TOPS-10 Operator's Command Language Reference Manual for
a complete description of the above keywords, arguments, and switch.
Normally, the SET USAGE command is contained in your SYS:SYSTEM.CMD
file. Your system manager may have set up an accounting billing rate
for prime time users (for example, from 08:00 to 18:00) and for
off-prime time users (for example, from 19:00 to 07:00). There may
also be another accounting billing rate for weekend users.
WARNING
Consult with your system manager before you use the
SET USAGE command because this command changes time
parameters within the accounting database.
When you use the SET USAGE command, either through the
SYSTEM.CMD file or through the OPR terminal, the
command remains in effect indefinitely. You cannot
cancel or clear the SET USAGE command after it has
executed.
----- Example -----
On January 20, 1988, you use the SET USAGE command to cause file
closure every Friday at 4:00 P.M. (16:00 hours).
OPR>SET USAGE FILE-CLOSURE EVERY FRIDAY 16:00 <RET>
8-3
SCHEDULED SOFTWARE TASKS
OPR>
14:47:25 -- Will close usage file at 24-Jan-88 16:00:00 --
OPR>
On 24-Jan-88 and every Friday thereafter, the following message
appears at 4:00 P.M.:
OPR>
16:00:01 -- Message from the Accounting System --
ACT.USAGE.OUT closed and renamed to yymmdd.hhx
OPR>
The "yymmdd.hhx" in the above message specifies a numeric filename and
file extension in the format of year, month, day, hour, and sequence.
8.4 MAINTAINING SYSTEM CATALOG FILES
The CATALOG application in OPR enables you to maintain the system
catalogs and the information contained in those files. CATALOG's
functions include:
o Creating, changing, and deleting catalog entries
o Enabling and disabling automatic catalog updates
o Listing all volume-sets in a catalog file
The system catalog files contain information that is necessary for
GALAXY to avoid deadlocks when multiple jobs request the same
mountable device (disk or magnetic tape).
To enter CATALOG command level use the OPR command, ENTER, as follows:
OPR>ENTER CATALOG<RET>
CATALOG>
After you enter the CATALOG command subset, you can type a question
mark (?) to display a list of the CATALOG commands. See the TOPS-10
Operator's Command Language Reference Manual for more information
about CATALOG commands.
8.5 SAVING ACCOUNTING FILES
On a regular basis, you should save the system accounting files, which
contain all the data necessary to compute user charges. To save the
accounting files, all other system jobs must be logged off with only
8-4
SCHEDULED SOFTWARE TASKS
one [1,2] job left. Save the accounting files on both a magnetic tape
and a private disk pack. These files are used by billing programs to
produce computer usage bills. To save accounting files, type
everything that is underscored in the following dialog:
.RENAME mmddyy.FCT[1,2]=FACT.*[1,4] <RET>
Rename the accounting files from SYS:
to [1,2].
.MOUNT xxx <RET> Mount the private pack xxx.
.R PIP <RET>
*xxx:[PPN]/X/B=mmddyy.FCT[1,2] <RET>
Run the PIP program to transfer the
accounting files to the area [PPN] on
the private pack, xxx.
.MOUNT MT:/SCRATCH<RET> And mount a scratch tape on it.
.R BACKUP <RET> Run the BACKUP program.
/TAPE MT: <RET> Identifies logical tape MT.
/REWIND <RET> Rewind to the beginning of the tape.
/SAVE [1,2]*.FCT <RET> Save all the files with the extension
.FCT in the [1,2] area.
!1,2 DSKB BACKUP prints the UFD as it begins to
save files from that area.
.
.
.
"Done The SAVE is complete.
8.6 SAVING GRIPE FILES
During timesharing, the user can run the GRIPE program. This program
allows the user to enter suggestions, complaints, or other comments,
which are then stored in disk files named CMPnnn.CMP on area [3,3].
These text files may be copied to another disk area, or printed on the
line printer.
8.7 RIDDING THE SYSTEM OF DETACHED JOBS
The following procedure eliminates detached jobs that have been
inactive for a long period of time. Such inactive jobs may be using
up job slots needed by users, however, this action should not be taken
without the instruction of your system manager.
1. Run SYSTAT at different times, to determine the inactive jobs
that must be eliminated.
2. Attach to the inactive jobs from a TTY at which you are
logged in under [1,2], and attempt to log them off. To do
this, type everything that is underscored in the following
8-5
SCHEDULED SOFTWARE TASKS
dialog:
.ATTACH 5[40,111] <RET>
Attach to job 5, user [4,111].
From Job 2 Monitor response.
.<CTRL/C> Type <CTRL/C> to return to the monitor.
.K/F <RET> Log out the job.
3. Make a note on the SYSTAT output concerning the action taken
and file the SYSTAT in the System Logbook.
If the user is over quota or if his job has eternal ENQ. locks set,
you will be unable to log out the job. In that case, perform the
following steps:
1. Type everything that is underscored in the following dialog:
.<CTRL/C> Type <CTRL/C> to return to the monitor.
.DETACH <RET> Detach the job.
From Job 5 Monitor response.
2. Make a note on the SYSTAT that the job could not be logged
off and file the SYSTAT in the System Logbook.
The ATTACH command detaches your current job and attaches your
terminal to a detached job. To reattach your terminal to your
original job, make note of your job number before you use the ATTACH
command. After logging out or detaching the user's job, attach to
your original job by typing:
.ATTACH jobn [1,2]
Password: <RET>
Refer to the TOPS-10 Operating System Commands Manual for more
information about the monitor commands ATTACH and DETACH.
8.8 BACKING UP THE SYSTEM (DAILY)
At a scheduled time each day, you should run the BACKUP program to
save on magnetic tape all files that have been created or modified
since the same time the day before. This is called an incremental
save. (Refer to Appendix E for a complete discussion of BACKUP.)
You should file the log output of all BACKUP procedures in the System
Logbook. If files are lost during a system crash, you can refer to
the BACKUP logs to determine which magnetic tapes contain the files to
be restored. This assumes that you have set up some system of
externally labeling the magnetic tapes and that you enter
corresponding tape identification in the logs.
8-6
SCHEDULED SOFTWARE TASKS
To save all the files that have been created or modified since 6 PM
yesterday, type everything that is underscored in the following
dialog:
.MOUNT MT:/SCRATCH<RET> Mount a tape for the BACKUP program.
.R BACKUP <RET> Run the BACKUP program.
/TAPE MT: <RET> Identifies logical tape MT.
/REWIND <RET> Rewind to the beginning of the tape.
/MSINCE:YESTERDAY:18:00 <RET> Limit the SAVE to all files created or
modified since 6 PM yesterday.
/SAVE <RET> Save the files.
!1,2 DSKB BACKUP prints each UFD as it begins to
save files from that area.
.
.
.
"Done The SAVE is complete.
8.9 BACKING UP THE SYSTEM (WEEKLY)
Once a week, you should use the BACKUP program to save the entire
contents of the system disk structures on magnetic tape. This is
called a full save. Once you have saved the files, you can refresh
the disk structures. (Refer to the following section for information
on refreshing disk structures.) Then you can restore the files from
the tapes.
The following is an example of one way to save the contents of the
system disks. Perform the following steps:
1. Run OPR and use the SET KSYS command to stop timesharing.
.R OPR<RET>
OPR>SET KSYS +0:05<RET>
OPR>
2. When timesharing stops, type everything that is underscored
in the following dialog:
.MOUNT MT:/SCRATCH<RET>
Mount a tape for the BACKUP program.
.R BACKUP <RET> Run the BACKUP program.
/TAPE MT: <RET> Identifies logical tape MT.
/REWIND <RET> Rewind to the beginning of the tape.
/LIST DSK: <RET> Request a directory listing of disk.
/SAVE DSKB: <RET> Save system disk.
!1,2 DSKB BACKUP prints each UFD as it begins to
save files from that area.
.
.
8-7
SCHEDULED SOFTWARE TASKS
.
"Done The SAVE is complete.
3. Repeat Step 2 to save other system disks.
If the data overflows a reel of tape, you will receive the following
message:
[BKPAMD Asking MDA for next volume]
Replace the full tape with a new tape and type GO.
8.10 REFRESHING FILE STRUCTURES
Two reasons that you may want to refresh file structures are:
1. To free up lost disk space.
Lost disk space is space that was allocated to a user who was
unable to use it before the system crashed. When the system
came back up again, the space was still allocated. However,
because the owner did not close the file before the crash, no
one owns it. Therefore, it is lost.
2. To reorganize the disk.
Over time, the system files become fragmented as they are
used. Each of these fragments contain retrieval pointers.
Retrieval pointers not only take up space on the disk, but
the CPU wastes overhead time finding them.
When you save all files, refresh the disk, and restore the
files to the disk. The system consolidates the fragments and
removes the extra retrieval pointers. Therefore, the disk
contains the same files as before, but the files are better
organized.
There are two ways to refresh file structures:
1. Reload the monitor. (See Chapter 5).
2. Run the system executable file (usually SYSTEM.EXE).
Either of these methods starts the system startup dialog. For more
information refer to the ONCE dialog in the TOPS-10 Software
Installation Guide.
8-8
SCHEDULED SOFTWARE TASKS
8.11 ANALYZING SYSTEM FILE STRUCTURES WITH DSKLST
The DSKLST program compiles and prints an analysis of the contents and
the current status of the system file structures. It provides the
information with which you and the system administrator can do the
following:
o Analyze the efficiency of disk space usage.
o Detect and diagnose problem areas on disk.
o Determine when to refresh the various disk areas.
o Determine optimum cluster sizes for assigning and releasing
file storage space.
To run DSKLST while logged in under [1,2], type everything that is
underscored in the following dialog:
.ASSIGN DSK LPT <RET> Assign the disk to receive the DSKLST
output rather than the printer.
.R DSKLST <RET> Run the DSKLST program, which will
prompt with an asterisk.
FOR HELP TYPE /H
* <RET> Press RETURN to print all DSKLST output
for all structures.
*<CTRL/C> Type CTRL/C to return to the monitor.
.PRINT DSKLST.LST <RET> Queue the report to be printed.
If you include the above steps in a batch control file such as
DSKLST.CTL, you can submit the job to run under batch with the
command:
.SUBMIT DSKLST <RET>
Refer to the DSKLST Specification in the TOPS-10 Software Notebook Set
for more information on DSKLST.
8.12 OBTAINING DISK ERROR INFORMATION WITH DSKRAT
The DSKRAT program compiles and prints damage-assessment information
for disk file structures. It can also free up lost disk space. Lost
disk space is space that was allocated to a user who was unable to use
it before the system crashed. When the system came back up again, the
space was still allocated. However, because the owner did not close
the file before the crash, no one owns it. Therefore, it is lost.
To recover lost disk space, you must run DSKRAT standalone with the
SCHED bit set to 1. If no other jobs are running, DSKRAT will then
create a file called LSTBLK.nnn in the [1,2] area. After DSKRAT
8-9
SCHEDULED SOFTWARE TASKS
exists to return all lost disk space to the free usage pool, you may
delete LSTBLK.nnn.
To run DSKRAT while logged in under [1,2], type everything that is
underscored in the following dialog:
.ASSIGN DSK LPT <RET> Assign printer output to the disk.
.ASSIGN str STR <RET> Assign the logical device name STR to
the file structure "str" that you are
analyzing.
.R DSKRAT <RET> Run the DSKRAT program.
.PRINT RAT.LST <RET> Queue the report to be printed.
If more than one structure is to be analyzed, repeat the last three
lines of this dialog using different "str"s.
To run this procedure under batch, include the above command sequence
in a file DSKRAT.CTL and submit it to batch with:
.SUBMIT DSKRAT.CTL <RET>
Refer to the DSKRAT Specification in the TOPS-10 Software Notebook Set
for more information on DSKRAT.
8-10
CHAPTER 9
UNSCHEDULED SOFTWARE TASKS
The tasks in this chapter are considered unscheduled software tasks
because they are performed as needed. If any of these tasks should be
scheduled at your installation, decide upon a schedule for them with
your system manager.
9.1 CONTROLLING THE ORION LOG 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 file contains all OPR-to-ORION commands and transactions
performed at the operator's console. The following OPR commands
control this logging facility:
o ENABLE LOGGING
o DISABLE LOGGING
o CLOSE LOG
If your installation has ANF-10 network software, only an operator
with HOST or SYSTEM privileges can issue any of the above OPR
commands.
The Centralized Logging Facility is on by default at system start-up,
but can be disabled by placing the DISABLE LOGGING command in the
SYSTEM.CMD file, or by using this command at OPR command level.
To enable the Centralized Logging Facility again, use 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 file and automatically
9-1
UNSCHEDULED SOFTWARE TASKS
creates a new one. When the CLOSE LOG command is issued, the log file
is closed and renamed to OPERAT.nnn. The file extension of closed log
files is numbered sequentially starting from 001. You can then print
the log file on the line printer to obtain a hard copy of all the
ORION messages for a given time period.
The CLOSE LOG command also enables you to include date and arguments
that specify a future time to close the log file. Use the SHOW QUEUES
EVENTS command to display pending ORION log file closure times.
The name of the log file is determined when your system manager runs
GALGEN. (Refer to the TOPS-10 Software Installation Guide for the
GALGEN procedures.) The default file name is OPERAT.nnn.
----- Examples -----
1. Disable the logging facility for a period of time while the
system is operating stand-alone.
OPR>DISABLE LOGGING <RET>
OPR>
08:52:12 -- ORION Logging Disabled by JOB 6 OPERATOR
[1,2] at terminal 14 --
OPR>
2. Close the current log file and automatically create a new log
file.
OPR>CLOSE LOG <RET>
OPR>
9.2 DUAL PATH ACCESS TO MAGTAPE
It is possible to share a string of TU70, 71, 72, or TU78/79 tape
drives between two systems. In the case of the TU70, 71, 72, a TX03
switch is installed in the TX01/02 controller. In the case of the
TU78/79s, the TM78/79 controller can be dual-ported between RH20s on
two separate systems, and A/B switch position is employed on the
drives similar to that used on Massbus disk drives.
9.3 INITIALIZING TAPES
Occasionally you may be asked to initialize and/or reinitialize a
magnetic tape. When you initialize a tape, the system writes specific
9-2
UNSCHEDULED SOFTWARE TASKS
information on the tape pertaining to the identification of the tape.
When you initialize a tape specifying an ANSI or EBCDIC standard
label, the system writes the following information on the tape:
o A standard volume label that contains the volume
identification (volid) of the tape
o Standard header and trailer labels. Later, when a file is
written on the tape, these labels contain specific
information pertaining to the file.
To initialize one or more tapes, use the following OPR command:
OPR>SET TAPE-DRIVE MTxn: INITIALIZE /switch1,/switch2,...RET>
where x is the tape controller identification and n is the tape drive
number.
Table 9-1 describes the valid switches for the SET TAPE-DRIVE
INITIALIZE command:
Table 9-1: SET TAPE-DRIVE INITIALIZE Switches
______________________________________________________________________
Switch Meaning
______________________________________________________________________
/ABORT allows the operator to abort a
tape initialization in progress.
This resets the tape drive to a
"normal" state, making it
available for user mount
requests.
/COUNT:nn specifies the number (nn) of
tapes to be initialized. The
/COUNT switch, when specified,
provides a mechanism for
initialization of multiple tapes
with the same attributes. After
initialization, the tape is
automatically unloaded and the
tape drive is ready to accept the
next tape to initialize. When
the number of tapes specified by
nn has been initialized, the tape
drive returns to the available
state.
9-3
UNSCHEDULED SOFTWARE TASKS
/DENSITY:nn specifies the density of the
tapes to be initialized. The
number (nn) can be 200, 556, 800,
1600, or 6250 BPI
(Bits-Per-Inch). If you do not
specify the /DENSITY switch, the
density defaults to the default
density for that drive.
/INCREMENT:nn specifies the numeric value (nn)
by which to increment the tape
volumes. This switch is valid
only when specified with the
/COUNT and /VOLUME-ID switches.
If you do not include this
switch, the default numeric value
is 1. For example, to initialize
a set of 10 tapes with volids
from 442000 through 442900, use
the switches /COUNT:10,
/INCREMENT:100, and
/VOLUME-ID:442000. Every tape
mounted on the tape drive is
initialized with the next
sequence number as specified by
the /INCREMENT switch.
/LABEL-TYPE:type specifies the type of label to be
written on the tape. The type
can be ANSI, EBCDIC, or
UNLABELED. The default label is
ANSI when you specify this
switch. If you do not specify
the /LABEL-TYPE switch, the
default is that specified in the
GALGEN dialog by the system
manager.
/OVERRIDE-EXPIRATION:YES or NO specifies whether to check for
expiration date of the data on
the tape. If you specify NO and
attempt to reinitialize a labeled
tape whose first file is not
expired, the system issues an
error message and does not
reinitialize the tape. If you
specify YES, each tape is
reinitialized unconditionally.
If you are initializing virgin
tapes, you should specify YES to
prevent the tape drive from
"running away" when PULSAR tries
9-4
UNSCHEDULED SOFTWARE TASKS
to read a label from the tape.
If you do not specify this
switch, the default is YES.
/OWNER:[PPN] specifies the project-programmer
number of the user who owns the
tape(s) to be initialized. If
you do not specify the /OWNER
switch, the tape is initialized
with no owner and a protection of
000.
/PROTECTION:nnn specifies a 3-digit octal number
as the protection number of the
tape. The number ranges from 000
(where anyone can use the tape)
through 777 (where no one can use
the tape). If you do not specify
the /PROTECTION switch, the
default is the standard file
protection (usually 057).
However, if you omit the /OWNER
switch, then the protection is
set to 0. The protection code is
described in the TOPS-10
Operating System Commands Manual.
/TAPE-DISPOSITION:condition specifies what is to be done to
the tape after it is initialized.
The condition can be either HOLD
or UNLOAD. If you specify HOLD,
the tape is initialized and is
not unloaded. If you specify
UNLOAD, the tape is initialized
and is unloaded from the tape
drive. The default is UNLOAD.
If a value greater than 1 is
specified by the /COUNT switch,
the /TAPE-DISPOSITION switch
applies to the last tape
initialized.
/VOLUME-ID:volid specifies a volume identification
for the tape. The volid must be
from 1 to 6 characters. The
volid must be made up of
alphanumeric characters only.
This switch is not necessary if
the tape is being initialized as
an unlabeled tape.
______________________________________________________________________
9-5
UNSCHEDULED SOFTWARE TASKS
When you use a tape drive for initializing tapes, the tape drive is
not available for user mount requests. When the initialization
process is complete, the tape drive automatically becomes available
for user mount requests. To force a tape drive out of initialize mode
prematurely, use /ABORT.
----- Examples -----
1. A user (JONES.J) has requested a tape mount of an ANSI labeled
tape with a volid of TAPE01 and has requested that you initialize
the tape first. The volume is initialized with ANSI labels and a
volid of TAPE01. The drive default for density (in this example,
1600 BPI) and protection (057) are used. When the tape is
mounted on the drive, the tape is initialized and the drive then
becomes available to the user (/TAPE-DISPOSITION:HOLD). Volume
recognition takes over and satisfies the mount request for
TAPE01.
OPR>
12:11:34 -- Magtape mount request #31 --
User: JONES.J [31,5723] Job# 39
Volume-set-name: MTA-DJ6YIH
Volume-ID Write Labels Track Density
--------- ------- ------ ----- -------
TAPE01 Enabled ANSI 9 1600
OPR>
Mount and ready the tape supplied by the user.
OPR>
9:04:38 Device MTA3 -- Unlabeled volume mounted --
Density 1600 BPI, write-Enabled
OPR>SET TAPE-DRIVE MTA3: INITIALIZE /LABEL-TYPE:ANSI- <RET>
/OWNER:[31,5723]/TAPE-DISPOSITION:HOLD/VOLUME-ID:TAPE01 <RET>
OPR>
9:05:12 Device MTA3 -- Volume initialized --
Volume Id:TAPE01, Label type:ANSI, Density:1600
Owner:[31,5723], Protection:057
OPR>
9:05:14 Device MTA3 -- Volume Initialization Complete --
Drive is available for use
OPR>
9:05:20 Device MTA3 -- Volume TAPE01 Reassigned --
User: JONES.J [31,5723] Job# 39
9-6
UNSCHEDULED SOFTWARE TASKS
OPR>
2. You initialize two tapes with ANSI-standard labels.
OPR>REC MTA3:
OPR>
6:17:58 Device MTA3 -- Unlabeled volume mounted --
Density 1600 BPI, Write-Enabled
OPR>SET TAPE MTA3:INITIALIZE /COUNT:2 /DENSITY:1600 /INCREMENT:1 -
/LABEL-TYPE:ANSI /OVERRIDE-EXPIRATION:YES /OWNER:[10,56] -
/PROTECTION:057 /TAPE-DISPOSITION:UNLOAD /VOLUME-ID:TEST00<RET>
OPR>
6:18:43 Device MTA3 -- Volume initialized --
Volume Id:TEST00, Label type:ANSI, Density:1600
Owner:[10,56], Protection:057
6:18:44 <6> Device MTA3 -- Please load next tape to be initialized --
Its volume identifier will be TEST01
Type 'RESPOND <number> ABORT' to terminate this operation
Type 'RESPOND <number> PROCEED' after completing requested operation
Mount and ready the next tape.
OPR>
6:19:20 --Message 6 canceled by user [1,2] job 8--
6:19:22 Device MTA3 -- Volume initialized --
Volume Id:TEST01, Label type:ANSI, Density:1600
Owner:[10,56], Protection:057
6:19:23 Device MTA3 -- Volume initialization complete --
Drive is available for use
6:19:23 Device MTA3 -- Offline --
9.4 HANDLING MAGTAPE 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. 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 -- Magtape mount request #nn --
User: username [PPN] Job# nn
Volume-set-name: name
Volume-id Write Labels Track Density
--------- ------- ------ ----- -------
9-7
UNSCHEDULED SOFTWARE TASKS
(tape conditions)
where:
hh:mm:ss specifies the time the operator received the
message.
request #nn specifies the request-id number assigned to the
mount request.
username specifies the name of the user who issued the
MOUNT command.
[PPN] specifies the user's project-programmer number.
Job# nn specifies the job number assigned to the user upon
logging onto the system.
Volume-set-name: name
specifies the volume set name the user assigned in
his MOUNT command.
Volume-id specifies the volid of the tape. The user assigns
this volid with the /REELID switch in the MOUNT
command.
Write specifies whether the tape is Enabled
(write-enabled) or Locked (write-locked).
Labels specifies the type of label, either ANSI, EBCDIC,
NO (for no labels), or BYPASS (to bypass label
processing).
Track specifies the tape tracks, either 7 or 9.
Density specifies the tape density in Bits-Per-Inch (BPI).
The densities can be either 200, 556, 800, 1600,
or 6250.
If the user includes a remark with the /REMARK switch in the MOUNT
command, you can display the remark when you use the SHOW QUEUES
MOUNT-REQUESTS command with the /ALL switch.
9.4.1 Displaying Tape Drive Status
If you need to find out the status of one or all of the tape drives on
your system, use the following OPR command:
OPR>SHOW STATUS TAPE-DRIVE MTxn: /switch <RET>
9-8
UNSCHEDULED SOFTWARE TASKS
where MTxn is optional, and identifies the tape controller and the
tape drive.
Instead of specifying a magnetic tape unit number you can use one of
the following switches:
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 (MTxnnn:)
o The number of tracks (7 or 9) that the drive is
set to read and write.
o The current status of the tape drive (Free,
Online, or Unavailable)
o The status of AVR (Automatic Volume Recognition)
on the tape drive (Yes = Enabled or No = Disabled)
o The write mode of the tape (Enabled or Locked)
o The volume identification of the tape on the drive
o The job number of the user who has the tape
assigned to his job.
o The name and PPN of the user who has the tape
assigned to his job.
/FREE displays the tape drives that are available (Free) to
you for mounting tapes. With this switch, the display
shows the drive unit number, the status, and whether
AVR is enabled or not.
If you do not give a physical device or one of the above switches, the
display defaults to the /ALL switch.
----- Examples -----
1. Use the SHOW STATUS TAPE-DRIVE command.
OPR>SHOW STATUS TAPE-DRIVE<RET>
OPR>
10:14:28 -- Tape Drive Status --
9-9
UNSCHEDULED SOFTWARE TASKS
Drive Trk Status AVR Write Volume Job User
------ --- ----------- --- ------- ------ --- ------------------
MTA0 9 Free Yes
MTA1 9 Free Yes
MTA2 9 Online Yes Enabled TEST01 185 BROWN.E [27,5107]
MTA3 9 Unavailable No
MTA4 9 Online Yes Locked PIPTAP 235 RON LUSK [30,5524]
MTA5 7 Free Yes
OPR>
2. Use the SHOW STATUS TAPE-DRIVE command with the /FREE switch.
OPR>SHOW STATUS TAPE-DRIVE /FREE <RET>
OPR>
10:18:45 -- Tape Drive Status --
Drive Trk Status AVR
------ --- ----------- ---
MTA0 9 Free Yes
MTA1 9 Free Yes
MTA5 7 Free Yes
OPR>
9.4.2 Controlling Tape Drive Volume Recognition (AVR)
Volume recognition 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 volume recognition enabled, PULSAR
automatically reads the volume identifier from the volume label.
If your system is using labeled tapes, then it is likely that volume
recognition has been enabled. Volume recognition is enabled by
default. If you need to disable volume recognition for one or all
tape drives, use the following OPR command:
OPR>DISABLE VOLUME-RECOGNITION argument <RET>
where the argument can be:
MTxn: (for a specific tape drive)
or
TAPE-DRIVES (for all tape drives)
9-10
UNSCHEDULED SOFTWARE TASKS
One reason for disabling volume recognition on a tape drive is to
avoid runaway tapes when you are initializing tapes. When you disable
volume recognition, OPR prints the following message confirming that
volume recognition has been disabled:
hh:mm:ss Device MTxn -- Volume Recognition is Disabled --
In addition, you can check the status of the tape drive with the OPR
command SHOW STATUS TAPE-DRIVE /ALL.
You can enable volume recognition for one or more of the tape drives
on your system by using the following OPR command:
OPR>ENABLE VOLUME-RECOGNITION argument <RET>
----- Example -----
Disable volume recognition for tape drive 0 (MTA0:).
OPR>DISABLE VOLUME-RECOGNITION MTA0: <RET>
OPR>
12:23:45 Device MTA0 -- Volume Recognition is Disabled --
OPR>
9.4.3 Handling Labeled Tapes with AVR Enabled
When a user issues a MOUNT command for a labeled tape, you receive a
message similiar to the following:
OPR>
10:15:43 -- Magtape mount request #12 --
User: BROWN.E [27,5107] Job# 59
Volume-set-name: MTA-GY31OL
Volume-ID Write Labels Track Density
--------- ------- ------ ----- -------
100200 Locked ANSI 9 1600
OPR>
If the user has not already given you the tape, you must mount the
tape on a drive that has volume recognition enabled. When the tape is
brought on line, PULSAR automatically reads the label and prints a
message similar to the following on your terminal:
OPR>
10:15:43 Device MTA0 -- Labeled Volume Mounted --
9-11
UNSCHEDULED SOFTWARE TASKS
Density 1600 BPI, Write-Locked ANSI Label
OPR>
10:15:45 Device MTA0 -- Volume 100200 Reassigned --
User: BROWN.E [27,5107] Job# 59
OPR>
When finished using the tape drive, the user issues a DISMOUNT command
to release the tape drive. When this command is given, the system
prints a message similar to the following on your terminal:
OPR>
11:20:33 Device MTA0 -- Released --
User: BROWN.E [27,5107] Job# 59
OPR>
9.4.4 Handling Labeled Tapes with AVR Disabled
When a user issues a MOUNT command, you see the same mount request as
explained in Section 9.4.3. However, because volume recognition is
disabled, PULSAR does not automatically read the label. Therefore,
you must use the OPR command RECOGNIZE to inform QUASAR 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 volume recognition disabled, for example, MTA0:. After you bring
the tape on line, use the following command:
OPR>RECOGNIZE MTA0: <RET>
This command causes the labels on the tape to be read, and the tape to
be reassigned to the user request.
9.4.5 Handling 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
"No Labels." To assign the tape to a user, or to associate a volid
with the tape, use the OPR command IDENTIFY.
After you have mounted the tape on a free tape drive, use the IDENTIFY
command to associate the tape with the mount request. In addition,
you can use the IDENTIFY command to assign a volume identification
(volid) to the unlabeled tape.
9-12
UNSCHEDULED SOFTWARE TASKS
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 -- Magtape mount request #12 --
User: SMITH [10,5353] Job# 21
Volume-set-name: MTA-Y57HAB
Volume-ID Write Labels Track Density
--------- ------- ------ ----- -------
TEST01 Locked No 9 1600
OPR>
When you receive this request, locate and mount the tape on an
available tape drive and then use the IDENTIFY command in the
following formats.
OPR>IDENTIFY MTxn: VOLUME-ID TEST01 <RET>
OPR>IDENTIFY MTxn: REQUEST-ID 12 <RET>
where MTxn is the tape unit.
This procedure assumes that volume recognition is enabled. If volume
recognition is disabled on the tape drive, you must use the RECOGNIZE
command before either of the IDENTIFY commands shown above. This
permits QUASAR to know the tape is mounted on the tape drive, before
you identify it. For example,
OPR>RECOGNIZE MTxn: <RET>
where MTxn is the tape unit.
----- Example -----
A user requests that you mount an unlabeled tape and you comply.
OPR>
12:25:09 -- Magtape mount request #57 --
User: PACELLI [2,134] Job 43
Volume-set-name: MTA-JM05KL
Volume-ID Write Labels Track Density
--------- ------- ------ ----- -------
SCR123 Locked No 9 1600
OPR>
Mount and ready an unlabeled tape on tape drive MTA2:.
9-13
UNSCHEDULED SOFTWARE TASKS
12:27:32 Device MTA2 -- Unlabeled Volume Mounted --
Density 1600 BPI, Write-Locked
OPR>
Then reply to OPR with:
OPR>IDENTIFY MTA2: REQUEST-ID 57 <RET>
OPR>
12:28:33 Device MTA2 --Volume SCR123 Reassigned--
User: PACELLI [2,134] Job# 43
OPR>
9.4.6 Dismounting Tapes
When a user has completed the desired tasks with the mounted tape, the
user should use the monitor command DISMOUNT (or DEASSIGN) to rewind
and unload the tape from the tape drive. You can then remove the tape
from the tape drive.
NOTE
If the user does not use the DISMOUNT command, but
instead logs off the system, any mounted tapes are
automatically rewound and unloaded.
If a tape is mounted on a tape drive and it is not assigned to any one
user, you can use the OPR command DISMOUNT in the following format to
remove the tape from the tape drive:
OPR>DISMOUNT TAPE-DRIVE MTxn: <RET>
To check the status of the tape drives use the SHOW STATUS command.
If a tape is mounted, but is not assigned to any user, the display
shows the tape online without a request number, user name, or [PPN].
Do not press the UNLOAD button to rewind and unload the tape drive.
Always use the DISMOUNT TAPE-DRIVE command to remove tapes from tape
drives.
If, however, you do press the UNLOAD button to remove a tape and then
you mount another labeled tape on the same drive, you must use the
RECOGNIZE command to force the system to recognize the tape.
----- Examples -----
1. Use the DISMOUNT command to rewind and unload a tape that is
mounted, but not assigned to any user.
9-14
UNSCHEDULED SOFTWARE TASKS
OPR>DISMOUNT TAPE-DRIVE MTA3: <RET>
OPR>
10:36:54 Device MTA3 -- Unloading --
OPR>
2. If you previously pressed the UNLOAD button on a tape drive
and then mounted a labeled tape, you must use the RECOGNIZE
command to force the system to recognize the labeled tape.
OPR>RECOGNIZE MTA2: <RET>
OPR>
10:07:02 Device MTA2 --Volume 100100 Mounted--
ANSI Labels, 1600 BPI, Write-Enabled
OPR>
9.4.7 Canceling Tape Mount Requests
If you are unable to satisfy a user's mount request, you can cancel
the mount request by using 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, use the following command:
OPR>CANCEL MOUNT-REQUEST nn /REASON:I CANNOT FIND THE TAPE <RET>
where "nn" is the request number assigned to the mount request.
----- Example -----
Cancel mount request 204.
OPR>CANCEL MOUNT-REQUEST 204 /REASON:I CANNOT FIND THE TAPE <RET>
OPR>
11:49:19 -- Mount Request 204 Canceled --
OPR>
9.4.8 Setting Tape Drives Available or Unavailable
When you start the system, all tape drives are under control of the
9-15
UNSCHEDULED SOFTWARE TASKS
mountable device allocation system. However, there may be times when
you want to gain control of the tape drive. To do this, use the
following command:
OPR>SET TAPE-DRIVE MTxn: UNAVAILABLE <RET>
OPR prints:
Enter text and terminate with ^Z
This allows you to enter a comment explaining why you are setting the
tape drive unavailable.
When you use this command, MDA releases control of the tape drive and
users can assign the drive to their jobs by using the TOPS-10 command
ASSIGN. To return control of the tape drive to MDA, use the following
command:
OPR>SET TAPE-DRIVE MTxn: 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 ^Z
OPR>
12:23:00 Device MTA0 -- Set Unavailable --
OPR>
9.5 HANDLING FILE STRUCTURE AND DISK-DRIVE TASKS
OPR commands help you to control structures and disk-drives. With OPR
commands, you can do the following:
o Enable volume recognition
o Force the system to recognize a structure or disk-drive
o Dismount or remove a structure
o Lock structures to prevent users from mounting them, and
unlock structures
o Cancel mount requests that you cannot satisfy
9-16
UNSCHEDULED SOFTWARE TASKS
o Display the status of structures
o Display the status of disk-drives
o Control structure-recognition
o Control volume-recognition
o Examine the mount requests queue
The following sections describe each of the above commands to assist
you in the control of file structures and disk drives.
9.5.1 Answering Structure Mount Requests
When a user issues a request to mount a structure with the MOUNT
command, one or both of the following conditions must be present:
o The structure must be defined in the system catalog file.
See Section 8.4 for more information about the system catalog
file.
o All packs in the structure must be mounted and ready.
When either of these conditions are present, the following message
appears on your OPR terminal to inform you of the user request. A
list appears immediately following the message, displaying the
structure request and where the structure is mounted.
OPR>
hh:mm:ss Device str -- Structure Mount Request #nn --
From User: username [PPN] Job# nn
Unit Volume Type Drive
------ ------ ---- -----
(List showing where structure may be mounted)
where:
hh:mm:ss specifies the time the operator received the
message.
Request #nn specifies the request number assigned to the
mount request.
username [PPN] specifies the name and project-programmer number
of the user who issued the MOUNT request.
Job# nn specifies the job number the user was assigned
when the user logged onto the system.
9-17
UNSCHEDULED SOFTWARE TASKS
The display provides the following information:
o The unit identification
o The volume identification
o The type of drive (RP04, RP06, or RM03)
o The disk drive identification
If the requested structure consists of more than one volume disk pack,
all volumes are displayed in this list.
If the structure is defined in the system catalog file, but not
mounted and in the ready state, this list displays available disk
drives, along with the type, volume, and unit.
You must answer a MOUNT request by doing one of the following:
o If the structure is not mounted and ready, you must mount and
prepare the structure on an available disk drive.
If volume recognition is enabled for both structures and disk
drives, the system automatically recognizes the structure and
satisfies the mount request.
o If volume recognition is disabled for either structures or
disk drives, you must use the RECOGNIZE command to OPR to
force the system to recognize the structure mount.
Once the structure is known by the system, OPR prints a message
similar to:
OPR>
hh:mm:ss -- Structure str Mounted --
OPR>
OPR prints the preceding message only after you have physically
mounted all the packs in the structure. For example, if a structure
mount request exists for structure DSKR:, and DSKR: consists of two
packs, both packs must be mounted to satisfy the mount request.
NOTE
MDA continues to process 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.
9-18
UNSCHEDULED SOFTWARE TASKS
----- Examples -----
1. In this example, a user wants to MOUNT a structure that is
not defined in the system catalog file and volume recognition
is disabled. In this case you must know in advance of the
structure mount so that the user does not receive an error
message for his mount request. Before the request is given,
you must mount and prepare the structure. Then you must use
the RECOGNIZE command to have the system recognize the
structure mount and satisfy the mount request.
OPR>
13:12:10 Device ECB1 -- Structure Mount Request #221 --
From User: BROWN,A [27,5107] Job# 68
Unit Volume Type Drive
------ ------ ---- -----
ECB10 ECB10 RP04 RPA0
OPR>RECOGNIZE RPA0: <RET>
OPR>
13:13:13 Device RPA0 -- Volume ECB10 for Structure ECB1 Mounted --
OPR>
13:13:15 -- Structure ECB1 Mounted --
OPR>
2. In this example, a user requests that structure DSKN: be
mounted. DSKN: is defined in the catalog list but is not
currently mounted and ready.
OPR>
12:40:15 Device DSKN -- Structure Mount Request #37 --
From User: PACELLI,V [2,134] Job# 27
Unit Volume Type Drive
------ ------ ---- -----
DSKN DSKN0 RP06 RPB1
OPR>
You can now physically mount DSKN: and make the system recognize the
structure as being on line. Request 37 is satisfied automatically,
and the user is notified.
OPR>
12:43:33 Device RPB1 -- Volume DSKN0 for Structure DSKN Mounted --
OPR>
9-19
UNSCHEDULED SOFTWARE TASKS
12:43:35 -- Structure DSKN Mounted --
OPR>
9.5.2 Mounting a Structure with MOUNT
If structure recognition is disabled, or you need to mount a structure
with an alias, you can use the OPR command MOUNT. For example, to
mount a structure called DSKX: with structure recognition disabled,
use the command:
OPR>MOUNT STRUCTURE DSKX: <RET>
OPR>
12:17:20 -- Structure DSKX Mounted --
OPR>
NOTE
If volume and structure recognition are enabled and
the structure is defined in the system catalog file,
you need not use the MOUNT command, because the system
recognizes the structure when it becomes ready
(mounted and spinning).
If volume and structure recognition are disabled, you
must use the RECOGNIZE command and then the MOUNT
command.
If you want to mount a structure with an alias, and the structure is
the first structure by that name, you must disable volume and
structure recognition before giving the MOUNT command and mounting the
structure. After you have mounted and readied the structure, you
should re-ENABLE structure and volume recognition.
In addition, the MOUNT command allows you to specify an alias name for
the structure when two file structures of the same name are to be
mounted. For example, if DSKA: is already mounted and you must now
mount another structure of the same name, you can use the following
command:
OPR>MOUNT STRUCTURE DSKA: ADSK: <RET>
OPR>
2:32:09 -- Structure ADSK Mounted --
OPR>
9-20
UNSCHEDULED SOFTWARE TASKS
When you assign an alias name to a structure, the physical name of the
structure (which is written in the HOM blocks of the structure) is not
changed.
WARNING
MDA strictly enforces unique volids on both disks and
tapes. Therefore, you cannot mount two identical
DSKAs. You can mount two DSKAs if the volids in the
HOM blocks are not identical.
To examine the mounted structures and their alias names, use the OPR
command SHOW STATUS STRUCTURES (refer to Section 9.5.5).
9.5.3 Controlling Structure Dismount Requests
When you use a valid DISMOUNT command, OPR prints:
hh:mm:ss --Structure str Dismounted--
From Unit: xxxn
where:
str specifies the file structure name.
xxxn specifies the disk drive name.
When a user dismounts a structure, you are not notified unless the
user specified the /REMOVE switch in his DISMOUNT command. (Refer to
the TOPS-10 Operating System Commands Manual for additional
information on the DISMOUNT command.)
When you issue the OPR command DISMOUNT to dismount a file structure,
there are two additional considerations you must acknowledge. They
are:
1. You can lock the structure before you dismount it to prevent
other users from accessing the structure.
2. If more than one user is currently using the structure, you
receive a message to which you must respond.
The next section explains the tasks involved in dismounting file
structures.
9.5.3.1 Locking and Unlocking Structures -
When your system is brought up, all mounted structures are unlocked so
9-21
UNSCHEDULED SOFTWARE TASKS
that users can access files on the structures.
However, if you must remove a structure during normal operation and
you want to prevent users from accessing the structure, you can
"lock-out" further jobs from access before dismounting the structure.
You can use the OPR command LOCK to accomplish this task.
All jobs and programs currently accessing the structure will continue.
When the jobs and programs complete, you can dismount the structure.
In addition, you can specify a date and time and an optional switch
/NOUNLOAD with the LOCK command. The date and time specifies when the
structure will be locked so that users cannot access it after the date
and time you specify. The /NOUNLOAD switch specifies that the
structure will not be removed, but will be locked from user access.
To reverse the effects of a LOCKed structure, you can use the OPR
command UNLOCK.
----- Examples -----
1. You want DSKZ: to be locked at 16:00 to change your
operation over to the evening production schedule.
OPR>LOCK DSKZ: 16:00 <RET>
OPR>
14:10:13 -- Structure DSKZ: --
LOCK set for 21-Feb-88 16:00
OPR>
2. To reverse the effects of DSKZ: being locked at 16:00:00,
you can unlock the structure.
OPR>UNLOCK DSKZ: <RET>
OPR>
16:01:07 -- Structure DSKZ: pending LOCK canceled --
OPR>
9.5.3.2 Removing a Structure with DISMOUNT -
To dismount and/or remove a structure from the system (perhaps to have
maintenance done on a drive, to run ONCE on a structure, or to mount
another structure), use the OPR command DISMOUNT.
In addition, you can specify the /REMOVE switch with the DISMOUNT
9-22
UNSCHEDULED SOFTWARE TASKS
command to automatically stop the structure for removal.
If users currently have the structure mounted, the following message
appears at your OPR terminal:
OPR>
hh:mm:ss <n> Device str: -- Problem removing structure --
Mount count = nn
RESPOND with ABORT (CANCEL) or PROCEED
OPR>
where:
hh:mm:ss specifies the time the message was sent to you
<n> specifies the message number that you must respond
to
str: specifies the structure name that other users are
accessing
nn specifies the number of users who have the
structure volume mounted
You must do one of the following:
o If you must dismount the structure immediately, you can send
a message to all other users that the structure is being
dismounted and then respond with PROCEED.
o If time allows, you can use the LOCK command to prevent other
users from accessing the structure and then, at the
appropriate time, dismount the structure.
o If you cannot dismount the structure or if you specified the
wrong structure in the DISMOUNT command, you can respond to
the message number with ABORT to cancel the dismount request.
When you respond with ABORT, OPR displays the following message:
hh:mm:ss -- Can't Dismount Structure str: --
If you respond with PROCEED, the structure is dismounted and OPR
displays following message:
hh:mm:ss -- Structure str: Dismounted --
From Unit: disk-unit-name
----- Examples -----
9-23
UNSCHEDULED SOFTWARE TASKS
1. You want to dismount a structure from system access so that
you can run ONCE on the structure. First, send a message to
all users that the structure is being dismounted by
operations.
OPR>SEND ALL DSKX: WILL BE DISMOUNTED IN 10 MIN. <RET>
OPR>
15:50:19
;;SYSTEM: - DSKX: WILL BE DISMOUNTED IN 10 MIN.
OPR>
In 10 minutes, use the DISMOUNT command to dismount DSKX:
from system use.
OPR>DISMOUNT STRUCTURE DSKX: <RET>
OPR>
16:00:13 <16> Device DSKX: -- Problem removing structure -
Mount count = 9
RESPOND with ABORT (CANCEL) or PROCEED
OPR>
Now use the RESPOND command to proceed with the dismount.
OPR>RESPOND 16 PROCEED <RET>
OPR>
16:01:18 -- Structure DSKX Dismounted --
From Unit: RPD4
OPR>
2. You need to dismount TEST: at 16:00 to change over to the
production shift. First, LOCK the structure to prevent
additional users from mounting it.
OPR>LOCK TEST: <RET>
OPR>
15:15:30 -- Structure TEST: Locked --
OPR>
At 16:00, dismount and remove structure TEST: from disk unit
RPD1.
OPR>DISMOUNT STRUCTURE TEST: /REMOVE <RET>
OPR>
9-24
UNSCHEDULED SOFTWARE TASKS
16:01:39 -- Structure TEST Dismounted --
From Unit: RPD1
OPR>
9.5.4 Canceling Structure Mount Requests
If you are unable to satisfy a user's structure 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.
----- Example -----
Cancel structure mount request 204.
OPR>CANCEL MOUNT-REQUEST 204 /REASON: NO AVAILABLE DISK DRIVES <RET>
OPR>
10:23:17 -- Mount Request 204 Canceled --
OPR>
9.5.5 Displaying Structure Status
You can display the status of the file structures with the SHOW STATUS
STRUCTURE command. With this command, you can specify one of the
following:
o The structure name, to display the status of an individual
disk file structure currently known to the system
o The /USERS switch, to display the status of each file
structure, along with the users currently accessing the
structure
If you do not specify either the file structure name or the /USERS
switch, the SHOW STATUS STRUCTURE command displays all structures
mounted and known to the system.
The output from this command displays:
o The name of the file structure
o The PPN of the owner, if the structure is private
9-25
UNSCHEDULED SOFTWARE TASKS
o The time (in hour and minutes) that the file structure was
mounted
o The number of free blocks on the file structure
o The mount count (the number of users currently accessing the
file structure) and the request count (the number of jobs
that have allocated the structure)
o The volume name of the disk file structure and its unit
number
o The disk drive type
o The disk drive name
With the /USERS switch specified, the output display includes the
user's name, [PPN], and job number.
----- Examples -----
1. Use the SHOW STATUS STRUCTURE command to display all disk
file structures.
OPR>SHOW STATUS STRUCTURE <RET>
OPR>
8:50:55 -- Disk File Structures --
Name Time Free Mount #Req Volume Type Drive Owner PPN
---- ----- -------- ----- ---- ---------- ----- ------ -------------
BLKX 6:53 15580 0 8 BLKX0 1/1 RP04 RPA2 31,5063
DSKA 6:53 26152 24 12 DSKA0 1/1 RP06 RPD0
DSKB 6:53 56460 12 0 DSKB0 1/2 RP06 RPD1
3 DSKB1 2/2 RP06 RPD2
DSKC 7:34 34960 24 0 DSKC0 1/2 RP06 RPB3
0 DSKC1 2/2 RP06 RPB4
DSKZ 8:41 721740 1 0 DSKZ0 1/1 RP06 RPE0 20,404
TEST --Waiting to be mounted--
Total of 6 file structures
(5 mounted, Total of 854892 free blocks)
OPR>
2. Use the SHOW STATUS STRUCTURE command with the /USERS switch
for DSKB:.
OPR>SHOW STATUS STRUCTURE DSKB: /USERS <RET>
OPR>
8:58:14 -- Disk File Structures --
9-26
UNSCHEDULED SOFTWARE TASKS
Name Time Free Mount #Req Volume Type Drive Owner PPN
---- ----- -------- ----- ---- ---------- ---- ----- -------------
DSKB 6:53 56460 12 0 DSKB0 1/2 RP06 RPD1
3 DSKB1 2/2 RP06 RPD2
Users: Job 10 User OPERATOR [1,2]
Job 20 User TONY WACHS [10,10]
Job 25 User YOUNG-KP [30,5221]
Job 21 User BROWN.E [27,5107]
Job 22 User QHALLYBURTON [10,5324]
Job 27 User RON LUSK [30,5524]
Job 28 User OPERATOR [1,2]
Job 31 User MAROTTA [27,5434]
Job 33 User CUSTER,L [27,2345]
Job 37 User TUCKER,B [27,5342]
Job 40 User CARLSON,A [10,3331]
Job 41 User GODSELL,S [10,334]
OPR>
9.5.6 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:
o /ALL to display FREE, MOUNTED, and unavailable disk drives
and their current status
OPR>SHOW STATUS DISK-DRIVES /ALL
o /FREE to display all disk drives that are available for file
structure mounts
OPR>SHOW STATUS DISK-DRIVES /FREE
o /MOUNTED to display those disk drives that are currently
mounted
and known to the system
OPR>SHOW STATUS DISK-DRIVES /MOUNTED
If you do not specify a switch, the SHOW STATUS DISK-DRIVES command
defaults to /ALL.
The SHOW STATUS DISK-DRIVES command with /FREE displays:
o The disk drive name
9-27
UNSCHEDULED SOFTWARE TASKS
o The auxiliary port name
o The disk drive type
o The status of the disk drive
o The AVR (automatic volume recognition) status (YES when AVR
is enabled, NO when AVR is disabled.)
The SHOW STATUS DISK-DRIVES command with /MOUNTED displays the same
information as the /FREE switch with the following additional columns.
Note that the status column shows the word "Mounted".
o The file structure name
o The volume name of the file structure
o The file structure unit number
The output display with /ALL show FREE, MOUNTED, and unavailable disk
drives.
----- Examples -----
1. Use the SHOW STATUS DISK-DRIVES command with the /FREE
switch.
OPR>SHOW STATUS DISK-DRIVES /FREE <RET>
OPR>
10:12:03 -- Disk Drive Status --
Drive Type Status AVR
----- ---- ----------- ---
RPA1 RP04 Free Yes
RPA5 RP06 Free Yes
RPB5 RP06 Free Yes
RPE1 RP04 Free Yes
OPR>
2. Use the SHOW STATUS DISK-DRIVES command with the /MOUNTED
switch.
OPR>SHOW STATUS DISK-DRIVES /MOUNTED <RET>
OPR>
9:23:45 -- Disk Drive Status --
Drive Type Status AVR STR Volume Unit#
9-28
UNSCHEDULED SOFTWARE TASKS
----- ---- ----------- --- ----- ------ -----
RPA2 RP04 Mounted Yes BADP BADP0 0
RPA3 RP20 Mounted Yes BLKX BLKX0 0
RPB0 RP04 Mounted Yes SIRS SIRS0 0
RPB1 RP06 Mounted Yes BLKK BLKK0 0
RPB6 RP04 Mounted Yes GAL0 GAL00 0
RPD0 RP06 Mounted Yes DSKC DSKC0 0
RPB2 RP06 Yes DSKC1 1
RPE0 RP20 Mounted Yes BLKY BLKY0 0
OPR>
9.5.7 Controlling Structure Recognition
Structure recognition allows QUASAR to recognize all the mounted packs
of a structure. When you mount a structure on a disk drive that has
structure recognition enabled, QUASAR automatically mounts the
structure.
To disable structure recognition, use the following OPR command:
OPR>DISABLE STRUCTURE-RECOGNITION <RET>
hh:mm:ss -- Structure Recognition is Disabled --
In addition, you can check the status of the structures with the OPR
command SHOW STATUS STRUCTURE.
If structure recognition is not already enabled, use the following OPR
command to enable structure recognition:
OPR>ENABLE STRUCTURE-RECOGNITION <RET>
9.5.8 Controlling Disk Drive Volume Recognition
Disk drive volume recognition allows you to mount disks without
telling the system the volume identification of the structure. When
you mount a disk pack on a disk drive that has volume recognition
enabled, the system automatically reads the volume identifier from the
HOM blocks when the disk drive is brought on line.
If your system is using volume recognition for disk drives, then it is
likely that volume recognition has been enabled. Both structure and
volume recognition are enabled by default. If, for some reason, you
need to disable volume recognition for one or all disk drives, use the
following OPR command:
9-29
UNSCHEDULED SOFTWARE TASKS
OPR>DISABLE VOLUME-RECOGNITION argument <RET>
where the argument can be:
xxxn: (specifies the physical unit number of a specific drive,
such as RPA0:.)
or
DISK-DRIVES (for all disk drives)
One reason for disabling volume recognition on a disk drive is to run
ONCE on a structure. When you disable volume recognition, OPR prints
the following message confirming that volume recognition has been
disabled:
hh:mm:ss Device xxxn -- Volume Recognition is Disabled --
In addition, you can check the status of the disk drive with the OPR
command SHOW STATUS DISK-DRIVE.
You can enable volume recognition for one or more of the disk drives
on your system by giving the following OPR command:
OPR>ENABLE VOLUME-RECOGNITION argument <RET>
----- Example -----
Disable volume recognition for disk drive 0 (RPA0:).
OPR>DISABLE VOLUME-RECOGNITION RPA0: <RET>
OPR>
12:25:47 Device RPA0 -- Volume Recognition is Disabled --
OPR>
9.6 EXAMINING TAPE/DISK MOUNT REQUESTS IN THE QUEUE
When a user submits a mount request, the request is placed in a queue,
where it waits for you to mount the tape or disk, or to delete the
request. To examine the mount queue, use the OPR command SHOW QUEUES
MOUNT-REQUESTS.
The SHOW QUEUES MOUNT-REQUESTS command displays:
o The tape/disk volume name of the request
9-30
UNSCHEDULED SOFTWARE TASKS
o The status of the request
o The type of request (tape or disk)
o Whether the request is write-enabled or write-locked
(The Write column for disk mount requests is blank. For tape
mount requests the Write column contains Enabled for
write-enabled or Locked for write-locked.)
o The request number
o The job number
o The user name and PPN
The status column displays the following:
o Waiting, if a tape/disk request is waiting to be satisfied
o A tape/disk drive name, if the request has been satisfied
o Dismount, if a tape or disk is being dismounted
In addition, the SHOW QUEUES MOUNT-REQUESTS command has optional
switches. With the /ALL switch specified, all the available
information for each request is printed. With the /SHORT switch
specified, only those requests that have not been satisfied are
displayed. The default is /SHORT if you do not specify a switch.
----- Example -----
Use the SHOW QUEUES MOUNT-REQUESTS command to display the current
mount requests in the queue.
OPR>SHOW QUEUES MOUNT-REQUESTS <RET>
OPR>
9:34:51 -- System Queues Listing --
Tape/Disk Mount Queue:
Volume Status Type Write Req# Job# User
------- -------- ---- ------- ---- ---- -------------------
BKLX Waiting Disk 7 25 YOUNG-KP [30,5221]
TEST01 Waiting Tape Enabled 30 41 BROWN.E [27,5107]
Volume-set: MTA
Label-Type: No, Tracks: 9, Density: Default BPI
There are 2 Requests in the Queue
OPR>
9-31
UNSCHEDULED SOFTWARE TASKS
9.7 CONTROLLING SYSTEM LISTS
At various times (possibly between shift or production changes) you
may be requested to change one or all of the system lists. These
lists consist of:
o The active swapping list (ASL)
o The crash dump list (also called the system dump list, or
SDL)
o The system search list (SSL)
To change any of these lists, use the OPR command MODIFY. To display
the system lists, use the OPR command SHOW SYSTEM LISTS. The
following sections explain these procedures.
NOTE
Consult your system manager before changing system
lists. The performance of your system can be greatly
affected if you remove or add a structure or disk unit
to any of the system lists.
9.7.1 Displaying System Lists
To display the current system lists, use the SHOW SYSTEM LISTS
command. This command displays the following information:
o The structures in the crash-dump list
o The disk units in the active-swapping list
o The structures in the system-search list
----- Example -----
Use the SHOW SYSTEM LIST command to display the current system lists.
OPR>SHOW SYSTEM LISTS <RET>
OPR>
11:21:45 -- System Lists --
Crash Dump List: BLKL:, BLKM:, BLKN:
Active Swapping List: RPD1:, RPD2:, RPD0:
System Search List: BLKN:, BLKL:, TEST:
OPR>
9-32
UNSCHEDULED SOFTWARE TASKS
9.7.2 Modifying System Lists
To change any of the system lists, use the MODIFY command. With this
command, you must specify the specific system list and whether you
want to EXCLUDE (remove) or INCLUDE (add) a structure or disk unit.
Note that the following changes occur when you modify the lists
specified below:
o Modifying the active-swapping list changes the disk unit
names that the system uses to swap pages of memory.
o Modifying the crash-dump list changes the structures that the
system uses to dump (or copy) memory during a system crash.
o Modifying the system-search list changes the structures that
the system uses to search for file structures and file names
when the user specifies SYS:.
----- Example -----
Use the MODIFY command to add structure DSKZ: to the crash dump list.
OPR>MODIFY CRASH-DUMP-LIST INCLUDE DSKZ: <RET>
OPR>
14:32:02 Device DSKZ -- Added to Crash Dump List --
OPR>
9.8 RESTORING DISK FILES WITH BACKUP
If a user requests that you restore some files from a magnetic tape,
be sure to find out:
o Which magnetic tape(s) to use. You might have to use a tape
containing a complete SAVE and some tapes from incremental
SAVEs. You should look through the terminal output kept for
each save operation and determine which tapes to use.
o Which files to restore and what directory they are in.
o Which directory to put them into.
o Which special BACKUP status commands to use, if any. Refer
to Appendix E for more information about BACKUP.
Then do the following:
9-33
UNSCHEDULED SOFTWARE TASKS
1. On a terminal, logged-in as [1,2], type MOUNT MTx: with an
optional logical-name and the /VOLID:volid switch. The
default mode is Write-Locked. The x in MTx: represents the
tape controller identification. If the tape is a labeled
tape, you must specify the /LABEL switch. Otherwise, the
labels are ignored.
OPR prints:
hh:mm:ss Device MTxn -- Labeled Volume Mounted --
Density nnnn BPI, Write-Locked
If volume recognition is disabled, use the IDENTIFY command
to OPR to identify the tape drive to the mount request.
2. If the desired structure is not mounted, type MOUNT
structure-name: at TOPS-10 monitor command level, and
physically mount and prepare the structure.
3. Type R BACKUP and give the following BACKUP commands:
.R BACKUP<RET>
/TAPE MTxn: <RET>
/REWIND <RET>
/RESTORE str:filespec[PPN] <RET>
"Done
(See argument types for filespecs below.)
4. When BACKUP replies with "Done, type:
/REWIND <RET>
/EXIT <RET>
.DISMOUNT MTxn: <RET>
5. When the OPR terminal replies with:
hh:mm:ss Device MTxn -- Released --
User: OPERATOR [1,2] Job# 2
remove the magnetic tape from the tape drive.
Argument types for RESTORE:
o To restore an entire user area; for example, to copy all the
files of directory DSKA:[10,4733] on tape to directory
DSKA:[10,4733]:
RESTORE DSKA:[10,4733]
9-34
UNSCHEDULED SOFTWARE TASKS
o To restore certain files of directory DSKA:[10,4733] on tape
to directory DSKA:[10,4733] on disk:
RESTORE DSKA:filespec1[10,4733],DSKA:filespec2[10,4733],...
o To restore DSKA:A.MAC[27,5107] to DSKB:A.MAS[10,4733]:
RESTORE DSKB:A.MAS[10,4733]=DSKA:A.MAC[27,5107]
o To copy all files from DSKB:[1,4] on tape to SAVE:[1,4] on
disk:
RESTORE SAVE:[1,4]=DSKB:[1,4]
----- Example -----
A user has requested you to restore all of his files on structure
MISC:.
.MOUNT MTA: /REELID:001234 <RET>
The OPR terminal replies:
18:14:23 -- Magtape mount request #146 --
User: OPERATOR [1,2] Job# 2
Volume-set-name: MTA-CJ7ZXY
Volume-ID Write Labels Track Density
--------- ------- ------ ----- -------
001234 Locked No 9 1600
OPR>
Mount and ready tape volume 001234 and OPR replies:
18:15:01 Device MTA0 -- Unlabeled Volume Mounted --
Density 1600 BPI, Write-Locked
OPR>
Use the IDENTIFY command at the OPR terminal.
OPR>IDENTIFY MTA0: REQUEST-ID 146 <RET>
OPR>
18:16:56 Device MTA0 -- Volume 001234 Reassigned --
User: OPERATOR [1,2] Job# 2
OPR>
9-35
UNSCHEDULED SOFTWARE TASKS
Run BACKUP from the monitor terminal.
.R BACKUP <RET>
/TAPE MTA0: <RET>
/REWIND <RET>
/RESTORE MISC:[21,3307] <RET>
!21,3307 MISC
"Done
/REWIND <RET>
/EXIT <RET>
.DISMOUNT MTA0: <RET>
MTA0: Dismounted
.
OPR replies with:
18:26:12 Device MTA0 -- Released --
User: OPERATOR [1,2] Job# 2
OPR>
9.9 COMMUNICATING WITH THE USERS
Timesharing and batch users often need to communicate with you to
perform various tasks, obtain help, or send and receive messages.
This section describes how to answer PLEASE requests with the OPR
command RESPOND, and how to send messages to a user with the OPR
command SEND.
NOTE
The SEND command that is discussed here is the OPR
command SEND. If you are at monitor command level,
you can use the monitor SEND command. These commands
are slightly different. Refer to the TOPS-10
Operating System Commands Manual for a discussion of
the SEND monitor command.
9.9.1 Answering PLEASE Messages with OPR
The PLEASE command provides two-way communication between you and the
user. It is initiated by the user typing at monitor level:
.PLEASE <RET>
9-36
UNSCHEDULED SOFTWARE TASKS
Enter text, terminate with Altmode or ^Z
When a user sends a message with PLEASE, you receive a message at the
OPR terminal that is time stamped and has a message number enclosed in
angle brackets. You should answer the message with the RESPOND
command from OPR.
Whenever you receive a message by means of the PLEASE command, the
user issuing the command is identified by job number, PPN, user name,
and terminal number. For example:
User SMITH,J [40,64] at terminal 100 types the following line:
.PLEASE <RET>
Enter text, terminate with Altmode or ^Z
WHEN WILL MTA2 BE FREE ^Z
[PLSOPN Operator at KL1026(26) has been notified at 9:08:22]
The message is transmitted to the CTY and appears at OPR command level
as follows:
OPR>
10:06:33 <3> -- Message from Timesharing User --
From User SMITH,J [40,64] at terminal 100
WHEN WILL MTA2 BE FREE
OPR>
If you know a batch job using MTA2: will be finished soon, you can
answer:
OPR>RESPOND 3 MTA2 WILL BE FREE IN 10 MIN <RET>
OPR>
Your response will appear on the user's terminal.
Respond to the PLEASE commands as soon as possible, because in some
cases the user cannot proceed to other tasks until you respond to the
message.
9.9.2 Talking to a User with SEND
If you need to send a message to a user, you can use the OPR command
SEND. Use any of the following commands at the OPR terminal.
OPR>SEND JOB n message <RET>
or
9-37
UNSCHEDULED SOFTWARE TASKS
OPR>SEND TERMINAL m message <RET>
or
OPR>SEND ALL message <RET>
where n is the number of the timesharing or batch job in the first
command format above, and m is the number of the user's terminal line
in the second command format above.
To send a message to all the users on the system, use ALL instead of
the job number or terminal number.
The SEND command also allows you to include the message with the SEND
command string or as multiple lines terminated by a <CTRL/Z>.
The SEND command does not affect the user's job. If the user is
waiting for input to a program, the message sent will appear on the
user's terminal, but it will not affect the program input.
Refer to the TOPS-10 Operator's Command Language Reference Manual for
a complete description of the OPR SEND command.
----- Examples -----
1. Tell a user that a requested task is now complete.
OPR>SEND JOB 27 <RET>
Enter text and terminate with ^Z
THE UPDATED FORTRAN SOURCE LIBRARY IS NOW UP <RET>
YOU MUST CONNECT TO TEST: <RET>
^Z
OPR>
13:57:19 -- SEND Command Completed --
OPR>
2. Send a message to terminal 15 to notify the user that batch
requests are being held.
OPR>SEND TERMINAL 15 YOUR BATCH REQUESTS ARE BEING HELD <RET>
OPR>
17:23:09 -- SEND Command Completed --
OPR>
9-38
UNSCHEDULED SOFTWARE TASKS
9.10 REPORTING ERRORS WITH OPR
You can report problems or errors that occur during normal operations
with the OPR command REPORT. This command allows you to enter one or
more lines of text into the SYS:ERROR.SYS file. This file can be
printed when you run your system error program, such as SPEAR.
In addition, the REPORT command optionally allows you to enter the
following:
o A user name of 1 to 6 characters in length. You may supply
your last name here. Your PPN is always automatically
entered into the system error report file.
o A device name of 1 to 6 characters in length. The device
name may be used when a device is causing errors.
----- Example -----
Report an error with tape drive MTA2:.
OPR>REPORT SMITH MTA2: <RET>
Enter text and terminate with ^Z
TAPE DRIVE MTA2 HAS STOPPED FOR NO APPARENT REASON. <RET>
FIELD SERVICE HAS BEEN CALLED. <RET>
OPERATIONS ^Z
OPR>
11:35:09 -- ERROR.SYS entry made by the REPORT Command --
OPR>
9.11 DOWN-LINE LOADING ANF-10 REMOTE STATIONS
To load an ANF-10 remote station (DN80-series or DN92) from the
TOPS-10 system, you must use the NETLDR program. This program should
be available on SYS. You can only run NETLDR if the remote node that
needs to be loaded is running its bootstrap and has issued a load
request. The load request is issued when the remote node is turned on
and its bootstrap ROM is activated. After the load request comes up
the line to the TOPS-10 host, NETLDR can be run to down-line load the
appropriate software into the remote node.
NETLDR runs automatically when the monitor receives a load request,
unless either SCHED 1000 (down-line node loading disabled) is set, or
the monitor was brought up in debugging mode (Bit 0 of DEBUGF is set).
(Refer to the NETLDR Specification in the TOPS-10 Software Notebook
Set.)
9-39
UNSCHEDULED SOFTWARE TASKS
9.11.1 Running NETLDR Automatically
Normally, NETLDR runs automatically. For this to occur, the NETLDR
program must be on SYS:. When the node is started up, its bootstrap
program sends a load request to a TOPS-10 host through intermediate
node(s). As long as SCHED 1000 has not been set, the host processor
will create a job and run NETLDR automatically. If SCHED 1000 has
been set, NETLDR will be neither loaded nor run.
When NETLDR starts automatically in response to a load request from a
remote station, it prints the following message on the CTY:
%%LOAD req on Node nodename (nn) Line:syn# for DNtyp Ser:ser
This message indicates that a station of type DNtyp has sent a load
request to the host. Nodename is the name and nn is the number of the
host system from which the remote DNtyp station must be loaded.
Line:syn# is the number of the synchronous line from the node that
first received the load request to the remote station, and Ser:ser is
the serial number of the remote station's processor (ser can be zero).
If the load request includes a file specification, NETLDR loads the
specified file directly into the node. If the load request does not
contain all the necessary information, NETLDR searches SYS:NETLDR.INI
for the appropriate entry. If there is no corresponding entry in
SYS:NETLDR.INI, the node cannot be loaded and an error message of the
following form appears at the CTY:
?NETNMI - Cannot find match in SYS:NETLDR.INI
The SET SCHED command and the NETLDR switch /IGNORE can be used to
control the load requests. If a host is to disregard all load
requests, the system operator can prevent the automatic running of
NETLDR by typing the operator-privileged command:
.SET SCHED 1000 <RET>
However, if requests from certain nodes are to be disregarded, the
NETLDR switch /IGNORE can be placed in the NETLDR.INI file.
9.11.2 Running NETLDR Manually
To run NETLDR manually, you must start by issuing a command to SET
SCHED 1000. This prevents NETLDR from running automatically while you
are running it manually. Issue the following commands:
.SET SCHED 1000 <RET>
.R NETLDR <RET>
NETLDR responds with the prompt:
9-40
UNSCHEDULED SOFTWARE TASKS
FILE:
You must enter a command string of the form:
/LINE:syn#
filespec/CPU-type/NODE:nodeid /switch/switch...
/SELF
where entries are:
Entry Form/Use
filespec Form: dev:filename.ext[PPN]
In a load operation, filename is required; other
arguments default to your disk area, file
extension .BIN, and your [PPN]. In a dump
operation, an omitted filespec defaults to
DSK:nodename.LSD. If the node to be dumped is
running, nodename is the name of the node itself.
If the node is not running, nodename must be the
name of an adjacent node.
/CPU-type Form: /PDP11, /11, /PDP8, or /8
This entry must appear. It specifies the
processor type of the remote node (use /11 for
DN8x-series stations, /8 for DN92-series).
/NODE:nodeid Form: 6-character nodename or three-digit octal
node number
This entry must appear. If the remote node is
running, nodeid specifies the node itself; if the
remote node is not running (as in a load
operation), nodeid specifies an adjacent running
node.
/LINE:syn# One of these entries must appear. If the remote
/SELF node is running (as when NETLDR is requesting a
dump), the /SELF switch is used. If the remote
node (to be loaded) is not running, syn# specifies
the synchronous line at the adjacent node over
which loading is to occur.
Optional NETLDR switches are:
Switch Action
/DUMP:c-d Dumps all or a specified portion of the remote
node's memory, in octal. /DUMP with no
arguments gives a full memory dump; /DUMP:c-d
9-41
UNSCHEDULED SOFTWARE TASKS
dumps from location c to location d, inclusive;
/DUMP:c-* dumps from location c to location 17777
(PDP-8) or 137776 (PDP-11).
/IMAGE Specifies that the file to be read is in image
mode. This is the default for a PDP-8 node.
/LOAD Loads the file into the remote node; does not
start the program.
/PACKED Specifies that the file to be read is in PDP-11
packed image mode. This is the default for a
PDP-11 node.
/START:addr Starts the program at address addr. If no
filespec is given in the command, the program
currently in memory is started. This switch is
not needed if a filespec is given and the program
is to be started at its default start address.
9.12 CONTROLLING ANF-10 REMOTE STATIONS
If your installation has DN60-series (IBMCOM), DN80-series, DN92, or
DN20 network software, you can perform the following tasks for remote
stations using OPR commands:
o Start a node
o Shutdown a node
o Display the status of a network node
o Route output from one node to another node
o Display the route table
This section describes the tasks associated with the above commands.
The TOPS-10 Remote Station Guide provides more information about the
ANF-10 remote stations and operating them. The DECnet front end (DN20
running MCB) and the DECnet network tables must be built by the system
manager and maintained by the operator using DECnet programs described
in the DECnet-10 Operator's and System Manager's Guide.
NOTE
If your installation has 2780/3780 network software,
you can perform additional tasks with the OPR commands
DEFINE and SET NODE. These commands are described in
the TOPS-10 Operator's Command Language Reference
Manual and in the TOPS-10 IBM Emulation/Termination.
9-42
UNSCHEDULED SOFTWARE TASKS
If you are a remote station operator, the OPR running at your station
can control only the devices at your remote station. All commands you
specify default to your node when those commands are passed to ORION
for processing. In addition, you have complete control over all jobs
located at or queued up at your node.
To specify a remote node, use the /NODE switch. This switch is
available with many of the OPR commands described in previous sections
of this manual. The /NODE switch allows you to identify any node in
the network. The format of the /NODE switch is:
/NODE:node-id::
where the node-id is either the number or the name of the node.
Because a remote station operator has control only of the devices and
jobs at his remote station, his commands always default to a job or
device at his station when the command is processed by ORION.
Therefore /NODE is not necessary to refer to devices at the remote
station. However, if the operator would like to refer to another node
in the system, the /NODE switch must be included in the OPR command.
9.12.1 Starting and Shutting Down a Node
To start a node, use the OPR command START NODE. This also schedules
start-up for the printer and/or card reader at that node.
----- Example -----
Start node CTCH22(22).
OPR>START NODE CTCH22:: <RET>
OPR>
9:08:21 Printer 0 [CTCH22(22)] -- Startup Scheduled --
OPR>
9:08:21 Reader 0 [CTCH22(22)] -- Startup Scheduled --
OPR>
To shut down a node, use the OPR command SHUTDOWN NODE. This also
schedules shutdown for the printer and/or card reader at that node.
----- Example -----
You shut down node CTCH22(22).
9-43
UNSCHEDULED SOFTWARE TASKS
OPR>SHUTDOWN NODE CTCH22:: <RET>
OPR>
14:34:21 Printer [CTCH22(22)] -- Shutdown --
OPR>
14:34:21 Reader [CTCH22(22)] -- Shutdown --
OPR>
9.12.2 Displaying Node Status
To display the status of one or all nodes in your network use the OPR
command SHOW STATUS NETWORK-NODE. If you do not specify a specific
node, this command displays all nodes in the network.
The SHOW command displays the following information:
o The node name and node number
o The status of the node (either On-line or Off-line)
----- Example -----
Display the status of all nodes in your network.
OPR>SHOW STATUS NETWORK-NODE <RET>
OPR>
9:08:35 -- System Network Status --
Node Status
----------- -------
KL1026 (26) Online
COMET (70) Online
NOVA (31) Online
TITAN (61) Online
WIZARD (75) Online
KS4101 (76) Online
CTCH22 (22) Offline
JINX (134) Offline
There are 8 nodes in the network
OPR>
9.12.3 Routing Device Output between Nodes
To route the output for one device or all devices from one or more
9-44
UNSCHEDULED SOFTWARE TASKS
nodes to another node, use the OPR command ROUTE. The ROUTE command
can route the output for the following devices:
o ALL-DEVICES
o CARD-PUNCH
o PAPER-TAPE-PUNCH
o PLOTTER
o PRINTER
The ROUTE command is useful when there are hardware problems on a
device whose output is very important. If you are the operator at a
host system, you can route output to any node. If you are a remote
station operator, you cannot route output; you must request that
routing be done for you by the host operator.
----- Examples -----
1. To route the output of all printers on node COMET to printer
number 1 on node KL1026, you use the following command:
OPR>ROUTE PRINTER ALL-UNITS /NODE:COMET::1/NODE:KL1026:: <RET>
COMET:: 1 /NODE:KL1026:: <RET>
OPR>
13:05:19 -- All Printers [COMET] Routed to [KL1026(26)]
--
OPR>
When this command has been executed, an entry is entered into
QUASAR's Route Table (refer to the next section).
2. In addition, the ROUTE command allows you to delete entries in
the system route table. To end device routing on a node, omit
the destination node-id.
To delete the entry made above, use the following command:
OPR>ROUTE PRINTER ALL-UNITS /NODE:COMET:: <RET>
OPR>
17:34:19 -- Routing for All Printers [COMET] Deleted --
OPR>
9-45
UNSCHEDULED SOFTWARE TASKS
9.12.4 Displaying the Routing Table
To display the route table, use the OPR command SHOW ROUTE-TABLE. The
routing entries are listed from specific device entries (such as
Printer 0) to more general entries (such as All printers). For
example, the output of printer 0 on node NOVA:: routed to node
ALPHA:: is listed first; while the output of all printers on node
CTCH22:: routed to KL1026:: is listed second.
----- Example -----
Use the SHOW ROUTE-TABLE command to display the current device output
that has been routed.
OPR>SHOW ROUTE-TABLE <RET>
OPR>
12:34:09 -- System Device Routing Table --
Printer 0 [NOVA(33)] Routed to Printer 0 [ALPHA(45)]
All Printers [CTCH22(22)] Routed to [KL1026(26)]
OPR>
9.13 STOPPING AND RESTARTING KS10 COMMUNICATIONS
The ANF-10 network runs on the KS10 processor. The TOPS-10/KS10 host
communicates on the network with TOPS-10 remote nodes and other
TOPS-10/KS10 hosts.
The TOPS-10/KS10 network consists of a KMC-11, two DUP-11s, the ANF-10
network software, and a KMC-11 loader program, KDPLDR. KDPLDR runs
automatically at system start-up. The KDPLDR program initializes the
KMC-11 hardware and both of the TOPS-10 network communications lines.
You can stop and restart either or both communication lines by running
KDPLDR on the KS10 processor.
To stop communications, use the following KDPLDR command sequence:
.R KDPLDR <RET>
*/STOP:n/KMC:0 <RET>
Where n is 0 or 1 for a DUP-11 line number, or ALL for both lines.
To restart communications, use the following KDPLDR command sequence:
9-46
UNSCHEDULED SOFTWARE TASKS
.R KDPLDR <RET>
*/START:n/KMC:0 <RET>
Where n is 0 or 1 for a DUP-11 line number or ALL for both lines.
NOTE
To restart communications on both lines of the KS10
processor, you can use the following command sequence:
.R KDPLDR <RET>
*/AUTO <RET>
The /AUTO switch is the same as using the switch
sequence of:
/MCLEAR:0/LOAD:0/VERIFY:0/USTART:0/START:ALL/KMC:0
For more information on KDPLDR, refer to the KDPLDR Specification in
the TOPS-10 Software Notebook Set.
----- Examples -----
1. Stop all TOPS-10 network communications on the KS10
processor.
.R KDPLDR <RET>
*/STOP:ALL/KMC:0 <RET>
2. Restart communications on line 2 of the KS10 processor.
.R KDPLDR <RET>
*/START:1/KMC:0 <RET>
9.14 RECONFIGURING SYSTEM HARDWARE
The CONFIG application is a command subset of OPR that allows you to
reconfigure system hardware without halting the system. With CONFIG
commands you can do the following:
o Add controllers, CPUs, and memory to the system
o Automatically configure peripheral devices into the system
9-47
UNSCHEDULED SOFTWARE TASKS
o Remove controllers, CPUs, and memory from the system
o Enable and disable automatic reloads of the monitor and DX20
microcode
o Specify the BOOT-TEXT command string
o Shut down and reload the system
o Suspend the system
o Stop the system, dump the memory image, and continue the
system automatically
To enter CONFIG command level use the OPR command, ENTER, as shown
below.
OPR>ENTER CONFIG<RET>
CONFIG>
After you enter the CONFIG command subset, you can type a question
mark (?) to display all of the CONFIG commands. See the TOPS-10
Operator's Command Language Reference Manual for a complete
description of the CONFIG commands.
----- Example -----
.R OPR
OPR>ENTER CONFIG<RET>
CONFIG>? one of the following:
ENTER EXIT PUSH RETURN TAKE WAIT
or one of the following:
ADD AUTO-CONFIGURE HELP LOAD REMOVE
SET SHOW SHUTDOWN SNAPSHOT SUSPEND
CONFIG>
9.14.1 Adding System Hardware
Use the CONFIG ADD command to add the following to the system:
o Disk controllers
o Tape controllers
o CI (Computer Interconnect) interface
o NI (Network Interconnect) interface
9-48
UNSCHEDULED SOFTWARE TASKS
o CPUs
o Memory
----- Examples -----
1. Use the ADD command to add a tape controller to the system.
CONFIG>ADD MTB<RET>
CONFIG>
13:09:43 CONFIG -- ADD CONTROLLER --
Controller MTB added
CONFIG>
2. Use the ADD command to add a CI to the system.
CONFIG>ADD CI-1<RET>
CONFIG>
13:18:04 CONFIG -- ADD CI --
CI port on CPU1 enabled
CONFIG>
9.14.2 Configuring System Hardware
The AUTO-CONFIGURE command automatically configures disks and tapes on
a specified CPU or ALL-CPUs into the system. Use the CONFIG
AUTO-CONFIGURE command to configure devices that were powered-off when
the system was first bootstrapped.
----- Example -----
Use the AUTO-CONFIGURE command to configure all disks and tapes on
CPU-1 into the system.
CONFIG>AUTO-CONFIGURE CPU1<RET>
CONFIG>
13:19:58 CONFIG -- AUTOCONFIGURE --
CONFIG>
9.14.3 Removing System Hardware
Use the CONFIG REMOVE command to remove the following devices from the
9-49
UNSCHEDULED SOFTWARE TASKS
system.
o Disk controllers
o Tape controllers
o CI (Computer Interconnect) interface
o NI (Network Interconnect) interface
o CPUs
o Memory
----- Examples -----
1. Use the REMOVE command to remove a CI from the system.
CONFIG>REMOVE CI<RET>
CONFIG>
13:18:04 CONFIG -- REMOVE CI --
CI port on CPU1 disabled
CONFIG>
2. Use the REMOVE command to remove a tape controller from the
system.
CONFIG>REMOVE MTB<RET>
CONFIG>
13:10:34 CONFIG -- REMOVE CONTROLLER --
Controller MTB removed
CONFIG>
9.14.4 Controlling System Hardware
To automatically control a monitor reload use the CONFIG SET command.
The SET command has the following optional keywords:
o [NO]AUTO-RELOAD reloads the monitor after crashes
o BOOT-TEXT specifies the BOOT-TEXT command string
o [NO]DUMP causes continuable dumps
o [NO]IGNORE causes monitor to ignore interrupts
9-50
UNSCHEDULED SOFTWARE TASKS
o KLINIK sets KLINIK parameters
o [NO]MICROCODE enables reload of microcode
o [NO]RELOAD enables reload of the monitor
----- Examples -----
1. Use the SET AUTO-RELOAD command to automatically reload the
monitor after a monitor crash.
CONFIG>SET AUTO-RELOAD<RET>
CONFIG>
13:22:09 CONFIG -- SET AUTO-RELOAD --
Automatic system reload is enabled
CONFIG>
2. Use the SET DUMP command to cause the monitor to take
continuable dumps after JOB stopcodes.
CONFIG>SET DUMP JOB-STOPCODES<RET>
CONFIG>
13:23:16 CONFIG -- SET DUMP --
System will do continuable dumps on CPU, DEBUG, and JOB stopcodes
System will reload on STOP stopcodes
9.14.5 Shutting Down the System
To take the monitor down with a reload (RLD) stopcode and reload the
monitor, use the CONFIG SHUTDOWN command. You must supply a
single-line reason for the reload.
----- Example -----
Use the SHUTDOWN command to take down the monitor to clear a hung tape
system.
CONFIG>SHUTDOWN CLEAR HUNG TAPE SYSTEM<RET>
9.14.6 Stopping the System
To execute a stopcode, dump the system memory image, and continue the
system automatically, use the CONFIG SNAPSHOT command. You must
supply a single line reason for stopping the system.
9-51
UNSCHEDULED SOFTWARE TASKS
----- Example -----
Use the SNAPSHOT command to obtain a dump of the system memory image.
CONFIG>SNAPSHOT HUNG JOB<RET>
CONFIG>
13:12:34 CONFIG -- SNAPSHOT --
CONFIG>
9.14.7 Suspending a System
To suspend a system use the CONFIG SUSPEND command. The SUSPEND
command temporarily suspends system operation and writes a system dump
file. You can reload the dump file and continue the system with the
BOOT /REBOOT switch. You must supply a single line reason for
suspending the system. You must perform all logical software
reconfiguration that is needed before a system is suspended.
To record system configuration before suspension, you can use the SHOW
HARDWARE-CONFIGURATION command. Then use SUSPEND to suspend system
operations.
----- Example -----
1. Display the current configuration.
CONFIG>SHOW HARDWARE-CONFIGURATION
CONFIG>
14:24:24
CONFIG -- SHOW HARDWARE-CONFIGURATION --
CPU Configuration
CPU0 is running and scheduling jobs
KL10 model B serial number 1026, microcode version 442
Hardware options:
MCA25 cache/pager Extended addressing Internal channels
Cache
Cache status: Enabled
Internal channels:
0: RH20 1: RH20 2: RH20 3: N/C
4: N/C 5: NIA20 6: N/C 7: CI20
DTE configuration:
DTE0: up CFE running RSX20F version VA15-50
Reload enable: ON Retry enable: ON Fault-continuation: ON
DTE1: up DN60 running DN60
DTE2: up DN87S running ANF10 node NOVA(31)
DTE3: down
CFE UNIBUS Configuration:
CSR Device CSR Associated Device
9-52
UNSCHEDULED SOFTWARE TASKS
------ --------------------- ------ --------------------
172100 MF11-UP Mem Parity
177340 TC11 DECtape Control
.
.
.
Monitor Memory Configuration
Monitor configured for 4096P (2048K) of physical memory
Controller Microcodes
Controller Version
---------- -----------
DX10/TX01 15(0)
DX20/TX02 10(74)
DX20/RP20 3(1)
CI20 1A(733)
NIA20 1(172)
CI Configuration
Node S/W type S/W vers H/W type
------------- -------- -------- --------
00 (KL-1026) T-10 0703 KL10
02 (KL-1322) T-10 0703 KL10
06 (HSC006) HSC V350 HS50
09 (HSC009) HSC V350 HS50
11 (KL-1042) T-10 0703 KL10
13 (KL-2476) T-10 0703 KL10
NI Configuration
Chan/Kont State E-net Address
--------- ------- -----------------
ETH-0 Online AA-00-04-00-6E-1C
NI-0 Online AA-00-03-03-00-13
NI-1 Online AA-00-03-03-00-87
NI-2 Online 08-00-2B-00-13-BC
Disk Configuration
Drive Type Str Volume CPU(s) Controller
------ ---- ---- ------ ------ ----------
RAJ1 RA81 012 HSC-9
RAG1 RA81 HSC-6
RPE0 RP06 1322 13220 2 RH20-0 (540)
.
.
.
Tape Configuration
Drive Type Volume CPU(s) Controller(s)
------ ------ ------ ------ -------------
MTA260 TU70 0 DX10-0 (220)
MTA261 TU70 0 DX10-0 (220)
.
.
.
DECtape configuration
Device CPU
------ ---
9-53
UNSCHEDULED SOFTWARE TASKS
DTA260 0
DTA261 0
DTA262 0
DTA263 0
Unit Record Device Configuration
Card reader configuration:
Device CPU
------ ---
CDR260 2
Line printer configuration:
Device CPU Type Status
------ --- ----- ------
LPT260 1 LP100 Online
2. SUSPEND the system.
CONFIG>SUSPEND FIX MEMORY<RET>
;;SYSTEM: - Expect an interruption of service
;;SYSTEM: - Suspending system operation
[Suspending system on DSKF:CRASH.EXE[1,4]]
[System suspended] The system is suspended.
All other CPUs in an SMP
system should now be
HALTed.
Note that SMP systems must
be REBOOTed on the CPU that
was the policy CPU when the
system was suspended.
RSX-20F VE##-## 8:57 26-Mar-86 RSX-20F version and
creation time and date.
[SYO: redirected to DBO:] DBO: is the system device
[DBO: mounted] for the RSX-20F tasks.
KLI -- VERSION VA##-## RUNNING KLINIT prints this and
KLI -- KL10 S/N: 2996., MODEL B, 60 HERTZ the following lines.
KLI -- KL10 HARDWARE ENVIRONMENT
MCA25 CACHE PAGER
MOS MASTER OSCILLATOR
EXTENDED ADDRESSING
INTERNAL CHANNELS
CACHE
KLI -- PAGE TABLE SELECTED: BOTH
KLI -- MICROCODE VERSION #.#[###] LOADED
KLI -- ALL CACHES ENABLED
KLI -- % MOS MEMORY IS ALREADY CONFIGURED
9-54
UNSCHEDULED SOFTWARE TASKS
LOGICAL MEMORY CONFIGURATION
ADDRESS SIZE INT TYPE CONTROLLER
00000000 768K 4 MF20 10
03000000 768K 4 MF20 11
KLI -- CONFIGURATION FILE WRITTEN
KLI -- BOOTSTRAP LOADED AND STARTED KLINIT has loaded and
started BOOT.
BOOT V#(##) BOOT version number.
?No file found on any structure
BOOT>/REBOOT<RET> Type /REBOOT and press
RETURN to reload the
default monitor from the
file DSKF:CRASH.EXE[1,4].
[Reloading from DSKF:CRASH.EXE[1,4]] BOOT is now reloading the
monitor.
Date:3-Sep-88 Before answering the date
prompt, start other SMP
system CPUs using the JUMP
400 PARSER command.
Time:1150
CONFIG>
;;SYSTEM: - System resumed
CONFIG>
9-55
10-1
CHAPTER 10
ERROR RECOVERY ON THE KS10 CENTRAL PROCESSOR
This chapter describes various types of errors that may occur on a KS
system. KL error recovery is described in Chapter 11.
When the system is running, unexpected errors may occur, resulting in
a crash. A crash can be caused by one or more of the following:
o Software problems
o Hardware problems
o Environmental problems
The system usually uses BOOT as the bootstrap program. Use BOOT when
you first power up your system. If the system crashes after it has
been running for more than five minutes, BOOT automatically dumps and
reloads the system.
Excluding crashes, after the system has been running for five minutes
you only have to use BOOT if you power down the system and load from a
cold start, or if the system does not recover from an error,
preventing BOOT from performing an automatic reload. The monitor
calls BOOT, which can dump any amount of memory, from one page to all
of it. The bootstrap program is highly tolerant of errors such as
memory parity errors. When an error occurs, BOOT prints an error
message before it takes corrective action. (For further information
on BOOT messages, see Appendix A.)
It is very important to record all system problems accurately. If
software problems cause a crash, you must fill out a Software Error
Report (SER) form and make an entry in the logbook. Similarly, if
hardware problems cause a crash, you must fill out a hardware error
form and make a log entry. This chapter discusses some of the errors
you may encounter and how you can correct them. To correct errors not
discussed in this chapter, contact either the system programmer or
your software specialist.
Common problems (and references to the sections that address them)
10-1
ERROR RECOVERY ON THE KS10 CENTRAL PROCESSOR
are:
o Nothing prints on CTY when you type CTRL/backslash (Section
10.1).
o System does not respond to you or to users (Sections 10.1,
10.3).
o Two crashes occur within 5 minutes (Section 10.2.2).
o System does not automatically reload (Sections 10.1, 10.2.2).
o System overwrites crash file (Section 10.4).
o Stopcode prints on CTY (Section 10.5).
o Message that begins "?Non-recoverable memory" or
"?Non-existent memory" prints on CTY (Section 10.6).
o "***************" prints on CTY above and below a series of
messages (Section 10.6).
o No characters print on CTY (Section 10.7).
o "?J" prints on CTY (Section 10.8).
o "%File not found..." prints on CTY (Section 10.8).
o "%HLTD" prints on CTY (Section 10.10).
o "?" followed by two or more capital letters prints on CTY
(Section 10.11).
o Power fails or fluctuates (Section 10.12).
10.1 RECOVERING FROM A MICROPROCESSOR CRASH
If the system does not automatically reload after a crash, it may mean
that the microprocessor has crashed. If the following are all true,
the microprocessor has crashed.
o The KS10> prompt does not print on the CTY.
o The CTY is plugged in and has paper.
o The LOC-LINE switch is set so the terminal is on-line.
o After you insert the key in the REMOTE DIAGNOSIS switch and
set the switch to ENABLE, the REMOTE indicator light is on.
10-2
ERROR RECOVERY ON THE KS10 CENTRAL PROCESSOR
o The STATE indicator light is blinking.
If the above conditions are not met, refer to Section 10.2. If the
above conditions are met, perform the following steps:
1. Go to another terminal. If the system is still up, log in
under [1,2].
2. Halt timesharing by typing SET KSYS +hh:mm to OPR. (See
Section 4.3.2 for detailed information on halting
timesharing.)
If neither of the above steps is effective, call your Field Service
representative.
10.2 RECOVERING FROM A MONITOR CRASH
To recover from a monitor crash, BOOT must perform the following
steps:
1. Record (dump) the memory image as it appeared when the
monitor crashed.
BOOT dumps the memory image to the default file
DSKB:CRASH.EXE[1,4], which is called the crash file. BOOT
always writes the crash file to the [1,4] directory area.
However, if the system crashes again, BOOT will not overwrite
one crash file with another. Instead, it prints the
following dialog on the CTY:
[Dumping on DSKB:CRASH.EXE[1,4]] BOOT tries to dump the
memory image to the
default file
DSKB:CRASH.EXE[1,4],
where DSKB: is the
system dump list.
%Unprocessed dump on DSKB:CRASH.EXE[1,4]]
Do you want to overwrite it? No<RET> Type no, which is the
default, or yes, and then
press RETURN.
Structure on which to dump: DSKB:<RET> Type the name of the
structure on which you
want BOOT to dump the
crash file, and then
press RETURN. BOOT
defaults to the system
dump list.
[Dumping on DSKB:CRASH.EXE[1,4]] Approximately 20 seconds
10-3
ERROR RECOVERY ON THE KS10 CENTRAL PROCESSOR
elapse while BOOT dumps
the memory image to the
file DSKB:CRASH.EXE[1,4].
2. Reload the last monitor that was loaded.
When the monitor has been loaded into memory, the monitor
startup questions begin. (See Section 4.5.) There is a
60-second time-out after the first monitor startup question.
If you do not answer the first question during the 60-second
time-out, the system assumes (and prints on the CTY) the
default answers to the ONCE dialog. (Refer to the TOPS-10
Software Installation Guide for complete information on the
ONCE dialog.)
Normally, if the monitor crashes, BOOT automatically performs the
above steps for you. However, if the monitor crashes twice within 5
minutes, you must direct BOOT to manually perform them. (See Section
10.2.2.)
When your system administrator or Field Service representative reports
a crash to DIGITAL, you must provide the logbook information and a
magnetic tape containing both the crash file and a copy of the monitor
as it appeared before it was run. (Be sure to include operating
system and software version numbers.)
After you answer the monitor startup questions, INITIA may print a few
lines on the CTY. Whether or not your system runs INITIA at system
startup is determined when the monitor is generated. (Refer to the
TOPS-10 Software Installation Guide for more information on INITIA.)
10.2.1 Automatically Dumping and Reloading the Monitor
Usually, if the system has not crashed in the last 5 minutes, BOOT
automatically dumps and reloads the system. In this case, the
following message prints on the CTY:
?CPU0 monitor error. Stopcode name is UIL
File TTY6:
Job 2 on TTY6 running FD User [1,2]
CPU Status Block on dd-mmm-yy hh:mm:ss
CONI APR, = 001060,,004072
CONI PI, = 000000,,000377
CONI PAG, = 000000,,020000
DATAI PAG, = 500100,,000117
Reload monitor
10-4
ERROR RECOVERY ON THE KS10 CENTRAL PROCESSOR
[Dumping on DSKB:CRASH.EXE[1,4]] Approximately 20 seconds
elapse while BOOT dumps
the memory image to the
file DSKB:CRASH.EXE[1,4].
[Loading from DSKB:SYSTEM.EXE[1,4]] BOOT is now reloading the
monitor.
When the first monitor startup question prints on your CTY, the system
has already used the /D switch to BOOT to dump the memory image to the
crash file DSKB:CRASH.EXE[1,4] and has loaded the default monitor from
the file DSKB:SYSTEM.EXE[1,4].
There is a 60-second time-out after the first monitor startup
question. If you do not answer the first question during the
60-second time-out, the system assumes (and prints on the CTY) the
default answers to the ONCE dialog. (Refer to the TOPS-10 Software
Installation Guide for complete information on the ONCE dialog.)
After you answer the monitor startup questions, INITIA may print a few
lines on the CTY. Whether or not your system runs INITIA at system
startup is determined when the monitor is generated. (Refer to the
TOPS-10 Software Installation Guide for more information on INITIA.)
10.2.2 Manually Dumping and Reloading the Monitor
To manually dump and reload the monitor, perform the following steps:
1. Type everything that is underscored in the following sample
dialog:
^\ENABLED Type CTRL/backslash, which
does not echo. The
microprocessor then prints
the word ENABLED.
KS10>SHUT<RET> Type SHUT at the KS10>
prompt, then press RETURN to
shut down the system.
KS10>USR MOD Enter user mode.
BOOT>/D<RET> Type /D and press RETURN to
dump the memory image to the
default file specification,
DSKB:CRASH.EXE[1,4]. (The
prompt prints here only if
the system has not been up
for 5 minutes.)
10-5
ERROR RECOVERY ON THE KS10 CENTRAL PROCESSOR
[Dumping on DSKB:CRASH.EXE[1,4]] Approximately 20 seconds
elapse while BOOT dumps the
memory image to the file
DSKB:CRASH.EXE[1,4].
BOOT><RET> Press RETURN to load the
default monitor from the
file DSKB:SYSTEM.EXE[1,4].
[Loading from DSKB:SYSTEM.EXE[1,4]] BOOT is now reloading the
monitor.
When the monitor has been loaded into memory, the monitor
startup questions begin.
2. Answer the monitor startup questions discussed in Section
5.6.
After you answer the monitor startup questions, INITIA may print a few
lines on the CTY. Whether or not your system runs INITIA at system
startup is determined when the monitor is generated. (Refer to the
TOPS-10 Monitor Installation Guide for more information on INITIA.)
10.3 RECOVERING FROM A HUNG OR LOOPING SYSTEM
Sometimes the central processor does not respond to you or to users.
In this case, if the scheduler cannot run any job other than the null
job, then the central processor is probably hung or looping.
To recover from a hung or looping system, make certain the processor
LOCK switch is off. Then follow the procedure discussed in Section
10.2.2.
If this procedure does not solve the problem, you can perform the
following steps:
NOTE
The following procedure will destroy useful
information in the dump. Use this procedure only if
the procedure described in Section 10.2.2 does not
work.
1. Make sure the processor LOCK switch is off.
2. Type everything that is underscored in the following sample
dialog:
^\ENABLED Type CTRL/backslash, which
10-6
ERROR RECOVERY ON THE KS10 CENTRAL PROCESSOR
does not echo. The
microprocessor then prints
ENABLED.
KS10>MR<RET> Type MR and press RETURN to
reset memory.
KS10>SM<RET> Type SM and press RETURN.
%HLTD/000000 PC/000000,,000000
KS10>ST 407<RET> Type ST 407 and press
RETURN.
KS10>USR MOD Enter user mode.
BOOT>/D<RET> Type /D and press RETURN to
dump the memory image to
the default file
DSKB:CRASH.EXE[1,4]. (If
the system has been up for
five minutes, the prompt
does not print.)
[Dumping on DSKB:CRASH.EXE[1,4]] Approximately 20 seconds
elapse while BOOT dumps the
memory image to the file
DSKB:CRASH.EXE[1,4].
BOOT><RET> Press RETURN to load the
default monitor from the
file DSKB:SYSTEM.EXE[1,4].
[Loading from DSKB:SYSTEM.EXE[1,4]] BOOT is now reloading the
monitor.
When the monitor has been loaded into memory, the monitor
startup questions begin.
3. Answer the monitor startup questions discussed in Section
5.6.
10.4 COPYING CRASH DATA
CRSCPY is the default program that automatically copies system dumps
and then clears the unprocessed-dump bit. CRSCPY runs at system
startup and when a continuable stopcode occurs. (Refer to Appendix A
and the files CRSCPY.DOC and CRSCPY.HLP for complete information on
CRSCPY.)
10-7
ERROR RECOVERY ON THE KS10 CENTRAL PROCESSOR
If you want to use your installation's own program to copy system
dumps, you must redefine the symbol CPYNAM in the SIXBIT hardware
definitions in MONGEN to be equivalent to the name of your
installation's program. (Refer to the TOPS-10 Software Installation
Guide for complete information on MONGEN.)
10.5 RECOVERING FROM STOPCODES (MONITOR ERROR STOPS)
When the monitor detects an internal error, it executes its stopcode
macro. This macro prints the following message on the CTY:
?CPU0 monitor error. Stopcode name is xxx
where:
xxx is a mnemonic identifying the error. (See the STOPCD
specification in the Software Notebooks for a complete list
of stopcodes.)
The following types of stopcodes, may occur:
o DEBUG (See Section 10.5.1)
o JOB (See Section 10.5.2)
o STOP (See Section 10.5.3)
o CPU (See Section 10.5.4)
o HALT (See Section 10.5.5)
o INFO (See Section 10.5.6)
o EVENT (See Section 10.5.6)
In general, there are two types of stopcodes: continuable stopcodes
that allow most user jobs to continue without interruption, and
noncontinuable stopcodes that cause the system to halt and reload.
HALT stopcodes do not initiate automatic recovery procedures. Also,
HALT stopcodes do not cause the '?CPUn monitor error. Stopcode name
is xxx' error message to print. The following is an example of what
you will see on the CTY when the monitor detects a continuable
stopcode.
?CPU0 monitor error. Stopcode name is ICN
CPU Status Block on dd-mmm-yy hh:mm:ss
CONI APR, = 001060,,004102
10-8
ERROR RECOVERY ON THE KS10 CENTRAL PROCESSOR
CONI PI, = 000000,,000777
CONI PAG, = 000000,,020000
DATAI PAG, = 500100,,000002
[Dumping on DSK:CRASH.EXE[1,4]]
[Continuing system]
In this case, the monitor executed its stopcode macro, dumped the
memory image, and continued the system.
For more information on stopcodes, refer to the TOPS-10 Stopcodes
Specification.
10.5.1 Identifying DEBUG Stopcodes
A DEBUG stopcode is not immediately harmful to any job or to the
system. The monitor prints the following message on the CTY:
?CPU0 monitor error. Stopcode name xxx
[Continuing system]
Processing then continues. Fill out a Software Error Report form.
10.5.2 Identifying JOB Stopcodes
A JOB stopcode indicates an internal error that endangers the
integrity of the job that is currently running. The monitor prints
the following message on the CTY:
?CPU0 monitor error. Stopcode name xxx
[Aborting job]
Also, the following message prints on the user's terminal:
?Monitor error; UUO at address
where address is one of the following virtual memory locations:
o User loc n
o Exec loc n; Exec called from exec location m
o Exec loc n; Exec called from user location m
where m and n are memory addresses.
The monitor then aborts the current job and continues normal
operation. Fill out a Software Error Report form.
10-9
ERROR RECOVERY ON THE KS10 CENTRAL PROCESSOR
10.5.3 Identifying STOP Stopcodes
A STOP stopcode indicates an internal error that endangers the
integrity of the entire system. The monitor prints the following
message on the CTY:
?CPU0 monitor error. Stopcode name xxx
Reload monitor
This means that all jobs are aborted and the system begins to
automatically dump and reload the monitor.
If the monitor can obtain the necessary information, it prints a
supplementary message on the CTY of the form:
JOB jobno on TTYnnn running xxxxxx
UUO is octal at user PC address
File filespec
where:
jobno is the number of the job causing the error.
nnn is the number of the controlling TTY.
xxxxxx is the name of the program running for that job.
octal is the octal representation of the monitor call
that failed for that job.
address is the value of the program counter for that
job.
filespec is the file specification for the file being
accessed.
10.5.4 Identifying CPU Stopcodes
A CPU stopcode has the same effect as a STOP stopcode. In other
words, a CPU stopcode indicates an error that endangers the integrity
of the entire system. The monitor prints the following message on the
CTY:
?CPU0 monitor error. Stopcode name xxx
Reload monitor
This means that all jobs are aborted and the system begins to
automatically dump and reload the monitor.
If the monitor can obtain the necessary information, it prints a
10-10
ERROR RECOVERY ON THE KS10 CENTRAL PROCESSOR
supplementary message on the CTY of the form:
Job jobno on TTYnnn Running xxxxxx
UUO is octal at user PC address
File filespec
where:
jobno is the number of the job causing the error.
nnn is the number of the controlling TTY.
xxxxxx is the name of the program running for that job.
octal is the octal representation of the monitor call
that failed for that job.
address is the value of the program counter for that
job.
filespec is the file specification for the file being
accessed.
10.5.5 Identifying HALT Stopcodes
A HALT stopcode affects the entire system. Also, the monitor cannot
automatically reload. In this case, the system halts, and you must
manually dump and reload the monitor. (See Section 10.2.2.)
10.5.6 Identifying INFO and EVENT Stopcodes
INFO and EVENT stopcodes report on system events that may be of
interest in debugging crashes. These stopcodes are for informational
purposes only, and do not interrupt system or job execution. EVENT
stopcodes are the same as INFO, but do not ring the terminal bell, and
the CTY message is in a different format.
10.6 RECOVERING FROM PARITY AND NXM ERRORS
Memory-system errors are hardware errors. The types of memory-system
errors are:
1. Parity errors
2. NXM (nonexistent memory) errors
10-11
ERROR RECOVERY ON THE KS10 CENTRAL PROCESSOR
When the system detects a parity or NXM error, it performs the
following steps:
1. Prints a series of informational messages that describe the
error.
Include these informational messages in the system logbook.
They are important because they provide the system
programmers and your Field Service representative with
information that will help them troubleshoot the problem. To
make the informational messages easy to identify, 15
asterisks (that is, ***************) print on the CTY above
and below each message series. (See Examples 1 and 2.)
2. Tries to automatically recover in the way that causes the
least amount of damage.
3. Prints one of the following error messages if it cannot
recover:
?Non-recoverable memory parity error in monitor.
[CPU Halt]
?Non-existent memory detected in monitor.
[CPU Halt]
If either of the above error messages prints on the CTY,
perform the following steps:
a. Include the error messages that are printed on the CTY in
the system logbook.
b. Manually dump and reload the monitor. (See Section
10.2.2.)
c. If you cannot dump and reload the monitor, call your
Field Service representative.
Examples 1 and 2 are similar to what you see on the CTY when the
monitor detects a memory error.
Example 1: (CPU Parity Trap)
***************
CPU0 parity trap at user PC 007017 on dd-mmm-yy hh:mm:ss
Job 42[WRTBAD] was running
Page fail word = 760000,013271
Mapped page fail address = 5