Digital PDFs

AA-P512C-TB

May 1988

172 pages

Original

11MB

view download

OCR Version

6.0MB

view download

Document:	704 Monitor Installation Oct88
Order Number:	AA-P512C-TB
Revision:	0
Pages:	172
Original Filename:	AA-P512C-TB_704_Monitor_Installation_Oct88.pdf

OCR Text

TOPS-10

Software Installation Guide
AA-P512C-TB

October 1988

The TOPS-10 Software Installation Guide provides the site
administrator, system manager, system programmer, or

software specialist with the information required to install
the TOPS-10 software on KL and KS processors.

Operating System:

TOPS-10 Version 7.04

Software:

GALAXY Version 5.1

digital equipment corporation, maynard, massachusetts

First Printing, February 1984

Revised, April 1986
Revised, October 1988

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 only 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.

The Reader's Comments form on the last page of this document requests the
user’s critical evaluation to assist in preparing future documentation.
The following are trademarks of Digital Equipment Corporation:

DECtape

LAS0

SITGO-10

DDCMP

DECUS

LNO1

TOPS-10

DEC

DECwriter

LNO3

TOPS-20

DECmail

DELN!

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

Q-bus

VT50

DECsystem~10

KL10

ReGIS

DECSYSTEM-20

KS10

RSX

Eflgflnan TM

CONTENTS

PREFACE

GETTING

THE

the

Powering

the

Worksheet

SYSTEM

BOOTING

THE

SYSTEM

Initializing
Booting
BOOTING

the

THE

the
KL

THE

DIALOGUE

ONCE

BUILDING

THE

BOOTSTRAP

MONITOR
.

NEW

SYSTEM

MONITOR

FILE

WWwwhH

Front- End

SYSTEM

STARTING

BRINGING

Monitor

ALLOCATING

DISK

SPACE

FOR

RESTORING

BACKUP

FROM

TAPE

RESTORING

FILES

3 Ui i

INFORMATION

Worksheet

CREATING

Restoring
Restoring
Software

CORYING
USING

KL10
K310

THE

[S NG NS MO NE;]

SYSTEM

Powering

THE

THE
THE

SYSTEM

the
the

FROM

TAPE

SYSTEM
THE

FRONT-END

.
TO

DISK

Bootstrap Monitor
Monitor Sources and Assoc1ated

TOPS lO
FILES

SYSTEM

INTO

FILES

iii

DIRECTORIES

]

W
B

bdWWWWN

Hardware

CONFIGURATIONS

Hardware

MATERIALS

HARDWARE

POWERING

INSTALLATION

BOOTING

)]

INSTALLATIONS

NNDDDNOND

SYSTEM

REQUIRED

PREPARING

[S; NS

INSTALLATIONS

EXISTING

INFORMATION

FRONT-END

PREPARING
OO

TOPS-10

dbdbdbWWWN

SUPPLEMENTARY

KL,

CHAPTER

FOR

CHAPTER

FOR NEW

PATH

PREPARATION

PATH

READING

WWwww

PART

READING

=
e

INTRODUCTION

CHAPTER

STARTED

NDNNNODNODNNONNNNNN

PART

THE

SUPPLEMENTARY

BUILDING

THE

CREATING

the

Booting

the

THE

Writing

UPGRADING

CHAPTER

FRONT-END

Front-End
KS

Creating A

N
e
o) Wer
(el e

PART

BUILDING
=

CHAPTER

FILE

SYSTEM

Front-End

from

DlSk
FILE

.
SYSTEM

File

Bootstrap

EXISTING

FILE

MICROPROCESSOR

Front-End

the

PROCESSOR’S

System Directory Area
Program to Disk

SYSTEM

RESTORING

THE

DISTRIBUTION

RESTORING

MICROPROCESSOR

RESTORING

THE

MONITOR

RESTORING

THE

SUPPLEMENTARY

RESTORING

THE

DISTRIBUTED

TAPES
FILES

SQURCES

AND

ASSOCIATED

WRITING

BUILDING

THE

File System
Front-End Reload
.

THE

BOOTSTRAP

MONITOR AND

PROGRAM

TAILORING

Installatlon
TO

DISK

Dlalogue
Front-End

Automatic

SOFTWARE
o

RSXINS

FRONT-END

The

Automatic

SYSTEM

RSXINS

FILE

USING

PROCESSOR’'S

O W
D

PART

WRNNNN
R

CHAPTER

os}

SOFTWARE

THE

SYSTEM

CHAPTER

BUILDING

9.1

MONGEN

MONITOR

Running MONGEN
The MONGEN Dialogue

9.1.1

9.1.2

9.1.2.

Running

9.1.2.

Running FGEN

9.2

ASSEMBLING

THE

LINKING

9.4

BRINGING

9.5

CREATING

THE

9.5.2

8.6
9.6.1

9.6.2
9.7

AND

Copying

MONITOR
THE

.
MONITOR

New Monitor

THE

NEW

Creating the
THE

Tape

BOOT

BOOT
BOOT

THE
THE

10.2.

Running

10.2.

Assembling

STARTING

Files

AND

PROCEDURE

the

TAILORING

TAPE

System Bootable

the

10.2

BUILD

Customizing

10.1

Tape

Customizing

c
.o

BOOTABLE

9.7.2

STARTING

System Bootable

9.7.1

SYS:

Customizing the Build
The Build Procedure
CUSTOMIZING

MONITOR

SYSTEM

the

AUTOMATING

SAVING

the

Creating

Questlons

SYSGEN

9.3
9.3.1

9.5.1

CHAPTER

YOUR

9-22
9-24

TAILORING

GALAXY
GALAXY

THE

GALAXY

SYSTEM

SPOOLERS

10-1

SYSTEM

10-2

GALGEN

the

10-2

Tallored

10.3

SHUTTING

DOWN

THE

10.4

STARTING

THE

GALAXY

GALAXY
SYSTEM

SYSTEM

System
.o

10-10

10-11
10-13

MAINTAINING

11.

CONVERTING

11.

ENTERING

AND

11.

GETTING

HELP

11.

DISPLAYING

11.

CREATING

REACT

11-2

INFORMATION

11-3

Accounts

w1th

the

New

Account

ACCOUNTS
CHANGES

ACCOUNT

Same
11-3

Single

DELETING

User

11-4
11-6

11-7
TO

ACCOUNTING

FILES

VALIDATION

11-7

11-8

11.

CREATING

THE

PROJCT.ACT

FILE

11-9

11.

CREATING

THE

PROJCT.EXE

FILE

11-10

RECORDS

11-11

REACT

11.

USER-MODE

COMMANDS

CREATING

12.

INITIA

12.

The

Format

STARTUP

Terminal

12-4

Llnes

12-5
12-6
12-9

12-9

ONCE

OPTIONS

SYSTEM

RUNNING

ONCE

STARTUP

OPTIONS

STARTUP

USER
AND

MODE
SWITCHES

CHANGing

System

DEFINing

Structures

Parameters

EXITing

Monitor

Single

Option

CHANGING

Optlon

THE

Structures
Parameters

MONITOR

LIBRARY

SYMBOLS

Defined

COMMON

Symbols,Values

SIXBIT

Symbols,Values

Defined

Decimal

Symbols

MONITOR

COMMON

Octal

Level

Selected

THE

Decimal

Octal

Structure

System

Symbols

LlStS

COMDEV

Symbols,Values

FILE

SHOWing

System

NOINITIA

and

Structures

DISSOLving

REFRESHing

W N

12-4

TTY.INI

D WD

kW=

12-2

INFORMATION

REBUILDING
NN

SYSJOB.INI

File

ONCE

Wo~Jo

WWWWLWWWWWWWwNh

12-1
12-2

Specifying Terminal Options
Associated (Error) Messages
The INITIA Monitor Command

MODIFYING
DD NDNDNODNN

Towoowwww

STARTUP

DESTROYing All

FILES

File

Specifying

SUPPLEMENTARY

TTY.INI

11-13

INITIALIZATION

SYSTEM

Format

11-12

{

12.

SYSTEM

FAILURE

COMMANDS

ovltveieviveRlusiNes
RN ve v v

12.

SYSJOB.INI

The
W N

e
e
e

12.

TOP-LEVEL

MAINTAINING

WNNNNDN

11.
11.

12.

APPENDIX

11-1

Number

VERIFYING

12.

APPENDIX

FILES

ACCOUNTS

11.

USING

Multiple

11.
-

FILE

REACT

ACCOUNT

ACCOUNTS

12.

WHILE

CHANGING

11.

AUTHORIZATION

ACCOUNTING

USER

Creating

11.

SYSTEM

EXITING

NEW

Project
11.

PART

OLD

Creating

11.

CHAPTER

THE

CHAPTER

()O(?()Q(fi()O(d

SCDSET

PARAMETERS

PRIVILEGES

CAUTIONS

COMMANDS

EDIT

EXTIT
HELP

READ/SET
JOBS

SCDMAP.SYS

FILE

CREATING

BOOTABLE

UPDATE
THE

oo
o

Symbols,Values

SCHEDULER

REQUIRED

(620SOV
NI o

DWWWWWWwN

Symbols,Values

SIXBIT

SETTING

COMMOD

wwww

Octal

Symbols,Values

FRONT-END

GORONNNN

wowww

APPENDIX

Defined

Decimal

C
Qoo
an

APPENDIX

Symbols

MEDIA

D.1

BUILDING

THE

PRIMARY

D.2

BUILDING

THE

THIRD

9-1

Monitor Build Files
FAILUR.LOG File Format

11-11
11-12

BOOTABLE

VOLUMES

VOLUME

GLOSSARY

INDEX

TABLES

11-1

11-2

Top-level

11-3

REACT

12-1

REACT

Field

Commands

Change

Commands

Special

Processing

Commands

12-2

Options

c-1

SCDMAP .SYS

Run

Programs

Format

9-17

11-14

12-7

12-8

C-6

PREFACE

This manual describes how to install, upgrade,
customize,
and
start
the
TOPS~-10 operating system.
It includes procedures for loading the
default monitor, copying the programs from the distribution
tapes
to
disk,
Dbuilding
the
monitor,
starting
the
operating
system,
and
creating
the
bootstrap
tape.
The
procedures
for
installing,
customizing,
and
starting
the
GALAXY batch and spooling system are
also included, as well as descriptions of
the
wvarious
system
files
needed
for
timesharing
on
the
TOPS-10 system.
The procedures are
described and explained in a step-by-step method.
The

TOPS-10

following

Software

Installation

situations

Start

the

Change

the

Install

Change

disk

Guide

may

shutdown

also

11used

the

to:

system

after

monitor

failure.

configuration.

new version

the

monitor

GALAXY

subsystem.

parameters.

This manual is intended for experienced TOPS-10
software
who
are
familiar
with TOPS-10 conventions for commands
You should be able to operate the hardware components
of

maintainers
and symbols.
the
system

being
installed.
For
example,
instructions
for mounting software
media (tapes and disks) are not
documented
in
this
manual
because
those
procedures
are
documented in the TOPS-10 Operator’s Guide and
the TOPS-10/TOPS~-20 Operator’s Hardware Device and Maintepance Manual.
The

following

additional

TOPS-10/TOPS-20
This

manual

batch
TOPS-10
This

manuals

are

also

valuable

sources

information

for

reference:

Batch Reference
provides

control

Operating
manual

files
System

Manual

information
to

the

GALAXY

Commands

provides

about
batch

writing

and

submitting

processor.

Manual

information

about

monitor

commands

and

program

and

conventions.
TOPS-10

This

Operator’s

Command

manual

provides

operator-privileged

Language

Reference

information

commands.

vii

about

Manual

+the

OPR

TOPS-10

MACRO

This

manual

program

TOPS-10

Reference

provides

source

LINK

manual

its

switches,

TOPS-10

Monitor

This

information

commands,
the

and

software

Calls

manual

required

for

making

changes

Manual

provides

after

monitor

information

code.

Reference

This

monitor

Manual

about

TOPS-10’s

linking

functions.

LINK

configuration

has

been

loader,

used

to build
specified.

the

Manual

provides

symbols

in-depth information about monitor calls
and
you
may
wish
to
modify
in the monitor

that

sources.

TOPS-10/TOPS-20
This

RSX-20F

manual

System Reference Manual

provides

information

about

processor.

dialogue

the

PARSER commands.

File

Specification

TOPS-10/20
This

and

USAGE

manual

created

particular

provides
the

USAGE

importance

the
are

information

about

accounting

system.

system’s

references

the

formats

front-end
the

KLINIT

the

files

remote

nodes.

TOPS-10 ANF-10 Software Installation Guide
This
The

manual

provides

information

for

building ANF-10

procedures

for installing a TOPS-10 system
vary
greatly
between
first-time, new.installation of a system, and the installation of
new version of the
monitor
on
a
system
that
has
been
running

the
a

TOPS-10.

This manual
needs of each

specific
Part
to

"Getting

use

will

the

help

Chapter

TOPS-10
out

for

" the

Field

worksheet

information

disk

software

made

the

parameters

"Preparing

describe

the

building
Part

the

upgrading

the

are

Part4,

"Building

the

particular

and

new

needs of
installations.

Part

"Supplementary

for

modifying

the

describe

alternatives

the

that

explain

how

can

(Worksheet

which

installation.

when

system

material

your

worksheet

made
up
installers

TOPS-10
existing

Monitor

chapters

document

1).

answered

System",

four

that

to
wuseful

personnel

software

address

building

help

you

the

fill

manager

you

(Worksheet

and

Queéstions

about

3).
a

DIGITAL

must

Software

is
made
up
of
four
chapters
that
TOPS-10
installers
must
complete
before
new installation.

procedures
monitor

chapters

introductory

apply

Service

parts

System",

procedures
monitor on a

"Upgrading

describe

the

two

that

worksheet
can

separate

that

Specialist.
Part

(Worksheet

for

considerations

into

contains

worksheets

DIGITAL

hardware

the

Chapter

find the procedures

contains

monitor.

the

provide

Started",

manual.

you
2

is organized
case.

your

and

how

monitor

two

must

chapters

complete

Tailoring

the

System",

made

tailor

build

your

monitor

and

site.

This

part

applies

appendixes

the

that
before

system.

Information",

made

installation

software.

viidi

procedure

both

and

upgrades

that

information

This

part

how

is
wuse

PART

made

this

GETTING

two

manual.

STARTED

chapters
Chapter

which

explain

contains

introductory material which will help you find the
procedures
that apply to the installation you are
responsible for.
Chapter
2 contains
worksheets
that are useful when building the TOPS-10 monitor.

CHAPTER

INTRODUCTION

Before you install the system, read the cover letter distributed
with
the
software
package,
and
the
BEWARE
file
(MONITR.BWR)
that is

included on the Monitor/ANF-10
last

minute

included
This

changes

manual

procedures

this

manual.

uses

the

for

Within

The

READING

new

PATH

system

type

sections,

system,

type
Part

of
4

tailor

each

processor

and
it

follow
to

the

the chapters in
installation.

PART

Chapter

This

It
you

that

denote

about

could

the

not

different

one

type

processor

include

references

are

made

the

text

(KL

or
of

data

the

system

read

and
of

KS)

and

you

find

formatted

the

all

system

the

read

and

are

appropriate

you

are

that

installing.

necessary

build

site.

are

all

the

for

Next,

your

Below

instructions

that

disks.

files.

Then,

particular

the

and

that

your

and

Part

procedures

the

monitor

appropriate

summary

for

to
and
of

new

apply

the

sure

that

STARTED

INTRODUCTION
chapter

helps

you

are

the

currently

procedures

responsible

that

for.

PREPARATION

Chapter
was

first
1

needs

installation
Chapter

have

chapter

the

Parts

GETTING

specific

initialize

Chapters
in

information

title.

new

only

the

assumed

install
Part

INSTALLATIONS

must

instructions

conventions

FOR NEW

you

contain

procedures

processor.

Therefore,

the

They

systems:

appropriate

type

tape.

installation

following

and

processor

each

1.1

Sections
the

describes

installed
contains
will

how

worksheets

need

properly
during

check
and
help

the

hardware

ready

you

installation.

for

prepare

software
the

installation.

information

that

INTRODUCTION

PART

Chapter

PREPARING

THE

BOOTING

This

chapter

tape

and

SYSTEM

THE

SYSTEM

describes

boot

the

booting

the

front-end

system,

you

can

Chapter

This

chapter

start
Chapter

the

This

areas

describes
the
initialization
Chapter

This
KL

THE

and

chapter

ONCE

FILE

how

unbundled

you

Chapter

BUILDING

THE

This

BUILDING
chapter

MONGEN.

Chapter

You

system

10:

can

particular

load
Chapter

the

11:

This

AND

Chapter

CREATING

chapter
start

system

wup

how

the

and

initial

describes

monitor
from

for

the

this

how

the

sources,

control

files

FILE

front-end

how to

CUSPs,

distribution

purpose.

PROCESSOR’S

TATILORING

and
new

tailor

tapes

also

and program

SYSTEM
processor

(for

boot

the

THE

SYSTEM

the

<create

load the
version

TAILORING

systems)

(for

from

the

front-end

from

monitor

wusing

THE

TOPS-10
new

new

start

configuration

software,

the

GALAXY

monitor

and

reload

monitor.

SYSTEM

up the
batch

installation,

GALAXY
spoolers
and
spooling system to

and

and how

assemble

and

system.
THE

SYSTEM

how

files.

AUTHORIZATION

use
The

describes
TOPS-10

the

for

INITIALIZATION

the

REACT

system

authorization

SYSTEM

reloaded.

the

copy

and

used

describes

accounting

and disk usage

12:

This
to

needs

GALAXY

MAINTAINING

chapter

system

PPNs

new

+this

SYSTEM

copy

This chapter describes how to
servers,
how
to
tailor the
the

With

from

describes

MONITOR

assemble

STARTING

monitor

chapter

installation.

microprocessor

start

new

administrative

how

describes

well.

software

MONITOR AND

THE

SUPPLEMENTARY

the

MONGEN

files.
the

THE

this

monitor.

prepare

distribution media to disk,
disk with the new software.

PART

bootstrap

dialogue,

MONITOR

system’s
files.

TOPS-10

the

describes

systems)

systems,

that

BUILDING

the

monitor

describes

system,

disk

the

describes

chapter

load

MONITOR

bootstrap

BUILDING

GALAXY

into

THE

to
For

processor

build

STARTING

how

system.

program

accounting

create

files

the

specify

users.
FILES

INITIA program,

system

FILES

components

and how to

use

automatically

INITIA
when

the

INTRODUCTION

1.2

READING

you

has

are

PATH

installing

been

running

information

on
initialization
monitor

tape

from

and

systems)

the

type

and

it
to
the
chapters in

(KL

procedures

needs

of
1,

the

file

system
with

restore

.existing

system

first

KS)

a
disks

that
system

create
system
accounting
or
not
need to boot the bootstrap

sources,

chapter

use

files

from

procedures.

for

Chapters

each

monitor

probably

to
fall
back
install or run.

the

necessary

monitor

monitor,

Part

Parts

these

front-end

processor

the

will

monitor

new

instructions

the

you

need
not
you
will

existing

allow
you
difficult to

install
the

new

instructions
of

INSTALLATIONS

version

However,

documented

the

(for

new

You
and

files

save

This
will
monitor is
To

them.

building

should

TOPS-10,

tape.

exactly

Before

FOR EXISTING

that

Part

your particular
and
4
that

disk

follow
read

that

are

have.

Next,

your

you

components,
or

old monitor

Then,
3

build

GALAXY

backup

and

you

your

read
and

necessary

installation,

CUSPs,

all
and

tape.

the

new

the

all

appropriate

for

monitor

Part

and

site.
Below 1is a
are
appropriate

summary
for
a

procedures

apply

tailor

of the
system

upgrade.

PART

Chapter

GETTING

This

STARTED

INTRODUCTION
chapter

helps

installation
Chapter

you

will

find

the

Chapter

need

Chapter

during

checklists

chapter
into

This

THE

BUILDING

unbundled

them

Chapter

the

chapter
the

BUILDING

This

files.

that

the

for.

You

MONITOR

how

from

THE

FILE

this

restore

the

important.
Chapter
information that

the

installers

chapter

disk

will

useful.

PROCESSOR’S

build
systems

system

MONITOR

YOUR

CUSPs,

and

how

and

copy

the

front-end

only)

systems

FILE

and

SYSTEM

file

how

system

and

create

the

only)
.

TAILORING

THE

SYSTEM

MONITOR
how

used

assemble

start

(KS

AND

monitor,
tapes,

areas.

(KL

file

the

distribution

how to

can

very

SYSTEM

SUPPLEMENTARY

describes

prepare

Experienced

worksheets

front-end

MONGEN

system

monitor
you

help

describes

THE

chapter

the
to

appropriate

BUILDING

MONGEN.

the

responsible

installation.

and

describes

software

microprocessor

the

SYSTEM

THE

RESTORING

reload

PART

find

currently

for building
worksheets

UPGRADING

This

you

are

PREPARATION

Preparation
2
contains

PART

you

the

and
new

tailor

the

<create

load

the

version

TOPS-10
new

new
the

monitor

software,
monitor.

using

configuration

and

reload

INTRODUCTION

Chapter

10:

This

STARTING AND

chapter

servers,

the

Chapter

the

11:

This

and

This

chapter

the

Appendix
This

This

are

This

all

assemble

and

FILES

program to

create

files

the

specify

FILES

and

how to

use

automatically

INITIA
when

the

Part

This

appendixes

information
summarized

for

contain

consists

alternatives

modifying

the

monitor

below:

options

and

start

the

ONCE
program
monitor.

the

that

MONITOR

file

how

by
by

modify

hand,

and

Digital

the

generate

Equipment

the

monitor,
a

build

monitor

that

Corporation.

relevant

symbols,

the

not
also

source

SCHEDULER PARAMETERS

explains
quotas,

logged

CREATING

how to

for

wuse

adjust

jobs,

BOOTABLE

describes

bootable

The

descriptions
symbol files.

appendix

media

OPTIONS

THE

supported

usage

how

and

system

users.

components

provided

glossary.

brief

'SETTING

for

spoolers

spooling

accounting

INITIA program,

system

describes

appendix

class
Appendix

the

describes the
characteristics

and

system

and

system

INITIALIZATION

procedure,

library

completely

STARTUP

appendix

modules,

GALAXY
and

INFORMATION

MODIFYING

contains

the

batch

the.REACT

authorization

appendixes

disk

use
The

appendix

monitor

Appendix

how to

SYSTEM

and

ONCE

define

installation,

files.

information

The

This

start
GALAXY

SYSTEM AUTHORIZATION

TOPS-10

installation

Appendix A:

SYSTEM

reloaded.

appendixes

software.

GALAXY

the

THE

describes

SUPPLEMENTARY

Supplementary

THE

system.

usage

wup

describes

CREATING

system

four

needs

GALAXY

disk

start

how

tailor

accounting

12:

new

chapter

PPNs

1.3

MAINTAINING

system

Chapter

describes

how

particular

load

TAILORING

SCDSET

and manipulate

FRONT-END

the

scheduler

program

parameters,

set

update

SCDMAP.SYS

the

file.

MEDIA

procedure

for

making

the

front-end

RSX-20F.

Glossary

The

glossary

manual.

lists

and

defines

the

specialized

terms

used

this

CHAPTER 2
PREPARATION

This chapter explains the steps and precautions
to
take
before
you
install the monitor on a new system or upgrade your existing monitor.

you

are

installing

new

system,

DIGITAL

Field

Service

Representative will install the hardware components of your system and
will run diagnostics to ensure that the hardware functions properly.
The

materials

system

you need to

install

new system or upgrade

existing

are:

A supported hardware

configuration.

See

Section

2.3.

To ensure that you have the
hardware
information
that
you
need
to
install
the
system,
prepare
Worksheet 1 in this
chapter.
If you are installing a new
system,
the
hardware
characteristics should be listed for you by the Field Service
Representative.
o

A disk

unit

At least
upgrade.

with plenty

free

100,000
disk
blocks
A
newly
formatted

space.

are
disk

required
for
1is
required

a
system
for a new

installation.

Software distribution media:
floppy diskettes.

magnetic tapes,

DECtapes,

and

Each type of processor requires software that is
distributed
on
a
different
set
of media.
The distribution package is
described in the following sections.

A list
Use

software

Worksheet

list

Use

in this

accounting

this
files

and options.

chapter to

disk parameters

Worksheet

System

components

and

chapter to
to

record this

information.

lists.

record this

record user

information.

accounts

and

access

privileges.

You can create
these
with
described in Chapter 11.

the

REACT

program.

REACT

PREPARATION

SYSJOB.INI

system

file

Chapter

OPR.ATO

explains

file

reload

the

2.1

TOPS-10

The

following

how

can

TOPS-10

contains

tape

for
the

Monitor

are

file,

included

DECnet-10

CUSP

for

"Commonly

program

that

user.

all

GALAXY

tape contains

1600

the
and

contains

BPI

Used

by the

the

customer-supported

monitor

tape

are

not

Tools

contains
as

1600

about

that

last

could

System

Program".

important

tapes

contain

monitor

CUSPs

system.

BACKUP

functions

not

The

program.

for

the

The

latest

the

files

tapes

are
CUSP

first

which describes

changes

customer
1600

BPTI.

files

modules

Tape

files

supplied.

supported.

CUSP

the
and

that are supported by
the
This tape is also written at
following types of files:

This

information

files

CUSP

Unsupported

ANF-10
at

programn.

DIGITAL.

customer-supported

purposes,

BACKUP

tape.

The

and

written

procedures

a file named CUSP.BWR,

contains
by

distribution

monitor
is

the

spooling

Tape

contains

These

Customer-Supported

not

tape

TOPS-10

CUSP

tape

the
file,

software

bundled

provides

the

This
It

batch

programs

base,

OPR.ATO

Tapes

the

The

and

files

the

load

files

and

file.

inclusion
on

manual.

versions

written

SYSJOB.INI

automatically

the

installation

monitor
the

The

which

network

stands

system

the

(BPI)

in this

network

TOPS-10

for

files

changes

ANF-10

"CUSP"

automatic

following:

for

Tape

contains

density

MONITR.BWR

The

wused,

provided

TOPS-10.

source

minute

create
be

Monitor/ANF-10

bits-per-inch

wuse

front-end - by
For information
Operator’s Guide.

tapes

magnetic

software

INSTALLATION MATERIALS

magnetic

This

file

commands.

TOPS-10

SYSTEM

The

also

package:
o

OPR.ATO

communications

appropriate
see

and/or

startup.

that
The

can

tools

are

wused

provided

for
"as

various
is",

and

PREPARATION

Bootable

The

Tape

related
This tape contains the TOPS-10 bootstrap monitor and
provided to allow you to
1s
tape
bootable
The
programs.

start a standard operating system used to build a

Software

Unbundled

written
'

tape

The

monitor.
program.

customized

1600 BPI by the BACKUP

Tapes

For each unbundled software product, magnetic tape(s)
software

the

necessary for running the software.

contain

Note that

that
unbundled options may require installation instructions
not included in this manual because the product contains
are
own installation manual.

its

2.2

KL FRONT-END INSTALLATION MATERIALS

for the
The KL processor installation is also supplied with software
The front-end software is distributed on different
RSX-20F front-end.
A KL10-D
system.
of
depending upon the type
of media,
types
(DECsystem-1090)
DT-B, and DT-C.

floppy diskettes,

2.3

labeled DT-A,
DECtapes,
three
requires
front-end
three
front-end requires
A KL10-E (DECsystem-1091)
labeled FLP-A,

FLP-B,

and FLP-C.

REQUIRED HARDWARE CONFIGURATIONS

The bootstrap monitor for TOPS-10 requires a minimal set of peripheral
The required configurations are different for the KL and KS

hardware.
systems,

KL Hardware

2.3.1

For

and are specified below.

processor,

the

minimally

peripherals for the boostrap monitor is:

One RH20 for disk,

required

configuration

and

configuration

dual-ported between the front-end

processor

One

RH20

CTY

(console terminal)

KS Hardware

2.3.2

For

for tape

KS$

processor,

the

minimally

peripherals for the bootstrap monitor is:
o

One RH11

(UBA#1l)

for disk

One RH11

(UBA#3)

for tape

CTY

(console terminal)

required

PREPARATION

If you are
available

installing

begin

system;

continue

version

2.4

the

reading

monitor

POWERING UP

Before

powering
¢

For

THE

the

magnetic

Power

the

line

the

terminal

Service

printer,

the

Manual

the

light

system,

installing

Section

the

following

the

new

2.5.

port

controller

select

dual-ported between
position.

tape

the

switch

KL10

and

the

drives.

the

sure

each

terminal

set

Representative

loaded

setting

300

baud.

what

the

powering-up

for

For

with

paper

line

speed.

LA120,

and

ask

the

baud

rate

should be.

not

powered

up,

Device

and

drive,
or magtape drive
TOPS-10/TOPS-20
Operator’s

for

steps:

Make

must

KL10,

2.4.2

press

position
labeled

refer

the

Hardware

procedures.

black

labeled

POWER

instructions.

the

switch

POWER

lit.

ON.

TOPS-10

you

the

When

the

have

never

OQperator’s

upper

system

control

powered

Guide

for

the

detailed

Powering up the KS10

power

the

KS10,

powered

up,

few

seconds.

will

try

AUTO

continue
stop

that

Chapter

following

button

the

microcode
on

the

from

microcode

will

AUTO

process

searching

you

the

every

the

prompt KS10>
load microcode

have

powered

But

first,

instructions

the

light

disk

not

this

The

message

operation

and

the

from

tape.

microcode

printed

system,

the

you

can

disk.

the

CTY.

boot

information

section.

CTRL/C

you

system

unsuccessful

Enter

system

takes

the

disk,

will

on,

drive

that

the

usually

the

comes

seconds.

prepare

When

This

for

the

POWER.

lit.

indicate

microcode

labeled

power

CTY

how

Now

the

labeled POWER

after

Because

CTRL/C,

describes

seconds

load

to
the

press

light

printed

progress.
to

the

load the

will

attempts
to

materials

power

Powering up the KL10

power

enter

are

disk

the

printers.

Check

LA36

all

ready

drives.

CTY(s).

on-line.

Field
line

panel

A/B

Power

2.4.1

the

Maintenance

set

that

disk

you

system,

perform

only,

drive

the

refer

up,

system,

Turn

existing

Power

chapter.

have

now

SYSTEM

systems

disk

this

the

front-end

a
new
system
and
installation,
you are

repeated
CTY

the

When

will

CTY
you

Chapter

described

will

need by

PREPARATION

2.5

PREPARING

INFORMATION

It is important to prepare the information that you will
need
during
installation.
Because this information is lengthy, and may come from
several sources, worksheets are provided to
record
the
information.

Use

the

keep

2.5.1

completed worksheets

record of

the

Worksheet

If you are installing
provide
you
with
Configuration.

2.5.2

Worksheet

reference

characteristics

the

during

installation

and to

system.

a new system, a Field Service Representative can
the
information
for
Worksheet
1,
Hardware

Use Worksheet 2 to
configuration
is

- The
software
system manager.
Information to make the necessary decisions is provided in this manual
and
in
other
documents
in
the
TOPS-10
Software
Notebook
Set.
Questions should be directed to a DIGITAL Software Specialist.

2.5.3

Worksheet

record the software
configuration.
largely
the
responsibility of the

Use Worksheet 3 to record disk characteristics.
The disk system
must
be
defined for the monitor.
This is accomplished when you select the
DEFINE startup option for the ONCE dialogue (see Appendix A).

PREPARATION

Worksheet
Hardware

System name

(24

characters

CPU

K3):

type

Number

CPU

(KL

CPUs

Serial

(KL

Worksheet

maximum)
:

only):

Numbers

CrpUO:
CpPUl:

CpU2:

Total

amount

Clock

ticks

Devices

Answer

YES

or NO to

(KS

512K):

(KL

768K):

the

following questions.

the

system have

One

CI-20

(SCA)

One

NI-20

(Ethernet)

RP01/2/3

disks?

Swapping

drums?

RS04/05
Any

any

DX20/RP20

any

the

following:

subsystem

the

TM02/TM03

disks

disk

subsystem

interfaces?

subsystems?

(RA60/RA81)°7

following

kinds

magtape

controller-based drives

DX10/TX01/TX02-based drives
DX20/TX02-based drives

TM78

interfaces?

fixed-head disks?

CI-based

Are

memory

(60,50):

System

Does

system

controller-based

drives

(TU45/TU77s)?

(TU70/71/72s)?

(TU78/79s)?

TM10B

controller-based

(TU40/41s)?

TM10C

controller-based

(TU43)7?
2-6

present:

PREPARATION

Does

the

system

have

any

the

following

devices:

Line

printers

connected

the

I/O

Line

printers

connected

the

Console

XY10

I/0 bus

plotters?

CR10

I/0

card

Cb20

CFE-based

bus

Bus?
Front-End?

readers?

card

CP10/CP10D

I/0

bus

Paper-tape

punches?

Paper-tape

readers?

card punches?

Front-Ends

Will

any

front-ends

running:

ANF-107?
DN60

IBMCOMM?

DECnet-107?

How many

terminal

lines

are

there

CPU0?
CPU1?
CPU27?
CPU3?

CrPU4?
TTY

number

Which

for

lines on

OPR

(usually

your

system

CTY)?

are

dataset

lines?

PREPARATION

Worksheet

Software

Maximum

number

jobs:

Maximum

amount

memory

Allow

locking

Minimum

jobs?

amount

real-time

Number

HPQs:

Number

PTYs:

Monitor

Answer

memory

Number

per

Worksheet

job:

N):

for

unlocked

jobs:

devices:

Services

YES

the

following

accounting:
Exclude

Use

monitor

EBOX/MBOX

questions

overhead?

clocks?

(KL

only)

Include

Account

verification?

Include

MSGSER?

PSISER?

IPCFEF?

ENQ/DEQ?

time?

(KL

only)

about

user

runtime

PREPARATION

Worksheet

Disk

For

each

file

Structure

Units

(RPAQ,

structure,

Name

Parameters

note

the

Worksheet

following:

(DSKB)

Structure

RPAl)

Consecutive blocks
tried on output
Overdraw blocks
allowed

per

Private

structure?

Owner

PPN

Amount

for

space

crash

Blocks
Bits

file

per

user

cluster

count

Units

For

Unit

each unit,

note

the

following:

Name

Unit-id
SAT

Blocks

SAT

Blocks

Swap

Space

Core
K

PART

PREPARING

THE

SYSTEM

This
part
1is
made
up
of
four
chapters
that
describe
the
preparatory procedures that must be
accomplished
before
building the
monitor
and
tailoring
the
system.
If
you are upgrading an
existing system, you should go to Part 3,
Chapter
7,

now.

CHAPTER
BOOTING

This
how

chapter describes how to
to
boot
the
system.

described
described

3.1

in
in

Section
Section

BOOTING

THE

Before booting the
drives,
load
the
bootstrap monitor.
mounting
software
Device

and

floppy

diskettes,

3.1.
3.2.

THE

3
SYSTEM

load the bootstrap monitor from tape and
The procedure for booting a KL system is

The

procedure

for booting

system

SYSTEM

KL system, you must mount the required media on the
front-end,
initialize the front-end, and load the
If you
are
wunfamiliar
with
the
procedure
for
media, refer to the TOPS-10/20 Operator’s Hardware

Maintenance
disk

Manual

for

packs,

and magtapes.

instructions

mounting

DECtapes,

The monitor, supporting CUSPS, and unbundled software are
distributed
on
magnetic
tape.
The front-end software is distributed on DECtapes
or floppy
diskettes.
Perform
the
following
steps
to
mount
the
distribution

media

and

load

Step

front-end:

Explanation

Mount
For

the

distribution media

DECtapes:
’

Mount

the

DECtape

Drive

Mount

DT-B
For

floppy

diskettes:

Mount

Drive

labeled
the

DT-A

DECtape

the

floppy

left-hand

drive

labeled FLP-A
unit,

floppy
labeled
FLP-B
right-hand drive unit, DX1:.

tape:

Check
in

the

mounting

see

reel,

there

DX0:.

the

Magnetic

labeled

the

Mount

1in

the

write

ring

and

remove

before

the

bootable

tape

Drive

also

mount

disk

pack

that

0.
Disk

pack:

You

must

the

system

properly

where

can

formatted

m’

controller

is
letter

disk

pack

the

The

dual-ported

between

Mount

and

number.
the
used

access.

disk
’‘x’

drive
the

unit’s
the

unit

must
front-end

processor.
The drive
throughout this manual.

RPmx,

RPAQ

be
and

BOOTING

Set the data switches
the front-end control
to 000007.

Check

control

on
panel

THE

SYSTEM

To do this, raise the switches marked
0,
1, and 2 on the switch register to
the up position.
The
data
switches

switches

are

off

when

The

control

switches

the

data

switches

raised.

down,

This

causes

the

Hold the

press
then

3.1.1

the

ENABLE

switch

SW/REG

release

on,

When

switch,

and

vyou

front-end

both.

when

data

configuring
these

or
initialization

right

all

setting

run

the

(KLINIT)

CPU

for

memory.

switches,

the

loaded

from

floppy
dialogue

and
starts.

the

software

DECtape

the

switch

dialogue

press

up.

should

front-end

initialization

Initializing the KL Front-End

At the CTY, type the responses underlined in the dialogue shown
below
and
press
RETURN after typing each response.
You cannot type ahead;
you must wait for the system to respond after you press
RETURN.
The
dialogue
shown
here
is
reproduced
from
a DECsystem-1091, KL10-E,
system startup.
Note that the messages printed
by
the
system
will
differ

slightly

for

DECsystem-1090,

type the same answers to the
system you are installing.
The
KL
initialization
prompting
for
commands

underlined

1in

description

the

TOPS-10/TOPS-20

(KLINIT)
KLI>.
Enter

with

following

KLINIT

RSX-20F VE##-##

example

Reference

REDIRECTED

[DX0:

MOUNTED]

-- VERSION VA##-## RUNNING

MOUNTED]

KLI

ENTER

DIALOGUE

KLI>YES<RET>
KLI -- KL10 S/N:

MOS

Refer

’

CACHE

MASTER

MODEL B,

ENVIRONMENT:

PAGER
OSCILLATOR

EXTENDED

ADDRESSING

INTERNAL

CHANNELS

CACHE

[NO,YES,EXIT,BOOT]?

1042.,

HARDWARE

MCA25

for

DXO0:]

[DX1:

KL10

the

dialogue.

KLI

but

HERTZ

you

should

+type

starts
automatically,
the
responses that are

dialogue.

Manual

hh:mm mmm-dd-yy

[SY0O:

KLI

systems,

regardless

dialogue

RSX~-20F

the

KL10-D,

questions,

the

thorough

BOOTING

The

following

cache

with

question

pager.

BOTH
KLI

and
--

you

press

SELECT

THE

applies

only

have

MCAZ25

RETURN.
PAGE

TABLE

SYSTEM

installations

cache

pager,

with

answer

this

MCA25

question

[FILE,BOTH,0,1]

KLI>BOTH<RET>
KLI

PAGE

KLI

RELOAD

TABLE

SELECTED:

MICROCODE

BOTH

[YES,VERIFY,FIX,NO]?

KLI>YES<RET>

KLI

MICROCODE

KLI

RECONFIGURE

VERSION

###

CACHE

LOADED

[FILE,ALL,YES,NO]?

KLI>ALL<RET>
KLI

ALL

KLI

CONFIGURE

CACHES

ENABLED

MEMORY

[FILE,ALL,REVERSE,FORCE,YES,NO]?

KLI>ALL<RET>
LOGICAL

MEMORY

CONFIGURATION

ADDRESS

SIZE

INT

TYPE

000000000

768K

MF20

KLI

LOAD

BOOTSTRAP

CONTROLLER

[FILE,YES,NO,FILENAME]?

KLI>YES<RET>

KLI

WRITE

CONFIGURATION

FILE[YES,NO}?

KLI>NO<RET>
KLI

--BOOTSTRAP

LOADED

AND

STARTED

BOOT V# (##)
BOOT>

3.1.2

Booting the

BOOT>

are

the

prompt,

loading,

name,

and

defaulting

KL Monitor
type

followed

press

the

the
a

file

switch

RETURN.

The

specification
to

specify

file

the

tape

monitor

you

drive

controller

optional,

specification

following:

DSKB:SYSTEM.EXE([1l,4]/switch

Where
One

/TM02

’/switch’
the

identifies

following

/TMO3

for

TU45

than

/TM10

/TX01

/TX02

and
0,

unit

TU10,

for

tape
may

Unit

the

for

the

switches

used:

TU77

tape

specify

for

drives.

/TM02:u

the

For

and TU41

TU71,

/TM78 :nx

for

TU70,

for

TU78/79

digit
is

TU71,

for
single

drive.

drives

other

/TM03:u,

TU72

tape

drives.

tape

drives

channel
.

/DX20

tape

number.

TU40,

TU70,

controller

TU72

a DX20

where

’u’

DX10

channel.

tape drives, where
‘n’
is
a
single
the TM78’s MASSBUS unit number and ‘x‘
digit for the slave unit number.

BOOTING

When

BOOT

has

procedure

located

the

from

system

file

DSKB:SYSTEM.EXE

[1,4]]

the

running,

the

system

name

tape,

the

printed

1loading

the

CTY:

dd-mmm-yy

ONCE

dialogue

allowing

you

Continue

the

starts
give

Monitor".

Step

Section

3.2

BOOTING

THE

booting

automatically

the

installation

Bootstrap

Before

monitor

begins

KL10

The

SYSTEM

begins.

[Loading
When

the

THE

monitor

the

procedure

ONCE

fails

when

with
to

the

information

Chapter

start,

repeat

3.1.

the

monitor

starts,

requires

run.

"Starting

the

procedure

from

SYSTEM

system,

you must mount the required media on the
supporting
CUSPS, and unbundled software are
distributed
on
magnetic
tape.
If
you
are
wunfamiliar
with
the
procedure for mounting software media,
refer to the TOPS-10 Operator’s
Guide for instructions on mounting disk packs and magtapes.
drives.

The

monitor,

First,
write

you will mount the bootable tape.
Check to see if there
is
a
ring in the reel.
If present, remove it and mount the bootable
on tape drive 0.
You may use a drive
other
+than
MTAOQ.
Next,

tape
mount

Start

the

formatted

disk

pack

bootstrapping

CTY.

The

system

disk

procedure

responds

drive

typing

printing

the

BOOT>

KS10>

prompt

prompt
on

the

on
CTY.

KS10>MT<RET>
KS10>USR

MOD

BOOT V# (##)
BOOT>

the

BOOT> prompt,

monitor
press

and

RETURN.

type

switch
The

file

the

that

file

specification

specifies

specification

the
is

following:

tape

drive

optional,

the

bootstrap

controller,

defaulting

then
the

DSKB:SYSTEM.EXE{1l,4]/switch

where

' /switch’

following

/TM02

When

BOOT

/TMO3

procedure

has

the

ONCE

located

the

Bootstrap

the

controller

and TU77

the

for

the

tape

used:

tape

drive.

drives.

monitor

file

from DSKB:SYSTEM.EXE

[1,4]]

begins

running,

the

The

the

tape,

the

system

name

printed

the

CTY:

dd-mmm-yy

you

Continue

TU45

dialogue

allowing

Section

for

system

KS10
The

may

begins.

[Loading
When

identifies

switches

starts
give

the

installation

Monitor".

TIf

automatically
monitor

the

procedure

ONCE

fails

with
to

3.2.
3-4

when

the

information

Chapter

start,

repeat

monitor

starts,

requires

run.

to
"Starting

the

procedure

from

the

CHAPTER 4
STARTING

THE

BOOTSTRAP

This chapter describes how to start up
standard

and

default

settings.

MONITOR

the

The

bootstrap

ONCE

monitor

program

always

using
runs

monitor startup and offers several options to the way it can run.
For
complete
information
about
ONCE, refer to Appendix A.
This chapter
contains only the information
and
procedures
needed
to
start
the
bootstrap monitor on a new installation using default disk parameters.
ONCE

allows

the

Keep

user

to:

record

the

reason

date

and

time

for

starting

reloading

the

system.

Provide

the

Define,

change,

and

show

Define,

change,

and

show the

list,

the

active

for

the monitor.

structure

and unit

system

swapping

lists

list,

parameters.

the

and the

system

system dump

list.

4.1

Start

THE

ONCE

the

monitor.

DIALOGUE

ONCE begins by printing, on the CTY, the system name and the date that
the
monitor was created.
The system name can be changed when you run
the MONGEN dialogue described in Chapter 9.
After printing the system
name
and
date,
ONCE
scans memory to be sure that it is accessible.
Each monitor

is built for a specific amount of memory.
When you build
your
monitor
wusing
MONGEN,
vyou
will
specify the amount of memory
needed for your installation.
Since you are installing a new
system,
you
may
receive
the
following message, indicating that the default
monitor was built to expect more memory than that which
1s
currently
on-line:

$Memory from xxxxxx to yyyyyy is off-line
Set memory (DOWN,OFFLIN,ONLINE)
[OFFLIN]:
For

then

new

Why

This

installation,

you

should

type

DOWN

and press

RETURN.

ONCE

asks:

reload:

question

asked

whenever

purpose
of
installing
a new
with NEW,
and press RETURN.

the

system

system,

you

1is

should

reloaded.

For

answer

question

this

the

STARTING

you

the

press

RETURN,
a

RETURN

possible
you

without

responses
will

and

THE

BOOTSTRAP

typing

their

provided

MONITOR

answer,

meanings.

with

list

explanation
of
each.
Appendix A,
Section A.1l.

ONCE

asks

for

date

then

the

date

prints

you

the

detailed

described

ONCE

type

possible

These

are

list

HELP

and

press

responses

also

and

listed

and

printing:

Date:

Enter

the

one

replaced

the

following

forms:

the

name

the

first

three

MMM-DD-YY
ox

DD-MMM-YY

Where

MMM

DECEMBER)
(JAN

abbreviated

through

DEC),

the

year

31)

and

the

hyphens

RETURN,

ONCE

are

asks

to
is

the

numerical
two

optional.

for

the

one

digit
After

month

(JANUARY

characters

day
year

you

the

month

(01

designation.
enter

the

through

month

Both

date

name

through
the

and

year
press

time:

Time:
Enter

the

time

the

following

forms:

HH:MM:SS
or

HHMMSS

Where

replaced

seconds past
minutes, and
It
If

very

you

dates,
or

the
the

hour,
seconds.

important

not,

resulting

time,

startup

you

option

the

minutes

hour,

based

past

the

with

optional
the time

Enter

that

wusers’

you

respond

files

may

with

confusion

and

errors.

correct

the

error

followed by

described

After

this

initial

the

in Appendix
dialogue,

DATE

the
If

you

type

switches
to start
define

with

you

later by

clock,

replaced

the

keyword.

the

enter

the

date

The

and

wrong

the

selecting

hours,

time.

creation

wrong
the

CHANGE

date

CHANGE

startup

ONCE

prompts

return,

ONCE

you

for

lists

the

startup

printing:

Startup

correct

written

24-hour
and

colons
separating
and press RETURN.

may

option

hour,

startup

option

option:
HELP

and

press

options

and

and a brief explanation of each.
This chapter describes how
the monitor quickly using default values.
If you
prefer
to
file
structures
to
suit
the
particular
needs
of
vyour
installation, refer to Appendix A now for more information.

STARTING

4.2
To

BRINGING
start

the

A NEW

new

THE

BOOTSTRAP

MONITOR

SYSTEM

installation

quickly,

the

procedures

this

section.
The
DEFINE
option
provides reasoconable default values for
most disk parameters,
allowing you to create file structures that
are
usable
by
the
monitor
and to construct system lists from the units
that

are

DEFINE

line.

structure

particular
information

and

unit

parameters

suit

the

needs

installation
now,
refer
to
Appendix
about the DEFINE startup option.

for

your

complete

NOTE

your

may
A

disk

units

contain

find the DESTROY

for

complete

unknown

information

about

option.
So

far,

date
the

you

format

you

Refer to Appendix

the

DESTROY

startup

)

have

(in the

information,

option useful.

provided

format

HH:MM:SS

reason

MMM-DD-YY
or

for

the

reload

or DD-MMM-YY)

HHMMSS).

Now,

you

(NEW),

and have

have

set

the

time

(in

set

are

prompted

are

decimal

for

startup

option:
Startup
Enter

option:

DEFINE

and

press

RETURN.

Startup option:DEFINE<RET>
Define
(ASL, SDL, SSL, STRUCT) : STRUCT<RET>
In

the

following

indicated.
square

dialogue,

Values

brackets

all

numbers

within parentheses

are

defaults

which

will

unless

are

options.

substituted

otherwise

Values
if

within

RETURN

pressed.

Any

question

parameter

preceded

will

with

require

the

HOME

blocks

structure

will

have

initialized

been

asterisk

structure

Note

indicates
be

examples

that

units

the

**x%*

immediately

after

all

this

manual

use

DSKB

the

structure
area

to
which

copied.
Structure

define:DSKB<RET>

Disk

drive

for

logical

unit

Disk

drive

for

logical

unit

see

bad

you

[HOME

want

blocks

entered.

It 1is advisable that you define at least one
All

<changing

refreshed.

the

initialized

0:RPAQO<RET>
1:<RET>
regions

RPAQ]

(NO,YES)

[NO]:NO<RET>

DSKB.

files

are

STARTING

the

following

brackets.

section,

Default

structure

type.

Parameters

*Blocks

for

Private
Owner

PPN

*Number

Blocks

for

262143)

(NO,YES)

CRASH.EXE

for

blocks

cluster

enclosed

ONCE

pressing

according

square
to

the

RETURN.

DSKB

[10]:<RET>

[NO]:<RET>

[ALL]:<RET>

are

[NONE] :<RET>

allowed

per

value

(NONE, [p,pn])

Consecutive

*Bits

values

(1-36,ALL,NONE)

MONITOR

calculated

default

structure

Disk-set

are

the

cluster

BOOTSTRAP

default

wvalues

per

THE

4096).

[1536]:<RET>

overdraw per

user

tried

output

count

for

18)

307800)
-

[500]:<RET>

262143)

[30] :<RET>

[12]:<RET>

Make

this

the

only

structure

the

SSL (NO,YES)

Make

this

[NO]:YES<RET>

the

only

structure

the

SDL

[NO]:YES<RET>

section,

specify

the

following

return

the

default

wunit

value.

The

(NO,YES)

identification
unit

identification

press
resides

in the HOME blocks on the disk unit,
for unique identification of
the
disk pack.
Therefore, it must be a unique number.
The unit-id may be
a combination of numbers and letters,
and
can
have
as
many
as
6
characters.
for

part

You

the

Parameters

Unit

might

for

unit

blocks

per

SAT

blocks

for

unit

core

Make

Enter

swapping

this

the

only

DSKB must

another

prompted

for

Structure

81)

swapping

[0]:<RET>

define

startup

serial

number

(33090

269332)

[134672] :<RET>

press

RETURN

and

you

will

REFRESH

and

option.

define:<RET>

[Rebuilding the

active

swapping

[Rebuilding

system dump

the

list

from

list

the

HOM blocks]

from the

HOM blocks]

option:

After

press

RETURN:

structure

option:

Structure

[Updated

HOM

[Structure
Structure

must

refreshed.

Enter

DSKB

refresh:
blocks

DSKB
to

defined,

REFRESH<RET>

refreshing:

DSKB<RET>
unit

RPAQ]

refreshed]

refresh:<RET>

[Rebuilding

the

system

[Rebuilding

the

active

swapping

[Rebuilding

the

system

dump

Startup

pack’s

in the ASL (NO,YES)
[NO]:YES<RET>
refreshed before it can be used.

system

Startup

the

[8]:<RET>

for

the

Needs

use

unit

structure
another

[Rebuilding

Startup

(1 - 8)
[8]:<RET>
- 4807)
[1000]:4807<RET>

logical block
Swapping class
(0 -

Structure

useful

RPAO

*First

[DSKBO]:<RET>

*SAT

find

unit-id.

option:

list

from

list

the

from

from the

HOM blocks]

the

HOM

blocks]

HOM blockg]

STARTING

start

the

Startup

monitor

now,

THE

enter

BOOTSTRAP

NOINITIA

the

system

[Rebuilding

the

active

swapping

[Rebuilding

the

system

dump

automatically

KL10

and press

RETURN:

option:NOINITIA<RET>

[Rebuilding

MONITOR

Thursday

log

23-Jun-88

list

under

list

the

from

from the

[1,2]

14:53:34

from

type

HOM blocks]

the

HOM blocks]

"LOGIN"

CHAPTER
BUILDING

Before

you

system.

this,

Restore

before
o

the

files

sources

Restore
tape.

chapter

software

the

name

you
to

before
your

can

both

restore

the

for

This

device
Next,

MTAQ:

you

for

restore

tape,

Commonly
batch

restore

and

you

from

mounted

tape

the

contains

System

spoocling

from

and

the

unless

drive

following

bootable

this

tape

+the

you

booted

command.

to
On

tape.

All

noted

must

the
the

are

unbundled

TOOLS

tape,

when

Program

system

otherwise

identified

monitor

mounted

which

Used

and

files

tape,

systems

assign

the

system,

monitor
CTY,

for

type

the

with:

1is

the

name

TAPE

different

the

tape

name.

front-end

which

file

ANF-10.

GALAXY

monitor

TAPE:<RET>

assigns

tape

the

assigned

restore

Then,

and

CUSP,

the

how

files

The

the

responds

command

bootable

tape,

tape.

You

ONCE.

using

.ASSIGN

MTAQC

build

Monitor/ANF-10

customer-supported

tape.

running

system

Dbootable

monitor

following:

The

must

SYSTEM

title.

the

job

from

explains
to

the

this

the

apply

section

Before

also

tape,

procedures

from

files

FILE

will:

for

files
The

included
This

you

files from
the
running ONCE.

Restore

MONITOR

can build your monitor you

THE

are

file

monitor

from

Section

5.1

file

that

system,

used

unit

MTAQ.

the

correct

use

Section

allocate

5.1

will

space

system.

both
the

installing

the

tape

drive,

and

BACKUP

tape
and

systems,

program,

Section

which

will

disk.

you

directly

Section

are

5.2
be

will

used

installing
5.2.

show

copy

physical

show

you

how

disk

for

the

you

how

the

bootstrap

system,

skip

BUILDING

5.1

ALLOCATING

This

section

space

for

.REWIND

The

Now

FOR

how

front-end

file

MONITOR FILE

THE

SYSTEM

FRONT-END

restore
system.

file

that

the

CTY,

type

used

the

allocate

following:

TAPE:<RET>

TAPE:FEFILE<RET>

system
Job

SPACE

describes

the

.GET

DISK

THE

will

respond

with:

setup

that

the

FEFILE

unit

for

press

RETURN:

the

job

front-end

set

file

up,

you

system.

will

allocate

the

space

prompt,

type

disk

START

and

.START<RET>

The

system
DISK

Enter

will
UNIT

respond

with:

NAME:

disk

unit

name

assumes

that

the

front-end

RPAO.

You

must

RP06

drive

SIZE
Press

UNIT

FILE
to

the

(2008

5.2

disk

AREA

will

section

shows
to

customer-supported

the

FROM

you

copy

files

how
the

GIVES
file

this

respond

following

stored

for

and

RPAO,

the

KL,

the

example
disk

but

the

and

must

unit

disk
be

HOM

BACKUP

DEFAULT

size.

There

operation.

When

2000) :<RET>
may

the

delay

operation

with:

LOGICAL

CREATED,

restore

BACKUP

default

ALLOCATED

STARTS

FILE

This

the

will

DATA BLOCKS

the

The
be

unit

front-end

(<CRLF>

completes

RESTORING BACKUP

restore

the

will

with:

BLOCKS

use

tape.

system

[FRONT END
you

physical

between

respond

the front-end

[FE.SYS

Next,

any

RETURN.

system

NAME:RPAQ:<RET>

will

RETURN

complete,

press

file

type.

system

before

specify

dual-ported

DISK

The

may

and

FE.SYS]

BLOCK

BLOCKS

2301.]
WRITTEN]

program.

TAPE

restore

bootstrap

from

the

tape,

any

the

BACKUP

monitor

from

Monitor/ANF-10
unbundled

software

program.
tape

tape,
tapes,

You
disk

CUsp
and

the

will
and

tape,
TOOLS

BUILDING

THE

MONITOR FILE

SYSTEM

The following example shows how to
restore,
save,
and
Enter the commands that are underscored in the example:

BACKUP.

TAPE :BACKUP<RET>

.GET
Job

run

setup

BACKUP<RET>

.SAVE
BACKUP

.RUN

saved

BACKUP<RET>

The / sign is the BACKUP prompt,

indicating that BACKUP is running and

is
ready
to
accept
BACKUP
commands.
Next
you
will restore the
bootstrap monitor.
When that
is
completed, "~ you
will
restore
the
monitor
sources
and
associated
software.
The
BACKUP
program is
discussed in the TOPS-10 Operator’s Guide.
This manual shows only the
commands
you
need
to type to restore the monitor and its supporting
software.

RESTORING FILES FROM TAPE TO DISK

5.3

The examples in this manual use DSKB as the
structure
to
which
the
files will be copied, and the area [10,7] for the directory area.
The
BACKUP program recognizes the ersatz device name
DEC
as
8SL:[10,7],
therefore
the
procedures
in
this manual use the device name DEC to
represent DSKB:[10,7].
The area [1,4] is reserved for
ersatz
device
SYS,
from
which
system programs are run.
Do not substitute another
directory area for [1,4].
The
procedures
in
this
manual
use
the
SYS to

represent

DSKB:[1l,4].

device

name

5.3.1

Restoring the Bootstrap Monitor

Now,

you will

restore

For KL systems,

the bootstrap monitor

from

the

Dbootable

type the following commands after the / prompt:

tape.

/TAPE TAPE:<RET>
/SUPERSEDE ALWAYS<RET>

/RESTORE SYS:=*

*<RET>

"DONE

/
For KS

systems,

type the

following commands:

/TAPE TAPE:<RET>
/SUPERSEDE ALWAYS<RET>
/INTERCHANGE<RET>
/RESTORE SYS:=*,*<RET>
"DONE

/RESTORE DEC:=*

*<RET>

"DONE

Unload the bootable tape.
To
type the following command:
/UNLOAD

[MTAO:

This
the

TAPE:<RET>

Read(C/H/S)

command rewinds
drive.

the

this,

for both

and

systems,

7202000/0/0]

tape

and unloads

it.

Remove

the

tape

from

BUILDING

The

the

section describes
Monitor/ANF-10
tape,

CUSP

tape,

5.3.2
To

the

files

dismount

unless

how

MONITOR FILE

from

Monitor

from

each

otherwise

tape

tape,

the

cover

the

procedure

Monitor/ANF-10
1.

Mount

Type

for

each

distribution

following

restore

software

the

TOOLS

the

files

tapes,

Software

mount,

restore,

the

tapes

with

the

distribution

the

tape.

must

included

from

restore

letter

tape.

the

below

and

you

may

tape.
Repeat

and Associated

disk,

You

BACKUP

SYSTEM

unbundled

Sources

tape.

noted

use

any

customer-supported

Restoring the

copy

and

the

THE

tape,

unload

any

order,

specific

starting

with

tape.

commands

restore

the

files:

/TAPE TAPE:<RET>
/REWIND<RET>
/SUPERSEDE ALWAYS<RET>
/PROTECTION 155<RET>
/SSNAME ALL<RET>
/RESTORE DSKB:<RET>
110,7

DSKB

"DONE

/UNLOAD
[MTAOQ:
3.
After

Dismount

the

pressing
do

this,

files

you

The

TOPS-10

can

access

files

each

TOPS-10

system

The

program

need

the

certain
and

then

copy

The

monitor

Therefore,

the

from the

recognizes

the

device

the

copy

the

from

which

name

DEC

procedure

procedure,

the

create

are

demonstrated

ersatz

the

device

appropriate

device

4is

The

is
Utilities

create

DSKB:([10,7]

Only

files.

then

ersatz

CREDIR.

system.

will

Manual.

monitor

the

files

You

directories

wused

EXIT

file

directories

User

are

disk

CUSPs.

TOPS-10
this

typing

directories

creates

following

directory

disk

the

complete

the

TOPS-10

that

monitor
with

BACKUP

and

SYSTEM DIRECTORIES

following procedures.

described

the

directory.

programs

disk,

from

create
the

requires

directories.

DSKB:[10,7].

7752000/0/0]

exit

can

create

support

disk,

you

into

THE

tape.

Now

monitor

directories
as

are

will

CREATING

those

the

RETURN.

appropriate

5.4

TAPE:<RET>
Read (C/H/S)

wused

these

area

name

DEC

the

CREDIR program

the

commands

is
you

below.

names

recognized

directories

Each ersatz device name results in
a
standard PPN that the monitor reserves for

for

directory

area
purpose.
A
file structure

that

for the specified PPN will be created on each
system search list, unless you specify otherwise.

the

storing

BUILDING

The

THE MONITOR FILE

used in this manual

SYSTEM

ersatz

device names

are

defined as

follows:

PPN

Name

Use

[10,7]

DEC:

DEC-supplied

[1,4]

SYS:

System

[2,5]

HLP:

HELP

[5,14]

DOC:

DOC

[5,11]

REL:

REL files

[5,17]

UNV :

MACRO universal files

[1,7]

ACT:

Accounting daemon

[5,35]

UpPS:

Files maintained by MX mail listener

software

library

files
files

files

(ACTDAE)

Use the following commands to create the
ersatz
device
directories.
The
directory
areas
will
Dbe
created on each file structure in the
system search list.
CREDIR will report on each directory
it
creates
on
each
file
structure.
In
this
example,
DSKB is the only file

structure in the system search
list.
underscored in the following examples:
.RUN

Type

the

you for the directory name you wish to create:

Create

directory:HLP:<RET>

for

each directory name:

Create

directory:DOC:<RET>

Create

directory:REL:<RET>

Create

directory:UNV:<RET>

Create

directory:ACT:<RET>

Create

directory:UPS:<RET>

Created DSKBO:[2,5].UFD/PROTECTION:775

Created DSKB(O:([5,14] .UFD/PROTECTION:775

Created DSKBO:[5,11].UFD/PROTECTION:775

Created DSKBO:[5,17] .UFD/PROTECTION:775

Created DSKBO:[1,7] .UFD/PROTECTION:775

Created DSKBO:[5,35] .UFD/PROTECTION:775

To exit

that

DSKB: [10,7,CREDIR]CREDIR<RET>

CREDIR will prompt

Repeat

commands

from CREDIR,

type CTRL/C:

Create directory:<CTRL/C>

are

BUILDING

5.5

COPYING

THE

This

section

shows you how
directories.

appropriate
areas

from

described
The

NFT

.RUN

copy
the

from

DEC:

For

SYSTEM

INTO DIRECTORIES

the

TOPS-10

MONITOR FILE

copy

the

You

will

copy

NFT

(Network

User

Utilities

run

NFT,

files
the

File

from

files

Transfer)

DEC
the

into

program.

Manual.

type

the

following

the

appropriate

NFT

command:

COoPY

you

only

need

command

copy

use

the

COPY

files

command

into

their

shown

below.

appropriate

areas

*COPY

SYS: /PROTECTION: 055=DSKB:

*COPY

SYS: /PROTECTION: 055=DSKB: [10,7,%,
%, *]* %,*,
RAM<RET>

*COPY

SYS: /PROTECTION: 055=DSKB: {10,7,
% % *x]*
*,*
VFU<RET
,
>

*COPY

SYS: /PROTECTION: 055=DSKB:

*COPY

SYS: /PROTECTION: 055=DSKB: {10,7,*,
*] JOBDAT
*,*,*,
. REL<RET>

*COPY

SYS: /PROTECTION: 055=DSKB: [10,7,*,*,
%, %, *]OVRLAY.REL<RET>

*COPY

SYS: /PROTECTION: 055=DSKB: [10,7,%,
%, *]TECO.ER
*,%,
R<RET>

*COPY

HLP: /PROTECTION: 055=DSKB:

[10,7,*,*%,
%, * x]* HLP<RET>

*COPY

DOC: /PROTECTION: 055=DSKB:

[(10,7,%,*,%,
%, *]* DOC<RET>

*COPY

REL: /PROTECTION: 055=DSKB: [10,7,*%
% *]*
,%,%
REL<RET
,
>

*COPY

UNV: /PROTECTION: 055=DSKB: [10,7,*,%,
*]* UNV<RET>
%,%,

*COPY

SYS: /PROTECTION: 055=DSKB:

[10,7,*,*,*,
%, *]SYSTEM.CMD<RET>

*COPY

SYS: /PROTECTION: 055=DSKB:

(10,7, *, X, %, %, %1% SYS<RET>

*COPY

SYS: /PROTECTION: 055=DSKB:

[10,7,*%,
%, %, %, *]* INI<RET>

DSKB: [10,7,NFT]NFT<RET>

files

Use

using

the

prompt

DEC,

FILES

THE

systems,

also

copy

the

[10,7,*%,*,%,*%
*]* EXE<RET>

[10,7,*,*%,*,
%, *]DDT.REL<RET>

following

files

shown:

*COPY

REL:/PROTECT[10,7,MO
ION:
N,
055=
KL] TOPS10.R
DSKB
EL<RET>
:

*COPY

SYS:=DSKB:[10,7
*, *]DXMCA.
,*,*,
ADX<RET>
*,

*COPY

SYS:=DSKB:[10,7
%, * *]DXMPA.A
,*,*,
S8<RET>

*COPY

SYS:=DSKB:[10,7
%, *]DXMCD.A
,*,*,
DX<RET>
*,

*COPY

SYS:=DSKB:[10,7,*,*,*,*, *]KNICOD.BIN<RET>

*COPY

SYS:=DSKB:[10,7,*,*,*,*

*]FEUIC.TXT<RET>

BUILDING

For

systems,

*COPY

exit

copy

the

THE

MONITOR

following

FILE

file

SYSTEM

shown:

SYS:=DSKB:[10,7,*,*,*,
* *]SMFILE.EXE<RET>

from

NFT,

type

EXIT

and press

RETURN:

*EXIT<RET>

If you have not
what .BWR files

yet
are

read the beware
available, type

files, read them now.
the following:

find

out

command.

.DIR DSKB: [10,7,*,%,%,
%, *]* BWR<RET>

You can
sure to

5.6

display the files on your terminal using the TYPE
read all the files listed by the DIR command.

USING

SYSTEM FILES

The SYS area includes several sample system files.
The
monitor
uses
these
to
create
wuser
accounts
and
to initialize system programs.
After you complete the procedures in Chapter 9 you
can
tailor
these
files

your

installation.

ACTDAE.SYS

This is the
passwords,

system’s accounting
access information,

file.
It records
the
PPNs,
and disk quotas for users and

operators.
Without the ACTDAE.SYS file,
no
one
(users
operators)
can
log in.
Chapter 11 describes how to use
REACT program to maintain this file.
o

S8YSJOB.INI

This

file

SYSJOB.INI

This file can be read by OPR to automatically start batch
spooling processes for GALAXY (refer to Chapter 10).

and

described
o

or
the

automatically starts
in Chapter 12.

system

jobs.

SYSTEM.CMD

TTY.INI

INITIA reads this
STOMPER functions.
Next,

file
and
initializes
the
CTY
TTY.INI is described in Chapter

and
12.

TTY

if you are installing a KL system,
vyou
will
c¢reate
the
file
system for the front-end.
If you are installing a KS system, you will
create the file system for the microprocessor.
Chapter
6
describes

these

procedures.

CHAPTER
BUILDING

The

and KS

THE

SUPPLEMENTARY

processors

are

each

PROCESSOR'S

supported by

FILE

SYSTEM

another processor.

The

KL
processor uses a PDP-11 front-end for I/0, which requires space on
disk for its software.
The KS system uses an 8080 microprocessor that
also
requires
disk
space
for
storage.
This chapter explains the
procedure for creating these disk file systems.
If you are installing
a KL system, continue reading with Section 6.1.
If you are installing
a KS system, go directly to Section 6.2.

6.1

BUILDING

THE

KI. FRONT-END

FILE

SYSTEM

To build the front-end file system, you must locad the
front-end
from
the
front-end
media, which you mounted according to the instructions
in Chapter
3.
The
front-end
software
is
distributed
on
either
DECtapes
or floppy diskettes.
The commands that you will type to the
RSX-20F command language processor, the PARSER,
differ
primarily
in
the
physical device names used.
The examples used to illustrate your
communication with
the
PARSER,
if
not
specifically
separated
by
appropriate
headings,
apply
to
Dboth DECtapes and floppies.
1In all
examples, the commands that you will type are underscored.
The following procedures assume that the front-end file system will be
stored
on
DSKB, mounted on RPAOQ.
In fact, you can use any structure
by replacing DB0 in the commands with
DBn,
where
'n’
is
the
unit

number

in RPxn.

Make

dual-ported between

the

sure that the
front-end

disk unit

and the

is write-enabled and is

KL.

KL systems may have
more
than
one
CPU
by
implementing
Symmetric
Multi-Processing
(SMP).
In
a
multiple-CPU
system, each CPU has a
front-end, and each front-end requires its own file
system.
If
vyou
are
installing
an
SMP
system, you must follow the steps in Section
6.1.1 and 6.1.2 for each CPU, at each CTY.
For

DECtapes:

First,

check

make

sure

that

the

DECtapes

are

mounted

correctly.

The DECtape labelled DT-A should be mounted on DECtape drive 0,
DTO:,
and the unit selector switch should be set to 0.
The DECtape labelled
DT-B should be mounted on DECtape drive 1, DT1l:, and the unit selector
switch

should

LOCAL/REMOTE
ENABLE.

set

switch to

REMOTE

and

both

the

DTO:

READ/WRITE

and

DT1:,

switch

set

the

WRITE

BUILDING

For

THE

SUPPLEMENTARY

PROCESSOR’S

FILE

SYSTEM

floppies:

First,

check

make

sure

the

floppy

diskettes

are

mounted

correctly.

The floppy diskette labelled FLP-A should be mounted in the
floppy
drive
DX0:,
and the floppy diskette labelled FLP-B

mounted

6.1.1

the

right-hand

floppy

drive

left-hand
should be

DX1:.

Loading the Front-End

Invoke the PARSER by typing CTRL/\
(control-backslash)
on
the
CTY.
This control character is not echoed, but the PARSER responds with the
prompt

PAR>,

indicating

that

ready to

commands.

NOTE

you

with

make

error

the PARSER,

PARSER prompt

any

time

type

CTRL/Z

printed,

will

during

your

dialogue

followed by CTRL/\.
and

you

can

retype

The
the

command.

If you are loading
least 45 minutes to
Type the SET CONSOLE
KL is not running.

RSX-20F
copy the

MAINTENANCE

from
DECtape,
files.

and

RESET

commands

allow

ensure

that

the

<CTRL/\>
PAR>SET

CONSOLE

MODE:

MAINTENANCE<RET>

MAINTENANCE

PAR>RESET<RET>

PAR#

Set
the

the data switches on the front-end control panel
first two switches (0 and 1) raised and the rest

to
000003,
off.

Hold the ENABLE switch on and, at the
same
time,
press
the
switch.
The
front-end will print its software name and date
location

the

front

end

with

SW/REG
and the

software.

For DECtapes:

For floppies:

RSX-20F VA##-## hh:mm dd-mmm-yy

RSX-20F VE##-#4# hh:mm dd-mmm-yy

[SY0:
[DTO:

REDIRECTED
MOUNTED]

[SY0O:
[DX0:

MOUNTED]

[DT1:

MOUNTED ]

{DX1:

MOUNTED]

the

INIalization

Initialize

invoke

the

DTO:}

front-end by

running

the parser by typing CTRL/\,

REDIRECTED

and type

the

DXO0:]

program.

following

First,

commands:

PAR#MCR

INI<RET>

INI>DBO
: <RET>

The INI program does not prompt when initialization is complete.
When
initialization
1is
complete,
the
1lights
on
the
drive
panel stop
flashing.
Wait 30 seconds, then type CTRL/\ to invoke the parser.
<CTRL/\>
PAR

BUILDING THE SUPPLEMENTARY PROCESSOR’S FILE SYSTEM

Mount the disk unit on which the front-end file

system

Run the MOUnt program by typing the following commands:

will

reside.

PAR#MCR MOU<RET>
BO
: <RET>
MOU>D

MOU

COMPLETED

MOUNT

MOU><CTRL/Z>

Create the front-end file system directory.

typing the following commands:

Run the

UFD

program

PAR#MCR UFD<RET>

51 <RET>
BO0:
[5,
UFD>D

When the
The UFD program does not prompt the CTY when it is finished.
lights on the front panel stop flashing, the operation is complete.

Wait 30 seconds,

then type CTRL/\ to invoke the parser.

<CTRL/\>
PAR

you will copy the
If you are loading the front-end from DECtapes,
If
* TSK files into directories before copying the rest of the files.
you are loading the front-end from floppies, you will copy all of the
program to copy the files from DECtape or
Run the PIP
files now.
following
Type the
Exit from PIP by typing CTRL/Z.
floppy to disk.
commands:

For DECtapes:

For floppies:

PAR#MCR PIP<RET>

PIP>DB0:=DT0:F11ACP.TSK<RET>

PIP>DR0O:=DX0:,DX1:<RET>

PIP><CTRL/Z>

PIP>DB0:=DT0:PARSER.TSK<RET>
PIP>DB0O:=DT1:PIP.TSK<RET>

system
Run the REDirect program to redirect the
Type the following
from DECtape or floppy to disk.

Redirect the system.

search area (SY0:)
commands:
<CTRL/\>

PAR#MCR RED<RET>
RED>DB0 :=8Y0:<RET>

finished.
1is
The REDirect program does not prompt the CTY when it
on the front panel stop flashing, the operation is
1lights
When the
Wait 30 seconds, then type CTRL/\ to invoke the parser.
complete.
<CTRL/\>
. PAR

you

BUILDING

THE

SUPPLEMENTARY

the

front-end

are

the

files

complete.

the

files

front-end

need

When

in
from

list

For

from

DECtape
this

8YO0:

has

from

disk.

been

and

floppies,

the

you

will

copy

take

minutes

directory

from

have

already

Type

the

PIP
but

will

For

the

files

and

only

write

the

DBO:[5,5].

The

commands:

floppies:

PIP>DB0O:/LI<RET>

SY0:.

and

disk

Run
is

are

the

SAVe

already

program

defined

logically

messages

about

the

files

these

messages.

Type

the

following

DECtapes:

For

dismounted

warning

ignore

all

are

automatically.

that

already

exist,

commands:

floppies:

PAR#SET CONSOLE OPERATOR<RET>
PAR#MCR SAV<RET>
SAV>SY(: /WB<RET>

PAR#SET CONSOLE OPERATOR<RET>
PAR#MCR SAV<RET>
SAV>SY0: /WB<RET>

[DBO:

DISMOUNTED]

[DBO:

[DTO:

DISMOUNTED]

[DX0:

DISMOUNTED]

[DT1:

DISMOUNTED]

[DX1l:

DISMOUNTED]

DECtapes:

Remove

the

labelled

For

may

floppies

the

rest
more

PIP><CTRL/Z>
R

front-end monitor

you

copied

you

the

PAR#MCR PIP<RET>

PIP><CTRL/Z>

monitor

the

For

PIP>DB0:=DT0:,DT1:<RET>

list

following

PIP>DBO: /LI<RET>

DECtapes

may

PIP.

DECtapes:

front-end

SYSTEM

This

PAR#MCR PIP<RET>

Write

FILE

DECtape,

completed,

exit

directory.

PROCESSOR’S

DECtapes

DT-C

from

drive

drives

and

mount

the

DECtape

floppy

labelled

DTO:.

floppies:

Remove

the

floppies

FLP-C

Type

the

following

- For

DECtapes:

drive

from

DX0:

and mount

For

the

PAR#MCR MOU<RET>

MOUNT

MOU><CTRL/Z>

floppies:

MOU>DTO : <RET>
--

DX1l:

commands:

MOU

and

DXO0:.

PAR#MCR MOU<RET>
MOU>DX0
: <RET>

COMPLETE

MOU

MOUNT

MOU><CTRL/Z>

COMPLETE

BUILDING

THE

SUPPLEMENTARY

PROCESSOR’'S

FILE

files
Run PIP to copy
the
Copy the files to disk.
and list the directory
DECtape
or
floppy
to
disk
floppy
Then, exit from PIP, dismount the DECtape or
Type the following commands:
media from the drive.
For

For

DECtapes:

and

PAR#MCR PIP<RET>

PIP>DB0 :=DT0:<RET>

PIP>DBO0 :=DX0:<RET>

PIP><CTRL/Z>

~<CTRL/\>

PAR#MCR DMO<RET>
DMO>DTO : <RET>

PAR#MCR DMO<RET>
: <RET>
DMO>DX0

DMO

-- DISMOUNT

COMPLETED

DMO

-- DISMOUNT COMPLETED

DMO><CTRL/Z>

6.1.2.

Section

the

PIP>TT:=DB0:/LI<KRET>

You can now boot the RSX-20F front-end from the disk.
described in

remove

floppies:

DMO><CTRL/Z>

This

procedure

Booting the KL Front-End from Disk

6.1.2
To

third
the
from
of files on DBO.

PIP>TT:=DB0:/LI<RET>

SYSTEM

initiate the

switch
panel.

load,

hold the ENABLE switch on

and

press

the

DISK

at
the
same
time.
These switches are located on the drive
Following is the output when the front-end is loaded:

RSX-20F VA##-## hh:mm dd-mmm-yy
[SYO:

REDIRECTED

[DBO:

MOUNTED]

KLI

TO DBO:]

-- VERSION VA##-## RUNNING

KLI

-- KL10

KLI

S/N:

KL10

2996.,

HARWARE
MCA25 CACHE

MODEL B,

HERTZ

ENVIRONMENT:
PAGER

MOS MASTER OSCILLATOR
EXTENDED ADDRESSING
INTERNAL

CHANNELS

CACHE

SELECTED:

BOTH

KLI

PAGE

TABLE

KLI

-- MICROCODE VERSION 2.1[###]

KLI

ALL

CACHES

LOGICAL

MEMORY

CONFIGURATION

SIZE

ADDRESS

768K

00000000

LOADED

ENABLED

INT

TYPE

MF20

KLI -- CONFIGURATION FILE WRITTEN
KLTI -- BOOTSTRAP LOADED AND STARTED
BOOT V# (##)

[Loading
KL10
Why

from DSKB:SYSTEM.EXE[1,4]]

dd-mmm-yy
reload:

CONTROLLER

BUILDING

The

ONCE

dialogue

described
option.

THE

in
If

procedures

SUPPLEMENTARY

begins

are

Section

quick

6.1 at the console for
9 for information about building your
installing a single processor KL system, go to

Chapter

you

6.2

are

CREATING

This
the

section
KS

6.2.1
If

installing

THE

system,

you

describes

the

procedure

microprocessor,

and

for

are
on

installing
disk

(6,2020],

and

for

create
.R

the

resides
on
RPAQ.
microprocessor file

MICROPROCESSOR FILE

new

system,

microprocessor

Do not
system.

use

area,

each

CPU,

monitor.

Chapter

Section

then

If
now.

you

are

system

for

6.2.

SYSTEM

creating the

the

file

monitor.

System Directory Area

recommended

directory

for

booting

Creating A Front-End File

area

SYSTEM

The
startup
options
are
startup, use the GO startup
multiple-processor
KL,
repeat
the

A.
For
installing a

FILE

automatically.

Appendix

you

PROCESSOR’S

you

must

file

system.

that

you

wuse

a multiple-unit

type

the

following

create

the

file

This

directory

area

must

structure

for

that

the

commands:

CREDIR<RET>

Create directo[6,2020]
ry:DSKB
/EXIT<RET>
:
Created

6.2.2

Writing the

Next,
the

for

DSKBO:{6,2020] .UFD/PROTECTION: 775

you

will

SMFILE

your

serial

write

program

system’s

number
of

.RUN

the

bootstrap

shown

CPU.

Note

VERSION

the

You

must

disk.

supply

the

following

4097.

2020

#.#,

HELP

DIAGNOSTICS

TOPS-10,

TYPE

KS10,

SMEILE>WRITE

SETUP

RESET<RET>

SMFILE>READ

CPU

PROGRAM

=4097

DSKB:<RET>

DEC:T10KL.RAM<RET>

SMFILE>SERIAL
SMFILE>WRITE

FE-FILE

"HELP"]

SMEILE>WRITE

4097<RET>
CRAM<RET>

SME'ILE>WRITE

BOOT

SMFILE>WRITE

DONE<RET>

SMEILE>EXIT<RET>
EXIT

program

below.

that

Disk

DEC:SMFILE<RET>

.DECSYSTEM

[FOR

Bootstrap Program to

DEC:KSBOOT.EXE<RET>

example

this,

serial

uses

run

number

CPU

BUILDING

The

now

THE

ready

SUPPLEMENTARY

run.

Reload

PROCESSOR’S

the

monitor

RESET

buttons

FILE

SYSTEM

wusing

.the

following

commands
:

<CTRL/\>
KS10>HA<RET>
When

the

CPU

KS10
BT

halted,

press

the

CPU

panel.

CSL.V#.#

AUTO

BOOT V# (#)
BOOT><RET>

[Loading

from DSKB:3YSTEM.EXE

{[1,41]

You can load the monitor by typing commands to the BOOT
program.
To
load
the
default
monitor just press RETURN to the BOOT prompt.
The
default file
name
is
DSKB:SYSTEM.EXEJ[1,4}.
To
load
a
different
monitor,
type the file name of the monitor to the BOOT prompt, taking
care
to
include
the
structure
name
and
the
complete
directory
specification.
The ONCE dialogue
begins
automatically.
described
in
Appendix
A.
For
a quick
option.

After

monitor.

you

choose

Part

startup

Chapter

option,

The
startup
options
are
startup, use the GO startup
you

can

begin

building

PART

This

part

describe
a

new

how to
version

installing
Chapter

UPGRADING AN EXISTING

made

prepare
of
new

"Building

the

your

monitor.

system,
the

two

system
go

SYSTEM

chapters
If

directly

Monitor".

which

for upgrade
you
to

Part

to
are
4,

CHAPTER 7
RESTORING

THE

DISTRIBUTION

Before you can upgrade your system,
distribution

restore the

tapes

files

disk.

you must

You

will

from the Monitor/ANF-10

TAPES

restore
wuse

the

tape,

files
BACKUP

which

from

the

program to

contains

the

sources
for
the monitor and ANF-10.
You will also restore the files
from the CUSP, or Commonly Used System Program tape; the files for the
GALAXY
batch
and
spooling
system
are included on this tape.
This
chapter also explains how to restore files from the unbundled software
tape, the customer-supported tape, and the TOOLS tape.

The files contained on the Monitor/ANF-10,
CUSP,
DECnet,
and
TOOLS
tapes
are
stored
on
the
tapes in a series of sub-file directories
(SEDs) under the {[10,7] PPN on structure DSKB:.
The examples in
this
manual
use DSKB:
as the structure to which the files will be copied,
and the area [10,7] for the
directory
area.
After
the
tapes
are
restored,
you
will
wuse NFT to copy the files into their appropriate
directories.
IMPORTANT

Before

proceeding,

monitor

sources,

you

CUSPs,

should
GALAXY

save

your

components,

and

existing
(for

systems only) front-end file system on a
backup
disk
or tape.
This will allow you to fall back to your old

monitor

if the

new monitor

difficult

install

run.

Existing KS installations require some of the files from the
bootable
tape.
These
files are not compatible with previous versions and are
required for building the microprocessor file system and you must copy
these
files from the bootable tape before copying the TOPS-10 monitor
and CUSPs.
If you are upgrading a KS system, mount the bootable
tape

now.

If you

are upgrading a KL

system,

mount the Monitor/ANF-10

tape.

For
existing
systems
already
running
GALAXY,
ensure
that
the
tape-drive
vyou
are
using
is
not available to MDA by using the OPR
command SET TAPE-DRIVE.
MTAQO is used in the following example; if the
distribution
tape
is
on a different drive, use the correct physical
device
.R

name.
OPR<KRET>

OPR>SET TAPE-DRIVE MTAQO UNAVAILABLE
Enter text and terminate with "~Z<CTRL/Z>
~Z
OPR>

10:29:36
OPR>EXIT<RET>

Device MTAO0

©Unavailable

for use

=~=-

RESTORING

For

both

following

and

system

MTAQ0

MTAQ:

assign

name

the

TAPES

the

tape

typing

the

TAPE:<RET>

responds

with:

ASSIGNED

This

command

The

procedures

program.

systems,

DISTRIBUTION

command:

.ASSIGN
The

THE

assigns

for

the

name

TAPE

copying

files

prompt,

type

from
the

tape

unit

MTAOQ.

disk

use

the

BACKUP

following:

BACKUP<RET>

/
The

ready

sign

the

you
If

are

BACKUP

following
a

underscored

/TAPE

restore

upgrading
KL

RESTORING KS

upgrade

prompt,

indicating

BACKUP commands.
Operatoxr’s Guide.
This

type

upgrading

7.1

The

the

TOPS-10

need
you

are

is
to

the

and

continue

directly

that

BACKUP

manual

monitor

system,

The

shows

its
with

program
only

Section

and

discussed

the

commands

supporting

Section

running
is

software.

7.1.

vyou

7.2.

MICROPROCESSOR FILES

commands

allow

microprocessor

the

following

you

file

system.

restore

the

Type

the

files

needed

commands

procedure:

that

to
are

TAPE:<RET>

/SUPERSEDE ALWAYS<RET>

/INTERCHANGE<RET>
/RESTORE DEC:=SMFILE.EXE<RET>
"DONE

/RESTORE

DEC:=T10KL.RAM<RET>

"DONE

/RESTORE

DEC:=KSBOOT.EXE<RET>

"DONE

/UNLOAD TAPE :<RET>
[MTAO:

Read(C/H/S)

Remove

the

tape.

Then,

7.2

bootable

RESTORING

copy

tape

proceed

THE

with

7752000/0/0]

from
the

MONITOR

the

drive

and

instructions

SOURCES

AND

mount
in

the

Section

ASSOCIATED

Monitor/ANF-10
7.2.

SOFTWARE

the files from tape to disk,
you must mount,
restore,
unload
dismount
each
tape.
You
may
restore the tapes in any order,
unless otherwise noted in the cover letter included
with the
specific
tape.
'
and

RESTORING

THE

DISTRIBUTION

TAPES

Repeat the procedure below for each distribution tape,
starting
with
the
Monitor/ANF-10 tape.
If you wish to restore the tapes to an area

other than DSKB:[10,7],
command

line

the

Mount

the

Type the

you must

procedure

specify this

area

the

/RESTORE

below.

distribution

tape.

following commands

restore the

files:

/TAPE TAPE:<RET>
/REWIND<RET>

/SUPERSEDE ALWAYS<RET>
/PROTECTION 155<RET>

/SSNAME ALL<RET>
/RESTORE DSKB:<RET>
DSKB

t10,7
"DONE

/UNLOAD

[MTADO:

TAPE:<RET>

Read(C/H/S)

= 7752000/0/0]

Dismount

After the files

the

are

tape.

on disk,

exit

from

BACKUP

typing

EXIT

and

pressing RETURN.

Next,
vyou
will
copy
the
files
to
DSKB:[10,7],
wusing
the
Network File
described
To

Use

copy

from

the

files

the

COPY

TQOPS-10

you

User Utilities

only need to use

command to

the

the
appropriate
areas
from
Transfer (NFT) program.
NFT is
Manual.
COPY

copy the files

command

shown

into their appropriate

below.

areas

DSKB: [10,7]:

*COPY

SYS:/PROTECTION:055=DSKB: [10,7,*,*,*,*, *]1*

EXE<RET>

*COPY

SYS:/PROTECTION:O055=DSKB:
[10,7,*,*,*, % *]* RAM<RET>

*CQPY

SYS:/PROTECTION:Q55=DSKB:[10,7.*
* * * *|* VFU<RET>

*COPY

SYS:/PROTECTION:055=DSKB:
[10,7,*,*,*,*, *]DDT.REL<RET>

*COPY SYS:/PROTECTION:055=DSKB:[10,7,*,*,*,
6 *, *]JOBDAT.REL<RET>
*COPY

SYS:/PROTECTION:055=DSKB:
[10,7,*,*,*,*, *]OVRLAY.REL<RET>

*COPY

SYS:/PROTECTION:(055=DSKB:[10,7,*,*,
%, * *]TECO,ERR<RET>

*COPY HLP:/PROTECTION:055=DSKB:
[10,7,*,%,6 %, *, *]* HLP<RET>
*COPY

DOC:/PROTECTION:055=DSKB:
[10,7,*,*,*, *, *]* DOC<RET>

*COPY

REL:/PROTECTION:055=DSKB:
[10,7,*, %, *, *, x]* REL<RET>

*COPY

UNV:/PROTECTION:055=DSKB: [10,7,*,*,*,*, *]*

*COPY

SYS:/PROTECTION:055=DSKB:
[10,7,*,*,*, %, *]SYSTEM.CMD<RET>

*COPY

SYS:/PROTECTION:055=DSKB:
[10,7,*,*, %, * *]* SYS<RET>

*COPY

SYS:;/PROTECTION:055=DSKB:
[10,7,*, %, * * *]* INI<RET>

UNV<RET>

RESTORING

For

systems,

copy

the

DISTRIBUTION

following

files

TAPES

shown:

*COPY

REL:/PROTECTION:055=DSKB: [10,7,MON,KL]TOPS10.REL<RET>

*COPY

SYS:=DSKB:[10,7,
%, *]DXMCA.ADX<RE
*,*,*,
T>

*COPY

SYS:=DSKB:[10,7,
% %]DXMPA.A8<RET
*,*,*,
>

*COPY

SYS:=DSKB:[10,7,*,*,
%, *]DXMCD . ADX<RET>
*%,

*COPY

SYS:=DSKB:[10,7,
*, *]KNICOD.BIN<R
*,*,*,
ET>

*COPY

SYS:=DSKB:[10,7,*,*,*,*, *]FEUIC.TXT<RET>

systems,

*COPY

also

THE

exit

copy

the

following

file

shown:

SYS:=DSKB:[10,7,*,
* *x]SMFILE.EXE<RET>
*,*

from NFT,

type

EXIT

and press

RETURN:

*EXIT<RET>

you

what

You

have

not

yet

read

.BWR

files

are

available,

.DIR

DSKB: [10,7,*,
% *]* *,*,
BWR<RET>

can

display

sure

the

beware

read

Processor’s

the
all

files,

File

the

files
the

files

System".

beware

type

your

read

them

now.

find

out

command.

following:

terminal

listed

Chapter

files,

the

using
DIR

the

TYPE

command.

"Restoring

the

After

reading

Supplementary

CHAPTER
RESTORING

The

processor uses

disk

and

for

its

THE

SUPPLEMENTARY

processors

are

PDP-11

software.

The

each

PROCESSOR’S

supported

front-end

for

I/O,

uses

system

FILE

SYSTEM

another

which
8080

processor.

requires

The

space

microprocessor

that

also
requires
disk
space for storage.
Sections 8.1 and 8.2 explain
the procedure for restoring the front-end file system for KL
systems.
For
KS
systems, Section 8.3 explains the procedure for restoring the
bootstrap program to disk.
If

you

are

upgrading

system,

continue

you

are

upgrading

system,

8.1

RESTORING

For

existing

front-end

THE

DISTRIBUTED

installations,

software,

from

FE.SYS[1,4]

with

the

new

you

version

where

should

backup
of

KL,

the

FRONT-END

the

area

have

current

with

Section

8.1.

8.3.

SOFTWARE

modifications

copy

disk

reading

directly

been

made

front-end

resolve

those

file

the

system

modifications

front-end.

The
front-end
software
for
KL
systems
is
distributed
on
the
Monitor/ANF-10 tape.
Additional installation tools are distributed on
the CUSP tape.
You must restore these tapes to
disk,
following
the
procedures in Chapter 7, before beginning the installation.
If

you

have

following

used

DSKB:[10,7]

Sub-File

Directories

DSKB: [10,7,RSX20F]

the

will

Contains

the
and

contains

RSXINS.MIC,

Contains

distributions
floppy

file.
8.2,

DSKB: [10,7,F11]

FELOAD.BIN,

F1ll,

populate

the

RSX20F

for

both

systems.

also

master~ installation

1is

PDP-11

described

program

which

process.
tool

used

front-end
file
system.
installation process will use
and

disk,

in the boot blocks of the disk
front-end file
system
during

installation

Contains

based

RSXINS.MIC

will be placed
containing the
the

area

exist:

DECtape

command
Section
DSKB: [10,7,FELOAD]

distribution

(SFDs)

new

RSX20F

file

manipulate

The
F1ll

the

RSXINS.MIC
to
create

system.

RESTORING

Monitor

THE

Interpreted

distributed

new FE.SYS

create
o

file.

PROCESSOR’S

(MIC)

FILE

file,

performs

all

SYSTEM

named
of

the

RSXINS.MIC,

steps

necessary

will:

Ask a set of questions about the installation,
such
as
the
target
disk
for
the
installation,
where the distribution
files are stored,
and whether or not
the
console
front-end

Use

reloaded.

create

and populate

disk.

Fl1l

blocks

F1ll

target

to
of

new

FE.SYS

file

the

’

write
the

the

contents

target

FELOAD.BIN

into

the

boot

disk.

Run DTELDR to reload the front-end
with
the
new
software.
This
is
done
1f
you
answer
YES
to
Question
7
of the
installation
dialogue.
The
installation
dialogue
is
described in Section 8.2.1.

8.2

Commands

DSKB:[10,7,RSX20F],

should

The

SUPPLEMENTARY

section

describes

the

RSXINS

must

make

installation

process

detail.

USING RSXINS

Before

running RSXINS,
0

Your

The CUSP tape
organization

system must

Chapter

you

sure

the

running MIC Version

following:
11

later.

must
be
restored
so
that
its
1s
preserved.
This procedure is

subdirectory
described in

You must be logged in as [1,2].
The F11
program,
which
invoked
by
RSXINS,
uses
Super USETI/USETO calls to do
work.
These can only be executed
by
a
Job
logged
in

1is
its
as

[1,271.

8.2.1

The RSXINS

A sample
dialogue
numbered
used

run
of
the
RSXINS
procedure
is
reproduced -‘below.
questions are numbered for clarity in this text, but are
in the dialogue itself.
1In the following example, RSXINS
install

(DECtape-based)

RSXINS

.DO

Dialogue

new

front-end

file

system.

invoked by

the

command:

DSKB:RSXINS[10,7,RSX20F]

<RET>

structure

DSKE

The
not
1is
1090

RESTORING

will

display
RSXINS

THE

the
~-

This

RSX-20F

procedure

will

the

following

square

brackets.
to

angle

bracket

FILE

SYSTEM

File

16:29:17

create,

file

System

Tuesday,

populate,

system

any

Installation

and

TOPS-10

08-Mar-88

make

bootable

obtain

the

all

([1).

need

you

question

asked,

answer

with

can

expects.
you

can

help

any

Then,

wish

RSXINS

the

to
a

default

with

type

installation

the

respond

first

Which

disk

answer,

time

question

will
back

question,

with

the

left-hand

not,
you

it
to

the

dialogue,

enclosed

square

brackets

RETURN

answer

key.

particular

RSXINS

will

appropriate

then

type

question,

provide

question.

your

are
with

needed.

the

(?).

the

angle

for

press

the

answer

mark

and

repeat

showing
ask

information

default

question

left-hand

will

().

provides

take

explanation

the

question

structure.

RSXINS checks to see if you are logged into [1,2].
If you
will abort execution.
Otherwise,
it will begin a dialogue
each

Procedure

dialogue, default answers
are
enclosed
within
If you would like further information about any
it with a question mark
(?).
If
you
wish
to

answer

return

Front-End

started

front-end

question,

PROCESSOR’S

following:

Installation

RSX-20F

SUPPLEMENTARY

question

bracket

().

the

name

the

you

wish

that

was

RSXINS

the

target

asked,

will

you

repeat

the

default.

disk

structure

unit:
1

[DSKB]?

Respond

this

structure

Use

the

part

structure

DSKE

question
with

physical

put

the

FE.SYS

area

<RET>

with

the

unit

either

name

you

name

multiple-unit

the

four-character

specific

are

disk

installing

unit

name

(such

RPAQ).

disk

FE.SYS

disk

that

structure.

Next you will specify the location of the RSX20F
distribution
files.
The default is the area in which the executing RSXINS file is located.
2

Where

the

distribution

(DSKB: [10,7,R8X20F]]?

You

will

now be

FELOAD.BIN
3

the

two

F1l1.EXE,

exist

FELOAD.BIN

and

asked

Are

the

These

two

files,

questions,
[10,7,F11]

SYS:default
If

you

described

normally
on

prior

area

CUSP

invoking

answer
answered

is
Y,

the

programs

the

files

flles

SYS:

the

N.
question

[N]?
for

subdirectories

If you have
RSXINS,
answer

used

explanations

the

tape.

proceed

front-end

located

procedure,

SYS:.

F11.EXE

exist

the

<RET>

<RET>
the

[10,7,FELOAD]

moved
these
Y, otherwise,

two
files
answer N.

two

and
to
The

RESTORING

Next,

you

PDP-11

will

SUPPLEMENTARY

asked

Dbootstrap

subdirectory
is

THE

specify

program.

the

same

The

disk

the

and PPN

Where

the

distribution

[DSKB:
[10, 7,FELOAD]]?

Next,

specify

the

location

FE.SYS

subdirectory

on the same disk
For example:

located.
5

Where

the

files.

F1ll

where

the

Your

answer

will

are

either

The

the

this

indicating

for

RSXINS

one,

will

The

area

where

number

rest

the

disk’s

Question

using

the

then

RSXINS

using the

DECtape-based
DECtape

ask

how

large

blocks

you

DBO:]"
blocks

wish

The

"[DBO:

not

disk

mounted]"
reserved

FE.SYS

new

DTELDR

reload

the

will
target

answered NO

perform

only

structure

this

the

new

currently

guestion,

please

the

disk,
the

refresh,
Operator’s

it,

there

messages

"[SYO:

RSX-20F

console

with

restore

TOPS-10

files

software

procedure

backup,

user

the

backup

the

when

software

will

and

and then

reloaded.

FE.SYS

8, RSXINS will ask if the console front-end
target structure.
If you accept the default
run

file

contiguously.

between

for

allocated
than
the

available

disk
of

with

seconds

the

file is
larger

then

file,

for

make

(decimal);

necessary

Chapter

<RET>

the

blocks,

FE.SYS

RSX-20F;

[D]?

available

400

is:

400

procedures

should be

file,

FE.SYS

the

RSX-20F

Question

system

<RET>

will

file

(VA##-##).

based

that

space
for

will

create

created

and

disk

multiple
it

disk

documented

F11

system.

(D)

multiple

newly-installed RSX-20F

NO,
Is

files.

are

file

How many
[2000]?

version

the

case,

RSXINS

delay

redirected to

(F)

that

run

(VE##-##)

the

FE.SYS

version

it,

the

for

variant

responses

the

which

there

position

file

RSXINS

valid

place

that

and restoration
Guide.

located

block

area

requested

new

FELOAD

RSXINS

executing

or
at

the

procedure

the

the
will

size is 2000 blocks.
The FE.SY3
disk.
If the new FE.SYS file is

fail.

you

Floppy

default

refresh

follows:

the

determines

system.

DECtape-based

The

answer

your

the

beginning

question

specifies

distribution

answer

where

created beginning

and PPN

floppy-based

contiguously

tool

the

can

used

default

specifies

Question

will

The

file.

Fll,

the

<RET>

located

default

6
In

installed

FELOAD,
will

executing

FELOAD

program

[DSKB:[10,7,F11]]?

answer

SYSTEM

<RET>

manipulate

FILE

location

default

located.
4

PROCESSOR’S

file

is
currently
answer of YES,

front-end

target

processor

disk.

you

installation.

use

skip

RSX-20F

[Y¥]?

Question

10.

<RET>

RESTORING

you

answered
**%

Note

the

THE

YES,

target

SUPPLEMENTARY

RSXINS
is

PROCESSOR'S

SYSTEM

will

then

display

important

that

the

console

running

not

access

the

FE.SYS

structure

(DSKE:)

FILE

cautionary

message:
on
area

during

the
course
of
the
installation,
otherwise
the
front-end
system
could
crash.
This
in
itself is not a
problem, because RSXINS will reload the
FE
after
the
new
file
system
is
built.
However,
if the KL10 CPU were to
crash during the installation procedure
before
the
update
process
was
completed,
then
the
front-end
would not be

rebootable

from the RP06

necessary

boot
the
DECtapes),

front-end
from
console
media
(floppies
after which you could then reload the monitor.

disk.

While this is unlikely, it is
that you can take to minimize

would

possible.
There
this risk further,

Use the SHUTDOWN or STOP commands in
unit-record
connected to

OPR

are
such

devices
(card. readers. and line
the front-end during the update.

steps
as:

stop

any

printers)

Do not run this procedure
if
the
+time
is
within
15
minutes
of
midnight.
This prevents the possibility of
RSX-20F attempting to run the
MIDNIT
task
during
the
update.
If
it
1is
close
to
midnight,
refrain from
answering the final question
in
this
procedure
until
after

12:01

(by

the

system

clock).

Avoid running this procedure if the monitor
or
there
1is
a high incidence of hardware
system crash in the middle of the procedure

is
unstable
failures.
A
would
leave

the
FE.SYS
file
in
a
partially-updated
state.
The
front-end would then have to be
relcaded
from
console
media.

After

this

you

text

displayed

wish to

see

this

will

text

ask:

again

[N}°?

The default answer of N will cause RSXINS to proceed to the next
question; a ¥ will retype the warning message.
If you are running a single-processor KL system, please skip down to
Question 10.
If you are running an SMP system, answer the following
question with the CPU number whose console front-end area you are
installing.
The default is CPU 0.
9

Which CPU’s
entered

console

You

have

the

selected parameters
a

all

the

Here

this

installation.

summary

Target disk
Location of
Location of

front-end

parameters
is

wish

required by

displayed
the

you

options

for

you

have

structure for installation:
RSX20F distribution area:
FELOAD distribution area:

Location of Fll distribution area:
Installation type (D=DECtape, F=Floppy):
Size

FE.SYS

Structure
Console

FE.SYS

file

currently

use

front-end

currently

exists

created:

DSKE:

8-5

CPU:

reload

RSXINS.

[0]?

selected

for

DSKE
DSKB: [10,7,RSX20F]
DSKB: [10,7,FELOAD]

DSKB: [10,7,F11]
D
Y
0

<RET>

summary

check:

2000

RSX20F:

reloaded

RESTORING

Please

indicate

answer

the

dialogue
10

Are

you

with

response

now

1if

exist

choices

question

correct

will

begins

files

the

places

are

with

RSXINS
become

RSXINS
in

FILE

correct.

NO,

the

will

SYSTEM

you

entire

you

Fl1l

have

will

abort

the

are

located

default]

restart

new

defaults

proceed

Section

and

[No

will

the

RSXINS

the
for

install

dialogue.
each

the

Your

question.
new

front-end

8.2.2.

System

installation

FELOAD

the

PROCESSOR’S

restarted.

described

the

them,

all

these

Automatic Front-End File

RSXINS
see

with

respond

software,

8.2.2

will

above

respond

SUPPLEMENTARY

following

the

original
you

THE

Installation

process.

programs

and

specified.

7If

installation

and

successfully,

will

the

does

exit

you

first

RSX-20F

not

will

check

subdirectories

find

monitor

see

one

level.

the

following

messages:

All

guestions

have

been

that

required

SFDs

and

All

files

have

been

asked.

files

The

procedure

will

now

verify

exist.

located.

Commencing

actual

installation

procedure.
Now it
target
F1ll

will check to see
structure/unit.

and

delete

Deleting

the

file

existing

if
If

an
an

FE.SYS
file
already
FE.SYS file does exist,
from the target disk:

DSKE:FE.SYS[1l,4]

exists
RSXINS

on
will

the
run

file...

[OK]
RSXINS

will

now

create

Initialize
you

the

requested

Create

Copy

the

RSX20F,

and

FE.SYS
in

[5,5]
file
to

Copy

the

Copy

output

area,

rest

new

FE.SYS

allocating

directory

[0,0]

created when

file.

the

RSXINS

number

will:

blocks

dialogue.

CORIMG.SYS,
the

file

of
The

the

UIC

area.

populate

the
the

the

file.

containing
directory,

area

was

RSX20F

the

bootable

replacing

image

the

placeholder

[5,5]

directory

initialized.

files

the

FELOAD.BIN

the
from

disk

RSXINS

Creating

new

Defining

the

boot

will

look

front-end

file

new

blocks

(blocks

and

through

unit.

[5,5]

UFD

Placing

RSX-20F

system

Placing

RSX-20F

files

Writing

FELOAD.BIN

the

image

into

the
the

this:

DSKE...
area...
the

[5,5]
disk

area...
UFD

boot

the

area...

blocks...

[OK]
If
If

you
you

answered

Question

YES,

RSXINS

RSXINS
will

front-end.
8-6

use

will

finish

DTELDR

this

point.

reload

the

console

RESTORING

8.2.3

Automatic

THE

SUPPLEMENTARY PROCESSOR’S

Now reloading

RSXINS

reload the console front-end that
a
single-processor
KL
system,

front-end

front-end
on
the
CPU
reloaded, completing the

Front-end

CPU

For

SMP

system,

front-end

the

using
will

console

will be

using newly-installed RSX-20F...

started

procedure

finished at

16:34:06

on Tuesday,

repeat the procedures

and

file

for

is
this

specified
in
response to Question
installation procedure for RSX-20F:

For a multi-processor KL system,
8.2

SYSTEM

Front-End Reload

RSXINS will run DTELDR to
the
target
disk.
On
automatically be

FILE

each CPU’s

front-end

08-Mar-88

Sections

8.1

system.

Section 8.3 describes the procedure for writing the bootstrap
program
to
disk
for
KS
systems.
If
you are installing or upgrading a KL
system,

8.3

WRITING

THE

Chapter

BOOTSTRAP

PROGRAM TO DISK

To
KS

upgrade an existing KS system, it is not necessary to
microprocessor’s
file
system.
However, before you
monitor, you must write the bootstrap program to disk.

rebuild
the
can boot the

To do this, run the SMFILE program as shown below.
You restored
this
program from the bootable tape in Chapter 7.
You must use the version
of SMFILE shipped with TOPS-10 Version 7.04 and you
must
supply
the
serial
number for your system’s CPU.
Note that the following example
uses a CPU serial number of 4097.
.RUN

DEC:SMFILE<RET>

DECSYSTEM 2020 DIAGNOSTICS FE-FILE PROGRAM
VERSION #.#, TOPS-10, KS10, CPU =4097
[FOR

HELP

TYPE

"HELP"]

SMEILE>WRITE

SETUP

SMFILE>WRITE

RESET<RET>

DSKB:<RET>

SMFILE>READ DEC:T10KL.RAM<RET>
SMFILE>SERIAL 4097<RET>
SMEFILE>WRITE

CRAM<RET>

SMEILE>WRITE

BOOT

SMEILE>WRITE

DONE<RET>

SMEFILE>EXIT<RET>
EXIT

KSBOOT.EXE<RET>

RESTORING

The

now

following

THE

ready

commands

SUPPLEMENTARY

run.

the

CTY:

PROCESSOR’S

Reload

the

FILE

SYSTEM

monitor

typing

the

KS10>HA<RET>
When

the

CPU

KS10
BT

halted,

press

the

RESET

buttons

the

CPU panel.

CSL.V#.#

AUTO

BOOT V# (#)
BOOT><RET>

[Loading

from

DSKB:SYSTEM.EXE

[1,4]]

You can load the monitor by typing commands to the BOOT
load

the

default

file

monitor,

monitor

name

type

the
care
to
include
specification.

press

RETURN

DSKB:SYSTEM.EXE[1,4].

file
the

just

the

To
of the monitor to the
structure
name
and
the

name

BOOT

program.

prompt.

The

load
a
different
BOOT prompt, taking
complete
directory

The ONCE dialogue
begins
automatically.
The
startup
options
are
described
in
Appendix
A.
For
a quick startup, use the GO startup
option.
Here is a sample GO startup dialogue.
Only
the
first
few
lines of system startup output are included for clarity:
KS10
Why

dd-mmm-yy
reload:

NEW<RET>

Date:

22-Aug-88<RET>

Time:

17:17<RET>

Startup
KS10

option:

17:18:12

Connected

.LOGIN
.R

OPR

OPR>

1,2

CTY
Node

GO<RET>
system

4097
Line

CENTRA(0)

PART

BUILDING

This

part

describe
system

system
Part

how

the

THE

MONITOR AND

TAILORING

THE

SYSTEM

made

wup
of
four
chapters
that
build your monitor and tailor the
particular needs
of your site.
All

installations

require

the

procedures

CHAPTER
BUILDING

YOUR MONITOR

Even though you have a running monitor, the bootstrap monitor is
only
a
tool
for configuring a monitor for the system.
When you build the
monitor, you configure support
for
the peripheral
devices,
memory
units,
terminal
and
network
lines, and supply information that the
monitor needs to run CUSPs successfully.
You will build
the
monitor
using
the
MONitor
GENerator
(MONGEN) program, assemble the monitor
with MACRO, and load and save the monitor with LINK.
Then
you
will
bring
up
your new monitor and create a bootable monitor tape.
Later
sections describe how to automate the build
procedure
and
customize
BOOT.

This

chapter

describes

MONGEN.

Run

the

following

steps

build the

monitor:

Run MONGEN and answer the questions in the dialogue
section.
MONGEN
creates
symbol
definition
source files, containing
information
obtained
from
your
answers
to
the
dialogue
questions.
You use the source files to build your monitor.
MONGEN
o

creates

the

SYSCNF.MAC
contains
hardware and software

F.MAC
. If

contains

you

switches

the

and

create

procedure

new

any

and their
of

described

the

settings.

monitor

This

setting

for

monitor

Assemble

Link

the
symbol
definitions
configuration.

test
if you add any
feature
reassemble, the bundled

modules

the

files:

switches in the FGEN dialogue, or
test
switches,
you
must
then

feature

library

file,

in Appendix

source modules.

The COMMON, COMDEV,
assembled
with the
configuration file,

source

feature test

change

TOPS10.REL.
2.

following

load the

and COMMOD modules
symbol definitions
SYSCNF.MAC.

of the monitor must be
recorded in the MONGEN

monitor.

The modules must be linked with
the
monitor
library
file,
TOPS10.REL,
and
with
any
unbundled software (such as MPE)
that your installation has chosen to run.
These are combined
to
form
a
runnable,
executable
monitor
in
a file named
SYSTEM.EXE.

BUILDING

9.1

YOUR MONITOR

MONGEN

modules

and

dialogue

and

define

MACRO-10

program

features

your

source

that

hardware
files.

that
are

and
The

software

create

your

Parameters

determine

Before

how

the

monitor

running MONGEN,

you

choose

appropriate

executable

data

that
base is

the

following:

for

the

your

configuration.

MONGEN-created

information

needed to
installation.

allows

most

source

monitor

MONGEN

files

that

are
assigned
assembled.

is
in

files

Be thoroughly familiar with yofir system configuration.

Predetermine the answers you will provide to the questions
MONGEN

will

Obtain
each

you

copy

with

might

the

product-specific

product

any

Dbe

you

are

wish

modifications

necessary

installation

products

yourself

with

the

Worksheets 1 and 2, provided
determine your responses.

unbundled

Special

acquaint
dialogue.

dialogue.

help

yourself

that

for

the

MONGEN

asking

dialogue

questions

SYSGEN

divided

about

following

procedures

for

unbundled

software.

unbundled

software

installation

FGEN

SYSGEN

monitor

that

longest

portion

you

options,
features

and

creates
the
you

the

monitor.
must

creating
For
building

the

offers

of the
file.

MONGEN

dialogue,

change

the

enabling

symbol

accept.

settings

and

each

values

that

the

and

F.MAC
If

file,

you

monitor

which

change
all

for

dialogue

the

FGEN

dialogue.

make

changes

your

change

subsequent
harware

you

want

feature

test

switches.

creates

fieature

the

test

software

monitor

wuses

to
service
users
and
how to perform
operations.
You
must
run
FGEN.
FGEN

rebuild

SYSGEN

disabling

the

any

the

required

default

monitor

monitor that is not
information, refer to

the

services

some

refuse

how

maintenance

sections,

configuration:

system

may

thus

determine

also

you

SYSCNF.MAC

Allows

are

following

the

the hardware and software configuration.
This
includes
type
and
number
of
CPUs,
processor
characteristics, ports for
data
communications,
tape
and
disk
wunits,
line
printers, and other peripheral
devices.
SYSGEN defines
the
terminal
configuration,
including
the
OPR
1line
number
and the dataset line

the

you

for

Defines

numbers.

questions

the

aspect

guide

familiarize

product-specific

into

specific

Chapter

and

installing

instructions

available

use,

current

installation
to

guides.

new

these

this chapter
to
version of the MONGEN

FGEN

the

specific

Read

builds

contain

the

The

software

installation

for

building

switch

settings

library

supported
Appendix B.

files,

thus

DIGITAL.

first

time,
answer
all
the
then answer the questions in
occasions,
select SYSGEN if you want

first,

software

feature

test

configuration,

switch

settings

and

select

add

any

BUILDING

9.1.1

YOUR MONITOR

Running MONGEN

You can run MONGEN from any disk area, and the source files
that
generated
are
stored
in
your
Jjob’s default disk area (DSK)
or
other disk area you specify.
Make sure that the disk area
where
monitor
1is to be built has at least 7000 free disk blocks.
Clear

directory
confusion

area
when

of any extraneous files
assembling the monitor.

eliminate

the

are
any
the
the

possibility

MONGEN has three modes
of
dialogue
(SHORT,
PROMPT,
and
LONG)
to
service
wusers
of
different
levels
of ‘experience.
Throughout the
dialogue, MONGEN questions take the
form
of
the
mode
you
choose.
MONGEN questions are in the form:
question
An

(default,possible

explanation

each mode,

the

three

answers)

modes

and

[explanation]:

the

provided below:

form the

questions

take

’

Mode

Effect

SHORT

MONGEN prints only the questions on your terminal.
This
mode
assumes
that
you
need no listing of
default or possible answers, and no explanation of
the
question.
familiar with the
is

PROMPT

recommended

MONGEN
choice

only

for

assumes
that
you
answers.
SHORT

are
mode

experienced users.

MONGEN
prints
each
question,
but
adds
(in
parentheses)
a
choice
of
answers.
The default
value,
if
any,
is
printed
first
in
the

parenthesis,
type,

followed by

separated

the

commas.

other
Due

answers

the

you

may

nature

some of the questions, a default answer may not be
offered.
This is the default mode and it is
wused
in this section to illustrate the dialogue.
LONG

MONGEN prints each question, the choice of answers
(in
parentheses),
and adds an explanation of the
question
[in
square
brackets].
LONG
mode
1is
strongly
recommended
for all first-time users of
this

Each

question,

you

choose

version

regardless

PROMPT

of MONGEN.

of the

LONG

mode

mode,

chosen,

select

ends

your

with

answer

from

colon.
the

possible

answers

listed within parentheses and enter it after
the
colon.
To
accept
the default answer, Jjust press RETURN.
If the question has no
default, MONGEN prints an error message and repeats the question.
The
possible answers are listed in one of these forms:
(d, m-n)

A range

default
the

largest

in
that
specified
(m-n)

numbers

wvalue,

A range

where

the

smallest

number

you

may

type.

range.
otherwise
of

provided.

provided,

'm’

the

and

'n’

number

Numbers
are
decimal
in the question.

unless

numbers
For

’d’

number

with

example,

you

no
can

Choose

default
specify

consecutive

range

terminal lines
by
answering
numbers in the form (m-n).

(YES, NO)

Answer

with

(a,b,c,...,2)

Choose

one

YES

oxr

the

9-3

values

the

list.

value

multiple,
with

BUILDING

you

type

error

question
To

invalid

message

and

YOUR MONITOR

inappropriate

repeats

the

question

again.

execute

the

version

MONGEN

command:
.R

. response,

MONGEN

can

that

you

DSK:[10,7,MON],

prints

respond

type

the

an
the

following

SETSRC<RET>

*CP

[10,7,MON]<RET>

*<CTRL/C>
.RUN

MONGEN

MONGEN<RET>

responds

Write

with:

MONGEN.MIC

You answer
dialogue.

this

(YES,NO) :NO<RET>

question

This

with

YES if you want
to
record
the
would be useful for building several

record

monitors.
After

you

answer

MONGEN

for

MONGEN

will

this

704

begins:

about

any

which

known TOPS-10
configurations

refer

/HELP

(PROMPT, SHORT, LONG) : /HELP<RET>

PROMPT

answers
LONG

MONGEN

monitors

generate

information

Since

question,

the

default

this

MONGEN

for

704

MONGEN

will

information

mode,
If

you

question:
monitors.

are

(PROMPT,

the

any known TOPS-10
which configurations

supported,

SPD.

SHORT,

are

unless

stated otherwise
allowed everywhere to all

are

questions

/HELP reasks a question in the next longer mode
/HELP:xxx sets the mode permanently.
Modes are:

SHORT

LONG
As

shown

current

PROMPT,
to

short

has

choices

above,

you

question

remaining
or

LONG.
to

LONG

may

and

ask

type

For

()

typing

questions,

change

For

please

LONG)
{

decimal

abbreviations

PROMPT

For

please

MONGEN provides a list
of
possible
now type /HELP, MONGEN provides the

configuration.

Unique

supported,

about

/HELP

numbers

are

generate

refer

All

configuration.

SPD.

parentheses.

version

entire
similar

MONGEN
/HELP.

explanation
for
If

the
you

/HELP:mode,

example,

mode

for

the

mode

LONG

you

next
wish

where
choose

remaining

[]]:PROMPT<RET>

longer
to

version

change

’mode’
SHORT

mode

questions,

modes

can
and

the

for

the

SHORT,

later

want

type:

/HELP
: LONG
This

will

can

answer

specific
To

exit

set
any

the

question

with

for

LONG

the
to

question.
from MONGEN

any

time,

type

remainder

get

the

LONG

<CTRL/Z>.

the

dialogue.

explanation

for

You
that

BUILDING

9.1.2

YOUR

MONITOR

The MONGEN Dialogue Questions

A
This section lists the dialogue questions for each part of MONGEN.
numbers help you to
These
question.
MONGEN
each
precedes
number

follow the dialogue more easily,

when

run

you

displayed

actually

and they are not

MONGEN.

NOTE

of
MONGEN asks some questions only for specific types
a
answer
you
only' if
others
asks
and
systems;
preceding question in a certain way.

MONGEN,

Before running

read

this

chapter

carefully.

Decide

the

Worksheets 1 and 2 are
in the dialogue.
question
each
for
answers
MONGEN
provided in Chapter 2 to help you record your responses to the
If you like, you can create a .MIC file to run MONGEN, and
questions.
answer the questions in the .MIC file to save time.

the
is
This section lists the MONGEN questions in PROMPT mode, which
LONG mode or type /HELP after a question to get
Use
mode.
default

information about each question.

GEN

Which

(SYS,F):

run.
to
wish
Respond with SYS or F to indicate the section that you
When
respond with SYS, MONGEN displays the SYSGEN questions.
you
If
the SYSGEN dialogue is done, MONGEN asks Question 1 again, so that you
The SYSGEN questions
start the FGEN part of the MONGEN dialogue.
can
are listed in Section 9.1.2.1.
The
FGEN
questions
are
listed
in
Section

9.1.2.2.

9.1.2.1
Running SYSGEN - SYSGEN asks gquestions about the hardware and
includes the central processor (s),
This
system.
your
of
software
storage devices, and other peripheral devices.
2

Output

(DSK:SYSCNF.MAC)
:

DECsysteml0

(KL,KS):

Question 4 is asked for KL systems only.
4

CPUs

System

Question

(1,1-6):
name:

asked for each CPU.

(1-10000):

CPUn serial

Exclude monitor overhead from user run time

Questions

8 and 9 are asked for KL systems only.

only if you answer Question 8 with YES.
8

EBOX/MBOX runtime

accounting

Exclude PI time from user runtime

Account verification

Question 9 is

(YES,NOQO):

(YES,NO):

asked

BUILDING

Questions
11

MOS

and

are

memory

Include

you

with

answer

PROMPT,

systems

only.

device options:
(NO, YES,PROMPT)
:

SCA

Questions

you

for

(YES,NO):

Autoconfigured

asked

YOUR MONITOR

will

Device

code

Drive,

slave,

through

asked

16,

the

20,

21,

following

26,

and

through

to use LAT

software.

questions:

(CR,0-774):

unit:

Data:

You must

you

want

specify

answer YES

Question

Include

Ethernet

Include

SAl10

Questions

through

service

(NO,YES):

if yéu want

(NO,YES,PROMPT)
:

device

support

asked

are

data

(NO,YES,PROMPT)
:

for

systems

Include

RP01/2/3

disks

(NO,YES,PROMPT)
:

Include

Swapping

drums

(NO,YES,PROMPT)
:

only.

If you answer Questions 17,
19,
22,
and 27 through 30
Question 18 with YES, you will be asked the following

Device

Massbus
Drive,

code

with

PROMPT,
questions:

(CR,0-774):

device
slave,

(0,0-7):
or

unit:

Data:
Do

you

Include

Prompt

Questions

want

specify

RS04/5

Massbus

disks

for

RPOx/RMOx

through

are

data

Massbus

asked

(YES,NO):

(NO,YES,PROMPT)
:
disks

for KL

(NO,YES):

systems

Include DX20/RP20 disks (NO,YES,PROMPT):

Include

Include SA10/IBM disks (NO, YES, PROMPT) :

Include

Questions

CI20/HSC

disks

TM02/TM03

through

(NO,YES,PROMPT)
:

magtapes

are

asked

(NO,YES,PROMPT)
:
for

Include

UNIBUS/LP20

printers

Include

UNIBUS/CD20

card

Local

25.

Terminal

DZ-11

Questions

TTY

through

systems

only.

(NO, YES, PROMPT) :

readers

(NO,YES,PROMPT)
:

Configuration:

lines

only.

(0-32):

are

asked

Include

DX10/TX01/TX02

Include

DX20/TX02

tapes

for

tapes

systems

(NO,YES,PROMPT)
:

9-6

only.

and

BUILDING

YOUR MONITOR

Include

TM78/TU78/TU79

magtapes

Include

TM10B

magtapes

(NO,YES,PROMPT)
:

Include

TC1l0C

magtapes

(NO, YES,PROMPT)
:

Include

SAl0/IBM

Include

BA10/LP100

Include

CFE/LP20

Include

XY10

plotters

Include

CR10

card

Include

CFE/CD20

Include

CP10/CP10D

card punches

(NO,YES,PROMPT)
:

Include

PC04

paper

tape

punches

(NO,YES,PROMPT)
:

Include

PC04

paper

tape

readers

(NO,YES,PROMPT)
:

tapes

(NO,YES,PROMPT)
:

printers

(NO,YES,PROMPT)
:

readers

card

(NO,YES,PROMPT)
:

readers

(NO,YES,PROMPT):

Types

of DTE service to load:
Load ANF-10 DTE service
(YES,NO):

Load

IBMCOMM

Load

DECnet

you

answer

you

YES

answer

Question

DTE

service

(YES,NO):

Question

43,

MONGEN

asks

NO,

(YES,NO):

MONGEN

54.
Local

terminal

Configure

Question

asked

terminal

scanners

for

each

CPU.

RSX-20F

TTYs

How

How many DC10s on CPUn

(1,0-2):

How many

DC68s

CPUn

(1,0-2):

How

DC76s

CPUn

(1,0-2):

Questions

For

many

through
DC10

Number

Correspondance

Question

For
51

are

DCl0E

asked

DC68

Number

for

line

data

Data

set

for

DC68

CPUn

asked

DC10B

Questions
44

then

goes

through

53.

directly

configuration:

old

asks

Question

DC1l0E
each

(0,0-128):

each DC10.

groups

control

lines

(NO,YES):

(1-8):

groups

the

(0-1):

DC1l0B

lines

(M-N,P):

DC68.

lines,

including

its

console

TTY

(1-144):

BUILDING

Questions

For

and

DC76

are

asked

DL10

port

Decimal

OPR

octal

line

Data

set

lines

Number

Maximum pages

Total

amount

asked

for

Question
59

which

Question

Clock

lines

Number

Allow

jobs

Guaranteed

(NO,YES):

KASER

(NO, YES) :

MPXSER

(YES,NO)
:

PSISER

(YES,NO):

IPCF (YES,NO):

ENQ/DEQ

711

Disk sets (ALL):

89,
72

pages

systems

locked

of pages

reserved

K (512-4096)
:

only.’

core

for

(YES,NO):

unlocked

locking

interrupt

jobs

queues

(0,0-16384):
Exec

Virtual

(0,0-15):

(YES,NO)
:

Questions

building

Questions

skips

(0,0-16384)
:

(60,50)
:

high priority

building

asks

job

monitor
73

and

through

97.

are

then

core

second

number

Meter

you

system

each

(0,0-77):

MONGEN

for

devices

(0,1-7):

(1-129):

real-time

Number

Question

connected

only.

asks

DC76

systems

(10,0-7?):

are

the

DC76.

you

core

for

Number

DC76

Memory

MONGEN

each

(1-511):

per

asked

for

(CTY,0-3)
:

Jobs

ticks

YOUR MONITOR

Configure

monitor

Question

through

and
96.

you
86.

you

answer

Question

Otherwise,

answer

Question

Otherwise,

MONGEN

97.

non-autoconfigured

hardware

(NO,YES):

with

MONGEN

with

asks

YES,

skips

YES,

Question

BUILDING

For

systems
on

only,

Questions

DIS

Type

Number

TD10S

(0,0-2):

Number

units

Number

DAZ28s

(0,0-4):

Number

lines

for

Number

DAS78s

For

DAS78

Decimal

Number

which

For

DN60

which

Decimal

How many
For

(1-8):

TTY

onl

(8,0-512):

(0,0-8):

port
on

DN60s

the

DAS78

connected

(0,0-7):

(1-16):

(0,0-7):

port

the

DN60

connected

lines

the

DN60

(1-12):

DN87s

DC75NPs

front

end

number

which DL10

systems

DTn

DL10
lines

86:

(VP10,340,VB10C):

For

through

(NO,YES):

MONITOR

CPUn:

YOUR

only,

port

CPUn

(0,0-7):

(0,0-8):

the

Questions

DC75

DN87

through

connected

96:

Number

RX211ls

Number

units

Number

of KMC/DUP

Type of line for KDPn (ANF10,DECNET,USER,
IBM) :

Number

DMRn

line

DMRn

switched

DMRn

half

Load

Number

Network

Node

100

Number

of DMR1l

DMRn

type

(0,0-2):

(1-2):

Lines

line

duplex

(0,0-8):

(YES,NO):

(YES,NO):
(YES,NO):

communications

PTYs

(0,0-2):

(ANF10,DECNET,USER,
IBM):

secondary

IBM

RXx

software

(YES,NO):

(20,1-505):

software

(YES,NO):

name:

remote

TTYs

(485,0-485):

(0,0-7):

BUILDING

you

114.

you

YES

answer

Question
NO,

101,

MONGEN

asks

102

Node

name

103

Node

number

104

Remote

105

Virtual

106

Remote

card

readers

107

Remote

line

printers

108

Remote

paper

tape

punches

(NO, YES):

109

Remote

paper

tape

readers

(NO, YES):

110

Remote

plotters

111

Remote

DN8x

DDCMP

devices

112

Remote

data

entry

terminals

113

Remote

task-to-task

114

Number

answer
1If

you

central

(YES,NO):

(NO,YES):

(YES,NO):

(YES,NO):
(256,1-512):

115,

MONGEN

software

(YES,NO):

MONGEN

skips

asks

Node

117

Areé number of central site (1,1-63):

118

Node

119

Routef type (ROUTING, NONROUTING) :

120

Transmit

lZi

Remote terminals (YES,NO):
you

(YES,NO):

central

password

Question
answer

software

122

with

NO,

LAT

123

Node

124

Number

125

Service

groups:

126

Decimal

"symbol,value":

127

Octal

128

SIXBIT

site

(1,1-1023):

(DECNET20)
:

122

name

122.

(node):

number

answer

Questions

Question

116

1If

through

(YES,NO):

DECnet

you

116

(YES,NO):

Question
NO,

(1,1-77):

(YES,NO)
:

connects

answer

site

115

125.

through

(node):

terminals

name

102

115.

(YES,NO):

terminals

YES

Questions

Question

ANF-10

you

software

MONGEN

skips

101

121.

answer
If

YOUR MONITOR

YES,

MONGEN

(YES,NO):

(node):
circuits

(20,1-100):

"symbol,value":

asks

skips

Questions

123

Question

126.

through

BUILDING

YOUR MONITOR

129

Type

"device-mnemonic,PI-channel"

for

special

devices:

130

Type

"device-mnemonic,PI-channel,no.-of-devices":

131

Type

"device-mnemonic,PI-channel,highest-ac-to-save”:

132

Type

"ersatz-device,P,Pn,search-list-type":

133

Type

"command-name,dispatch,flags,unique-bits,
PRVTAB-name":

If you enter a terminal class in Question 134, MONGEN
asks
135 through 144.
Otherwise, MONGEN skips to Question 147.
134

Terminal

135

Width

(80,17-255):

136

Length

(0,0-255):

137

Fill

138

Characteristics:

139

Address

of erase table

140

Address

141

ANSI

142

DEC

143

Characteristic

Questions

class:

(0,0-3):

rubout

conformance

:
(V100EP)

table
level

level

(VTXXBP):
(1,0-15):

(0,0-15):

attributes:

If you do not enter a member terminal type
in
Question
144,
repeats
Question
134.
If
you enter a member terminal type,
first asks Questions 145 and 146, then repeats Question 134.
Now enter member

terminal

144

Terminal

145

Additional

146

Attributes to clear:

types

type:

attributes

set:

If a class to extend is entered in Question 147,
146

are

repeated.

Question

MONGEN
MONGEN

class

Questions 144 through

to extend is entered,

MONGEN asks

148.

Additional
to

terminals

147

Class

148

System default

for

classes:

extend:

terminal

type

This is the
last
question
in
dialogue.
MONGEN responds with:

the

File

DSK:SYSCNF.MAC

Closed

(TTY):

SYSGEN

[SYSGEN

portion

the

MONGEN

finished]

The SYSGEN dialogue is finished when the source
file
is
written
to
disk.
Question
1 is repeated so that you may start the FGEN portion
of the dialogue.
If you wish to exit from MONGEN, type <CTRL/Z>.

BUILDING

9.1.2.2

Running FGEN
appropriate

choosing
FGEN

allows

you

application.

The

FGEN

software

select

"feature-test

YOUR MONITOR

the

dialogue
from

non-standard

dialogue,

simplifies

wide

selection.

TOPS-10

features

the

software

switches."”

the

task

For
for

options

example,
a

are

given

called

NOTE

Only

the

standard

installations

options,
and

settings

Appendix

the

FGEN

List

Request

explanation

Change

the

feature-test

Add

the

new

feature-test

questions

are

listed

Output

(DSK:F.MAC)
:

Feature

set

Standard
you

select

FGEN

with

option

supported.

settings

have

switches,

TOPS10.REL.

the

switches
the

dialogue,

with

you

their

must

then

procedure

may:

standard

feature-test

switch

you

This

switch

settings.
symbols.

settings.

switches.

below.

(SYS,F):

(KL10,KS10):

settings

the

(YES,NO)
:

standard

portion

NO,

GEN

the

feature-test

fully

supported.

file,

portion

Which

not

the

library

are

the

are

alter

nonstandard

monitor

select

may

FGEN

the

you

been

tested

the

documented

The

been

change

rebuild

After

and

Although

not
you

tested

have

feature-test

settings

switches

the

settings

dialogue

MONGEN prompts

you

with

and

its

answering

finished.

Question

Question
If

you

with

answer

YES,

Question

Featuie:
list

and press

standard

switch

RETURN.

For

setting,

type

the

example:

name

the

switch

Feature:KL10<RET>

Hardware

options

FTKL10==:-1

list

all

RETURN.

standard

All

according
to
communications
UUOQ
To

features,
change

enter

comment

the

1if

the

;KL10

switches

standard

the

and

value

desired,

and their

switches

and

settings,

settings

type

will

following

network

miscellaneous

name

support

the

ALL

and

listed,

categories:
hardware
features,
I/0 features,
scheduler
features,

and

customer

defined

known

switch,

create

switch

without

the

prefix,

separated

commas

and

press

its

RETURN.

press
grouped

options,

features,

features.
new

switch,

value,

and

BUILDING

YOUR MONITOR

FGEN

Question 5 is the last question in the
MONGEN responds

dialogue.

File

DSK:F.MAC

Question

9.2

with:

MONGEN

the

Closed

asked again.

exit

portion

You may choose

SYSGEN

FGEN,

type

from MONGEN.

ASSEMBLING THE MONITOR

You must always assemble the following monitor source files:
COMMON .MAC
COMDEV .MAC
COMMOD .MAC

With the configuration source file:
SYSCNF .MAC

It is necessary to assemble the following universal files with them:
F.MAC

S .MAC
NETPRM.MAC

DTEPRM.MAC

(KL

only)

DEVPRM.MAC

D36PAR.MAC

It is important that F.MAC precede S.MAC
in
the
compiler
commands,
has conditional assemblies that depend on the contents
S.MAC
because
of F.MAC.
Use the following monitor commands to compile the monitor:
.COMPILE/COMPILE F,S<RET>
MACRO:

MACRO:

EXIT

.COMPILE/COMPILE DEVPRM,DTEPRM,NETPRM, D36PAR<RET>
MACRO:

DEVPRM

MACRO:

DTEPRM

MACRO:

NETPRM

MACRO:

D36PAR

EXIT

.COMPILE/COMPILE
MACRO:

COMMON

MACRO:

COMDEV

MACRO:

COMMOD

,
COMMOD><RET>
<COMMON
SYSCNF+COMDEV,

EXIT

If you
are
wusing
a
standard
combination
of
feature-test
switch
settings and DIGITAL-supplied sources, you do not need to assemble the
remainder of the bundled monitor modules.
These modules have
already

been

assembled

and

combined

monitor

library

file

named

TOPS10.REL.
TOPS10.REL must be located in the same disk area as
that
which you are using to build the monitor, before you can link and save
the

monitor.

BUILDING

For

KL installations,
installations, the

you

are

not

have

assemble

all

the

These

9.3
The

procedures

step

LINK

runnable
can

full

THE

creating

the

LINK

new

sources,

monitor

switch

you

library

must
file.

MONITOR

linking

program

sequence

feature-test

monitor

in Appendix

the

process.

requires

LINK

instructions

configuration

This

with

and

lists

the

refer

loads

section

build

program,

Manual.

the

the monitor is to link the monitor
modules.
in the procedures that follow provides both a
(SYSTEM.EXE),
and several options for information you

the

following

standard

sources,

used

documentation

Reference

combination

changes

For

building

about

that

made

explained

SAVING

monitor

commands

The

are

program

receive

standard

monitor

LINKING AND

The

TOPS10.REL library is in
[10,7,MON,KL].
TOPS10.REL library file is in [10,7,MON,KS].

you

MONITOR

the

using

settings

YOUR

the

saves

unbundled

only

the

monitor.

TOPS-10

monitor

For

Link

for

software:

LINK<RET>

*SYSTEM/SAVE/NOINITIAL/HASH:13K = /LOCALS
#COMMON, COMDEV, COMMOD, TOPS10/SEARCH-<CR>

—-<CR>

#/PA
200 /COUNTERS
TCH:
/GO<CR>
EXIT

NOTE

It is
line
left,

very important to leave a space on
after
the
/LOCALS
switch.
If a

the

command

The

file

name

SYSTEM

can

use

any

file

SYSTEM.EXE[1,4],

load unbundled

relocatable
use

copy

your

following

.COPY
After

accepted.

arbitrary

name

chosen

However,

the

bootstrap

SYSTEM

the

customized

the

with

good

the

command

Copying the New Monitor to

loaded

the

not

name.

software

file(s)

will

choice

monitor

bootstrap

monitor

for

monitor,
line

CPNSER.REL.

9.3.1
Now

line

the
command
space is not

for

the

name.

the

name

COMMOD.

SYS

that

program.

copy

your

you

the

SMP

support

can

easily

SYS:

command:

S8YS,

For

monitor

SYS:=SYSTEM.EXE<RET>

SYSTEM.EXE

you

defaults

file

include

after

monitor;

program

can

start

your

new

monitor.

SYS,

type

BUILDING

9.4

BRINGING

THE

YOUR MONITOR

NEW MONITOR

Before you can load the new monitor, you must reload the
system.
To
do
this,
you
will
shut
down
the current monitor, then reload the
monitor.
Use the GO startup
option
to
start
the
monitor
quickly
without
changing
disk
parameters.
The following procedures show a
quick

startup

SYS:TTY.INI
Procedure

for

and

for

and

SYS:SYSJOB.INI

then

were

for

KS.

both

systems,

created previously.

Systems

<CTRL/\>
PAR>SHUTDOWN<RET>

DECsystem-10

not

[Dumping

[Loading

from

KL10
Why

running

DSKB:CRASH.EXE([1l,4]]

DSKB:SYSTEM.EXE[1,4]]

20-Jun-88
reload:NEW<RET>

Date:JUN-20-88<RET>
Time:18:36:12<RET>

Startup
KL10

option:

18:36:41

Connected to
.LOGIN

GO<RET>

CTY

system

Node

2996

CENTRA(0)

Line

1,2

OPR

OPR>EXIT<RET>

Procedure

for

Systems

(Press

the

RESET

KS10

and

BOOT

switches

the

Line

console

the

same

time.)

CSL.V#.#

BTAUTO

BOOT V# (##)

BOOT><RET>
KS10

11-Aug-88

Connected to Node CENTRA
Why

(0)

reload:NEW<RET>

Date:AUG-11-88<RET>
Time:10:29:04<RET>
Startup

option:

KS10 10:30:06
.LOGIN 1,2
.R

GO<RET>

CTY

system

4101

OPR

OPR>EXIT<RET>

Next,

you

will

create

bootable

magnetic

tape

for

your

system.

BUILDING

9.5

CREATING

This

section

tape

for

THE

running

disk.

You

SYSTEM BOOTABLE

describes

your

the

system.

the

YOUR MONITOR

event

should

procedure

The

TAPE

for

bootable

disk

failure

the

bootable

rebuild

Section

systems,

procedures

9.5.1

Use

Creating

the

following
Mount

tape

ensuring

that

bootable

systems,

create

magnetic

tape

the

ring

write

used

bootable
to

get

prevents

every

tape

refer

time

using

you

the

Section

monitor

load

from

new

instructions

9.5.2.

These

Tape

bootable

monitor

tape

that

you

will

the

tape.

for

magnetic

your

booting

DSKB:SYSTEM.EXE[1,4].

System Bootable

steps
a

the

monitor

use

for

Tape

the

drive

bootable

files

tape

MTAQ

here.

.ASSIGN
.SET

MTAQ:

BACKUP:<RET>

BLOCKSIZE

.REWIND

Then,

build

For

the

used

can

save

system.

tape,

you

9.5.1.

that

monitor.
For

creating

tape

BACKUP:512<RET>

BACKUP :<RET>

.COPY

BACKUP:=FEFILE.EXE<RET>

.COPY

BACKUP :=SYS:BACKUP.EXE<RET>

copy

your

new monitor

and

all

the

system

typing:
.R

BACKUP<RET>

/SAVE

DSKB:[1,4]=8YS:SYSTEM.EXE<RET>

/SAVE

DSKB:[1,4]=SYS:*.*
REL:*. *, UNV:* *<RET>

9.5.2

Creatihg the KS System Bootable Tape

Use the following steps to create a bootable monitor
system.

ensuring

Mount

that

.ASSIGN
.SET

write

MTAQO:

BLOCKSIZE

.REWIND

tape

ring

that

you

will

included.

BACKUP:<RET>
BACKUP:512<RET>

BACKUP:<RET>

.COPY

BACKUP:=T10KL.RAM<RET>

.COPY

BACKUP :=BOOT.RDI<RET>

.COPY

BACKUP:=S5YS:BACKUP.EXE<RET>

wuse

Tape

for

drive

tape' for
the

MTAO0

bootable

tape,

used here.

BUILDING

Then,

copy

your

new monitor

and

YOUR MONITOR

all

the

system

files

tape

typing:
.R

BACKUP<RET>

/SAVE

DSKB:[1,4]1=8SYS:SYSTEM.EXE<RET>

/SAVE DSKB:[1,4]=SY¥S:*.,*,

9.6

AUTOMATING

THE

BUILD

REL:*
*,6 UNV:*

*<RET>

PROCEDURE

This section describes how to
build
the
monitor
through

automate the build procedure.
After you
direct
interaction,
you
can
edit the

installation.
monitor, tells

describes the files necessary to build a
are located and how
to
customize
them

distributed build files to tailor them to the characteristics

and

use

This
section
you where they

them.

You can
rebuilt

use the automated build procedure whenever
(to
install patches, upgrade the monitor

changes

to the

configuration of the hardware

you
need
to make changes
follow the instructions in

to your monitor
this chapter.

Before you submit the control

files

the

system as

GALAXY batch

and spooling

the monitor
version, or

must be
to make

software).

When

and/or

that

require

described in this
described

The following table lists each file and its function.
appears
next
to
files that require customization.
explains how to modify these files.

rebuilding

section,
Chapter

9-1:

it,

start

10.

An asterisk (*)
The next section

Some of the files pertain only to
particular
installations.
where noted, all of the files below are on the Monitor/ANF-10

Table

your

Except
tape.

Monitor Build Files

File

Function

BUILD.CTL

compiles the files in the
build
areas.
These
areas
include
the
COMMON
modules
(COMMON,
COMDEV, and
COMMON)
.
In
addition,
BUILD.CTL
builds TOPS10.GLB and MON.EXE.

BUILDS.DCL

contains

BUILDS.MIC

submits

all

the

BUILDS.PTH

defines

the

build

COMCTL .MIC

provides

template

command

COMPIL.MIC

COMCTL.TEC

build

control

for

the

control

file

that

control

file

uses.

COMPIL.MIC

builds

files.

areas.

reads COMCTL.MIC to generate
that

COMPIL.CTL

definitions.

uses.

TOPS10.REL.

the

BUILDING

COMPIL.MIC

GEN.CTL
MPE.FIL

creates

lists

runs

the

submits

single

control

dialogues.

contains

the

This

file
MPE

monitor

MONGEN

names

the
START.CTL

and

YOUR MONITOR

list

MPE

files

directory

areas

for

applies

only

the

for

recompilation

Deletes

and

that

compiles

SMP

compile
the

and

.REL

sites.

following operations

all

files

the

from

the

files.

CPNSER tape.

performs
full

file

module.

in preparation

monitor:

BASE:

except

* MAC

* . MIC.

Creates

the

Creates

MPE.FIL,

they

LINK.CCL

and

GLOB.MIC

UNSUP.FIL,

not

already

files.

and

exist

DECNET.FIL

the

build

area.

Uses

the

*.FIL

TOPS10.CMD,

files

and

create

TOPS10.CCL

UNIV.CMD,

each

FGEN

area.

Invokes

TREE.TEC,

and

TOPS10.TEC.

NOTE

Submit
new

START.CTL

version

update

SWITCH.INI

TOPS10.FIL

TOPS10.TEC

defined

feature

switches,
with

defaults

for

the

creates

the

uses

UNIV.CTL

list

SUBMIT

.CCL

this

contains

all

unsupported

when

vyou

previously

symbols

the

from

and

list
This

wversion

PATH

and

sets

compile

and

the

commands.

.CMD

for

files

the

.REL

that

exist

deletes

files,

COMPIL.CTL,

use.

START.MIC

areas

7.04,

Version

files

and

'
to

and

insure

that

START.MIC

they
when

that

are
it

action.
the

defined

compile.

autopatch

or
any

directory areas

TREE.TEC

recompiles

areas,
UNSUP.FIL

the

BUILD

completes

runs

and UNIV.CTL

and

empty.

test

TOPS-10

BUILDS.PTH

FGEN

monitor,
of

install

file.

includes

contains

you

monitor,

wvalue

shipped

BUILD.CTL,
TREE.TEC

the

names

whenever

the

change

universal
*

universal

files
in
hard-wired paths.

selected

customer-supported modules to
applies only to sites with

file

configurations.

customer-supported

tape.

the

BUILDING

9.6.1

YOUR MONITOR

Customizing the Build Files

Some of the files
for
building
the
monitor
can
be
used
without
alteration.
However,
the
following
files are only templates.
You
must modify them to build a monitor that reflects
your
installation.
This section lists those files and explains how to customize them.
o

BUILDS.DCL

This file defines the PATH command to
run
SYS:PATH.EXE
(as
used in the supplied .MIC and .CTL files).
This command must
invoke
the
PATH
program
supplied
on
the
7.04
customer-supported
CUSP
tape.
If this version of the PATH
program is installed in SYS:
you do not need to include this
command definition.
o

BUILDS.MIC

This file submits COMPIL.CTL in
in each build area.
Edit it to
0o

each FGEN area, and BUILD.CTL
use only your monitor areas.

BUILDS.PTH

This file
consists
of
three
sections,
separated
Dby
the
following
string:
!<*>1
.,
Each section defines logical
names for one of the following areas:
library
areas,
FGEN
areas, and monitor build areas.
1.

LIBRARY
-

AREAS

BASE:

This

name

required.

Define

point

the

area
used
to
edit any locally modified sources for
building.
The area should be the
superior
SFD
(or
UFD)
of each of the FGEN areas defined in the second
section of the file.
-

CTLS:

This

name

required.

files

wused

the

* TEC,

and

*.FIL).

Define

build procedures

point

(*.MIC,

the

*.CTL,

LOGS:

This

name

area

that

stores

required.
all

the

Define

batch

log

files.

point

the

MON:

You must define this name, and
specify
the
/SEARCH
attribute.
The
/SEARCH
attribute
insures
accessibility of the files required during the
build
procedure.
It
points
to the distribution sources,
and files used in the build procedures.
-

SY¥YS:,

UNV:,

REL:

These may not be
current
version
monitor.

required,
of
MACRO

but
and

you
must
LINK
to

use

the

build the

BUILDING

FGEN
The

AREAS
FGEN

areas

monitors.

dialogue

you

only

one

The

monitor

each

system

SEFD.

the

not

defined

BUILDS.PTH
full

TOPS10.REL

file

for

FGEN

Most

for each
installations

area

and

FGEN

area

are

used

only

one

the

build

need

area.

build

MON.EXE

build

area

corresponding

the

two

areas

the

supplied prototype,

file

can

invokes

the

monitor

commands.

directory

scanning

necessary

define

required

for

the

defined,

therefore

area

runs

MONGEN

they

are

not

point

the

DECLARE
This

commands,

The

those

programs

could be

program
for

but

same

procedure

enabled

Jjob.

for

these areas to be
appropriate
FGEN
areas.

commands

Define

the System Search List definition
automated build procedure requires that

The

KS.

required

scanning

one
MONGEN.

areas:

areas

area,

define

that

there

FGEN

same

ensures

build

AREAS

build

Finally,

may

such

For example,

the

There

installation.
subordinate
to
the

SFDs
given

used

complete
two

MONITOR BUILD

However,

are

linking

YOUR MONITOR

to
also

the

job.

directory

commands

not

the

PATH

must

[1,4].
and

MIC

exist

Edit

SYS.

GEN.CTL

This
to

file

generate

only

the

for

each

FGEN

configurations

and build
in

your

area.

monitor

areas.

SWITCH.INI

This

file

area.
7.04
It

should

the

UFD

corresponding

Define

it to run the version
customer-supported CUSP tape and

should

also

set

wup

PATH

process

appropriate

the

supplied

BASE:
on

the

BUILDS.PTH.

defaults

for

commands.

SUBMIT

TOPS10.FIL

contains

file,

1lists

it
following
<UNIV

list

of files
to
optional fields

format:

SPEC>|<COMPIL

UNIV

SPEC

This

field

file,

and

four

STRING>|<LIBRARY

determines

compile.,

For
each
information in the

SPEC>|<AREA

whether the
file
is
conseqguently, whether its COMPIL
duplicated in UNIV.CMD.

COMPIL

This
the
file

LIST>

wuniversal

STRING

should

STRING

field

contains the command to give to COMPIL to
compiled.
1If the program is available as a
(such as EDDT),
leave this field blank.

file

get
.REL

BUILDING

LIBRARY

This

YOUR

MONITOR

SPEC

field

contains

the

specification

for

the

module

be
included
in
TOPS10.REL.
If this file should not be
part of the monitor library file, leave this field blank.
4.

AREA

LIST

This field contains the list of FGEN and build areas
which the file should be compiled.
o

UNIV.CTL

This

file

defines

your FGEN

9.6.2

The

for

forces

compilation

all

monitor

a path to each FGEN area to do this.
areas.

sources.

Edit

it to use

The Build Procedure

following example shows the complete build procedure.

to the left shows the commands that you type.

of the commands contains explanatory remarks.

.SUBMIT

The

column

The column to the right

START<RET>

.DO COMPILE MONGEN<RET>

command

Include this COMPILE
if

you

have

made

only

changes

MONGEN.MAC.

.SUBMIT UNIV<RET>
.DO COMPILE modulename<RET>

.DO BUILDS<RET>

Include

only

UNIV

SUBMIT

submitted

Include DO COMPILE

changes
will be
will be

command
START.

if you have made

to
a
module.
recompiled
and
generated.

The module
a
1listing

Compiles the monitor modules in the

FGEN

areas,

and builds

TOPS10.GLB.

changed

the

universal

only

the

perform.

9.7

the

you have

step

you
you
.

MON.EXE

and

have

not

files,

this

need

CUSTOMIZING BOOT

You can run the batch control file, BOOT.CTL, as distributed, to build
BOOT
after
you
have
started
GALAXY
(refer
to
Chapter 10).
The
following command submits the control file for batch processing:
.SUBMIT

BOOT.CTL<RET>

Or, before you bring up the monitor, you can
perform
the
individual
steps
manually
and
modify the control file to eliminate the loading
procedures for hardware that does not exist at your installation.

BUILDING

For

that
For

system,

creates
a

system,

microcode

for

allows

the

you

microcode

Section

9.7.1

describes

9.7.1
To

you

binary

can

modify

files

you

can

the
step

modify

various
save

YOUR MONITOR

the

hardware

space

control
to

file

start

control

file

components,

memory,

because

include

step

EDDT.
to

the

include

well.

This

monitor

exclude

procedure

contains

all

available.
describes

the procedure

the

procedure

for KS

for

systems.

Section

9.7.2

systems.

Customizing the KL BOOT

customize

BOOT

for

your

system,

first

enter

the

following

command:

.COMPILE/CCMPILE
The

following
MACRO:

output

BOOQOT.MAC<RET>
will

appear

your

terminal:

BTSPRM

BOOT

[Assembling Boot for a KL10}
[Including DX10/TX01l driver]
[Including TMO02 driver])
[Including DX20/TX02 driver]
[Including TM78 driver]
EXIT

The

files

create
.R

BTSPRM.UNV and BOOT.REL have

been

created.

Next,

run

LINK

BTONCE.EXE:

LINK<RET>

*BTONCE/SAVE=BOOT/LOCALS/SYMSEG
: LOW, REL : EDDT/GO<RET>
EXIT

Now,

you

can

questions,
components.
questions
..R

are

run

BTONCE

and,

providing

include

exclude

Running

BTONCE

creates

microcode
BOOT.EXE

for

and

answers

wvarious

BOOT.EXB.

follows:

BTONCE<RET>

Create binary output file

[Y/N]:

Preserve EDDT and symbols [Y/N]:
Load DX10/TX01 microcode [Y/N]:

Load DX20/TX02
Load
Load
Load

microcode

[Y/N]:

DX20/RP20 microcide [Y/N]:
KLIPA/CI microcode [Y/N]:
KLNI/NI microcode [Y/N]:

Enter Y or N,
press

RETURN

then

the

hardware
The

BTONCE

BUILDING

Lastly,

run

FILDDT

BOOT

the

with

your

BOOT

name
the

BTONCE
symbol

switch,

create

procedure.

table

from

monitor

followed

press

running

BOOT

and

The

by
the

YOUR MONITOR

DDT

that

examine

FILDDT

you

can

problems

prompt

use

that

File:.

you

loock

might

Enter

have

the

file

switch /S,
which directs FILDDT to
file.
After
entering
the
file
name

load
and

the

RETURN:

FILDDT<RET>

File:BTONCE/S<RET>
[Extracting
[1339
File:

symbols

Symbols

Enter the switch /M
/M
directs
FILDDT
note

that

Next,

the

command

enter
with

the

Process

Table).

FILDDT;

the

EPT

for

enter

the

command

Then,

Because

1is

string

the

CPUO

BOOT,

the

assembled values

exit

arbitrary

from FILDDT,

enter

followed by
number

RETURN.

the

sets

the

physical

the

page

<CTRL/Z>.

EPT

Then

provides
(Executive

page

the

selected by

EPT

number

be relocated.

argument

13$U

CPU’s

followed

location

must
the

character.

-1,,-BTSVEC$8U,

that

match

-1, ,-BTSVEC

escape

commmand that

string

wunlikely
the

13U,

occupies

will

and

‘

the

page

values

command,

DSKB:BTONCE,EXE[*,K
*]

file]

represents

physical

file

from

at the File:
prompt and press RETURN.
The switch
to look at the running monitor.
In the following

discussion,

FILDDT

from

loaded

the

$8U

that

RETURN.

assembled

symbol

monitor

the

for

relocation

command.

save

the

created.

BTDDT

file

that

you

can

File:/M<RET>

[Looking at the running monitor]
1SU<RET>
-1, , -BTSVECS$8U<RET>
<CTRL/Z>
.SAVE

These
now

BTDDT<RET>

commands
load.

create

The

multiple-processor
processor

every

you

time

new

version

file

must

system;

following procedure
single-processor
KL
system resides on DSKB.

.LOG

1,2<RET>

.RUN

F11<RET>

[DSKB
+-

BOOT

repeat this
an
SMP
system.
You must
rebuild the front-end file

The

F11>PUT

loaded

and

into

BTDDT

each

procedure
repeat

front-end

the

CTY of each
copying procedure

the

system.

shows how to load BOOT into
system.
It is assumed that

the

front-end

for

the

front-end

file

DSKB: [5,5]=DSKB:BOOT.EXB[10,7,BOOT]<RET>

will

be treated as RPAO]
RPAQ:[5,5]BOOT.EXB; 4076=DSKB:BOOT.EXRBR/IMAGE

F11>EXIT<RET>

can

bring

microcode

your
loading

new monitor with the
by the front-end.

you

control

\\e]

Now

new

BOOT.EXB

file

BUILDING

9.7.2
To

Customizing the

customize

These

BOOT

commands

systems.

Type

for
set

CTIRL/Z

BOOT

your

system,

enter

the

feature

test

switch

twice

.COMPILE/COMPILE

YOUR MONITOR

exit

following
to

build

commands.
BOOT

for

from COMPILE:

TTY:+DSK:BOOT.MAC<RET>

MACRO:FTKL10==0<RET>
FTKS10==-1<RET>

CTRL/Z
CTRL/Z

Next,

run
.R

LINK

and

create

KSONCE.EXE:

LINK<RET>

*KSONCE/SAVE=BOOT/LOCALS/SYMSEG
: LOW, REL : EDDT/GO<RET>
EXIT

Now,

you

can

modify

the

control

binary

output

files

and

Include

these

functions

file
step

answering

include

step

that

creates

start

EDDT

running

KSONCE.

the

following

questions

with

YES:

the

file

.R KSONCE<RET>

Create binary
Preserve EDDT
To

create

KSBOOT.EXE

.RENAME

Refer

the

output file
and symbols
from

[Y/N]:

Enter

[Y/N]:

press

RETURN

BCOT.EXE,

type

the

then

following:

KSBOOT.EXE=BOOT.EXE<RET>

Chapter

for

microprocessor

the

file

appropriate

system.

dialogue

used

copy

CHAPTER

STARTING UP AND

TAILORING

THE

GALAXY

SYSTEM

After the TOPS-10 monitor is running, you can start the
GALAXY
batch
and
spooling
system.
GALAXY is a set of programs that controls the
batch system, the operator interface, the output devices, and requests
for
the
disk and tape units of the operating system.
The components
of

the

GALAXY

are:

Module

Function

AC&&AE

Accounting daemon

BATCON

Batch

CATLOG

Mountable

CDRIVE

Card

GLXLIB

Sharable

LPTSPL

Line

NEBULA

DQS

OPR

Operator

interface

ORION

Operator

interface

PLEASE

10.1

system

controller

device

reader

GALAXY

printer

object-time

system

spooler

Spocler

PULSAR

Tape

QUASAR

GALAXY

QUEUE

User

spooling

SPRINT

Card

reader

THE

daemon

spooler

User-to-operator

STARTING

catalog

and disk
queue

GALAXY

controller

communications

label
manager

program

processor
and

and mount

]

scheduler

request

program

interpreter

SPOOLERS

Whenever the system is reloaded, the
GALAXY
spoolers
must
also
be
started.
You
can
start
the spoolers by typing commands to the OPR
program, the operator interface for
the
GALAXY
Dbatch
and
spooling
system.
After reloading the system, type the following command to run
OPR:
.R

OPR<RET>

OPR>

10-1

STARTING

OPR

responds

with

commands

arguments

spoolers,

type

its

the

any

AND

TAILORING

prompt,

OPR

OPR>.

program,

command,

THE

type

the

GALAXY

SYSTEM

obtain

command

1list

obtain

and

list

wvalid

start

the

START:

OPR>START

BATCH-STREAM

one

NQC-STREAM

the

following:

CARD-PUNCH

FAL-STREAM

NODE

PAPER~-TAPE-PUNCH

PLOTTER

PRINTER

READER

OPR>

this

START.

the

example,

the

new

START

start

command.

OPR>START

was

For

typed to

GALAXY

example,

BATCH-STREAM

you

may

configuration
next

ignore

does

not

use

start

OPR

10.2

program

section

the

with

exist

The

your

message

shows

installation.

that

do
a

Continue

not

certain

with

the

and

DECnet

are

Version

therefore,

for

tailoring

you

have

include

the

been

The

GALGEN

GALGEN
by

with

the

necessary

default
for

you

the

consists

standard

installation.
the

Command

have

made

the

built

necessary

the

system

procedures

GALGEN

batch

new parameters.

changes

parameters,
in

GALAXY

describes

submitting

you

described

not

It
the

GALGEN

support
is

during

program

the

GALGEN

into
to

the

run

GALAXY

you

wish

program.

distributed
GALGEN

Note

GALAXY

include

after

GALAXY

run

started.

started

Operator’s

support.

your

run

You

match

TOPS-10

program,

system

parameters

Running GALGEN

change

the

GALGEN

GALAXY

10.2.1
can

files

installation.

affected

default

DECnet

GALAXY

procedure

your
the

the

necessary

the

SYSTEM

the

running

that

programs;

GALAXY

describes

for

only

change

that

THE

starting

modules

described

OPR

Manual.

requirements

necessary
job,

Reference

TAILORING

This

arguments

command.

Language

arguments

the

indicating that certain objects

them.

You can ensure that the appropriate
using the OPR>SHOW STATUS command.

batch-stream

The spoolers can be started automatically by
above commands in the file SYS:SYSTEM.CMD.

The

possible

each

(O<RET>

If you receive error messages
exist,

show the

system,

shown
below
in
the
for some questions.

installation

set

configuration

your

answers
run

the

LONG

answers
(shown

GALGEN

format.

GALAXY

questions

match

to
in

the

all

that

allows

hardware

the

square

GALGEN

questions

brackets),

program.

The

Additional

explanation

10-2

vyou

configuration

GALGEN

not

dialog

provided

STARTING

You

disk

can save
area.

foll ow

the

.RUN

GALG EN

AND

TAILORING

time and effort by
Copy
GALGEN.EXE

procedure

shown

THE

GALAXY

SYSTEM

building the GALAXY system in your
into
your area before running it,

own
and

here:

GALGEN<RET>

begins

printing

GALGEN Version

the

following:

n(nnnn)

[Starting GALAXY Generation Procedure
for TOPS-10 System]
[Writing

the
text

GALAXY

Configuration

following dialog,

all

question

(list

File

DSKB:GALCNF.MAC[10,7]]

questions
range

are

of the

answers)

form:

[default

answer]

The line starts with the actual text of the question.

Following

the question is a description of the possible answers enclosed in
parentheses.
This description might be a
range
of
numbers,
a
list
of
keywords,
or
a
textual
description.
Following this
description is the default answer, enclosed in
square
brackets.
The

default

will

\gou have the

choice

xplanation
SHORT dialog
the

GALAXY

obtain
to any

assumed

you

of carrying.on a

of
each
in which
generation

the help text
question.

Length

procedure.

typing

(SHORT,LONG)

The

questions

which

RETURN

key.

dialog

1in

which

this
cannot

either

question

with
one).

automatically,
are
familiar
case,

mark

(?)

you

can

an
or a
with

always

response

either
LONG
(for
a
long
Simply pressing the RETURN

[SHORT]

Administrative

parameters,

LONG

the

question
1is
provided
it is assumed that you

Answer the following
question
dialog)
or
SHORT (for a short
key will imply SHORT.
Dialog

only press

Controls

section
be

and

Parameters

determine

overridden

absolute

GALAXY

wuser- or

operator

commands
.

The system logs all operator interactions in a
spooling
area.
Your answer to the following
the name to be used for this file.
Operator

log

filename

(3-6

Characters)

disk file
in
the
question specifies

[OPERAT]

You have the option of maintaining a
backup
master
queue
file
which
may
be used in the unlikely event that the primary master
queue file is destroyed.

10-3

STARTING UP

The

backup

master
the

file

queue

current
Do

queue

you

Any

for

file

want

the
is

master
so

queue

that

redundant

The

TAILORING

accidentally

jobs

permanantly

queues.

AND

mounted

structure

file
will

queue

structure
that

GALAXY

deleted

they

master

THE

useful

not

may

the

records

all

lost.

(YES,NO)

be
in

GALAXY

damaged.
be

file

first

SYSTEM

[NO]

wused

the

for

system

the

master

list

preferred.

The

structure

easily
List.
press

which

the

RETURN

File

for

this

structure

Users

can

use

priority

this
which

may specify the
/PRIORITY switch.

queue

you

default
maximum

specified

request

default

that

for

highest).
The

value
in

the

The

users will
lower
than

not

the

able to
default.

you

specify

Default

for

/PRIORITY

section

control

you

here

two

requests

specify

allows

While

IPCF

PID

[SYSTEM]INFO
PID
you

name

Maximum

facility,

communication

symbolic
length),

you

the

/PRIORITY

specify

greater

and

set

maximum

user.

(1-63)

[20]
specify
maxigum

question.

here

some requests
Therefore, it is

batch

for
and

questions

the

the user does not
between 1 and the

set

spooling

switch

will

than

must

used

1
If

take

the

and
the
you use 1

a
priority
that
recommended that the

spooling

requests

(1-63)

[10]

Parameters

any

currently

defined

[SYSTEM]INFO

parameters.

[SYSTEM]INFO

for

Search
should

[SSL]

and

following

may

used if
must be

[SYSTEM] INFOQO

" This

should

allowable values
lowest priority)

non-privileged

users

without

that

value

batch

for such requests.
The
value
must
be
between
that
you
specified
in the previous question.

The

stored

Characters)

their

question

to be
value

This

(3-6

The

first

specified

queued

priority.

here,

default

switch.
The
(representing

non-privileged

You

that

file

queue

priority

the

may

master

/PRIORITY
between 1

switch.

Maximum priority

for

the
range

(representing

relate

queue

SSL is the acronym for System
private version of GALAXY, you

question.

specify

requests
with
this parameter

master

accessible
by
GALAXY.
Unless you are running a

via

the

allowable

length

which

allows

symbolic

normally

name
have

limits

the

option
at

all.

PID

name

GETTAB
of

manipulate

now

the

maximum

item

%IPMPL

specifying

(29-79

10-4

users

names,

the

Characters)

part

length
(maximum

maximum

[39]

PIDs

QUASAR.
of

packet

length

STARTING

AND

TAILORING

THE

GALAXY

SYSTEM

Applications

The

feollowing

wish

section

run

your

through

OPR,

GALAXY

supports

the

operator
by

applications.

YES.

you

GALGEN

NCP),

answer

answer
is

this

determines

system.

wish

applications
will

you

accesible

program.

the

optional

applications

interface

default

vyou

which

These

CATALOG,

run

CONF1IG,

additional

and

QUOTA

applications

(such

question

with

NO,

the

Applications

portion

completed.

you

wish

run

optional

applications?

(YES,NO)

[YES]

The LAT Control Proto;;i (LCP) commands allow the operator or
system

administrator
to
control
various aspects of
(LAT)
service, and
to
display
status
and

Transport

settings

information.

The LCP command subset is required if
Ethernet LAT terminal access enabled.
Include
The

Local Area
parameter

the

LAT

Network

Control

administrator

Protocol

your monitor

(LCP)

commands?

built

(YES,NO)

Protocol

(NCP)

commands

allow

perform

various

DECnet

network

the

you

running

with

[YES]
system

management

functions.

The

NCP

Include
(YES,NO)

the

subset

DECnet

required

Network

Control

Protocol

include
installation-developed
to the following questions.

wish

you

are

DECnet-10.

(NCP)

commands?

[YES]

You can
answers

(YES,NO)

command

run

any

applications

installation-developed

with

vyour

applications?

[NO]

answer this

questicn

with

YES,

GALGEN

asks

the

following

questions:
v

Specify the name of the application.
the application through OPR.
Application

name

carriage

return

This

exit

name

(1-20

used to
’

access

characters)

Each

application must be associated
with
an
application
table
name.
This
table file contains the command syntax parsing tree
for the application.
Specify only the file name.

Table

name

for

application

(1-6

characters)

The

code to implement
an
application
can
exist
separate program (which communicates with users via
an internal module within ORION itself.

Internal

ORION

application?

(YES,NO)

10-5

[NO]

either
ORION),

a
as

STARTING

you

answer

this

AND

TAILORING

question

with

THE

YES,

specify
the
application-specific

incorporated

The

into

extension

Application

name

ORION.

.MAC

module

name

Application

name

questions
the

batch
The

various

carriage

this

need

only

application.
OPR.

that

Defaults

—e
|

—

are
a

used to

user

can

user

can

specify

maximum

If he
used:

does

Default

runtime

limit

(5-9999

batch

output.

job

has

These

maximum

1limits

appropriate

switches to
these switches,

specify
Line

printer

Card

punch

output

limit

Paper

tape

punch

output

Plotter

The

output

user

printed
the

can

specify

the

the
the

limit

after

SUBMIT

output

limits

can

(0-9999

(0-9999
limit

file

name.

used to

access

default

for

pages)

(0-5000

not

terminates

NOLOG to

action

The

for

his

batch

this

switch the

type

the

batch

limit

for

[200]

feet)

[200]

[30]

batch

log

using the

file

/OUTPUT

specified by:

memory

parameter

and

limit,

the

job

goes

batch

(LOG,NOLOG,ERROR)

the

batch

enforcement

Jjobs.
any

The

program

virtual.

10-6

spooled

user

with
user
doesn’t
be used;

LOG

of
user

should

switch
to

never print the log file,
only if the job
ended
with
an
wuser doesn’t specify this switch, the

system provides

memory

job

[300]

file

SUBMIT/OUTPUT

[1000]

the

wvalues

submitting

. error.
If
the
value will be used.

Default

and

characters)

each

cards)

whether

log

file,

the

when

seconds)

for

minutes)

The

log

assembled

SUBMIT command.
If the
following defaults will

command.

the

define

not specify

set

(0-5000

job

(1-20

runtime

switch.
will be

batch

the

specify

job.

batch

name

exit

using
the
/TIME
following default

Every

provide

Job

section

options

following

containing

will

This

return

————m
|

for

module

the

characters)

Batch

The

asks

assumed.
(1-6

the name of the
application through

the

This

You

Specify

the

code.

SYSTEM

GALGEN

question:
Please

GALAXY

always

and ERROR
wunhandled
following

[LOG]
a

maximum

can

specify

attempts

physical
a

maximum

exceed

this

STARTING

you

answer

section

user

Memory

memory

can

switch.
following

AND

following

GALGEN

Should

The

the

TAILORING

gquestion

with

limits

specify

enforced

maximum

(24-16384

Line

The questions
the

line

Job

banner

GALAXY

NO,

pages)

Printer

in this

printer

(YES,NO)

memory

not

Defaults

and

the

name

any

/NOTE

Number

job

banner

pages

are

pages
name

File

are

and

job

(0-5)

printed

any

header

trailer

pages

request.

header

page.

Number

Name

file

for

the

(0-5)

name

pages

output

each

printed

them.

end

each

information

request.
is

printed

[2]

each

file

printed

(0-5)

change

required

Number

characters

forms

type

that

with

the

type
type

that

There

may

the

current

for

qualify

fonts

you

want

form

the
a

name

user

any

each

when

the
following

determine

form
a

forms

request.
form

submitting

mounted

and

with

[NORMAL]

identify

identifies

the

(2-6)
a

the

[4]

request

printer

SYS:SPFORM.INI.

characters

and

is
the

Your

answer

name

the

match.

devices

LPTSPL
as
the module

which

special

10-7

require

needed.
LPTLOl in

requested.

load

request
specified the

Characters)

uniquely

number

copy
letters

uniquely

currently

site-specific

that

SYS:LPFORM.INI

drivers
loaded
with
laser printer requires
load

(4-6

specifies

BOLD

[2]

specific

type

specifies

which

user

forms

recorded

question

forms

characters

with

for

checkpoint

printed before
file

header

compared

forms

set default values

[2]

spooler

pages

are
The

standard

The number

this

the

value

user can specify a special form for a
/FORMS
switch.
If
this
switch is not
default will be used.

forms

/CORE

user,

beginning

The

the

them.

Number

The

using

Parameters

section are used to

printed

user’s

[512]

user’s

trailer

Defaults

spooler.

pages

The

Job

[YES]

limit

The

Job

Batch

specified

request.
of

the

SYSTEM

completed.

If
this
switch
1is
default will be used.

limit

THE

printer

special

device

For example, the LNO1
order for
LPTSPL
to

drivers?

(YES,NO)

([NO]

STARTING

you

answer

this

question

Each device
LPTSPL main

module.

driver

build

when

areas

Name

Any

AND

device

TAILORING

with

GALGEN

driver

The

questions

module

drivers

The
tape

(1-6
load

not

use

section

Mountable

gquestion

code

disk

this

the

following

avoidance
do

for

exist.

CPU

loaded with
found on

the
the

characters)

for

that

job

deadlock

set

jobs

may

the
from

already

avoidance

insure

the

that

default

(MDA).

enable

prevents

another

the

time

used

Allocator

you

code

[NO]

MDA

are

Device

This

Enabling

asks:

(YES,NO)

allows

MDA.

resources

slightly

SYSTEM

loaded.

Parameters

parameters

GALAXY

must have its own module to be
This module’s
.REL file must

LPTSPL

special

YES,

THE

code

deadlock
waiting

own,

causes

deadlocks

for
that

MDA

will

not

the

occur.

Enable
You

deadlock

have

the

avoidance?

option

(YES,NO)

[YES]

specifying

which

label

type

the

end

default.
NOTE:

Label

type

USER-EOT

tape

condition

will

<cause

the

automatically
program

will

Default

will

allow

wuser

expands
NOT

tape

see

UNLABELED

1label

Dblock

the

end

user

tape

volume

program

only.

All

end

set.

see

other

label

tape

while

this

case

types

MDA

the

user

tape.

type

(ANST,BYPASS,
IBM, USER-EOT, UNLABELED)

[USER-EOT]

You

have

tapes

the

are

option

read

and

specifying

the

default

density

Default

9-track

tape

density

(200,556,800,1600,6250)

Default

7-track

tape

density

(200,556,800)

You

have

mount

Default

The

the

option

track

type

you

which

the

[1600]

[800]

default

track

type

which

administrator

can

allow

non-privileged

users

bypass

processing.

mounting

specifying

[9]

want

this

for

/LABEL-TYPE:BYPASS
NO

(7,9)

Allow bypassing
When

tapes.

system

label

tape

written.

labeled

switch

function

question.

regardless

non-privileged

the

to
to

If
label

you

users?

(YES,NO)

tape,

user

specify

that

the

restricted

want

type,

all

users

answer

YES

10-8

can

tape

include

label

privileged

to
to

be
this

[NO]

able

users,

the

ignored.
answer

mount

question.

any

STARTING

AND

TAILORING

Miscellaneous

The

questions

this

THE

Defaults

section

refer

GALAXY

and

SYSTEM

Parameters

general

GALAXY

parameters.

The following section establishes default bias and disk
spooler

you

unit

want

conversion

the

page

factors.

standard

limit

computation

(YES,NO)

[YES]

This question refers to disk page conversion to spooler units.
(Note
that
one
disk page equals four disk blocks.) If you do not want this
conversion, answer NO to the
question.
If
you
answer
NO,
GALGEN
prints

the

following

and

prompts

vyou

for

value

for

each

output

device.

The default output limit of a spooled file is calculated as:
limit

disk

blocks

units

per

disk block

copies

The output limit is expressed in pages for the printer, cards for
the
card
punch, minutes for the plotter, and feet for the paper
tape punch.
The following
questions
establish
the
number
of
units of output per disk page.
Number of printed pages per disk block [.7]
Number of punched cards per disk block [8]
Minutes of plotter output per disk block [0.07]
Feet of paper tape per disk block [7]
The default action to be taken when output exceeds
limit
for
an
output spooler may be to ABORT the
all remaining output, ASK the operator what to do,
finish processing the Jjob.

Default

output-limit-exceeded

action

the
specified
job and ignore
or PROCEED
to

(ABORT,ASK,PROCEED)

[ASK]

If file access between network nodes is to be done,
each
FAL
file
access
listener
stream needs a network type associated
with it.
The network types supported are ANF-10 and DECnet.
Default

network-type

for

FAL

streams

(ANF-10,DECnet)

[ANF-10]

Galaxy-10

spoolers (object processors) are now grouped into three
are
started
(logged-in
and
run) by QUASAR at
depending on which category they fall into.
The
categories and their corresponding characteristics are:

‘categories
and
different times
three
SONCE

$STCMD

"fired up" by QUASAR after QUASAR starts ORION,
PULSAR,
and CATLOG.
The spooler will never logout on its own.
"fired
for
will

up"

QUASAR when

OPR

START

a
stream
controlled
by the
logout when all streams under

command

issued

spooler.
The spoocler
its control are
shut

down.

$DEMND

"fired up" by QUASAR when a job is in a queue
that
can
be
serviced by one of the spooler’s job 'streams.
These
"demand"
idleness.
for

spoolers

will

You will

"n"

10-9

logout

after

prompted below

"n"
to

minutes

define

value

STARTING

The

PRCDAT

macro

AND

TAILORING

QSRMAC.MAC

THE

GALAXY

defines

the

SYSTEM

directory

path,

any

for

PROJCT.EXE

the

[10,10]

with

PPN

not

log

overrides

[10,2370]

can

log

strings

The

However,
be

when

matched

can

characters,

sixth

and

the

only

the

of
is

character.

account

followed

seventh

any

strings with anfl number

it.

can

may

account

characters.

three

the

FILE

definition

number

must:

first

number

PROJCT.ACT,

run

ABC??FG*

the

PPN

account

replace

character,

for

user

any

wildcard

string

with

explicit

because

contain

containing

CREATING

containing ABC

followed

user

characters)

account

characters,

11.9.2

also

the

AUTHORIZATION

because

definition denotes

replace

Therefore,
two

can

SYSTEM

scheme,

JKL,

account string GHI,
for a single PPN.

Account

used

this

string

THE

any

characters,

characters.

FILE

and

ensure

PROJCT.EXE

program

that

shown

exists

vyour

below:

PROJCT<RET>

END

JOB

EXIT

error

displays
Edit
When

the

occurs

message
PROJCT.ACT

successful,

into

SYS:

When

account

additional
PASSWORD:

for

during

processing

indicating
file

PROJCT

the

correct

creates

the

field
the

the

PROJCT.ACT

problem

problem,

PROJCT.SYS

validation

has

been

prompt

the

dialogue

TOPS-10

Operating

prompt.

in
See

the

enabled,

information.

11-10

the

and

file,

the

run

file.

PROJCT
Copy

wuser

System

file.
again.

this

will

(ACCOUNT:),

PROJCT

input

see

after

Commands

file

the

Manual

MAINTAINING

11.10

MAINTAINING

REACT

uses

the

All

records

vary

for

the

eleven

Table

the

first

11-1:

All
the

file

validation
fields.

FAILUR.LOG

File

FILE

RECORDS

FAILUR.LOG

eleven

SYSTEM AUTHORIZATION

FAILURE

FAILUR.LOG
in

length.
fields

THE

maintain

records

file

written

7-bit

ASCII,

explains

the

are

failure
The

entries

following

have

table

the

failures.

same

file:

and

format

first

Format

Field
Number Position

Data

Type

001

Octal

003

Decimal

Contents

Error

code,

Date

and time,

USAGE

entries

017

Decimal

Job

number

020

Octal

PPN

(left

half)

026

Octal

PPN

(right

032

ASCII

character

044

ASCIT

050

ASCII

TTY

056

ASCII

Node

format

same

ACTSYM

QUEUE./IPCF

half)

character

name

defined

above

name

program

(for
of

job

name

above

job
job

above

job

name

example,

name

sender

above

TTY45)

(ANF-10,

DECnet,

LAT)

072

ASCII

Line

075

Octal

Asynchronous
(APC)

Port

node
Characteristic

code

The format for fields that end the Invalid account string
Invalid

password

077

(6)

error

entries

Octal

083

Octal

PPN

(left

was

invalid

PPN

(right

string
job

not

privileged

entry

because

The

the

job

number

shown

(3)

already

only

was

half)

and

whose

account

whose

string

account

invalid

contains

specified.

11-11

(1)

below.

the

first

fields

MATNTAINING

11.11

The

TOP-LEVEL

following

changing,
updating

Table

table

and
the

11-2:

REACT

describes

Top-level

REACT

FILE

the

basic

action

file

and

Commands

also

for

describes

displaying

user

creating,

commands

for

information.

Commands

Function

user-id

Enables
user

DELETE

AUTHORIZATION

accounts.

accounting

Command

CHANGE

SYSTEM

COMMANDS

deleting

master

THE

you

enter

wuser-mode

and

modify

profiles.

user-id/switch
Removes

the

ACTDAE.SYS.

specified
account
from
can specify a wildcard in

You

the
user-id.
Switches
/NOASK .
If you specify
you

confirm

each

are:
/ASK,

deletion

/ASK
and
REACT prompts

you

make.

you
specify
/NOASK,
REACT does not prompt
you to confirm each deletion.
/ASK
1is
the
default.
EXIT

Exits

the REACT program
monitor command level.

HELP

Displays information
To
display
a brief
commands,

get

type

REACT

HELP

and

about
REACT
list of REACT
and

press

information

command,

returns

type

about

HELP

you

commands.
top-level

RETURN.

and

particular
the

c¢command

name.

INSERT

user-id

[=user-id]
Enables
user

you

enter

accounts.

existing

You

user-id to

wuser-mode

and

can

use

supply

guide

create
optional

for

the

new profile.

LIST user-id filespec/switch
Writes information from the
profile
to
a
file.
You

specified user’s
can
specify
a

wildcard in the user-id.
The
default
file
specification
is DSK:ACCT.LST[-].
Switches
are:
/DETAIL,
which
lists
all
the
information
in a user’s profile, and /FAST,
which

lists

username.
LOCK

Opens
prevent

Deletes

ACTDAE.SYS
in
other
wusers

the
file
accounting
PURGE

only the

/DETAIL

while
file.

you

PPN

its

associated

default.

READ-ONLY
mode,
making changes

from

update

expired profiles.

11-12

and

the

to
to

master

MAINTAINING

SELECT

THE

SYSTEM AUTHORIZATION

Allows

you

certain
use

the

that

you

can

you

For

example,

all

you

the

extend

have

the

and

desired

Displays

wuser-id.

only

Reopens

access

the

/FAST,

and

its

specified

wildcard

which

displays

associated

username.

default.

ACTDAE.SYS

want

/DETAIL,
information
in a

the

and

PPN

31,

date

the

can

all

date

accounts

you

specify
Switches
are:

profile,

/DETAIL

date

from

You

displays
the

the

a
of

doing

on December

expiration

information

profile.

user’s

than

date.

user’s

the
which

attributes

SELECT

the

for
as

expiration

CHANGE

You
the

accounts

rather

the

have

identifiers

the

expire

following:

that

common.
specify

various

group,

accounts that
the

mark

change

want

you

profiles as a
individually.

change,

[filespec]

command

After

group.

that

VERIFY

SELECT

attributes

UNLCCK

accounts
attributes in

the

user-id/switch

mark

profile

group,

SHOW

FILE

that

other

wusers

it.

may

user-id/switch
Checks

for

accounting

differences

file

between

(MASTER.SYS)

file

and

master

the

system

(ACTDAE.SYS).
You
can
specify
a
particular
wuser account or verify all PPNs.
This
command
allows
you
to
differences between your master
system

accounting

update

the

user-id

can

name.

the

other

than

A-Z,

a-z,

enclose

you

11.12

USER-MODE

commands

commands,

and

are

consist

COMMANDS

Commands.
COMMANDS

subcommands

the

perform

These

You

either

change

can

define
the

optionally,

file.

[P, PN]

includes

hyphen

(-)

double

the

CHANGE,

types

changes

are

The

user

characters

digits,

quotes.

customer-defined

user

account

customer-defined
to

change

account

fields

field

Table

that
11-3.

you

want

11-13

with

Table

and

SELECT

Field

Change

you

FIELDS

special

that

change.

11-2.

that

the

fields

field

program

account

INSERT,

commands:

specified

REACT

COMMANDS

listed

installation.

listed

username

the

following

commands

customer-defined
tailor

and,

accounting

COMMANDS

User-mode

must

file,

master

list
the
file and the

specify

want

REACTU.MAC
needs

specify

These

the

change.
of

to
your

the

user

commands

are

MATNTAINING

The

following

prompt

THE

SYSTEM

indicates

that

AUTHORIZATION

you

have

FILE

entered

user

mode:

USER>

The

following

Table

11-3:

table

lists

REACT

Commands

REACT Field Change

Commands

change

fields.

Command

Function

ALL

Allows youkto specify all of the options for
a

AND

given

Allows you
with

ACCESS-TYPES

field

the

user,

BATCH,

of access
access is

behalf

access
to
combination
ACCESS-TYPES

CONTEXT-QUOTAS

DATA-SET,

one

the

limits

The

contexts

time.

one
A

Each

(current)
quota

swapping

ENQ-DEQ-QUOTA

the

user

the

Manual

the

Specifies a decimal
virtual
1limit
maximum

least

maximum

511.

limit.

occupy

=zero

The

pages

with

of
idle

indicates

Operating

job

System

information.

physical

maximum number

pages

virtual

1is

pages

16,384.

Specifies

text

page (s)

spooled

where

distribute

the

Writes

changes

the

Specifies
is

any

value for
the. physical
of the number of pages.

number

The

has

description

TOPS-10
for

have

job

number

user may

contexts

may

in
The

quota

outstanding

EXPIRATION-DATE

indicates

DONE

wuse

Refer

Commands

8,192.

the

quota

the

and

DISTRIBUTION~LOCATION

LOCAL,

context

indicates

space

limit.

gain

correct
password.
ANF-CTY,

governing

logged

zero

quota

contexts.

The

PHYSICAL-CARD-READER,

context.

saved page

CORE-LIMITS

wuser,

FILES-ONLY,

contexts.

number

SUBJOB-OF-BATCH.

Specifies

job

criteria

allowed to the
any attempt by

the
system
using
of
user-id
and
include
following:

NETWORK-FILE-ACCESS,

REMOTE,

selection

command.

the types
user.
An

command.

specify

SELECT

Specifies
specified
a

change

displayed
the

user’s
to

output.

the

banner

The

operator

text

should

output.
the

decimal value
ENQ
locks.

ACTDAE.SYS

for

the

The

maximum

file.

number
of
number

511.

Specifies

this

the date and time when
LOGINs
account are no longer allowed.

11-14

MAINTAINING

IPCF-QUOTAS

THE

Specifies

RECEIVE,

and

PID

each

quota

Displays

help

user-mode

command.

Specifies

the

for
HELP

SYSTEM AUTHORIZATION

allowed
24

user

7:00

AM,

6:00

it
NO

time

the

user

7:59

Allows

you

NOT

Allows

PASSWORD

PERSONAL-NAME

the

are

you

the

actually

the

following:

numeric

specify

between

profile.
%,

long,

and

character.

options

disallow all of
change command.

specify
command.

you
to
the SELECT

specify
command.

field

the

options

Specifies

name

offical

accounting

personal

name,

banner

criteria

selection

criteria

other
name

than
(see

available,

page(s)

output.

This

profile,

and

such

selection

Specifies a password the user must
type
gain access to the system.
The password
consist of any printable characters, and
be up to 39 characters long.

may

the

to
can
can

wuser’s
The

NAME).

printed

user’s

unprivilged

spooled

entry

modified by

a
the

’

Specifies the

user’s

number].

[P,PN]

The

Specifies
to
the
are:

printable

characters

SELECT

identifying

PROGRAM-TO~RUN

divided

Saturday

user.

PRIVILEGES

1is
into

Therefore,

with

Allows

the

PPN

wuser

divided

Weekends

can

Allows you to
a given field

with

day

commands

NONE

the

AM.

except
begin

SEND,
value

specified

wusername
for
this
can
consist of any

can be

cannot

with

segments.

and

the

maximum

the

Weekdays

permitted to

change

for

two-hour segments.

character

for
The

511.

text

Specifies the
The
username

value

quotas.

one-hour

into

NAME

decimal

FILE

[project,
is

the

the privileged
functions
allowed
user.
The
privileged
functions

CPU,

DISK-PRIORITY,

LOCK,

METER,

MON-SPY,

RTTRP,

SPY,

TRPSET,

UNSPOOL

Specifies
the
file
program to run after
file
specification
program

directory,
sub-file

means

user.

IPCF,

name,

programmer

primary

including

directories

11-15

ENQ-DEQ,

HPQ,

OPERATOR,

POKE,

specification
of
the
LOGIN is complete.
The
may
include
a
device
name,

(SFED).

extension,

five

levels

and

MAINTAINING

PROHIBIT

THE

SYSTEM AUTHORIZATION

Enables
users

useful

share
QUIT

the

Terminates

administrator

changing

their

situations

single

without
REQUIREMENTS

system

from

FILE

prevent

passwords.

where

several

This
people

PPN.

the

current

executing

that

user-mode

command

command.

Specifies additional
information
the
user
supply when logging in.
Options are:

must

ACCOUNT-STRING
with the user

INTERVAL

information

maximum

time

associated

between

password

changes

RESTORE

LENGTH

minimum

NAME

PASSWORD

under

PROHIBIT

password

REMARK

under

Deletes

any

profile

and

characters

timesharing

<changes

returns

all

password

batch

timesharing

batch

changes

stored

the

for

the

you

usage

have

current

made

user-mode

attributes

files
to

session,

their

original

values.

SCHEDULER-TYPE

Associates
group

the

that

class.

about

specified user

has

been

Displays
the
current
specified user profile.

SPOOLED-DEVICES

Specifies

the

physical

available

the user.

CDR,

PTP,

with

scheduler

LPT,

PLT

and

fields

devices

The

disk

space

disk

space

puts

allocated,

allocated
these

list,

following two

I/O

not

the

normally

options

are

which the
and the
the

structures

and

for

CDP,

ALL.

Specifies the structure on
has

(See
Appendix
C
for
information
assigning scheduler classes.)

SHOW

STRUCTURE-QUOTAS

profile

assigned

sets

status

structure.
in

the

either

bits:

user

amount

user’s

the

READ-ONLY

NO-CREATE.
WATCH-BITS

Specifies
that
MTA,

READ,

any

the

sets:
RUN,

the

TOPS-10

11-16

watch
DAY,

VERSION,

information,

Manual.

following
CONTEXTS,

see

WAIT,

the

Operating

SET

WRITE.

WATCH

System

bits
FILES,
For

command

Commands

CHAPTER

12
]

CREATING

There

are

system,
the

several

terminal

The

can

exist,

stored

that

initiate

user.

they

files

SYSTEM

files

the

created

INITIA program

them to

the

monitor.

The

them

and passes

files

INITIA

system startup
TEXT

SY3:NOTICE.TXT

the

NOTICE

ALL:STR.TXT[1, 4]

the

STRUCTURES

SYS:TTY.INI

DSK:SWITCH. INI [p,pn]

you

log

HELP

also

run

INITIA

and
that

12.1

INITIA AT

Special

Processing

SYSTEM

INITIA

runs

SYS:SYSJOB.INI,

system

administrator.

described

is,

the

FILDAE,

wup

and

SYSJOB.INI

can

If
information

the

read

are:

option

specified
is

specified

option

requests

specified

connection

requested

terminals

set

terminal

terminal.
are
listed

The
in

Commands.

system

can
by

SYSJOB.INI

not

that

the

system
file

that

the

normally

started

from

startup
in

the

running
as

necessary

detached

state

I/0).

Some

terminal

from

option,

commands

run

require

startup,
created

INITIA

NOINITIA

contains

normally

may

startup

prevent

wusing

programs

that

startup.
system

SYSJOB.INI

are

ACTDAE,

QUASAR.
allows

from

Most
the

system

you

start

system

the

programs

that

OPR.ATO

file,

that

the

INITIA

also

runs

INITIA

can

components

can

file

can

file,

read

automatically
reads

the

the terminal.
TTY.INI
interrogate
the
connecting
and attributes.

and

can

great

quickly

started

and

automatically

easily

and

SYSJOB.INI can contain
its intended purpose 1is
care

should

taken

the

successfully.

whenever

file

started

INITIA
through
SYSJOB.INI.
and commands to programs, but

initialization

ensure

system.

programs

efficiently
by
monitor commands
a

the

their

optional

You

system

automatically.
OPSER,

startup

programs

system

STARTUP

automatically

in Appendix

start

(that

start

information

adminstrator.

display
information
about
the
direct INITIA to read these files

reads

automatically

from

option

terminal

HLP:INITIA.HLP

can

help

system

the

12-1,

about

reads

the

SYS:INITIA.TXT

Table

use

and provide

When

characteristics
command options

can

SYS:S5YSJOB. INI

Users

monitor

communication,

Filename

INITIALIZATION FILES

terminal

SYS:TTY.INI

also

terminal

12-1

contain
to

connects

establish

commands

determine

its

information

to
INITIA
to
characteristics

CREATING

SYSTEM

INITIALIZATION

FILES

NOTE

INITIA

cannot

Therefore,

must have
codes are
System

12.1.1

access

the

files

system

that

protection
code
in detail

from

and

it.

TTY.INI

<155>.
Protection
TOPS-10 Operating

the

Manual.

The SYSJOB.INI File

If it exists, SYS:SYSJOB.INI is read
by
TOPS-10 provides several system programs

protected

SYSJOB.INI

described

Commands

are

files

INITIA from SYSJOB.INI.

System

INITIA
that are

programs

at
system
startup.
suitable for startup

commonly

started

from

SYSJOB.INI
are the system DAEMON programs DAEMON, FILDAE, ACTDAE; the
GALAXY component QUASAR; user utilities such as MIC; the mail delivery
program
MX;
and
site-specific
system programs.
Any system program
that normally runs in a detached state is a candidate for startup from
SYSJOB.INI.

INITIA
monitor

reads SYSJOB.INI
for
special

mechanism.
a

FRCLIN

privileged

and

sends

processing

program

internal
to

pass

the commands contained
through
the
FRCLIN
mechanism

commands

the

in it to
the
(force-line)

monitor

that

allows

though

the

commands had been issued from a terminal.
INITIA uses FRCLIN to start
system
programs because terminal input is handled by the monitor with
a minimum of delay.
After INITIA is finished, FRCLIN is free for
use
by

other

System

system

components

programs

mechanism

that

and

program must

may

detach

compare

startup
command
the FRCLIN

the

line

must

started

themselves

with

where

that

number
Word

number

162
is

send
from

commands

SYSJOB.INI

automatically.
the

terminal

(%CNFLN)

run

programs.

detect

To
1line

GETTAB

the

detect
that

Table

FRCLIN

FRCLIN,
sent

the

(.GTCNF),

stored.

The FRCLIN mechanism ignores output from the programs that are started
with
FRCLIN, and for that reason it may be difficult
to determine why
SYSJOB.INI fails to complete.
To detect the reason for
an
error
in
SYSJOB.INI,
set the DF.WFL bit in the monitor debugging word (DEBUGF),
and

then

restart

INITIA.

be printed

Output

the

from

the

programs

that

are

started

will

CTY.

12.1.1.1
the

monitor
the

Format

commands

of SYSJOB.INI

that

commands

<can

can be

most

commonly

used:

SET

DEFAULT

ACCOUNT

SYSJOB.INI

sent

placed

through

SYSJOB.INI,

string

Sets

the

logged

in.

but

Jjob

of
Any

following

are

string

FRCLIN

through

can

FRCLIN

program
next

list

monitor.

account

the
the

the

jobs

accommodate
started

default

which

Logs

formatted as

FRCLIN

by
be

that

the

line

file.
This

command

does

not

actually

UUO.
The monitor performs
for the program.
The jobs

run

the

program

special logging-in actions to
are
logged
in
under
the

default.

12-2

use

the

prepare a
PPN [1,2]

job
by

CREATING

may

possible

omitting
job

log

accomplished

the

that

is
for

and

that

any

PPN

RUN

not

responsible

SYSTEM

programs

omitting

command.

logged

logging

INITIALIZATION

with

The

program

wusing
in,

Each

program
is

name

assumed

other

than

command,

will

PPN

and

then

[2,5].

desired,

[1,2].
by

This

specifically

run

The

using

the

Specifies

the

name

program

run.

from

program

UUO

valid.

program

PPN

in,

itself

the

FILES

placed

run

line

from

following

SYS.

Therefore,

the

system

command.

The

command

BATCON

actually
R

the

command

BATCON

The actual
line.
The

interpreted

monitor

following
SET

DEFAULT

command R

example

ACCOUNT

RUN may

included

SYS:SYSJOB.INI

MUMBLE

the

command

string

"MUMBLE"

file:

;set

the

LOG

;log

account

ACTDAE

;run

the

;run

SYS:DAEMON

;run

SYS:FILDAE

QUASAR

;run

SYS:QUASAR

NIK/DETACH

;run

LOG

;mode

SYSJOB
accounting

daemon

LOG
DAEMON

LOG
FILDAE

LOG

SET
R

HPQ

;set

MIC

To insure
logically

;start

local
high

program
priority

in
run

SYSJOB.INI

commands
the

into

following

strings
list

delimited

shows

queue

for

MIC

that input
from
other
FRCLIN
wusers
does
not
related groups of commands in SYSJOB.INI, INITIA

example,

detached

commands

contained

interrupt
groups the

commands.
in

For

SYSJOB.INI

file:
LOGIN
ACTDAE

HPQ

DAEMON

INITIA

groups

first

string

the

following

the

above

into

commands

FRCLIN’s

into

input

two

strings.

buffer.

The

INITIA

first

copies

string

the

contains

commands:

LOGINKCR>ACTDAE<CR>

Then

second

copies

string

the

contains

HPQ

second

the

string

following

1<CR>DAEMON<CR>

12-3

into

FRCLIN’s

commands:

input

buffer.

The

CREATING

SYSTEM

INITIALIZATION

FILES

NOTE

INITIA considers any program name given in
SYSJOB.INI
that
starts
with
"LOG" to be a LOGIN command.
This
does not affect the content of the input, but
it
may

cause conflicts, which the
prevent.
To differentiate
other
program
names that
use

the
R

following

above technique attempts to
between LOGIN commands
and
begin with the letters LOG,

format:

LOG...

If errors occur during processing, the rest of the input file may
not
be
executed.
Therefore,
the order of the commands in SYSJOB.INI is
vital to successful system startup.
It is important to place
monitor
components
first
1in
the file, followed by CUSPS and other programs.
You should place ACTDAE first in the file, to ensure
that
accounting
is enabled when the rest of the programs are started.
You may include
commands to the programs you are starting.
If you
include
commands,
you
must
explicitly
detach
the
program
after the commands if the
program does not detach itself as a result of the commands.

12.1.2

The

TTY.INI

File

Before a user can log in, the terminal must be logically connected
to
the
system.
When
a
terminal requests connection, INITIA reads the
file SYS:TTY.INI to set up terminal and job characteristics.
TTY.INI
can contain commands to INITIA to:

Interrogate
the
connecting
terminal
characteristics and attributes.

Set

terminal

command.

Set
the

options that
terminal.

characteristics
specify

explicit

information

determine

its

associated

with

NOTE

If you specified the
ONCE
startup
option
NOINITIA,
users
must
issue
either the INITIA CHECK command or
SETTY command to activate the options in TTY.INI.
-

12.1.2.1
Format of TTY.INI - Each command
line
of
TTY.INI,
except
continued
lines,
must
Dbegin
with
one
of the terminal identifiers
listed in Section 12.1.2.2.
By
wusing
the
terminal
identifiers
in
combination
with
the
options
listed
in
Section
12.1.2.3 you can
specify any number of terminals in a command line, and you may use any
number
of
options
for
each
terminal.
If conflicting options are
specified for a single terminal, the last option in the
command
line
for

that

terminal

takes

effect.

To continue a command line, put a hyphen (-) as the last character
of
the
line
that
1is to be continued.
To insert a comment, precede the
comment by a semicolon (;) or an exclamation
point
(1) .
File
1line
numbers

are

ignored.

Multiple

tabs

space.

12-4

and

spaces

are

treated

one

CREATING

The

following

SYSTEM

example

ALL:

INITIALIZATION

SYS:TTY.INI

CHECK

NORUN

FILES

file:

KSYS

XONXOFF

TEXT

NOGAG

LC-

REMOTE
APC:CTERM

NOCHECK

STOMP

ACCOUNT

CONNECT

COMET

KL1026

TTY405

KL1026 TTY406
KL1026 TTY407
cTY:

TYPE:LA120

"MUMBLE"

TTYO

NC REMOTE NO

TABS

TABS
TABS

REMOTE

NO TABS

GALOPR

ACCOUNT-

"MUMBLE"
KL1026

TTY5

KL1026
KL1026
KL1026
KL1026

TTY6
TTY405
TTY406
TTY407

12.1.2.2
a
the

RCV:9600
TYPE:LA120

command

line,

XMT:300
CTY

;CPU2

TYPE:LA120

;CPUl

CTY

TYPE:LA120

;CPUO0

CTY

Specifying

terminal

XMT:9600

RCV:300

set

Terminal
of

Lines

terminals.

followed by

section,

the

(when

The

This

Terminal

ALL:

All

APC:x

Asynchronous
terminals

that

Port

the

commands
is

identify

placed

listed

first
the

lines.
Characteristic.

APC

by
characteristics.
of

are

CTY)

Indicated

determined
one

REMOTE

THE

following

Lines

terminal

not

identifier

options

Identifier

REMOTE

type

certain
This

where

All
’x’

is
attributes
and
identifier
can be

following:

unknown

hardwired

dataset
Gandalf
TSN

autodial
Micom
NRT

(Network

LAT

(Local

CTERM
CTY:

The

CTY

DETECT

Dataset

LINSPD

Lines

node identifier

OTHER

Remote

Area

(Command

Terminal)

(contreolling
lines

that

at
identifier

terminal)

that

are

set

are

Terminal

Terminal)

set

the

node
following

the

identifiers

Any

terminals

not

All

lines

12-5

not

set

specified

baud.

"node."
can

The

any

list.

identifier.
OTHSPD

baud.
called
node_

this

only.

baud.

with

TTY:

CREATING

TTYNnnn:

SYSTEM

INITIALIZATION FILES

Terminal

line nnn.

abbreviated

TTYNNN-z2z2:

All

terminal

lines

identifier

This

identifier can

TTnnn:.

from nnn to

can

lines

listed.

zzz.

This

abbreviated

TTnnn-zzz:.

(TTYaaa:,

TTYbbb:,...,TTYzzz:)
All terminal

Terminal line numbers range from 0-777
octal.
Hard-wired
terminals
are
assigned
permanent
terminal
line
numbers in the form TTYnnn:,
where ’‘nnn’ i1s the physical line number.
For example, if the terminal
number
TTY10:
is
assigned
to
a terminal that is hardwired to the
system, that number will not change.
If
the
host
system
is
named
MING, this terminal may also be referred
to as MING 10.

Terminals connected through nodes have permanent line numbers
in
the
form
nnn 111, where 'nnn’ is the node name or number and ‘111’ is the
number of the line that connects the terminal to the node.
When
one
of these remotely-connected terminals is recognized by the system, the
monitor assigns a "terminal name" to it, in the
form
TTY¥nnn:,
where

“nnn’
is
a
temporary
number assigned during the connection.
These
terminal names
are
reassigned
on
a
dynamic
basis,
as
terminals
logically connect and disconnect from the system.

For
example,
terminal
1line
15
on
node
number
44,
a
terminal
concentrator with node name XENON, would be called 44 15, or XENON 15,
and this designation will not change.
However, when terminal 44 15 is

connected to the host system,

it may be assigned terminal name TTY130:

by the monitor.
The terminal will be known to the monitor as
TTY130:
as
long
as it remains connected to the host system.
If the terminal
becomes disconnected and then reconnected,
it
might
be
assigned
a
different terminal name, such as TTY52:.

12.1.2.3
Specifying
Terminal
Options - Terminal
identifiers
are
followed by options that specify information to be associated with the
terminal
(s) identified at the beginning of the command line.
There

are

three

types

options:

Commands

that

Terminal

characteristics

specify

special

processing by

set

for the

INITIA.

terminal

when

connected.

Programs

run

automatically when the terminal

connected.

The options are separated by commas or spaces.
For those options that
require
an
argument,
the argument can immediately follow the option
name, or it can be separated from the option name
by
a
colon
or
a
space.
Option
names can be abbreviated, as long as the abbreviation
is unique.

In conflicting situations, the option specified last
in
the
command
line takes precedence over those specified earlier.
You can turn many
options off by typing NO before the option word, with
or
without
an
intervening

GAG,

complement
default

space.

NOGAG,

setting

and

the
of

-GAG

minus

sign

have

the

command

the

options

same

has

the

same

effect.

shown,

(*).

table

complement

designated by

12-6

effect

the

NO.

Thus,

below,

valid.

the

The

CREATING

The
following
table
processing to be done

Table

12-1:

SYSTEM

1lists
for the

INITIALIZATION FILES

TTY.INI
terminal

options
to
indicate
at initialization:

special

Special Processing Commands

Option

Meaning

ATTRIBUTE

Display terminal

attributes.

CHECK

Interrogate terminal to determine

CHECK:DEFAULT

and
type,
and
set
the
attributes
and
characteristics
associated with the class, model,
and type found.
When CHECK:default is
specified,

INITIA
matches
MONGEN.

its

class,

model

interrogates only if current terminal type
the
system
default
type
specified
in
Complement:
NOCHECK.
NOCHECK
1is the

default.
CONNECT

Connect

HELP

Read the
about

node

file

the

Display
NOKSYS.

KSYS

LOCATE

networked terminal

HLP:INITIA.HLP

INITIA

the

and print

set.

Print the system name.
is the default.

NORUN

Suppress the running of programs that
run automatically for the terminal.

NOTICE

SETTTY

Complement:

SYS:NOTICE.TXT,

4if

NONOTICE.

such

NONOTICE

NONAME.

see the TOPS-10

are

file

is the

Set terminal from TTY.INI (on CTY) or
If
the job is logged in, NOSETTTY is
For
more
information
about
SETTTY

options,

Complement:

connection with the specified node,
monitor LOCATE command.

NAME

Complement:

information

command.

KSYS time if it has been
NOKSYS is the default.

Make a logical
similar to the

host.

Operating

NAME

set

exists.

default.

SWITCH.INI.
the default.
and
SETTTY

System Commands

Manual.

STOMP

STRUCTURES

Initiate
the
"terminal
stomper"”
function
that
disconnects terminal lines that have been detached
and idle for two or more minutes.
Print

individual

ALL:STR.TXT([1,4].
NOSTRUCTURES

the

structure

notes

Complement :
default.

TEXT

Print
SYS:INITIA.TXT,
if
such
a
Complement:
NOTEXT.
NOTEXT is the

TTY

Display all
Complement:

terminal
NOTTY.

settings
NOTTY is

TTY: TTYnnn

Display

terminal

settingss for

all

12-7

from

NOSTRUCTURES.

for
the

file
exists.
default.

this
terminal.
default.
TTYnnn.

CREATING

The

following

terminal.
for

the

job.

programs

Jjob

Unless

terminal

the

terminal

node

INITIA
from

Table

automatically when INITIA
runs
for
in for the program and INITIA creates a
specified otherwise,
INITIA
constructs
PPNs

the

12-2:

Option

AUTOMATIC

local

terminal,

INITIA

uses

job

current

Options

setting

list

for

the

system

the

job,

which

list.

Start

OPSER

the

When

and

The

terminal

from

terminal

Otherwise,

device

the

processing

file

name

which

that

OPSER

connected

was

automatic

read

OPR:,

TTYnnn.ATO

terminal

the

OPR.ATO

directly

the

'nnn’

connected

device
OPR:,
"nnn’
is the node

node

used.

used,

number.

terminal

Otherwise,

line

the

nnnlll.ATO

used,

under

[1,2].

remote

111’

and

where

OPRnnn.ATO
number.

number

depends

started.

system:

When

begin

file.

the

local

used,

where

the

node:

where

‘nnn’

terminal

DAEMON

Start
run

remote

FILEX

Start

DAEMON

from

Start

file
the

the

’'nnn’

number

[1,2].

Start

OMOUNT

from

the

This

program

begins

the

terminal

cannot

processing

the

node

local.
is

number

and

111’

where

OPR

[1,2].

This

terminal.

12-8

SYS:nnnlll.CMD

terminal

under

remote

which

remote,

cannot

terminal.

OPR program,

program

[10,1].

under

remote

terminal

line

run

under

This

terminal.

SYS:SYSTEM.CMD,

where

OMOUNT

Start

run

GALOPR

CHKPNT

from

line

number.

CRASH

copies

Program

‘

[1,2].

Run Programs

startup

CHKPNT

the

PPN

is remote,
INITIA constructs a PPN using
the
[100+node-number,2].
For
example,
a terminal at
that has node number 12 receives the PPN [112,2].

creates

the

FILES

start

algorithm

INITIALIZATION

logged

follows:
o

SYSTEM

program

used,
is

the

started.
cannot

CREATING

OPSER

Start

STOMP

SYSTEM

Initiate

SYSDPY

the

idle

Start

12.1.2.4

Associated
file,

?INTCER

Correct

the

?INT...

for

the

INITIA

TTY.INI

error

The

INITIA

any

command.

use

SYSDPY

display

type.

and

command

may

run

include

there

are

Display terminal
terminal type.

Display

the

INITIA

serious

errors

enables

users

from

for

the

system

job.

Any

problem

that

initialize

terminal,

INITIA

use

command

their

the

other
must

and

the

terminals

INITIA monitor

your

choice

file.

following:

attribute

system banner

Display

general

system

Display

operator

notes

Change

terminal

the

TOPS-10

Operating

command

the

Command

settings,

and

any.

INITIA

for

specialist.

the

SWITCH.INI

INITIA

restart

INITIA

the

program

which

detached

ERROR

about

than

Messages

function,

that have been
two minutes.

terminal

indicates

software

your

See

file

INITIA Monitor

You

can

monitor

COMMAND

message

time.

options

(Error)

longer

stomper"

lines

INITIA prints:

investigated by

12.1.3

"terminal

terminal

appropriate

TTY.INI

FILES

OPSER.

disconnects
and

INITIALIZATION

time

mode

settings,

system

and

shutdown

check

(KSYS),

notices.

about

mounted

structures.

characteristics.
System

and

the

Commands

Manual

SWITCH.INI

12-9

file.

for

information

PART

SUPPLEMENTARY

INFORMATION

This part is made up
of
four
appendixes
and
a
glossary.
Appendixes
A
though
D
describe
alternatives to
the
installation
procedure
and
information for modifying the monitor software.

APPENDIX

ONCE

runs

initial
reload

and

running,
You

may

system

ONCE STARTUP OPTIONS

automatically

dialog

gquestions

system

allow

specify

the

date

ONCE

may

also

refresh

disks

startup,

and

you

and

run

change

may

startup.

you

run

time.

system

While

user

disk

ONCE

provide
mode

the

user

performs
©

the

Checks

state
o0

memory

Checks

and

following

the

for

HOME

it
©
©

should be

units

that

units

blocks

ONCE

disk

units

Checks

the

BAT

blocks,

all

the

Lists

the

Lists

each

their

file

structure

logical

order.

and

up
and
monitor.
runs

at
the

units

unit

confirms

from
for

blocks.

the

are

the

you.
inconsistencies

any

name,

units

asking

are

whether

offline.

listing

of bad

any

regions

and the

inconsistencies

any

unit

units

the

file

you

for

each

specify.

file

structure

Lists

Lists the units in the Active Swapping List.
For new
installations, there is no swapping list, and ONCE prints
message to indicate that.

all

the

disk

units

that

are

not

structure.

Lists

the

structures

the

System

Lists

the

structures

the

System Dump

Allows

you

change

parameters

any

structure.

Allows

you

change

parameters

any

unit.

Allows

you

change

any

disk

Allows

you

dissolve

Structures

exist.

Allows

you

the

system

reloading

or write-protected.

that

number

offline

the

unit.

the

ONCE

without

response

HOME

reports

write-enabled

Reports

are

rewrites

write-protected,

the

functions:

memory

optionally

system

when

mode

system.
ONCE

for

running

parameters

startup,

reason

define

system

file

List,

any

SSL.

SDL.

parameters.

structures,

structures.

List,

file

ONCE

Allows you to

STARTUP

OPTIONS

specify the units

on which you want HOME blocks

rewritten.

Lists the structures that need to be refreshed, and allows
you to specify the structures that you want refreshed.

Allows you to

[1,2],

after ONCE has

refreshed

structures.

Starts running the null

job and begins timesharing.

Worksheet 3,

The Disk Parameters Worksheet,

so many disk parameters with ONCE,

Chapter

is provided in

to record the disk parameters for your systgm.

Because you can define

you may find it

wuseful

record

parameters for your system on the worksheet and to use this
disk
the
or
as an aid when you refresh structures, create new file structures,
disk parameters.

redefine

A.1

SYSTEM STARTUP

ONCE AT

ONCE begins when you reload the system, as described in
Section
9.4.
First,
the
system name and the date that the monitor was created are

displayed.
of MONGEN

The system name is set by Question 5 of the SYSGEN portion

(see Chapter

[Loading

9).

from DSKM:RL336A.EXE([1l,4]]

RL336A DEC-10

Development

16-Feb-88

is
Each monitor
ONCE scans memory to be sure that it is accessible.
MONGEN Question 58 allows you
for a specific amount of memory.
built
to specify the amount of memory when you
are
building
the
monitor.
Therefore,
new
installations
may
receive
the
following
message,
indicating that the default monitor was built to

than that which is

expect

currently online:

memory

$Memory from xxxxxx to yyyyyy is offline
[OFFLIN]:
Set memory (DOWN,OFFLIN,ONLINE)

The default response
appears
in
square
Dbrackets.
If
the
memory
indicated
is not needed at this time, but will be needed later, press
RETURN to accept the default answer.
Memory that is set
offline
can
be
set
online
during system operation, with the SET MEMORY command.
If all memory must be online, enter ONLINE and press RETURN.
If
the

memory
RETURN.

is
not
going
to
be
required
at all, enter DOWN and press
Memory that is down cannot be brought up with the SET
MEMORY

command.

If you are starting an SMP

CPUs,

ONCE prints the

system and have not yet started

following message:

%CPU #nnnn is not running.

If you have an SMP system,
UP
and pressing
RETURN.
RETURN.

After receiving

reloading the

system:

Why reload:

Set CPU status

(DOWN,UP)

the

other

[DOWN]:

you can start the CPU indicated by entering
To
accept
the default value, just press

an
N

answer,

ONCE

asks

for

reason

for

ONCE

This

question

resronses

are

asked

STARTUP

whenever

allowed,

NEW
SCHED

the

depending

you are installing the Monitor,

OPTIONS

system

the

reloaded.

reason

for

the

Several

reload.

When

use one of the following answers:

you

are

installing

you

are

new

system
different

version

the

crash,

use

one

monitor
When

the

you

are

reloading

following

When

the

system

after

answers:

problem

HALT

the

system

ended

with

stopcode

HARDWARE

the

system

ended

with

hardware

malfunction

HUNG

the

system would not

LOOP

if the monitor was loopiné in executive mode

NXM

OPR

PARITY

memory

parity

POWER

power

failure

STATIC

static

you

are

session,

non-existent

operator

bringing

for

the

system

stop

occurred

error

occurred

electricity

scheduled

respond

memory

error

HALT

caused

the

after

standalone

time,

crash
scheduled

use

one

maintenance

the

following

answers:

for

preventative

for

corrective

for

scheduled

none

the

responses

OTHER
You

can

comment

include

stored

After

maintenance
stand-alone

you

see

followed by the

the

comments

with

the

receiving

reason

here

for

log
the

time

apply,

reason

further

semicolon

system error
a

maintenance

use

for the

describe

space.

file

the

following:

reload
your

Your

reasons
by

answer

preceding

this

question

EKROR.SYS.

reload,

ONCE

asks

for

the

date:

through

31),

Date:

Enter

the

date

the

form:

DD-MMM-YY
or

MMM-DD-YY

Where

name

the

three

the

letters

two

digit

numerical

month
of

the

year

day

(JANUARY
month

the

through
(JAN

designation.

month

through

The

(01

DECEMBER)
DEC),

year

MMM

and

replaced

optional.

the

abbreviated

the

first
by

ONCE

you

respond

question

Please

you

with an

again

type

specify

STARTUP

incorrectly

OPTIONS

formatted

date,

ONCE

asks

the

before

the

detail:

today’s

date

before

creation

date

the

monitor,

supplies

the

last

crash

MMM-DD (-YY)

the

last

the

ONCE

creation

system

dialog

date,

c¢rash

issues

and

asks

you

error
to

message,

verify

vyour

response:

$Specified

date

Last

date:MMM-DD-YY

crash

prior

last

crash.

monitor

%Specified date is prior
date:MMM-DD-YY

creation

date.

Creation
and

Specified date:MMM-DD-YY
Is this correct?
(Y or N)
To

which

you

typed

can
an

respond

reprinted

that

you

ONCE

for

the

time

asks

incorrect

can

the

date

date.

enter

after

the

you

typed was

enter

correct

receives

correct,

the

prompt

optional,

Date:

date.

the

date:

Time:
Enter
are

the

time

based

colons

separating

24-hour

clock.

the

hours,

incorrect,

The

minutes

seconds
and

are

seconds.

HH:MM:SS
or

HHMMSS

the

format

the

time

ONCE

prints

the

following

message:

Please

you

issues
verify

type

HHMMSS

specify

system

dialog

last

you

a time before the last
error message, supplies the
your response:

Last
Is

As
The

you

crash

this

enter

correct

option;

the

command.

correct?

N, the
time.

change

Time:

system time

operation
them.

that

last

crash.

reprinted

prompt

it is important
and time can be

However,

recommended

crash,
the
ONCE
crash time, and asks

time:HH:MM:SS

with the date,
system
date

system

HH:MM:SS

%¥Specified time is prior
Specified time:HH:MM:SS

the

may

that

that you
enter
changed with the

changed

with

the

changing

either

the

system

adversely

affect

operation.

the

you

can be

reload

system

you

can

enter

the
correct
time.
CHANGE DATE startup

SET

DAYTIME

date

time

Therefore,
find

monitor
during

necessary

is
to

ONCE

The

ONCE

program

Startup
ONCE

now

provides

several

available

options:

startup

option:<RET>

Options

are:

type

HELP

startup

options.

you

will

DEFINE

REFRES

SHOW

and

press

and

option.

option:HELP<RET>

Options

are:

you

press

provided

with

DESTRO' DISSOL

RETURN

switches

Startup

you

and

will

brief

CHANGE

Change

system parameters

DEFINE

Define

structures

DESTRO

Dissolve

all

DISSOL

Dissolve

Start

timesharing

NOINIT

Start

timesharing

REFRES

Refresh

selected

SHOW

Display

system

without

system

NOINIT

with

list

each:

initialization

parameters

are:
Don’t

use

Don’'t

start

NOPRIM

Start

timesharing

NOSDL

Don’'t

use

preserved

system

dump

NOSSL

Don't

use

preserved

system

NOVALI

Don’t

require

STANDA

Start

timesharing

Startup

option:

RUNNING

ONCE

the

reserved

active

swapping

list

CRSCPY

secondary

account

protocol
list

list

validation

with

SCHED10

set

IN USER MODE

user

disk

list

structures

changes

without

simple

and system lists
structures in the system
single structure

NOCOPY

ONCE

provided

change

RETURN
a

explanation

NOASL

Running
to

CHANGE

options

Switches

A.2

startup

option,

Startup

you

for

OPTIONS

option:

entering

the

prompts

STARTUP

mode,

parameters

disk

file

running

the

without

system,

you

monitor,

reloading
must

allows the
the

logged

operator

system.

make

[1,2].

.R monitor-name<RET>
Use

The

scratch

first

file.

question

The

opportunity
damage.

and

you

[1,2]

wuse

must

and you
?

file

Must

allows
of

how

are

not

the

answer
be

you

the

learn

you

(NO,YES)

[1,2]

NO,

[default]:

store

scratch

use

logged

default

you

ONCE
in

the

file
as

without

any

[1,2],

answer.

will

disk data base
in
provides the novice

the

you

returned

chance
default

are

not

monitor

.BIN

user

file

answer

logged

level:

the

system
is

YES

ONCE

STARTUP

OPTIONS

NO.
is
default
the
[1,2]
If you are logged in as
Then,
this question by pressing RETURN.
to
respond
for

units

you
Normally,
you are prompted

read:

Read units:

Specify the name of each disk

wunit

you

wish

and

change

press

Your entry specifies the units from which ONCE will read the
RETURN.
have
you
When
You may specify a single unit, or ALL.
home blocks.
specified all
Write

the units to

read,

press RETURN.

units:

changed
for
Specify the disk units on which to write new HOME blocks
The ONCE program ensures that you will not inadvertently
information.
disk
the
change
to
allowing you
not
disrupt system operation by
parameters for disks that you did not specify as 'Write units’.
Startup

option:

will

If you type HELP and press RETURN you will be provided with a list
the startup options and switches and a brief explanation of each:

If you press RETURN without entering a startup

option,

you

REFRES

SHOW

provided with a simple list of available options:
Startup

option:<RET>

Options are:

CHANGE

DEFINE

DISSOL

Startup

option:HELP<RET>

Options
CHANGE

are:
- Change

EXIT
REFRES
SHOW

- Return to monitor level
- Refresh selected structures
- Display system parameters

DEFINE
DISSOL

EXIT

system parameters

- Define structures and system lists
- Dissolve a single structure

Switches

are:

Startup

option:

NOERRO -- Re-write HOM blocks despite errors

A.3

STARTUP OPTIONS AND SWITCHES

and
parameters,
list
ONCE allows you to change many disk and search
refreshing and restructuring for maintenance purposes.
disk
performs
are
switches
and
keywords,
Certain startup options, startup option
when ONCE runs at system startup (executive mode); others
only
valid
In following sections,
are valid only when running ONCE in user mode.
its use is
of
an example
and
described
is
option
startup
each
provided.

ONCE

When

you

option
you

select

option

select

are

startup

after

the

are

already

option,

familiar

you

may

the

with

type

keywords

option,

option:DEFINE<RET>

you

OPTIONS

option

(ASL, SDL,5SL, STRUCT) :

the

applicable

parentheses.
keywords

for

that

For

example,

wvalid

for

this

parentheses:

keywords

startup

available

for

option

and

the

keyword

you

will

specific

keyword

the

asked

they

are

line:

you

option:DEFINE ASL<RET>

names

press

specify

units...

RETURN

startup

without

option

selecting

Startup

option:DEFINE<RET>
(ASL, SDL, SSL, STRUCT) :<RET>

Startup

option:

startup
U

options
are

denotes

and

listed

user

keywords,
and

Mode

Effect

CHANGE

E,U

Use

this

option

choose

the

system

startup,

the

modes

below.

CHANGE

password

change

which

denotes

the

executive

before

parameters.

option

when

command

you

can

log

describes

the

CHANGE

Mode

Valid Keywords
ASL

disk

startup

HEEHEEEDEEA

and

mode,

ONCE

requires

you

runs

PPN

job.

DATE

NN
N~
~

acacdaag

NETWORk

SDL
SETS

SSL
STRUCTure
UNIT

Section
Use

A.3.1

this

option

lists.
when

If
ONCE

command

define

<choose

runs

requires

you

Valid keywords
ASL

4
r

DEFINE

and

startup

startup,

the

password before

option.
system

option
LOGIN

you

can

job.

Mode

startup

structures

the

system

PPN

log

jegeNeRe

E,U

and

explained

mode.

Option

DEFINE

again:

Define

available,
and

the

Startup

Enter

The

option,

after

DEFINE

listed

Startup

startup

Define

startup
same

the

are

listed

STARTUP

SDL

SSL
STRUCTure.

Section

A.3.2

describes

the

DEFINE

startup

option.

ONCE

DESTROY

STARTUP

OPTIONS

Use this option with extreme caution.
The DESTROY
option
18
wused
to
refresh
all
structures and
rewrite
DESTROY
message

all

HOME
blocks.
startup option, ONCE

the

CTY:

automatically

log-in

Then you can log in
simply typing LOGIN

DISSOLVE

Section
option.

A.3.3

Use

option to

this

file

If
you
choose
the
prints the following

under

[1,2]

type

"LOGIN"

a job under the PPN
[1,2]
ta the monitor prompt.

describes

the

-dissolve

DESTROY

startup

single

specified

structure.

Section

A.3.4

describes

option

the

DISSOLVE

startup

option.
EXIT

Use

this

Section
REFRESH

A.3.5

return

describes

the

monitor
EXIT

level.

startup

option.

Use this option to refresh a single specified file
structure.
If
you
choose
the
REFRESH startup
option, ONCE prints the following message
on
the
CTY:

automatically

log-in

under

[1,2]

type

"LOGIN"

Then

you can log in a job under the PPN
[1,2]
simply typing LOGIN to the monitor prompt.

SHOW

Section
option.

A.3.6

describes

Use

option

this

ASL

agccaocac

NETWORk

system parameters.

Y
R

SDL
SETS
SSL
STRUCTure
UNIT

Use this
checking

describes

the

option to start
or dialog.

Section A.3.8
NOINITIA

startup

Valid keywords

Section A.3.7
GO

display

REFRESH

DATE

HEEEEEEE

Mode

' the

describes

SHOW

the

option.

monitor

lines

are

not

only

when

Section A.3.9

initialized,
running

describes

the

this

any

option.

Use this
option
to
start
the
initializing
terminal
lines.
used

without

monitor
Because

option

system

without
terminal

should

stand-alone.

NOINITIA

option.

ONCE

STARTUP

The

startup

the

type

output

are

listed

and

explained below:

option

can

be
to

OPTIONS

followed by
the

CTY.

The

number

switches

available

to
in

control
each

mode

Switch

Mode

Effect

/NOASL

Use this switch to force the
monitor
to
rebuild
the Active Swapping List from disk after a reload.
If you do not specify
this
switch,
the
monitor
first
tries
to
wuse .the
preserved
copy in the
Active Swapping List.
If the monitor
cannot
wuse
the

preserved

data,

then

rebuilds

the

data

from

disk.

/NOCOPY

Use

this

switch

automatically
When

the

current

/NOPRIMARY

file

/NOSSL

the

Use

this

switch

HOME

blocks.

Use

this

switch
This

timesharing

you

specify

If the
then it

Use

this

the
If

use

the

you

the

from

this

first

tries

List.

monitor
after

switch,

the

copy

rewrite

secondary

KL10s

only.

to
a

rebuild

reload.

monitor

the

force

the

monitor

List

from

disk

wuse

data,

into

first

System

Dump

cannot
use
the
preserved
the data from disk.

specify

System

for

disk

preserved

monitor

valid

force

List

not

preserved

monitor
rebuilds

switch

System

(SYS:CRASH.EXE)

start

Dump

up.

copies

area.

System

starting

started

CRSCPY

the

this

List.
data,

occurs,

force

the

tries

from
is

Use

not

file

XPN

switch

CRSCPY
monitor

stopcode

crash

the

protocol.

/NOSDL

prevent

continuable

backup

/NOERRO

to
when

this

switch,

the

preserved

then

after

rebuild
a

reload.

the

monitor

copy

the

monitor

cannot

rebuilds

the

off

account

the

use

data

the
from

disk.
/NOVALIDATE

Use

this

switch to

/STANDALONE

Use

this

switch

stand-alone

A.3.1
This

CHANGing
section

system

lists

describes

description

the

bring

validation.

the

mohitor

system.

System Parameters

describes
and

turn

the

structures

CHANGE

startup

before

you

DEFINE

startup

option

the

parameters

that

option.

You

CHANGE

them.

can

and

must

provides

DEFINE

Section
a

the

A.3.2

complete

defined before

they

are

changed.

the

following

first,

followed

underlined.

examples,
by

the

the
item

CHANGE
to

startup

change.

The

option
text

that

1is
you

selected
type

ONCE

CHANGE

the

Enter

the

extra

RETURN

names

Enter

when

Startup

per

Active

Swapping

the
the

units
list

names

units

OPTIONS

(E,U):

the

Active

Swapping

List.

Enter

complete.

ASL<RET>
to

Terminate

List

option:CHANGE

line.

STARTUP

appear

list

with

the

active

blank

line.

swapping

list,

one

RXxn<RET>
<RET>

Startup
To

CHANGE

option:

the

Startup

date

(E):

option:CHANGE

DATE<RET>

Date:dd-mmm-yy<RET>

Time:hh:mm:ss<RET>
Startup
To

The

CHANGE

network

option:

information

guestions

Startup

the

(E):

initially

MONGEN

option:CHANGE

provided by

node

name

node

name

[name]:name<RET>

ANF-10

node

number

Decnet

node

name

DECnet

area

number

63)

DECnet

node

number

1023)

Startup
CHANGE
the

extra

RETURN

Enter

per

when

77)

[nn]:nn<RET>

name] :name<RET>
[nn]:nn<RET>
[nnnn]:nnnn<RET>

[name]:name<RET>

the

names

DSKx<RET>

option:

(E,U):
in

the

System

Dump

List.

system

Enter

complete.

SDL<RET>

structures

Terminate

<RET>

List

structures

list

option:CHANGE

line.

Startup

the

[name] :name<RET>

[node

System Dump

names

Startup

option:

the

Enter

name

answers

NETWORK<RET>

System wide

service

your

dialog.

ANF-10

LAT

information

list

appear

with

blank

the

line.

dump

list,

one

ONCE

CHANGE

Disk-set
option,
option.

disk-set

numbers

STARTUP

OPTIONS

(E,U):

numbers are assigned
within
the
DEFINE
STRUCTure
and
may
also be changed within the CHANGE STRUCTure

Startup

option:CHANGE

startup
startup

SETS<RET>

Enter the desired disk-set numbers (1 - 36) or "ALL" for
disk-sets, one per line.
Terminate with a blank line.

all

ALL<RET>
<RET>

Startup

Option:

To CHANGE the System Search List
Startup
Enter
one

option:CHANGE

names

per

line.

(E,U):

SSL<RET>

structures

appear

Terminate

list

with

in
a

the

system

blank

list,

line.

DSKx<RET>
<RET>

option:

Startup
To

CHANGE

STRUCTure

The

CHANGE

change

parameters

STRUCTure

existing

only

its

startup

file

(E,U):

option

structure.

parameters,

used

You

ALL

can

change

the

specify

all

the

one

parameters
structure

structures.

In the questions that follow, any question preceded with
an
asterisk
indicates
changing
that
parameter
will require the structure to be
refreshed.
A range of acceptable values, if applicable,
1is
enclosed
in

parentheses.

brackets.

the

The

default

ranges

structure

type

wvalue,

acceptable

previously

any,

values

defined.

1is

enclosed

are

calculated

The

default

values

are those values
which
were
previously
defined.
All
default values used in the following example are used for
only.

Startup

default

option:CHANGE

Structure

value,

just

unit

parameters

for this

want

BAT

PPN

Blocks

structure

cluster

When

you

another

startup

have

for

option,

[NO]:

131071)

(NO,YES)

[NONE]:

36,ALL,NONE)
CRASH.EXE

for

([5]:

[NO}:
[ALL]:
(0

overdraw

4096)

per

user

[2048]:

output
[12]:

307800)

[500]:

262143)

[30]:

change:

finished

stucture

(NO,YES)

DSKx

(NONE, [p,pn])

allowed

RETURN.

structure

blocks

Consecutive blocks tried for on
*Bits per cluster count
(0 - 18)
Structure

ranges
and
illustration

[DSKx]:

structure

Disk-set
*Number

the

name

per

Private
Owner

see

for

Structure
*Blocks

provided

STRUCT<RET>

Change

Parameters

square

change:DSKx<RET>

you

press

according

+to

press

changing

one

all

CHANGE.

you

wish

RETURN.

structures,
to

you

prompted

may
for

enter
another

ONCE

CHANGE

The

CHANGE

UNIT

unit

values,

option

and

press

enclosed

square

option:CHANGE

question

*SAT

SAT

RETURN.
in

wunit

parameters

acceptable

range

parentheses.

brackets.

with

require

the

for

unit

default

blocks

for

asterisk

structure

core

swapping

Make

this

Unit

change:

you

have

value,

indicates
be

changing

that

refreshed.

(1
-

the

finished
you

wish

only

[5]:

21625)

[20000]:

for swapping (1400 - 705504)
[352752]:
1)
[0]:
unit in the ASL (NO,YES)
[NOJ:

changing
to

81)

unit,

prompted

you

for

may

enter

another

startup

RETURN.

A.3.2
This

DEFINing
section

examples,

item to
To

Structures

describes

the

DEFINE

define.

DEFINE

the Active

The

Active

Swapping

store

data

the

text

DEFINE

startup

option

that

List

the

option.

selected

you type

Swapping List

that

first,

the

swapping

CHANGE

units

UNIT

should

space

startup

the

following
the

system

use

underlined.

(E,U):

list

swapped

allocated
option.

1listed

accessibility.
The

swapping

list

divided

first,

then

Class

All

except

units

that

have

slow

controllers

of
to

units

that

disk.

The

the

units

the

units

For

the

most

efficient

fastest

the

order

the

will

the

Active

Make

this

change

the

1ist,

select

swapping,

the

slowest

into

classes,

swapping

units

Class

I/0O.

sure

where
Class
should be placed
to include
all

used
0,

several

in the swap list.
Use the DEFINE STRUCTure startup option
a unit to a swapping class.
To change the swapping class of
use the CHANGE UNIT startup option.

assign

unit,

press

followed by

Swapping List should have swapping space allocated on them:
allocation
with
the
DEFINE STRUCTure startup option.
To
of

unit

option,

and System Lists

startup

The

amount

value,

default

RXxn

ID [XXXXn]:
blocks per unit

*First logical block
Swapping .class
(0 -

the

change:RXxn<RET>

Unit

change

UNIT<RET>

preceeded

will

Parameters

CHANGE .

used

change

parameter

When

structure.

RETURN.

Startup

Unit

OPTIONS

(E,U):

applicable,

enclosed

press

Any

startup

file

any,

just

paramters

existing

Enter
if

Unit

STARTUP

ONCE

Enter

the

extra

RETURN

names

Startup
Enter
per

when

the

units

list

names

units

Terminate

option:DEFINE

line.

STARTUP

the

OPTIONS

Active

Swapping

List.

Enter

complete.

ASL<RET>
to

appear

list

with

List

(E,U):

the

active

a blank

swapping

list,

one

line.

RXxn<RET>
<RET>

Startup
To

DEFINE

Enter
extra
The

option:

the

System Dump

the names of the structures in the
RETURN when the list is complete.

System Dump

attempt

List

write

should be allocated
crash
file.
Make
option.

select

the

change

CHANGE

Startup

the

list

crash

file

whenever

System Dump

structures
the

on every structure in the
this allocation with the
the

amount

STRUCTure

option:DEFINE

space

startup

List.

where

the

system

Enter

system
halted.

System Dump List
DEFINE STRUCTure

allocated

for

the

will
Space

for the
startup

c¢rash

file,

option.

SDL<RET>

Enter names of structures
per line.
Terminate list

appear in
with a blank

the

system
line.

dump

list,

one

DSKx<RET>
<RET>

Startup

option:

To DEFINE the

System Search List

Enter the name of each structure
search list should be accessed.

(E,U):
in the SSL, in the order in which the
Type an extra RETURN when the list is

complete.

The

System

List

order
that
they will
specified or implied.
System

list

file

structures,

be searched whenever the
The system CUSPs must be

listed

the

ersatz device SYS:
1is
accessible through the

Search List.

Startup

option:DEFINE

Enter names of
one per line.

SSL<RET>

structures to appear in the
Terminate list with a blank

system
line.

list,

DSKP<RET>
<RET>

Startup
To

DEFINE

Enter

the

option:
structure

name

logical
Startup

names

(E,U):

structure

units

option:DEFINE

within

define

and press

that

structure.

RETURN.

Then,

enter

STRUCT<RET>

In
the
following
dialogue,
all
numbers
are
decimal
unless
otherwise
indicated.
Values within square brackets are defaults
which will be substituted if RETURN is pressed.

ONCE

Any

question

parameter

preceeded

will

STARTUP

with

require

the

blocks

the

structure

Structure

Disk
Disk
ONCE

checks

pack

the

are
formatted

You

have

had

blocks

for

the

ONCE

the
to

and

that

you

each

pack.
the

cannot

read
the

BAT

want

block

second

listing

information

the

after

BAT

blocks

all

units

blocks

point

them

written

when

errors.
can

the

wunit,

right,

the

all

bad

written

from
system

can be

the

would

are

updates

consistency

that

the

BAT

system

for

unit.

Two

first

regions

useful

read

the

finds

BAT

must

be
If

will

second

the

The

them.

they

pointed

only

to.

They

updated with

BAT

block

copy

the

first

BAT
inconsistent,

be
the

BAT

block

error.
If both BAT blocks
are
then
would be useless.
Therefore, if the first BAT block
but the second is consistent, and if the list of
bad
disk is lengthy, you should consider having the disk

initializes

see

the

HOME

bad

regions

(NO,YES)

[NOJ:

blocks.

Each disk pack
contains
two
HOME
information about the disk unit,
such as
file structure it is in, swapping space that has been allocated on
unit,
and the other unit-specific information that ONCE allows you

blocks
the

disk

the

reformatted.
Do

the

because

inconsistent,

that

0:RXxn<RET>
1:<RET>

in both blocks

information

regions

immediately

found

option

This

changing

refreshed.

***%x

are

consistency

this

BAT

unit

checked
properly,
so
If

indicates
be

entered.

unit

disk

checked,

define:DSKx<RET>

first

reported.

blocks.

been

formatted,

inconsistencies
is not
first.

have

Note

initialized

logical
logical

the

blocks

for
for

errors

when

blocks

drive
drive

hardware

will

asterisk

structure

* Kk

HOME

OPTIONS

that

contain

pertinent

change.

[HOME

blocks

initialized

If you ask to see
unit according to
%

Unit

RXxn

First

You

the

regions, the bad
format shown below:

No.

the

option

the

BAT

blocks

the

will

deleted

system

errors

When

the

and

the

rewritten

BAT

and
to

disk.

blocks

are

disk

into

BAT

blocks

All

BAT

will

bad

Error

BAT

blocks.

the

will

disk.

have

been

has

old

areas

blocks.

(NO,YES)

Unit

blocks

channel

rewritten,
about

Initialize

the
both

information
new

the

read/write

the

Cont

completely.

attempts

CPU

initializing

initialized

inconsistencies,
hard

regions

1listed

bad blocks:

block

have

only

RXxn]

bad

the

rewrites
disk

[NO]:

BAT

about

filled

The

BAT

disk

the

blocks

erroneously

blocks
the

errors

reported

been

Initialization

data

should

have

reporting

will

have

lost,
to

ONCE

If you

answer YES,

STARTUP

you will be

OPTIONS

informed

that

+the

action

has

been

completed:

initialized on RXxn]

[BAT blocks

Enter a value to specify the cluster size
the default value by pressing RETURN.

for the

structure,

or accept

The cluster size
1is
critical
to
efficient
wuse
of
the
disk.
A
one-block
data
file
requires
3 blocks on disk, including RIB, data
block, and spare RIB.
If a cluster size of 10 were assigned, 7 blocks
would
Dbe wasted for this one-block file.
The cluster size should not
be set to less than 3, but the actual size depends upon
the
type
of
applications using the disk.
The monitor requires a retrieval pointer
for each cluster in the file it is accessing.
Therefore, the
cluster

size

large

should

not

The cdefault value

unit.
disk,

too

small for the size of the average file.

file with a small cluster size wastes monitor overhead.

The

listed by ONCE is

best

wvalue

but the default
Parameters

for

*Blocks per

determined by

the

type

disk

depends on the type of application using the

often appropriate.

structure

cluster

DSKx

262143)

[10]:

Your next entry sets the privacy status of
a
structure.
A
private
structure requires that users who wish to access it must use the MOUNT
command to access that structure.
A system structure is not
private,
and
may
be
accessed
by
any
wuser
without explicitly mounting the
structure

for the
Private

job.
structure

(NO,YES)

[NO]:

A file structure need not have an owner PPN.
PPN
1is set, the user with that PPN has full

However,
if
the
owner
file access of the entire
structure.
Enter a PPN if you want to set or change the owner PPN
of
the
structure.
If
you
press
return,
the
default
wvalue will be
accepted and the current PPN will be cleared without replacing it.
The

full

PPN may be

access

wildcarded.

all

files

Note that

on the

a PPN of

[*,*]

allows

all

wusers

structure.

Owner PPN [NONE]:
Disk-set (1-36,ALIL,NONE)

[ALL]:

If this structure will be included in the System Dump List,
you
must
allocate
space
for
the
crash
file.
Enter a value to specify the
amount of space to allow on the structure for a crash file.
The crash
file,
CRASH.EXE,
1is
the
copy
of
memory
that
is written to disk
automatically when the system crashes.
This value should be at
least
the
size
of
the
maximum amount of memory used by your system.
For
RP20 and CI disks, however, this value should be 0.
*Number

of K for

CRASH.EXE

4096)

[4096]

Enter the number of blocks each user is allowed on the
structure
for
overdraw
purposes.
The maximum allowable value is a variable that is
dependant upon the type of disk unit.

ONCE

When

the

quota

file,

a
the

is
does

system

attempts

the

structure

allow

that

Determine
for

when

When

new

files

open

are

the

number

searching

system

specify

this

number.

and

free

the

space.
of

the

first

free

space,

give

can

affect

recommended

can

accessing

the

that

you

result

number

The

system

they

will
implied.
search

the

bits

The

system
Enter

this

dump

should

crash

file.

disk,

disk

tried

per

cluster

count

system

will

tries

You

found,

allocate

allowed

are

reflect

the

consecutive

file

will

Therefore,
on

cluster

size.

and

output
or

the

wvalue
disk.

262143)

press

RETURN

you
It

number

time

change

number

excessive

file

the

stored

the

storage

the

check

files.

the

18)

[500]:

are

count,

307800)

changed

the

write

the

write

whole

number
monitor

blocks

files

for

the

this

quota,

free.

find

here,

are

disk

that
to

disk-space

is
too

spent

[307]:
to

[12]:

list

searched

multiple

blocks

cluster

system

disk

cannot

fragmented

is a list of file structures, in the order
that
whenever the ersatz device SYS:
is specified or
CUSPs
must
be
accessible
through
the
system
YES

SSL.

attempt

blocks

consecutive

allowed:
attempts

user

that

whose

accommodate

exceeded.

if necessary.
efficiency of file

use

Make

The

per

list.

was
per

pointers

system

default.

*Bits

write

specified

the

files.

the

space

fragmented

Consecutive
Enter

overdraw

the

user
to

can be
reaches the

quota

user

blocks

for

enough

time

block

size

the

consecutive

SAT

file

large

created.

free

attempts

written

OPTIONS

for

number

blocks

the

allowed

consecutive

small

not

of blocks over
"overdraw".
When the

Blocks

write

number

not

files

STARTUP

the

list

write

the

allocated

only

you

want

this

structure

the

list

crash

file

whenever

every

Allocation

for

SSIL

structures

structure

the

structure

crash

(NO, YES)

where

the

system

the

system

dump

made

above.

file

was

included

[YES]:

system
halted.

will
Space

list

for

the

Make

Specify
HOME

this

unit

blocks

pack.

with

alphanumeric

only

the

disk

should

another

characters

number.
Parameters

Unit

for

should

select

*SAT

the

This

unit,

that

unit

unique

SDL

(NO,YES)

pack
a

number

should

portion

that

have

[YES]:

resides

identification

unique

Every
may

the

identification

for

code.

the

disk

will

never

unit-id

pack’s

serial

six

RXxn

[XXXXn]:

Specify the number
of
calculated according to
overhead.

structure

identification.
on

Therefore,

conflict

the

SAT
the

minimum

blocks

per

blocks

type

disk

number

SAT

unit

81)

the
unit.

[8]:

unit.
As

blocks,

The
a
to

default

general
reduce

rule,

is
you

monitor

ONCE

Enter

the

number

While

the

wunit

memory

for

fast

stored

memory.

SAT
Specify

the

amount

all

space

t.mesharing.

blocks

mounted,

access

blocks

allocated
enough

SAT

STARTUP

the

core

swapping
should

not

only

SAT

ONCE

swapping

calculates

system
the

for

will

default

swapping

the

value.

The

1is

swapping

The

swapping

first,

then

logical

list

Class

Swapping

The

active

swapping

store

data

unit

the

Make
If

you

have

reminds
%
Q

you

Structure

you

structure

option,

the

list

disk.

the

unit

only

any

DSKx

enter
in

parameters

structure
must

unit.

stored

blocks

should

the

unit.

memory
may

The

run

space

total

size.
out

during

refresh

the unit is or will be in
allocate some space for

1logical

must

the

disk,

minimize

However,

269332)

where

Class

that

the

you

wish

YES

below:

ASL

(NO,YES)
with

you

as
the
the

may

[1346727]:
0

1is

system will
to

the

appears

because

units

where

address

space.

(33090

marked

block

This

appropriate,

classes,

[0]:

list,

the

are

must

swapping

the

middle

into

swapped

swapping

usually

the

SAT

times

data.

swapping

first

swapped

block

include

used

use
this

[YES]:

asterisk,

ONCE

refreshed:

refreshed before

can

used.

define:

have

finished

DEFINE.

press

the

for

the

for

unit

{[4807]:

the

list

changed

that

Structure
When

this

the

Space

the

accessing

divided

that

active

default

class

4807)

allowed
least

expand

write

put

average seek time when
change this value.
*First

address

attempt

space

memory

[8]:

the disk, which destroys all user files.
the
system’s
Active
Swapping List, you
swapping on the unit.
*K

blocks
BAll

space
be

allowed,

way

stored

system.

units

The

the

OPTIONS

RETURN.

defining
If

you

structure,

wish

you

prompted

may

enter

another

for

another

startup

ONCE

A.3.3

This

DESTROYing All

section

available
The

DESTROY

contain

information

the

DESTROY

executive

option

data

very

startup

option.

This

option

1is

mode.
powerful.

structure

will

OPTIONS

Structures

describes

only

STARTUP

used

definitions,

destroyed.

The

with
the

HOME

disks
data

and

that
and

SAT

already
structure

blocks

are

initialized, deleting all information about the disk’s place in system
lists and file structures.
For this reason, the ONCE program
ensures
that

you

message

want

before

intended

prevent

SWARNING:

All

type

you
is

are

A.3.4

YES

press

and

refreshed.

warning

data.
All

disk

files

currently spinning packs
are positive that you

prompted

for

response

the

disks

operation,

another

Single

this

question,

all

will

prints

be
the

ONCE

refreshed.
following

will

When

message:

units]

startup

option.

Structure

the
DISSOLVE
startup
option.
executive and user modes.

following

example, the
DISSOLVE
startup
option
followed by the structure to dissolve.
The text

The

DISSOLVE

is
that

selected
you type

underlined.
file

structure

disk

This

option.

RETURN,

that

This section describes
option is available in

RETURN

initialized

DISSOLving

In the
first,

All information on
proceed unless you

startup

press

with

blocks

then

printing

[NO}:

another

finished

[HOME

option.

this.

(NO,YES)

for

You

will

you

ONCE

structures

want

type

option

startup

destruction

destroyed.
lost.
Do not

you

DESTROY

accidental

be
be

prompt

the

will
will

Proceed
If

select

accepting

part

the

any

file

containing those
Startup

dissolved by deleting
The units in that

unit.

structure

until

you

another

file

structure

option:DISSOLVE<RET>

Structure

startup

define

units.

Structure to dissolve:DSKx<RET>
All data will be destroyed.
Are

Enter

all reference to
that
file
structure will not be listed

structure

option.

you

sure

(NO,YES)

[NO]:YES<RET>

dissolve:
to

dissolve

press

RETURN

select

another

ONCE

A.3.5

This

OPTIONS

EXITing to Monitor Level

section

illustrates

the EXIT

startup

option.

EXIT

returns

you to

level.

monitor

You

STARTUP

may Y EXIT

only Y

when

running g ONCE

user mode.

option:EXIT<RET>

Startup

GO Option

A.3.6

This

section

available

describes

only

Startup

the

in executive

startup

option.

This

option

1is

mode.

option:GO<RET>

The GO option allows you to start up the monitor without changing
any
disk parameters.
INITIA is allowed to run, but offline disk units are
not checked for or reported.
Because the
GO
startup
option
starts
INITIA,

one

the

following

SYS:TTY.INI

set

SYS:0PR.ATO

to be

files

must

terminal

read by

OPSER

exist:

line

characteristics.

automatically.

INITIA first attempts to read TTY.INI.
If the file does not exist
in
sSYs,
it
runs OPSER, which attempts to read OPR.ATO.
If OPR.ATO does
not exist, OPSER prints an error message.
You
can
exit
from
OPSER

typing CTRL/C and continue.
If TTY.INI exists, then
The
following
example

INITIA follows the
instructions
in
TTY.INI.
assumes that TTY.INI exists, and contains the

line:
GALOPR

CTY

INITIA

reads

the

line,

and

are
entered.
INITIA
programs, and then waits
from

starts

OPR on the

OPR:

MONITOR
Why

FER-16-88

reload:Q0THER

; TEST<RET>

Date:

FEB-20-88<RET>

Time:

11:35<RET>

Startup
MONITOR

option:

GO<RET>

11:35:32

Connected to Node
.LOGIN
.R

1,2

OPR

OPR>EXIT<RET>

CTY,

where

the

commands

reads
SYS:SYSJOB.INI,
starting
the
system
for input.
Type the
EXIT
command
to
exit

CTY

system

CENTR(0)

Line

1026

ONCE

A.3.7

This

section

can

describes

only

start

in
up

terminal

lines

prevents

INITIA

SYSJOB.INI

way

start

monitor

wusing

the

because’

INITIA

run

option.

This

option

the

from

to the

running.

without
should

Note
file

initialize

that

7.04

information

system

reload:QOTHER;

1is

about

the

this

also

well.

option,

Therefore,

changing
any
not be used to

disk
start

required to initialize terminal lines.
from the CTY using the INITIA SYS monitor

option

The

10.

identical

option

INITIA

option.

SYSJOB.INI

Chapter

INITIA program
monitor

running

NOINITIA

for

TOPS5-10
Why

reading

NOINITIA

later

Chapter

without

the

described

the

However,

startup

mode.

the

NOINITIA

by
from

file

prevents

the

executive

The NOINITIA startup
it

OPTIONS

NOINITIA Option

available
You

STARTUP

except
is

that

quick

parameters.
timesharing

INITIA
command.

can
See

INITIA.

FEB-16-88

TEST<RET>

Date:FEB-16-88<RET>

Time:11:44<RET>

Startup

option:

After

entering

disk

wunits

NOINITIA<RET>

NOINITIA

and

1lists

and pressing

them.

RETURN,

However,

you

ONCE

are

them.
SUNIT-NAME

TOPS-10

A.3.8

This

7.04

section

example,

Selected

describes

the

REFRESH

startup

refresh.

The

may

refreshed

startup

option

text

that

option.

selected

you

executive

first,

type

and

user

the

following

followed by

underlined.

modes.

WARNING

When

you

refresh

a file structure you
structure.
Therefore, ONCE
absolutely certain that
you
intend
on - the

structure

change

Structures

REFRESH

Structures

offline

FEB-16-88

the

structure

for

allowed to

offline

system

REFRESHing

checks

not

before

doing

so.

destroy

all

data

attempts

make

refresh

the

ONCE

The
REFRESH
option
characteristics
that

startup option,

which

file

forces
require

STARTUP

a
refresh
refreshing.

the HOME blocks

structures

OPTIONS

procedure
to
When you select

of all units are checked to

need to be

refreshed.

Then,

initialize
the REFRESH

you are

determine
asked to

enter the name of a file structure to be refreshed.
After refreshing,
you
will
again
be
asked
for
the
name
of a file structure to be
refreshed.
If you press RETURN without providing the name of
a
file
structure, you will be prompted to enter another startup option.
Startup option:REFRESH<RET>
Structure to refresh:DSKx<RET>

Structure does not need refreshing.

Are you sure
Structure to

Startup

([NO]:NO<RET>
(NO,YES)
refresh:<RET>

option:

refresh or press RETURN.

Enter ancother structure to

SHOWing System Parameters

A.3.9

This section describes the SHOW

startup

To SHOW the Active Swapping List

(E,U):

option.

SHOW startup option is selected first,
the
examples,
The text that you type is underlined.
item to show.

Startup

following

option:SHOW ASL<RET>

Swapping units:

Startup

the

followed by the

Unit

UnitID

Class

RPAQ
RPA6
RPB4

DSKDO
KLADO
DSKPO

0
0
0

Space

(K)

4807
4807
20000

option:

The Active Swapping List is the list of units that the system will use
to
store
data that is swapped to disk.
The swapping list is divided
into classes,
so

where Class

is used first,

on.

To SHOW the date

(E):

Startup option:SHOW DATE<RET>
Thursday 4-Feb-88 :27:58

Startup

option:

To SHOW networks
Startup

(E,U):

option:SHOW NETWOR<RET>

Networks:

DECI10
System-wide node name:
ANF-10 node DEC10 (10)
DECnet node DEC10(7.169)
LAT service:
DEC10

Startup

option:

then Class

Class

and

ONCE

SHOW the

System Dump

List

STARTUP

OPTIONS

(E,U):

Startup option:SHOW SDL<RET>
System dump list:
DSKD, DSKP

Startup
To

SHOW the

System

Startup

option:SHOW

System

search list:
Structure

Startup

option:

SHOW disk

List

(E,U):

SSL<RET>

Position

option:

sets

(E,U):

Startup option:SHOW SETS<RET>
Disk sets:
2,
6, 11, 26
Startup
To

SHOW

Enter

option:

structure

(E,U):

structure

parameters

for

all

useful

vyou

wish

SHOW.

you

structures

enter

change

the

option:SHOW

are

parameters

you do not wish to SHOW a structure,
prompted for another startup option.
Startup

that

ALL,

ONCE

1lists

and

repeats

press

online

the

the
guestion so that you can SHOW parameters for another structure.
When
you
enter
a
structure
to
show,
you
are
provided with a list of
parameters for that structure or
structures.
This
1listing
can
be

the

file

RETURN

and

STRUCT<RET>

Structure :DSKD<RET>
Parameters

for

structure

*Blocks

per

cluster:

Private
Owner

structure:

PPN:

Disk-set:
*Number of
Blocks

DSKD

10
NO

{10,5¢6]
ALL
K for

allowed

Consecutive

CRASH.EXE:

for

blocks

user:

tried for

output:

*Bits per cluster count:
Position in the SSL:
0
Unit in the SDL:
YES
Structure:<RET>

Startup

option:

4096

overdraw per

500

structure.
you

will

If
be

ONCE

STARTUP

OPTIONS

(E,U):

SHOW a unit

Enter a unit to SHOW.
When you enter a unit to show, you are provided
with
a
1list
of
the
parameters of any disk unit or all disk units.
This listing is useful when changing the parameters of
a
disk
wunit.
If
you
type ALL, parameters of all of the disk units will be listed.
If you specify a unit, ONCE lists the unit parameters and then repeats
the question so you can SHOW another unit.
If you do not wish to SHOW
a unit, press RETURN and you will
be
prompted
for
another
startup
option.

Startup option:SHOW UNIT<RET>
RPAO<RET>
Unit:

Parameters

for unit

DSKDO
Unit ID:
*K for swapping:

RPAD
4807

*First logical block for swapping:
Swapping class:
0
*SAT blocks for unit:
*SAT blocks in core:
Unit

the ASL:

Unit:<RET>

Startup

option:

YES

8
8

134672

APPENDIX

MODIFYING

B.1

THE

MONITOR

REBUILDING THE MONITOR LIBRARY FILE

The

monitor

library

monitor

modules

(COMMON,

this

COMDEV,

For

for

monitor

library

modules.

monitor,

portion

you

TOPS10.REL

distributed

with

the

form.

linked with

the

monitor

and

new

building

monitor
FGEN

file,

standard

manual.

sufficient

The

COMMOD),

explained

installations,
the

the

TOPS-10

Section

procedure

common
9.3

Chapter

monitor.

file contains assembled code for all
the
bundled
If
an
installation has made modifications to the
changed any settings of feature test options in the

MONGEN,

you

must

reassemble

the

monitor

library

file.

NOTE

The

symbol

with
this
impossible
Therefore,

you

system

modules

and

procedure
to predict

operating
Equipment
Several

values

are
so
results

should

may
Corporation.

must

configuration

appear

not

aware

options

numerous
in
every
that

the

supported

specific

order.

possible

that
it
is
combination.
resulting

Digital

They

are:

F.MAC

S.MAC
NETPRM.MAC

DTEPRM.MAC

SYSCNF .MAC+COMMON . MAC

SYSCNF .MAC+COMDEV.MAC
-

SYSCNF .MAC+COMMOD . MAC
EJBDAT.REL
FILFND.MAC

FILIO.MAC
FILUUO.MAC
RHXKON .MAC
RPXKON .MAC

These

files

order.

the

must

The

precede

following

all

files

other
must

modules,
be

placed,

and must
in

list:

this

listed

order,

this

the

end

read

the

PATCH.MAC
EDDT.REL

USRONC .MAC

For

batch

information

control

file

about

building

COMPIL.CTL.

the

monitor

library

file,

MODIFYING

B.2

CHANGING COMMON

The

COMMON,

COMDEV,

THE

MONITOR

SYMBOLS
and

COMMOD

modules

redefined
with
MONGEN.
This
entering the symbols to MONGEN,

contain

section
type them

symbols

1lists
in the

that

those
form:

may

symbols.

When

symbol, value
The

symbols

typed

and

the

their

MONGEN

The

following

the

SYSGEN

default

values

are

listed

here

Questions

they

might

dialog.

symbols

may

MONGEN.

portion

changed

Decimal

Question 126, Octal values are changed with
are changed with Question 128.

126

through

128

changed

values

are

with

Question

127,

and

SIXBIT

symbols

are

listed

values

B.2.1
The

Symbols

following

the

B.2.1.1
with

form

Defined
symbols

COMMON

are

defined

COMMON.

The

symbol,default-value.

Decimal

values

Symbols,Values

decimal

The

following

symbols

are

defined

radix.

ERPTMX, 80

Specifies

EVBN, 128

Blocks

the

length

of block

available

for

'mapping

errors.
buffers

and

IOWDs.

HIGHXC, 80

Highest

extended

channel.

IFCO,5

Swapper

fairness

count

LIM1HS, 30

Limit

L.OGSIz, 34

17K

M.BMAX, 13

Maximum

stopcodes

(current

size

number

maximum.
any

hour

period.

of LOGIN CUSP)
.
of

simultaneous

batch

streams.

M.CBAT, 10

Number of bad addresses in per CfU bad.

M.CLSN, 16

Number of CPU classes for scheduler.

M.CMCT, 32

Number

M.DNSZ, 30000

DECnet

free

M.DTLS, 90

CPU

M.EBPS, 12500000

Default

number

M.ENQD, 100

Default

ENQ

M.ENQM, 500

Maximum

number

active

M.ETSZ, 3000

Ethernet

free

core

size.

M.KNSZ, 3000

KLNI

time

calls
core

limit

free

CHKTAL

routine.

size.

(seconds)
of

EBOX

set.

ticks

per

guota.

core

size.

gueues.

second.

job

MODIFYING

free

THE

MONITOR

core

size.

M.LASZ,15000

LAT

M.LCST, 0

Length of the Line Data
customer definition.

M.MBPS, 9750000

Default

M.OMSM, 60

Number of minutés between calls to BIGBEN.

M.PCST, O

Length of the Process
customer definition.

M.PFHT

Default

MBOX

Block

references

Page

per

Data

Fault

reserved

for
.

second.

Block

reserved

Handler

timer

for

trap

interval.

M.SCSZ, 4000

SCA free

core

size.

MAXNBP, 64

Maximum number

MEMITL, 4

Number

of ways

memory

MINCOR, Jobn*300

Assume

MINMAX,1024*12

Smallest

MLACTS, 39

Maximum length of the

NSPMEM, 1000

1000

PAVJS3P, 20

Predicted average

RLDTIM, 112

Time

SFCO0, 20

CPUQ

scheduler

fairness

count.

SFC1,20

CPUl

scheduler

fairness

count.

TTDMOS, 16

Maximum output

UFCO0, 10

UUO

fairness

counter maximum.

UFC1,10.

UUO

fairness

counter

DDBS

per

legal

can be

interleaved.

CORMAX.

account

per memory

job

string.
cycle.

size.

auto-reload.

The

string for RSX-20F.

Initial

user

CTYDCR, 0

Delay

for RETURN

CTYDLF, 0

Delay

for LINE

CPU

for

slave.

following symbols

BPTBIT, O

Initial

UUO breakpoints.

job.

nano-seconds

B.2:1.2
Octal Symbols,Values
values in octal radix.

DEFBPT, 0

SNOOP

are

defined

"SET DDT BREAKPOINT"
on

FEED

CTY

setting.

during ONCE.

on CTY

breakpoint

during ONCE.

mask

(one

bit

per

CPU) .

DEFDEB, 0

Debugging word.

DTTRY, 4

Number of times to

INDPPN, O

0
means
project
programmer
numbers
are
dependant across projects.
That is, owner of
PPN

retry on DECtape errors.

determined by programmer

B-3

number

only.

MODIFYING

THE

MONITOR

Limit

stopcodes

any

minute

period.

LIM8MS,
7

Limit

stopcodes

any

minute

period.

M. BMIN,
O

Minimum

M .CLSS,
1

Scheduler

.DCLS,
0

Scheduler

class

.EMRT,
0

Default

regular runtime.

.ITA,
O

Default

.JMAX,M.JOB-M.BMIN

Maximum

number

LIMIMS,
4

number

guaranteed batch

class

system

for

use

new

scheduler.

jobs.

interval

timer.

simultaneous

interactive

jobs.
.PIDN, JOBN*2

Size of PIDTAR.

.RCMP,
0

Prohibits

.STOF,
0

execution

features

from

Frequency

remote

jobs.

restricted

call

start

used to

set

TTY

output

(must

2”n-1)
.
.WCH, JW.WMT

Watch bits

.XFFA,
0

file

and

value.

STDENS,
5

Standard

density

SYSSEG,
-1

Minus

one

TTXTRA,
0

Number

B.2.1.3

SIXBIT

M. CRSH,

Symbols,Values

B.2.2

CRSCPY

Symbols

following

the

form

for

fast

extra

The

(6250

Default

Name

Defined
symbols

checking

TTY

crash

of mail

COMDEV

are

defined

symbol,default-value.

DDBs

following

copy

[1,2]

BPI).

GETSEG

radix.

M. MATIL,MS

protection

Schedule

initial.

JACCT.

SCHEDN,
0

values

The

access

command

terminals.

from
for

symbols

program

SYS.

slave

lines.

are

defined

name.
-

program

COMDEV.

The

symbols

are

listed

MODIFYING

B.2.2.1
with

Decimal Symbols,Values

values

decimal

THE

MONITOR

The

following

symbols

data

Maximum time

DSETIM, 320

are

defined

radix.

security

erase

(seconds)
.

Any terminal idle
disconnected.

IDLSEC,
90

LPT

LPTSIZ,27+2

buffer

size

printer) .

M.AIDL,n

this

number

words

seconds

gets

(132

column

idle

ANF-10

The number

lines
are
the current

disconnected, where n defaults
value for IDLESEC (see above).

before

M.DIDL,n

The number of
seconds
before
idle
dataset
lines
are
disconnected, where n defaults to
the current value for IDLESEC (see above).

M.LIDL,n

The

number

are

current

value

The number

M.NIDL,n

seconds

disconnected,

for

lines
are
the current

before

where

IDLESEC

seconds

idle

LAT

defaults

(see

above).

before

idle

lines
to

the

NRT/CTERM

disconnected, where n defaults
value for IDLESEC (see above).

MSGMAX, 512

Maximum message

MTSIZ,128

Magtape

12
NOISE,

Noise

NTTPLN,
32

Size

TAPTIM,
60

Maximum

TTCHKS,
8

Size of words in a TTY chunk, in powers of
with
a minimum of 8.
Increasing the size
a TTY chunk can increase TTY throughput.

TTYRMT,
1

Remote terminal.

local.

B.2.2.2
values

octal

the

network.

in words.

record length

in bytes.

terminal

time

terminal

Octal Symbols,Values in

size

buffer

size

The

Process

skip

following

Control

records

Block.

(seconds).

terminal

2,
of

remote.

symbols

are

defined

radix.

MAXODR,
6

Maximum number
devices.

MSGXMX, 512

Maximum message

size

the

~10

MTDAEM,
10

Number

per

reel

times

data

magtape

error

reports.

MTDLTP,
LT .BLP

Default

label

type.

MTELOG,
~1

Zero

log

all

requests

will
call

recovered magtape

for

input

transmit.
DAEMON

errors.

for

MODIFYING

B.2.3
The

Symbols

Defined

THE

COMMOD

following symbols are defined
the form symbol,default-value.

B.2.3.1

with

Decimal

values

Symbols,Values

decimal

MONITOR

COMMOD.

The

following.

symbols

are

symbols

radix.

listed

are

defined

BLKMAX, 100000

Maximum

number

blocks

transfer

(KL10).

BLKMAX, 252

Maximum

number

blocks

transfer

(K510) .

CHVIFP, 10

Standard
initial
positioning.

fairness

count

for

Standard

fairness

count

for

CHVIFT, 10

initial

transferring.
DSKTRY, 10

FIL4WD, 9

Number

error

Number

trys

word

core

disk

data

blocks

errors.

per

Job

NMB, PPB, UFB, ACC) .

M.BNDT, 16

Number

ONCE
MAXUSI, 8

MFDSIZ, 30

seconds

before

binding

USETI

(maximum

Maximum

negative

extended

RIBs).

Number

blocks

for

initial

Number

in-core

retrieval

file.
RCLTRY, 10

Number

times

try

'DSKTRY’

SERTRY, 3

Number

times

try

SWCLSN, 7

Highest

SWPMAX, 8

Maximum number of units

UNVRSF, 500

Reciprocal

B.2.3.2
values

Octal
in

Symbols,Values

octal

CCWMAX, 1

LBFSIZ,1000

class

The

safety

Maximum

Default

multiples
Maximum

monitor.

the

for

symbols

data

large-buffer

Specify

data

set

per

errors.

swapping.
each

unit.

are

defined

channel

size

command

(OP.LBF

octal value

200.

number

pointers

for

factor

following

number

swapping.

radix.

OPEN) .

LIMLVL, 5

for

disks

MFD

refresher.

PTRLEN, 7

time.

(for

nested

SFDs

words.

in words

for

this

MODIFYING

THE

MONITOR

LNMMXL, 144

Maximum length of any logical name specified.

LNMMAX, 77

Maximum number of logical names.

M.CBMX, JOBN-1

Default blocks

M.DFLB, 3

Default number of large disk buffers.

M.DFNR, 6

Default number of disk buffers.

MFDPRV, 555000

MFD privileges

PRVFIL, 057

Standard file privilege.

PRVSPL, 077

Protection for spooled output.

PRVSYS, 155

Protection for most

PRVUFD, 775

Standard UFD privilege.

PRYSYS, 157

Protection

RIBERN, O

RIB
for
threshold
error
RIB
structures in system search list.

SYNRPR, 357000

Privileged files in SY¥S.

SYRDPR, 355000

Non-privileged files in SY¥S.

SYSPRV, 775000

SYSSUF? privileges

B.2.3.3
value

for

in disk cache.

(all can READ,

.
LOOKUP)

system programs.

SYS:*.SYS.

errors

(project 1 can read/create

SYS).

SIXBIT Symbols,Values - The following symbol is defined by
SIXBIT

M.QSTR,

radix.

Default structure

for

device

gueues.

The

The wvalue
default wvalue for M.QSTR is blank.
is the SIXBIT name of the file structure
for
queuing
programs set up by ONCE-only code to
be the first stream up.

APPENDIX

SETTING

The

SCDSET

program

functions

file.

example,

For

the

you

can

Set

Adjust

scheduler

Create

and

Move

SCDMAP.3YS

Update

the

usage

C.1

REQUIRED

PRIVILEGES

privileges

required

accomplish.

The

for

different
©

file

into

set

all

use

system

usage

SYS

JACCT

privileges.

the

accomplish
a

the

SCDMAP.SYS

following:

area

jobs

depend

list

describes

logged

READ/SET

file,

move

quotas,

have

use

manipulate

the

SCDSET

you

the
and

the
the

need

file

you

functions

have

the

SYS

area.

SCDSET

must

want

required

only

scheduler

the

you

privileges

into

adjust

[1,2],

functions,

automatically

the

parameters,

program

logged

must

CAUTIONS
you

misunderstand
wusing

system.

the

scheduler
with

both

the

you

scheduler

may

Therefore,

works,

unintentionally

practice

non-production

make

halt

working

timesharing

quotas

High

Priority

file.

file,

you

and

you

sytem

Queue
use

adversely

locad

(HPQ)
an

HPQ

affect

from

except
when

system

typing

all

work

done

the

SCDSET

and

until

you

familiar

affecting

when
you

mistakes
being

with

them.

system

SCDMAP.SYS

how

SCDSET,

during

prevent

SCDSET
a

logged-in

SCDMAP.SYS

necessary

must

while

file

the

[1,2].

C.2

SCDMAP.SYS

you

SCDSET

following

manipulate

user

and

functions.

privileges
0

use

call,

parameters

class

The

privileged

quotas

modify

monitor

system

SCHEDULER PARAMETERS

enables

SCHED.

you

are

your

work,

create

performance.

run

modify

SETTING

C.3

SCDSET

This

COMMANDS

section

describes

with

the

C.3.1

describes

the

EDIT

subcommands,

READ/SET

commands.

top-level
and

the

SCDSET

Calls

the

MAKMAP

routine.

SCDMAP.SYS

file.

Subcommand

Function

COPY/SET

Copies

EXIT

Returns

HELP

Displays
CLASS

Changes

RANGE

the

MAKMAP

uses

from

routine

the

area or

read

enables

you

device

EDIT

help

also

and

set

create

scheduler

type

range

scheduler

SCDMAP.SYS

file

for

TYPE

Displays

specified

range

WRITE

Writes

SCDMAP.SYS

SYS

area.

class

the

scheduler

classes

file

modification.
scheduler

types.

device

area.

EXIT

Returns

your

Jjob

monitor

level.

HELP

Displays

C.3.4

scheduler

types

C.3.3

the

file.

C.3.2

file.

SCDMAP.SYS

subcommands:

text.

Reads

help

text.

READ/SET

Execute

functions

following

Parameter
SWAP

of the SCHED.
parameters:

monitor

call.

You

can

read

set

Meaning
TIME

The

estimated

the

system.

which

can

following

READ

AVG

you

top-level.

one

Changes

The

EDIT

file

SCDMAP .SYS

the

commands.

parameters

EDIT

modify

ONE

SCHEDULER PARAMETERS

the

when

The

class

average
The

swapper

chooses

swap

AVG

changes

jobs

time

SWAP

for

TIME

from

swap

one
in.

typical

controls

class

the

Job

rate

the

CLASS

class

Jjobs

run

background

whenever

the

batch.

system

Background batch
otherwise

idle.

SETTING SCHEDULER PARAMETERS

SWAP

TIME

The

estimated time

required to

swap

a background

batch

job.
The
scheduler
uses
the BB SWAP TIME to decide
when the system should permit a background batch job to

CORE

in.

swapped

INTERVAL

SCHEDULING

The rate at
which
the
system
stops
accounting
for
in-core
protect
time
and stops using in-core protect
time to requeue jobs.
The CORE SCHEDULING INTERVAL
1is
important for systems with a large amount of memory, or

CPU

SCAN

DEFAULT

very

few

users.

The

scan

table

ORDER

used by

a CPU

CPUs.

CLASS

The class new jobs assume when they first log in.
The
DEFAULT
CLASS
applies
to a new job until LOGIN reads
the job’s class from SCDMAP.SYS and changes
the
<class
appropriately.

FREE

CORE

GOALS/LIMITS
The percentage of free and potentially free memory that
must
be
available to the swapper.
If this percentage
is not available,
term wait.

HIGH

SEGMENT

RETENTION

the

swapper

swaps

out

Jjobs

long

TIME

The dormant high segment retention time is high segment
in-core
protect
time.
It prevents the deletion from
memory of high segments which have become dormant until
a
IN-CORE

FAIRNESS

specified time

has

elapsed.

FACTOR

The factor that controls the rate at which out of
jobs and in-core jobs are scheduled for swapping.
JOB

CLASS

INTERVAL

The scheduler class

The Micro
interval
class
PRIMARY

of all

logged in

Scheduling interval
(in
specifies
how
often the
be

core

jobs.

Jjiffies).
scheduler

The
MS
selects a

scheduled.

PERCENTAGES

The system
usage
percentages
for
a
particular
Jjob
class.
The
sum
of
all
primary
percentages may be
fixed.
In this case, the sheduler only chooses
a
Jjob
to
run
when its class has the highest priority.
When
the sum is fixed,
a
<class
cannot
exceed
its
class
quota.
If
the
only runnable jobs are in this class,
the scheduler runs the null job.
PROT

A constant used to calculate
the
minimum
quota.
The measurement is in microseconds.

core

usage

SETTING

SCHEDULER

PARAMETERS

PROT1

The

in-core timeslice used after a

initial
at which

job has

in-core protect time.
PROT1
I/O0
bound
Jobs
circulate

expired

controls
around

its

the
the

rate
run

job.

queues.

PROTM

The

maximum

specifies

in-core

upper

protect

limit

time

for

assigned

very

large

jobs.

PROTOT

constant

quota.
RESPONSE

used

The

rate

which

depends

swapped in
job
BY

core

usage

list",

the
on

scheduler
the

order

and the

chooses
of

the

Jjobs

jobs

allocations

run.

the

"just

specified by

the

classes.

amount

last

time

runtime

that

measurement
displays the

each

class

«class

has

quota

wused

was

since

the

changed.

The

is
in
jiffies.
This
parameter
percentage of runtime each class has

also
usegd.

FAIRNESS

The

rate

jobs.
run
SECONDARY

minimum

microseconds.

CLASS

The

SCHEDULER

the

in
)

rate

The

which

PQ2

jobs

are

SCHEDULER FAIRNESS

even

when

there

are

scheduled

allows

many

ahead

compute

interactive

bound
jobs

PQl

jobs

running.

ALLOCATION

The

maximum

using
SWAPPER

calculate

FAIRNESS

The

RUNTIME

measurement

amount

the

that

class

will

swapped

given

after

primary percentage.

FAIRNESS

The

rate

which

PQ2

Jjobs

are

ahead

PQl

either

run

jobs.
TIME

BASE

The

base

run

quanta

(in milliseconds)

for

queue.
Note that internally, the scheduler stores this
value in local
jiffies.
Therefore,
it
may
not
be
possible

adjust

the

time

slice. by

few

milliseconds.
TIME

TIME

MAXIMUM

The

maximum

quantum

The

parameter

for
the

large
Jjobs.
following:

runtime

that

job

uses.

MULTIPLIER

(TIME
The

BASE)+(TIME

scheduler

quantum
values

that

large

quantum

larger

quantum

runtime

MULTIPLIER)
* (job

compares

maximum,
to

asssigns

The

and

jobs.

the

runtime

result

size)

quantum

assigns

the

runtime

smaller

run

the

two

SETTING

C.3.5
The

UPDATE

for

UPDATE

the

command

JOBS

PARAMETERS

JOBS

logged

SCHEDULER

updates

Jobs,

and

accomplishes

all

the

job

writes

the

changes

this

through

the

parameters

defined

to. files

FIXJOB

routine,

above

requested.
which

does

following:
o

Asks

area.

you

want

you

answer

NO,

SCDMAP.SYS
O

Gets

Determines
of

each

the

Looks

Executes
correct

Prints
find

move

FIXJOB

whether

SCDMAP.SYS

you

move

calls

the

MOVMAP

job’s

the

batch

currently

for

SCHED.

scheduler

error

the

file

+to

SCDMAP.SYS

routine

the

8YS

file.

move

the

PPN.

use

file

ACTDAE.SYS

new

logged

yes,

file.

SCDMAP.SYS

answer

the

user’s

monitor

half

call

timesharing

half

SYS.
scheduler

put

type.

that

Job

the

class.

message

ACTDAE.SYS,

for
or

each

logged

for

which

the

SCHED.

the

job

SCHED.

does

not

monitor

call

failed.
The

FIXJCB

jobs,

C.4

THE

You

must

routine

for

have

the

constitute

the

map

the

zero

and

has

and

then

entries
for

and

class.
an

time,

Each

not

want

the

map

batch

the

looks

type

monitor

call

for

[2,5]

SYS.

The

words).

users,

wusers.
inclusive

512

the

Each

contains

1024

first

second

entry

(0-31)

scheduler

file
The

512
512

contains

that

types

for

the

PPN’s

entries
entries
a

number

specifies

both

timesharing

entry.

scheduler

half

decimal

timesharing

thirty-one

you

file

(256

for

looks

second

execute

FILE

map

scheduler

not

job.

SCDMAP.SYS

nine-bit

constitute

batch

does

own

SCDMAP.SYS

(decimal)

between

its

in ACTDAE.SYS

SCDMAP.SYS

job

type

for

the

(timeshare

differentiate
should

for

current

class

type

for

that

batch,

the

batch).

between

identical

scheduler

timeshare
to

the

and

first

half.

SETTING

The

format

Table

C-1:

the

SCDMAP.SYS

BITS

SCHEDULER PARAMETERS

file

0-8

9-17

no0

Word

nb5

Word 2

the

Scheduler

location
Type

follows:

Format

Word

nXXX

XXX,

the
as

27-35

n7v

]

nl0

nll

Class

for

)

Scheduler

stored

18-26

timesharing

wusers

ACTDAE.SYS.

Word

127

n508

n509

n510

n511

Word

128

Word

129

mb5

m6é

Word

130

ml0

mll

Word

255

m508

m509

m510

m511

mXXX

the

Scheduler

location

Type

XXX,

of
as

the

Scheduler

stored

Class

ACTDAE.SYS.

for

batch

users

APPENDIX

CREATING BOOTABLE FRONT-END MEDIA

This appendix documents the procedure for creating bootable
front-end
media
for
RSX-20F.
These media provide a fallback capability if the
front-end file system on your system’s RP06 disk is damaged or lost.
The installation process comprises two parts.
Part 1 of the
process,
described
in
Section
D.1,
creates
the
"A"
and
"B"
DECtapes or
floppies, and requires
that
your
system
be
standalone.
Part
2,
described
in
Section D.2, creates the "C" DECtape or floppy, and can

be performed at any time,
without

either before or after part

shutting down timesharing on

D.1

BUILDING

This

procedure

THE

performed,

PRIMARY BOOTABLE VOLUMES

assumes:

front-end’s

that you have

system mounted

hard disk drive.

that the system has been shut down,
done in a standalone environment.

procedure

that your system has a bootable front-end file
on the

the KL.

this process

must

installed your front-end files using the RSXINS

described in

that you have a

set

chapter

of three DECtapes

condition to hold the

front-end files.

floppies

The example below illustrates the
procedure
for
both
DECtapes
floppies.
The
left-hand
column displays the DECtape procedure;
right-hand displays

the

good

and
the

floppy procedure.

Mount the disk pack containing a bootable RSX-20F

system in

the

front-end RP06.

Mount a pair of DECtapes or floppies on drives 0 and
1.
These
will become the A and B volumes of the set you are creating.

If you are writing DECtapes,
write

ensure that both DECtape drives

enabled.

Set

the PDP-11

Press the

console

switches

SW/REG and ENABLE

000203.

switches

at the

same time.

are

CREATING BOOTABLE

Initialize
For

the

media

FRONT-END

drive

DECtapes:

For

<CTRL/\>
PAR>MCR

The

INI

The

program

will

approximately
INI

program

Repeat

For

line

Now tell

now

PAR>MCR

initialize

not
for

for

reprompt
drive

the

volume.

DECtape
when

it .is

mount

the

MOUNT

Create the
utility:

For

COMPLETE

MOU

COMPLETE

[5,5]

UFD

the

volume

seconds

10.
The

Repeat

11.

does

COMPLETE

wusing

the

UFD

finished.

The

UFD

DECtape

about

floppies:

not

for

commands

the

PIP

UFD<RET>

UFD>DX0:15,
5] <RET>

reprompt

takes

step

Invoke

the

MOU<RET>

MOUNT

PAR>MCR

about

when
it
minutes

is
on

floppy.

remaining

process
on

unit

For

UFD<RET>

INI,

floppies:

-~- MOUNT
MOU><CTRL/Z>

UFD>DT0:[5, 5] <RET>

creation

the

MQOU

UFD,

for

MOU>D
: <RET>
X1

DECtapes:

PAR>MCR

will

floppy.

MOU>D
: <RET>
X0

MOU><CTRL/Z>

MOU>DT1 : <RET>
--

PAR>MCR

MOU>DTO : <RET>

MOU

For

MOUNT

for

media:

PAR>MCR MOU<RET>
--

process

seconds

complete.

substituting

DECtapes:

MOU

This

INI.

RSX-20F

INI<RET>

INI>DX0:<RET>

minutes

will

step

command

floppies:

INI>DTQ:/INDX=MID<RET>

take

MEDIA

the
are

volume
common

utility

on
to

drive
both

copy

the

and

DECtape

files

and

floppy

both

systems.

volumes:

<CTRL/\>
PAR>MCR

PIP<RET>

PIP>WBLDFE1<RET>
BLDFEl

the

two

and

then

will

a
to

take

floppies.

command

file

volumes.

about

that

directory

tells

instructs

minutes

the

PIP

which
copy

files
the

newly-created

for

DECtapes

and

put

files

files.

about

on
The

each

volume

process

minutes

for

CREATING BOOTABLE

12.

FRONT-END MEDIA

Exit from PIP and boot the unrun image of RSX-20F from the
file
RSX20F.SYS.
This
4image
will
use the newly created front-end
volumes as the system device SY:.
PIP><CTRL/Z>

PAR>MCR

BOO<RET>

BOO>DB0 :RSX20F . SYS<RET>
13.

Wait a few
cause
the

seconds and then type control-backslash.
This
will
newly-booted
RSX-20F
to
search
for the PARSER on

DECtape

floppy

Please note that all commands
the files must now be read in

will take somewhat longer to perform,
from DECtape or floppy.

<CTRL/\>
INS

MOUNTED,

PAR

[PARSER]

TSK=PARSER

ESE

EBOX

STOPPED

EXAMINE

PAR>

14.

If you are building a
floppy-based
system,
please
step.
The DECtape version of RSX-20F does not mount
so you must do it manually:
PAR>MCR

skip
this
DECtape 1,

MOU<RET>

: <RET>
MOU>DT1
MOU

MOUNT

COMPLETE

MOU><CTRL/Z>
15.

Next, set some PARSER parameters and save the full RSX-20F image
to
the front-end media.
The last command, which directs SAV to
save the system core
image,
will
take
about
10
minutes
to
execute.
Once
the save is completed, the newly saved software
will

reloaded

automatically.

<CTRL/\>
PAR>SET

CONSOLE

CONSOLE
PAR>SET

MODE:

MAINTENANCE<RET>
MAINTENANCE

FAULT-CONTINUE<RET>

FAULT-CONTINUATION:
PAR>SET

DATE<RET>

DATE:

16-MAR-88<RET>

TIME:

16:11<RET>

CURRENT

SYSTEM

WEDNESDAY,
VALIDITY
PAR>MCR

DATE:

16-MARCH-88

FLAG

16:11

IS:ON

SAV<KRET>

SAV>SY0: /WB<RET>
[Dx0:

dismounted]

[Dx1l:

dismounted]

RSX-20F

VxH#-#4#

[SY0O:

redirected to

[Dx0:

mounted]

[Dx1l:

mounted]

16-MAR-88
DxO0:]

[PARSER]

ESE

EBOX

STOPPED

EXAMINE

CREATING

16.

Lower

and

raise

PDP-11

console

ENABLE

switches

the

You

may

now

remove

the

sure

place

labels

You

should be

now

have

DECtapes
now,

minimal

may

reboot

has

been

BUILDING
have

THE

that

not

The

steps

involved

they

may

starting

Mount

the

drive

1Initialize
For

"A";

If
the

the

from

the

one

system

and

The

INI

may

build

RSX-20F

fit
can

this

set

the

SW/REGC

and

drives.

Please

the

program

the

build
the

the

third

first

console

the

This

first

done

two

not

media,

volume

immediately

later.

DECtape

media

that

the

you

will

volume

after

must

hold

create

drive

after

Part
to

completed,

shut

down

the

receive

For

floppies:

the

files

PAR>MCR

will

now

initialize

minutes
not

RSX-20F

for

reprompt

mount

the

volume.

DECtape
when

the

or
is

device,

INI<RET>

This

seconds

process

for

making

available

For

PAR>MCR MOU<RET>

MOUNT

MOU>DX0
: <RET>
COMPLETE

MOU

the

[5,5]

MOUNT

COMPLETE

MOU><CTRL/Z>
UFD

DECtapes:

<CTRL/\>
PAR>MCR

floppies:

the

volume,

using
For

the

UFD

utility:

floppies:

UED>DT0: 15, 5] <RET>

will

floppy.

complete.

For

MOU><CTRL/Z>
Create

INI>DX0 :<RET>

MOU>DTO : <RET>

DECtapes:

additional

set.

necessary

MOU

two

third

use:

PAR>MCR

program

For

one

"B".

procedure.

floppy

the

media.

INI<RET>

Now tell

the

restarted.

done

approximately
INI

the

system

you

INI>DTO : /INDX=MID<RET>
The

console,

press

volumes

drive

RSX-20F
wish,

take

and

floppies

DECtapes:

PAR>MCR

PDP-11

identifying

you

000203,

time.

them

front-end

before

same

bootable

copy

will

MEDIA

THIRD VOLUME

complete

volume

files

FRONT-END

switch

DECtapes

floppies.

you

third

the

labelled

timesharing

D.2

HALT

switches

drive

BOOTABLE

PAR>MCR

UFD<RET>

UED>DX0:{5,5]<RET>

for

CREATING

UFD,

INI,

does

not

FRONT-END

reprompt

creation
process
takes
seconds on a floppy.
5.

BOOTABLE

about

when

minutes

MEDIA

1is
a

finished.

DECtape

Now invoke PIP, and tell it to copy the
this example are common to both DECtape

and

The
about

UFD
10-15

files.
The commands
floppy systems.

and

PAR>MCR

PIP>W@BLDFE2<RET>

BLDFE2,

belong

on this

volume.

finished

copying

those

minutes

for

Once

the

BLDFEl

DECtapes

the

file

and

copy

used

will

also

files.

minutes

Part

directory

The

for

complete,

tells

process

PIP

will

which

the

files

volume

take

when

about

floppies.

exit

from PIP

and

dismount

the

volume:

For DECtapes:

For

PIP><CTRL/Z>

PAR>MCR

DMO<RET>

DMO>DTO : <RET>
DMO

DISMOUNT

COMPLETE

The

Remove

the

DECtape

"C"

the

set.

installation

DMO<RET>

DMO>DXO0
: <RET>
DMO

DMO><CTRL/Z>
7.

floppies:

process

DISMOUNT

COMPLETE

DMO><CTRL/Z>
or

floppy

from the

complete.

drive.

Label

volume

GLOSSARY

This

this

appendix
manual.

lists

and

explains

are

used

the

terms

and

conventions

wused

"AC
An

accumulator.

Accounting Files
The

files

that

resources.

See

ACTDAE.SYS

Chapter

for

control

and

access

QUOTA.SYS

information

about

and

are

wuse

the

these

computer

accounting

files.

AUTCON

The monitor module
to
automatically
configure
tape
and
disk
drives.
AUTCON
is part of the monitor, that detects changes in
status of I/O channels.
It is also invoked at system startup
to
build the appropriate data bases for mass-bus and CI bus devices.

BAF

block

The

BAT

block

that

stored

memory.

block

The

data

areas

table,

stored

disk,

containing

disk.

information

about

bad

CRASH.EXE

The

file

automatically

CRASH.EXE

can

used

written by
reload a

BOOT
when
the
system
suspended monitor.

fails.

CTY:

The

console

usually

the

system

not

terminal

hard-copy

that
running.

for

the

terminal,

printed

can

front-end
so

Gloss-1

that

and

CPU.

important

easily

perused

The

CTY

information

when

the

about

system

CUSP
A

Commonly

monitor
and

Used

BACKUP

System

perform
are

Program

system

that

works

functions.

For

closely

example,

with

the

PIP,

CUSPs.

DAY-MON-YEAR

The

Ersatz

format

Device

The

File

the

system

date

you

supply

the

ONCE-only

dialog.

Names

monitor

associates

device

name

device

names

portion

1is

certain

called

can be
MONGEN.

device

names

"ersatz

expanded

with

device."

PPNs.

The

Such

list

Question

packs,

mounted

ersatz

the

HDWGEN

Structure

file

that

structure
have

referenced

structure
ONCE

one

been

defined

and

accessed

information

more
to

disk

the

monitor

the

entered

file

into

single

structure

the

disk

the

and

spinning,

entity

name.

HOME

blocks

program.

File

the

HH:MM:SS

The

time

you

input

for

the

system

time

ONCE-only

dialog.

HIGH-ADDR

The
the

HOME

high-bound physical
ONCE dialog.

address

memory

that

referenced

block

The

data

about
of

block

the

swapping

Initial

Job

that

wunit’s

stored

file

disk

structure,

which

access

contains

information

information,

space.

and

amount

Search List

The

job’s initial search list
information in the accounting

Job

List

Those

file

structures

that

(established
files.)

constitute

DSK

address

for

the

from

the

job.

LOW-ADDR

The

lower-bound

the

ONCE

address

physical

dialog.

Gloss-2

reference

specified

MEFD

The Master File