Digital PDFs

AA-H376A-TC

July 1984

104 pages

Original

45MB

view download

OCR Version

35MB

view download

Document:	RT-11 System Generation Guide
Order Number:	AA-H376A-TC
Revision:	0
Pages:	104
Original Filename:

OCR Text

RT-11 System
Generation Guide
AA-M240B-TC

July 1984

This manual describes the system generation process and is designed
for RT—11 users who need to build special monitors and handlers.
This manual supersedes the RT—11 Installation and System Generation

Guide, AA-H376A-TC and the RT-11
AA-M240A-TC.

Operating System:

System Generation Guide,

RT-11 Version 5.1

To order additional documents from within DIGITAL, contact the Software Distribution
Center, Northboro, Massachusetts 01532.
To order additional documents from outside DIGITAL, refer to the instructions at the back
of this document.

digital equipment corporation - maynard, massachusetts

First Printing, March 1983
Revised, July 1984

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 or its affiliated companies.

Printed in U.S.A.

A postage-paid READER’S COMMENTS form is included on the last page of this
document. Your comments will assist us in preparing future documentation.
The following are trademarks of Digital Equipment Corporation:

gliltlal
Ii
DEC
DECmate
DECsystem—10
DECSYSTEM-20
DECUS
DECwriter
DIBOL

MASSBUS
PDP
P/OS
Professional
Q-BUS
Rainbow
RSTS

M33400

RSX
RT-11
UNIBUS
VAX
VMS
VT
Work Processor

Contents
Page

Preface

Chapter 1

Preparing for System Generation
1.1

System Generation Process.

1.2

Gathering Information.

. .

...

.. ... 1-2

. . . .
. . ...

. .

...

... 1-5

. . . .
Interrupt Vectorsand CSRs

...

1.2.2

... 1-5

...

1.2.3

...

Monitor Services for Target Application

.. 1-5

1.2.4

Defining Other System Conditionals .
System Build Procedure . . . . . . .

. .

. .. C e

1.2.5.1

. .

. ...

1.2.1

1.2.5

Peripheral Devices.

1.25.2
1.3

Chapter 2

Automatic System Build .
Manual System Build . .

Studying the SYSGEN Dialog . .

e 1-9

e e

. 1-10

...

.. 1-10

. ...

...

.. 1-17

... ...

. 1-6

1-17

Performing the System Generation Process on a Disk System
2.1

Running the Program IND.SAV . . .

2.2

Collecting the Appropriate Files on the Appmprmw Media.

2.3

Assembling and Linking the Monitor(s) and Device Handlers.
2.3.1

2.3.2
2.3.3

Chapter 3

. .

.. .

...

... 2—1

. .

. 2-2

. . . 2—-2

Using SYSGEN.BLD to Build the System . . . . . . . . . .. 2-3
Using SYSGEN.MON and SYSGEN.DEV to Build the Symem .26
Building Handlers Separately . . . . . . . . . . . .. . .. .2-8

Performing the System Generation Process on a Small System
3.1

Creating a Working System for This Process . .

. .

3.2

Running the Program SYSGEN.COM

. .

...

3.3

Collecting the Appropriate Files on the Diskettes.

. .

. . . . .

. .

System Build Indirect Command Files . . . .
Creating System Build Diskettes. . . . . . .

. . .
. . .

. . . .33
. ... 3-5

3.3.2.1
3.3.22

.e
. ... ...

3.3.1
3.3.2

Diskette Contents
CopyingtheFiles

. . . .
. . . .

. .
. .

.
.

. .
. .

...

. .
. .

.. 3-1

... 3-2

. . 3-3

. .36
.. 3-7

111

3.4

3.4.1
3.4.2

Appendix

. . . . . 3-8

Assembling and Linking the Monitor(s) and Device Handlers.

o000 3-8
Assembling Files. . . . . . . . . . ..o
LinkingFiles . . . . . . . . . . .. 00000 3-11

SYSGEN Answers That Will Duplicate the Standard Monitors
Al
A2

SJ and FB Monitors . . . . . . . . . o« v v e, A-1
XM Monitor . . . . . .
A-3
SYSGEN Questions . . . . . . . . . . . . ... e A-5

Appendix B

SYSGEN Answers That Create a Multiterminal System

Appendix C

RT-11 Conditionals
C1

System Conditionals . . . . . . . . . . . .. ... ... C-1
C.1.1
C.1.2
C.1.3

C.2
C.3

Appendix D

SIMAC . . . . . . e C-4
FBMAC. . . . . . . e C4
XM.MAC . . . . . .
e e C-4

Individual Keyboard Monitor Command Conditionals. . . . . . . . . . C-5
Naming-Convention Conditionals . . . . . . . . .. .. . ... .. .C-6

Customizations for Specially Generated Monitors
D.1
D.2
D.3
D4

D.5
D.6
D.7

Installing Only the Generated Handlers . . . . . . . . . .
Suppressing the Multiterminal Polling Routines . . . . . .
Changing the Handler File-Name Suffix . . . . . . . . ..
Changing the Default Device for the SRUN Command . . .
Changing the Default File Type for the SRUN Command. .
Assigning a Remote Line as the Console Terminal . . . . .
Changing the Device Name of the UCL File . . . . . . . .

.
.
.
.
.
.
.

... .. D-1
. . . . . D-2
... .. D-2
. . . . . D-3
. . . . . D-3
. . . .. D-4
. . ... D4

Index

Figures
1-1
1-2
1-3

1-4
1-5

1-6

3-1

System Generation Process. . . . . . . . . . . . ... ...
.. 1-4
SYSGEN Input and Output Files. . . . . . . . . . . . .. ... ... 1-4
All Files on One Disk for System Build . . . . . . . . . .
. . .. 1-14
Source Files on Second Disk for System Build . . . . . . . . . . .. 1-15
Second Disk and Line Printer Receive System Build OQutput . . . . . 1-16
System Generation Worksheet . . . . . . . . . . ... .. ... .. 1-44
Sample SYSGEN.MON and SYSGEN.DEV Files. . . . . . . . . . .. 3-4

Tables
1-1

1-2

1-3
1-4

2—-1

3-1

Features Available Only Through System Generation Process
Source Files Required for System Build
Free Storage Required to Build Components .
Free Blocks on Devices After Initialization .

System Build Errors . . . . . . . . . .. ..o
System Build Errors . . . . . . . . . .. ..

.1-6

. 1-11

. 1-13

. 1-13
. 3-12

Preface

How to Use This Manual

The RT-11 software kit contains four generic operating systems that are
designed to meet the needs of most RT-11 users. However, you need not be
limited to the use of any one of these systems if they do not meet your
needs. This manual provides you with the information you need to generate
a system tailored to your specific needs. Chapter 1 describes the system
generation procedure that you must follow and specific questions you must
answer to generate your particular system. Chapter 2 tells you how to run
the SYSGEN program to build the resulting system. Chapter 3 describes
system generation on a dual-diskette system. However, DIGITAL does not
recommend a system generation of this kind.
Additional information available in the appendixes includes: system generation answers that duplicate the standard, distributed monitors, system
generation answers that create an example multiterminal system, RT-11
conditionals, and customizations required for specially generated monitors.

Before you begin, you should read the Guide to RT-11 Documentation,
which describes the other software documents associated with the RT-11
operating system. Familiarity with the RT-11 system, as described in the
RT-11 System User’s Guide, RT-11 System Ultilities Manual, and Chapter
1 of the RT—11 Installation Guide, is particularly helpful when you perform
the procedures in this manual.

If you are a FORTRAN 1V, BASIC-11, CTS-300, or other layered product
user, you build your FORTRAN IV, BASIC-11, FMS-11, CTS-300, or other
system after building the RT-11 system. A layered product is software that
is sold separately but requires the RT—11 operating system environment to

run. See the appropriate installation manual for instructions on installing
such products.

vii

Documentation Conventions

You should become familiar with certain symbolic conventions used in this
manual.
1.

Examples consist of actual computer output whenever possible. In these

examples, user input appears in red where it must be differentiated
from computer output.

Unless the manual indicates otherwise, all commands or command
strings end with a carriage return. The symbol
represents a carriage return, @ a line feed, &P a space,
an ESCAPE or ALTMODE,
a tab.
and
To produce certain characters in system commands, you must type a
combination of keys concurrently. For example, while holding down the
CTRL key, type C to produce the CTRL/C character. Key combinations
such as this are documented as CTRL/C), CTRL/O), and so forth.

In descriptions of command syntax, capital letters represent the command name, which you must type. Lowercase letters represent a variable for which you must supply a value.
In examples, you must distinguish between the capital letter O and the
number 0. Examples in this manual represent these characters as follows:

Letter O: O
Number 0: 0

The sample terminal dialog in this manual contains version numbers
where they would normally appear. The version numbers include xx in
those fields that can vary from installation to installation. The exact
contents of these fields are not of interest in the examples in this manual, as long as appropriate digits appear in the indicated area. The
same is true for the FREE BLOCKS messages included in device directories.

If you submit a software performance report (SPR) to DIGITAL, you
must include the complete version number.
A decimal point (.) follows a number to indicate that it is a decimal
number. A number without a decimal point is an octal number. For
example, 128. is 128 (decimal) and 126 is 126 (octal).

viii

Chapter 1

Preparing for System Generation

You can build a unique RT-11 monitor through the system generation
process; however, the procedure requires some preparation. Because the
procedure lets you set the parameters for the system you want, you should
be knowledgeable about the process and also prepared with the information
and selections you will be called on to provide.
System generation can be either an interactive or an automated procedure.
You must run the program SYSGEN.COM through the IND processor and
supply answers to the questions it asks. Answers can be supplied interactively through the console or automatically through an answer file. To
complete the process, you will have to assemble and link one or more monitors and device handlers that will then reflect the parameters you set.

The system generation process requires a significant amount of mass storage space and execution time. DIGITAL has distributed four standard monitors in the distribution kit and recommends that you undertake the system
generation process only if none of these standard monitors fully meets your
needs.

Before beginning the system generation process, you should:
1.

Successfully install and test your working system.

Determine whether the features you need are available only through
-gystem generation. (Read Chapter 1 of the RT-11 Installation Guide to
assess whether or not you need to perform a system generation.)

Become familiar with the RT-11 documentation, giving special atten-

tion to the RT—-11 System User’s Guide and RT-11 System Ultilities
Manual, and to Chapter 1 of the RT-11 Installation Guide.
Become comfortable with the keyboard monitor commands and RT-11

operating characteristics.

Read the installation guide for any layered products you have. (Some of
these products require specific answers to SYSGEN questions.)

1-1

You should not attempt to perform the system generation process unless
your hardware configuration meets certain requirements.

DIGITAL supports automatic system generation (under license) only on a

system with at least 16K words of memory and 2000 contiguous free blocks
of disk storage. The minimum configuration that DIGITAL recommends for
system generation is a system with at least two disk drives and 24K words
of memory.

DIGITAL also supports system generation on RX01 and RX02 diskette systems (with at least 28K words of memory), and Professional 325 computers,
provided you use the manual procedure described in Chapter 3. However,
DIGITAL does not recommend this very lengthy method.
To prepare for system generation, you should:
1.

Study the system generation process (Section 1-1).

Gather the information or make decisions described in Section 1.2.

Study the SYSGEN dialog (Section 1-3).

You can use the worksheet at the end of this chapter (Figure 1-6) to record
information, decisions, and choices.

1.1

System Generation Process
Once you have gathered some information about your configuration, you
can run SYSGEN and answer the system generation questions to set the
parameters for your special system. The command to run the system generation process 1s:
JRUN IND.S5AV SYSGEN.COM

IND.SAYV is an indirect control file processor that uses the input file SYSGEN.COM to drive the system generation process. (Both file type specifications, .SAV and .COM, may be omitted.) However, if the command SET
KMON IND was previously issued, you can use the indirect command

@SYSGEN.

The questions that you are asked are in the form of a dialog. SYS-

GEN.COM contains the dialog and the monitor conditionals. It contains
IND directives to display explanatory text, query for options, open input
and output files, test the validity of responses, test and modify conditions,
and set values for variables. Executing SYSGEN.COM produces the following default output files:

1-2

SYSGEN.CND

SYSGEN.TBL

SYSGEN.BLD

Preparing for System Generation

SYSGEN.MON

SYSGEN.DEV

SYSGEN.ANS

SYSGEN allows you to choose your own names for them. Your responses to
the dialog establish the conditionals that SYSGEN writes to the conditional file SYSGEN.CND. SYSGEN uses some of the conditionals that it
generates to create SYSGEN.TBL, another conditional file that sets up
device table entries for each device you specify and defines device handlers.
SYSGEN.TBL is included in the assembly and link procedures for all generated monitors. (For a list of RT-11 conditionals, refer to Appendix C.)
SYSGEN also creates three indirect command files: SYSGEN.BLD, SYSGEN.MON, and SYSGEN.DEV. These files contain all the command
strings that perform the assemblies and links that build the system you
specify when you answer the dialog questions. SYSGEN.MON builds the
monitor or monitors you define; SYSGEN.DEV builds the device handlers
you define. SYSGEN.BLD executes SYSGEN.MON and SYSGEN.DEV.

SYSGEN.COM optionally creates a user-defined answer file, named SYSGEN.ANS by default. This file reflects all responses made during the system generation session, and can be used as input during a later system
generation session to generate a new monitor without running the entire

system generation dialog. When an answer file is used, SYSGEN does not
ask the dialog questions; rather, it gets all the necessary information for
the attributes of the system to be generated from the answer file. After
executing the file, SYSGEN allows you to alter the output file to reflect any
changes you wish to make, for example, to add monitor options, to support
additional peripheral devices, or to change device addresses.
Ultimately, you must assemble and link the SYSGEN.CND, SYSGEN.TBL, and (optionally) TRMTBL.MAC conditional files with certain
system source files, depending on options you choose during system genera-

tion. For example, you would need RMONSJ.MAC, the SJ resident monitor
source file, if your desired system included the SJ monitor. The conditional
file TRMTBL.MAC, which is distributed with your system software, is required only if you are building a multiterminal system. The source file
EDTGBL.MAC is always required, because it contains system-wide definitions.

Once you have answered the SYSGEN questions, copy the system source
files you need (SYSGEN.CND and SYSGEN.TBL) to the volume that the
command files use as the source input device. Then assemble and link the
sources with the conditional files (using SYSGEN.BLD alone or, if you
wish, SYSGEN.MON and SYSGEN.DEV). You can enter the commands
individually if you choose.

Figure 1-1 shows the procedures involved in the system generation process;
Figure 1-2 shows the files required for system generation.

Preparing for System Generation

1-3

Figure 1-1:

System Generation Process

PREPARE FOR

SYSTEM GENERATION

RUN SYSGEN PROGRAM,

PROCESS

AND ANSWER DIALOGUE

QUESTIONS

ASSEMBLE SYSTEM
SOURCE AND
CONDITIONAL FILES,
LINK OBJECT FILES

COPY APPROPRIATE
FILES TO
APPROPRIATE

VOLUMES

Figure 1-2:

SYSGEN Input and Output Files
DK:SYSGEN.COM

{from distribution kit)
INPUT:

DK TRMTBL
MAC

: :: M:: :
-

]

‘

BK:&YS&EM.ANQA
—- —

\‘

PROCESS:
{RUN IND SYSGEN)

DEMOMNBLD.COM //K),Q%VHL&QOM

DICIND
L BAY

e
o o oe |
\\

DK.SYSGEN.CN

’!
A
s i s

}

DKSYSGEN.TBL

DK EDTGBLMAC

wfiww@zmm
“x‘

|
/

"”w,‘
S

/
/
M:fu - - P
{optional files)

DKMACRO
SAV
DICLINK SAY

1-4

Preparing for System Generation

1.2

Gathering Information
To answer SYSGEN dialog questions, you must be familiar with both the
target system configuration (that is, the one you are generating) and your
current configuration (that is, the one on which you will run SYSGEN and
assemble and link the new monitor or monitors and handlers). You should
also know which monitor services you want in the target system and which
vector and control status register (CSR) addresses are involved. You will be
unable to perform the system build process unless you know your current
configuration and its capabilities, you have planned an optimal file arrangement for system build on your configuration, and you have answered
the relevant SYSGEN dialog questions appropriately. In addition, you may
have to edit the conditional files before you build the target system. To
make sure that you have all the information you need, identify the following:

Peripheral devices to be supported in the special system you are generating (that is, the target system)

Interrupt vector and CSR addresses for devices in the target system

Monitor services you require for the target system

Edits you may need to make to the conditional files

Device assignments for the system build procedure

The following sections describe how to identify these items.

1.2.1

Peripheral Devices

Identify all the peripheral devices that your target system configuration
will include. List the device mnemonic for each device on the worksheet at
the end of this chapter (for example, DY for an RX02 diskette).
NOTE

You may need to include some empty device slots to make
sure that your system has enough device slots for your application’s requirements. The number of logical device assignments you will be able to make in the working system is
equal to the number of device slots available in the system.

1.2.2

Interrupt Vectors and CSRs

Identify the interrupt vector addresses and CSR addresses at which the
field service technician installed each peripheral in your configuration.
When installing the hardware, the field service technician is responsible
for leaving a written record of this address information at your site, usually
on a sticker attached to the processor. List each address on the worksheet
|
(Figure 1-6).

Preparing for System Generation

1-5

Although most peripherals have standard interrupt vector and CSR ad-

dresses, some have floating addresses. The presence or absence of such
floating address devices affects the addresses at which the other floating

address devices in the system are installed. (Floating address devices must
be installed in a standard sequence.) Even devices with standard vectors
may have been installed at nonstandard addresses.

1.2.3

Monitor Services for Target Application

DIGITAL has generated the standard monitors through the system generation process; you will probably need to select support for features that

standard monitors also support. In other words, many SYSGEN questions
offer features you will recognize as standard features in the distributed
monitors. Table 1-1 summarizes special features that are available only
through the system generation process.
Table 1-1:

Features Available Only Through System Generation
Process

Feature

Function

Asynchronous

Provides a program with the updated status of terminals in

terminal status

multiterminal systems. MU BASIC-11 require this support.

BATCH

Allows RT-11 to operate unattended. All monitors except BL

support BATCH.
Device I/O

Permits device handlers to issue a mark-time programmed

timeout

request. DECnet applications require this support.

Disable .FETCH

Disables the use of the FETCH request under XM, requiring

request under
XM

device handlers to be resident in memory.

Double-

Permits you to use only double-density RX02 diskettes on the

density

system. This feature makes the RX02 handler smaller.

only RX02
DZ11 up to

9600 baud

Permits you to initialize lines at specific baud rates up to
9600.

Error logging

Keeps a statistical record of device, memory parity, and memory cache errors. An error logging job is created when you

select this support for FB; a handler is created for SJ. The EL
job retrieves information that is later available to you in summary report format.

Extra device

slots

Permits you to add devices to the system after it is built. The
number of logical assignments you can make is equal to the

number of devices plus empty device slots in the system.
Global SCCA

When global SCCA is turned on (enabled), all CTRL/C characters sent from the terminal to the background are ignored,
protecting

the program from being aborted with double
CTRL/Cs. Support must be chosen to use IND directives .EN-

ABLE ABORT and .DISABLE ABORT.
(continued on next page)

1-6

Preparing for System Generation

Table 1-1:

Features Available Only Through System Generation
Process (Cont.)
Function

Feature

fiighmsp&ed

ring buffer

Keyboard
monitor

Causes character processing and interpretation to be performed at fork level. This allows short bursts of characters
transmitted at very high rates to be received. Use of this feature is recommended with PDTs.
Allows you to choose one, two, or three subsets of the keyboard
monitor commands instead of all the commands.

command
subsets
Memory parity

Causes the system to print an error message when a memory
parity error occurs if your configuration includes memory parity hardware. If you have this hardware but do not select this

support, the system halts when memory errors occur.
Month and year
rollover

Adds support that automatically rolls over the date at the end
of the month and the end of the year. Normally, you must
reset the date and time. This support is useful for applications
that run continuously and over a long period of time.

Multiterminal

Permits you to use two or more terminals with the SJ, FB, or
XM monitor. MU BASIC-11 requires this support.

support

Multiterminal
timeout

Causes the monitor to reset at regular intervals any terminal
that goes off line. This support minimizes the impact of static
in multiterminal systems. MU BASIC-11 requires this support.

Programmable
clock as
system clock

Allows you to substitute as the system clock the KW11-P programmable clock for the usual line clock. However, the programmable clock would not then be available for program use.

Ring buffer

Allows you to change the size of the input and output ring
buffers. The input ring is a buffer in the monitor that holds
characters you type at a terminal until a program requests
them. The output ring is a buffer in the monitor that holds
characters until the terminal can print them. The default input ring buffer size is 134 (decimal) characters, and the default output ring buffer size is 40 (decimal) characters.

size

Second RX01,
RX02, or TUS8

controller
SJ message
on system

I/O errors

Adds support for a second RX01, RX02, or TU58 RX02, or
TU58 controller, allowing a total of four units in the configuration instead of the usual two.

Causes the SJ monitor to issue an error message instead of
simply halting. This feature helps to reduce confusion when
an error occurs. The FB and XM monitors always issue error
messages.

SJ timer

Configures the SJ monitor to support mark-time and cancel
mark-time programmed requests. Otherwise, only the FB and
XM monitors support these requests, which provide timer capabilities.
(continued on next page)

Preparing for System Generation

1-7

Table 1-1:

Features Available Only Through System Generation

Process (Cont.)

Feature
SPCPS
programmed
request

Function
Changes the flow of control of main-line code by saving the PC
and PS and changing the main-line PC to a new value. This
support can be generated for only the FB and XM monitors.
SPCPS is especially useful for controlling switching among
users in multiuser applications.

System jobs

Assembles the FB monitor to support as many as eight simultaneously active jobs instead of the usual two. The error logging subsystem, SPOOL, VTCOM, and the device queue program (QUEUE) can run as system jobs. This feature is available in the distributed XM monitor.

User command

Permits users to create their own commands.

linkage

Every SYSGEN dialog question is a SYSGEN option. Some options enable
support for monitor services, while other options enable support for peripheral devices and device interfaces. The options that enable monitor services
are as follows:
Asynchronous terminal status
BATCH support
Device timeout support

Error logging support
Error messages on system I/O errors
.FETCH request

Floating point support

Global .SCCA support

50 Hz clock rather than 60 Hz

High-speed ring buffer
Input ring buffer size

Keyboard monitor command subsets
Memory parity

Month and year date rollover
Multiterminal support
Multiterminal timeout
Output ring buffer size

1-8

Preparing for System Generation

Power failure message

Programmable clock as system clock
SJ timer support
SPCPS programmed request

Start-up indirect command file
System jobs

User command linkage

Section 1.3 describes each dialog question in detail. When you study the
dialog, check off on the worksheet any options you want to select when you
actually run SYSGEN.

1.2.4

Defining Other System Conditionals

Some system conditionals are not set as a result of the system generation
dialog. For example, there is no system generation question that asks if you
want idle-loop light support; therefore, the LIGH$T conditional is not set by
a response to a system generation question. However, the system genera-

tion dialog lets you define these system conditionals during the system
generation session. This feature prevents you from ever having to edit a
system generation .ANS or .CND file, since the definitions will be included
in both files.

Questions 68 and 69 of the system generation dialog let you define system
conditionals. Appendix C contains a list of the system conditionals you can
define. The following is an example of the procedure.
68+

vyou want

define

any

other system conditionals

(N)?

If you have no system conditionals to define, respond NO.

Respond YES if you want to define other system conditionals. The dialog
then prompts you to define the conditionals:
B9

Enter

the

system conditional

and

value:

Type the conditional and value in this format:

CONDITIONAL = VALUE
Press RETURN after defining each conditional. For example, the following
definition enables idle-loop light support.
LIGH$T

1Q@ET

Type a question mark (?) to list all the conditionals you have defined in this
manner. Type a period (.) followed by a carriage return when you are
through defining conditionals.

Preparing for System Generation

1-9

1.2.5

System Build Procedure

The system build procedure requires that you assemble and link your generated monitors and handlers but not the utility programs or other nonex-

ecutive system components. The SYSGEN program produces indirect command files that issue all the commands to perform these assemblies and
links. However, if your only mass storage device is an RX01 or RX02 diskette, or you are performing a system generation on a Professional 325 system, you may have insufficient free storage space to use indirect command
files. You will need to issue individual commands to perform the same
system build procedures. (Refer to Chapter 3.)
The following sections describe both system build procedures, so that you
can plan the method you will use and answer the SYSGEN dialog questions
relative to the indirect command files.
NOTE

Once you have created the conditional files SYSGEN.CND
and SYSGEN.TBL, you can use them over and over without
rerunning the SYSGEN program. To add source customizations to your generated system, simply use the SLP utility to

customize your system. Then, reassemble those files, and relink the system.
1.2.5.1

Automatic System Build —

At the end of the system generation

process, the SYSGEN dialog asks you to identify the devices that the indirect command files should use for input, binary output, and map output
during the assembly and link processes. When you answer the dialog questions and SYSGEN completes, SYSGEN has tailored the indirect command
files, so that they make the logical assignments SRC:, BIN:, and MAP:
according to your instructions. The command files then expect to find the
correct files on each device. Therefore, before you answer these questions,
you must know which files you want and how much free space you need for
the build procedure. Then you must plan the organization of files so that
you can choose the appropriate devices for SRC:, BIN:, and MAP:. Figures
1-3 through 1-5 illustrate examples of such organization.
NOTE

If you answer NO to the SYSGEN question “Do you want to
retain the system OBdJs?”, the indirect command files include
deletion commands to remove the .OBJ files.
In most cases, you can use the indirect command files to build your system,

but you may want to make minor alterations to the command files themselves. For example, you might need to change the devices on which individual source or binary files reside to optimize mass storage usage.
Study the following paragraphs, which categorize requirements by device.
Then organize files on volumes according to the:

1-10

Preparing for System Generation

Hardware you have available

Free storage you have

Storage requirements for building each component

If possible, you will want to use the largest and fastest storage devices

included in your configuration.
System Device

When you perform the system build procedures, you must run RT-11 from

a system device that contains at least the following:
Monitor

System device handler
SWAP.SYS
Handlers for SRC:, BIN:, and MAP:
MACRO
LINK

SYSMAC.SML
During the build procedure, the default (DK) device needs as many as 128
free blocks to accommodate the work file MACRO uses during system assembly.

Source Input Device

The source input device must contain the files SYSGEN.CND and SYSGEN.TBL, which are the conditional files that result from a SYSGEN session, and TRMTBL.MAC, which is required only if you plan multiterminal
support. In addition, the source device must include the system source files

to build the system you are generating.

The system source files are included in the distribution kit, but you proba-

bly did not include them in your working system. You will need to copy the
appropriate source files from your customized distribution backup vol-

ume(s). Establish which source files you need by using Table 1-2, and write

the file names on the worksheet.

Table 1-2:

Source Files Required for System Build
Source
File

To Build Support For

BA.MAC
BSTRAP.MAC
CR.MAC
CT.MAC
DD.MAC
DL.MAC
DM.MAC
DP.MAC

BATCH
All monitors
Card reader
TA11 cassette
DECtape II cartridge
RL01/02 disk
RK06/07 disk
RP11/RPR0O2/RP03
(continued on next page)

Preparing for System Generation

1-11

Table 1-2:

Source Files Required for System Build (Cont.)
Source
File

To Build Support For

DS.MAC
DT.MAC
DU.MAC
DW.MAC
DX.MAC
DY MAC
DZ.MAC
EDTGBL.MAC
EL.MAC
ELCOPY.MAC
ELINIT.MAC
ELTASK.MAC
ERRTXT.MAC
FB.MAC
FSM.MAC
KMON.MAC
KMOVLY.MAC
LD.MAC
LP.MAC
LS.MAC

RJS03/04 disk
DECtape
MSCP-class devices
RD50/RD51 disk (Professional series)
RX01 diskette
RX02 diskette
RX50 diskette (Professional series)
All monitors
Error logging
Error logging
Error logging
Error logging
Error logging
FB monitor
File-structured magtape
All monitors
All monitors
Logical disk subsetting
Line printer
Serial line printer

MTTEMT.MAC
MTTINT.MAC

Multiterminals
Multiterminals

NL.MAC
PC.MAC
PD.MAC
RF.MAC
RK.MAC
RMONFB.MAC
RMONSJ.MAC
SJ.MAC
SP.MAC
SYSGEN.CND*
SYSGEN.TBL*
TJ.MAC
TM.MAC
TRMTBL.MAC
TS.MAC

Null handler
High-speed paper tape
PDT-11 series
RF11 disk
RKO05 disk
FB or XM monitor
SJ monitor
SJ monitor
Transparent spooling
All monitors and devices
All devices
TJU16 magtape
TM11 magtape
Multiterminals
TS11,TU80/TSV05 (UNIBUS/Q-BUS)
magtape

TT.MAC
USR.MAC
VM.MAC
XC.MAC

SJ monitor
All monitors
Virtual memory “disk”
VTCOM communication for Professional 300

XL.MAC
XM.MAC
XMSUBS.MAC

VTCOM communication
XM monitor
XM monitor

series

* Or specified file name.

1-12

Preparing for System Generation

Binary Output Device

The binary output device receives the object files created by the assembly
process. Identify all the components you must build, that is, all the monitors and device handlers for which your SYSGEN answers are intended.
Then refer to Table 1-3 to establish how much free storage you will need on
the binary output device to build each of these components.

Table 1-3:

Free Storage Required to Build Components
Number of

Component

Blocks

Monitor

300

Device handler

Set of monitor object modules retained

200

Set of handler object modules retained

When a device is initialized, some space is used for the boot and directory
blocks. Table 1-4 shows the number of free blocks remaining on various
devices, after being initialized.
Table 1-4: Free Blocks on Devices After Initialization
Device

Device
Name

Size in
Blocks

RXO01 diskette

486

RXO02 diskette

974

RKO05 disk

4.8K

RL01/02 disk

10.2/20.4K

RK06/07 disk

27.1/53.TK

RX50 diskette

DU, DZ

786

RD50 disk

9.7K

RD51 disk

19.6K

RC25 disk

43K (approximate)

RAS80 disk

220K (approximate)

Virtual memory

Variable, depending
on physical memory

available

Logical disk

Variable

Map Output Device

The map output device receives the link maps that result from the linking
process. It is sometimes useful to list the link maps on the terminal or a

Preparing for System Generation

1-13

line printer, in which case you should specify TT: or LP:, respectively, for
the map output device.
If you specify the name of a block-replaceable device, such as a disk, you
can send the link maps as files to that device. Send the link maps to a disk
(instead of a terminal or line printer) so that you will be sure they are
saved. DIGITAL requires that you include a link map and answer file listing whenever you submit a Software Performance Report (SPR) for a monitor created by SYSGEN.

You can suppress the link maps altogether by sending the output to the
null device (answer NL: to the SYSGEN question “What is the name of the

map output device?”). However, DIGITAL strongly recommends saving the
link maps.

Figure 1-3:

All Files on One Disk for System Build
SYSTEM DEVICE
monitor

SWAP.SYS
system device handler
MACRO

LINK

RLO1

PIP

SYSMAC.SML
SYSBLD.COM
MONBLD.COM

DEVBLD.COM

SRC: (source input device)

SYSGEN.CND
SYSGEN.TBL
SYSGEN PROGRAM

appropriate system source files

i
EXECUTION
COM PLETE

:
BIN: (binary
output device)

MAP: (map output device)

SYSTEM DEVICE
monitor

SWAP.SYS
system device handler

MACRO

LINK
PIP

RLO1

SYSMAC.SML
SYSBLD.COM
MONBLD.COM

DEVBLD.COM

’

SRC: (source input device)

SYSGEN.CND
SYSGEN.TBL

appropriate system source files

SYSTEM BUILD

(ASSEMBLY AND LINKING)

BIN: (binary output device)

COMPLETE

receives built system liles
\

with .SYG file type

MAP: (map output device)
receives link maps in tile

1-14

Preparing for System Generation

Source Files on Second Disk for System Build
SYSTEM DEVICE
monitor

RLOT Unit O

SWAP.8YS
system device handler

MACRO
LINK
PP

SYSMAC.SML
SYSBLD.COM
MONBLD.COM
DEVBLD.COM

RLO1T Unit 1

SRC: {(source input device)

SYSGEN.CND
SYSGEN.TBL
appropriate system source files
BIN: (binary output device)
o

MAP: {(map output device)

SYSGEN PROGRAM

EXECUTION COMPLETE

SYSTEM DEVICE
RLO1 Unit O

monitor

]

SWAP.SYS
system device handler
MACRO
‘

LINK
PIP

SYSMAC.SML
SYSBLD.COM
MONBLD.COM
DEVBLD.COM

RLO1 Unit 1

SRC: (source input device)

SYSGEN.CND
SYSGEN.TBL
appropriate system source files

(

BIN: (binary output device)

receives built system files
with .SYG lile type

MAP: (map output device)

Figure 1-4:

receives link maps in file

SYSTEM BUILD
(ASSEMBLY AND LINKING)
COMPLETE

Preparing for System Generation

1-15

Figure 1-5:

Second Disk and Line Printer Receive System Build
Output
SYSTEM DEVICE
maonitor

SWAP.SYS
system device handler
MACRO

RKOS Unit O

LINK
PIP

SYSMAC.SML
SYSBLD.COM
MONBLD.COM
DEVBLD.COM
SRC: {(source input device)

SYSGEN.CND

SYSGEN.TBL
appropriate system source files

RKO05 Unit 1

afanas

Line Printer

{ BIN: (binary output device)

{ MAP: (map output device)

SYSGEN PROGRAM
EXECUTION COMPLETE

SYSTEM DEVICE
maonitor

SWAP.SYS
system device handler

MACRO

RKO5 Unit 0

LINK
PIP

SYSMAC.SML
SYSBLD.COM
MONBLD.COM
DEVBLD.COM
SRC: {source input device)

SYSGEN.CND
SYSGEN.TBL
appropriate system source files

RKO5 Unit 1

Line Printer

SYSTEM BUILD
(ASSEMBLY AND LINKING)
COMPLETE

1-16

Preparing for System Generation

BIN: (binary output device)
receives built system files

with .SYG file type

MAP: (map output device)
prints link maps

1.2.5.2

Manual System Build — You may need to use a sequence of individ-

ual commands to build the system or one or more components of the system.
Use this manual method if you do not have enough mass storage space to
execute the entire command file or if you need to rebuild a particular component because an error occurred when you built it.
In this case, specify devices included in your configuration. (Refer to the
questions asking for device names in the “Device Assignments and
SYSGEN Cleanup” section of the SYSGEN dialog.) However, you need not
plan the arrangement of files on SRC:, BIN:, and MAP:, since you will not
be using the indirect command files SYSGEN.MON, SYSGEN.DEV, and
SYSGEN.BLD to build the system automatically. You will need the indirect files for information, and you will need to arrange specific files on
diskettes in order to perform the system build procedure.
If you intend to perform the system generation process on an RX01 or RX02
diskette system, or on a Professional 325, you will have to use the manual
system build procedure, because you cannot fit all the required files on two
diskettes. Consequently, you must arrange the files so that you can copy
them to your system volume a few at a time and perform the component
assemblies. Chapter 3 provides step-by-step procedures for generating special monitors and handlers on diskette systems. Those procedures require a
special organization of files on diskettes for the assembly procedure. Study
Chapter 3 if you need to use manual system build procedures.

1.3

Studying the SYSGEN Dialog
The SYSGEN dialog is reproduced here so that you can study it. When you
run the program SYSGEN.COM, most of this dialog prints on your terminal. Some dialog questions appear only if you answered a previous question
in a specific way. Therefore, SYSGEN may not ask you all the questions
shown in this dialog.
Default answers are shown in parentheses. If you respond to a question by
pressing only ®ED, the default answer is used.
The following dialog that prints on your terminal when you run SYSGEN

appears below as actual computer output. Additional information follows
the actual SYSGEN dialog.
t A

222 X2 222

SRR X

RT-11
2222

TR R

vyou want

Tyvee

"Y"

for

Rt R

SYSTEM
R

it iR

GENERATION

introduction

PROGRAM

XX R

system

a detailed exeplanation

X2 2

deneration

TSI

(N)?

of the system denneration

Process.,

Preparing for System Generation

1-17

Respond YES if you want to read an introduction to the system generation

process.
The

Svystem

active

Generation

dialod

questions.

features

Your

the

dgenerates.

You

you

can

obtain

the

ESCAPE

Kevy

from

printing

time

during

anvy

the

exeplanations

the

that

and

with

the

SYSGEN

vour

tyeping

can

eprevent

tvyeping

then

and

Program

responses

You

of
and

for

suestion

Kevy.,

«guestions

the

waits

valid

exeplanation

exeplanation.

inter-

characteristics

RETURN

entire

pPrints

series

auestion

explanation

the

handlers

device

immediately

followed

SYSGEN

vou

and

each

detailed

functions
askKs

the

eprints
reply

pProgram

establish

monitor(s)

can

prodgram

the

answers

SYSGEN

response.,

(SYSGEN)

which

stops

waits

printing

for

vour

FresPONsSe.

SYSGEN

can

dialod

sessions

your

denerate

responses

generated

The
the

SYSGEN

dialod

want.,

RT-11

SYSTEM

The

dialod

Althoudh

for

the

cause

answers

exceprt
an

follows

each

SYSGEN

can

use

filesy

What

files

about

monitors

the

and

files:

tardet

svystem

supPOort
vou

files

these

orPtions

should

vou

read

the

proceeding,

and

waits

for

auestions

several

vector
A

vour

response.

numbereds
which

tvyrpes

use

vou

time:s

and

choose

certain

not

apply

responses.

answer

file

contained

the

and

vou

choose

the

answer

file

the

RT-11
have

obtain

vyour

distributed

distribution
created

answer

monitors

If
to

during

use

file

device

answer

instead

responses.

monitors
Kit.,

(N)?

svstem.

create
vou

auestion.

responses

that
that

to
the

created

cases

pParentheses:
the
default

<CTRL/C>.

responses

dialod

the

these

in
use

tvepe

characteristics

interactive

responses

response

previously

commands
the

any

addressesi

default

the

files

the

all

sequentially

some

RETURN

tardet

answer
ation

only

uses

included

are

one

and

vour

Answer
are

CS5R

for
the

one

denerating.,

SYSGEN

printing

However:

produce

device

before

sKip

4«question.

want

handlers

and

question

number,

SYSCGEN

determine

a
to

are

for

tvyrpe

vou

output
dive.,

conditional

effectivelvy:

GUIDE

require

octal

terminate

two

output.,

9questions

questions

vyou

aprply

the

vou

be in the form of a character stringds a numbers or
SYSGEN expects
a decimal
number for
all
numeric

expects

responsesr

vou

respond

SYSGEN

4questions

monitor

askKs

dialod

Responses may
YES/ND
(Y/N).,

simply

from

responses

produces

files

GENERATION

system

Dialod

Process

about

able

the

responses

the

session.

asks

and

monitors

session

that

command

confiduration

durind

deneration

indirect

during

system

three

one

dependindg

You

earlier

and

handlers

can

also

system

use

dener-

sessions,

answer

Tyvepe

the

want

file

devicer
create,

vou

want

filename

Use

the

to
and

use

(SYSCGEN.,ANS)?

filetvyepe

following

format

the

for

answer

vyour

file

vou

reseonse:

ddn:filnam.tye
The

variable

answer

file

filetvyrpe

1-18

ddn

1is

the

answer

Preparing for System Generation

device

resides
file

name

and

filrnam.tvye

vyou

are

unit
is

creating.

number
the

where

the

filemame

and

If the specified answer file cannot be found, has an invalid file name, or
cannot be accessed, SYSGEN issues an appropriate error message.
Do

vou

want

create

answer

file

(N)7?

Tyvepe ¥ to create an answer file that reflects the
make during this sessions This answer file can be
later SYSGEN session.
What

answer

Tyepe
want

file

vyou

want

create

responses vou
used during a

(SYSGEN.ANS)?

the device: filename and filetvyrpe of the answer file
to create, Use the followingd format for vyour response:

vou

ddn:filnam.tvep

The variable ddn is the device name and unit
answer file
is to
resides and
filnam.tye 1s
filetyrpe of the answer file vyou are creating.,

number where
the filename

the
and

If the specified answer file already exists or is invalid, SYSGEN prints the
following warning message and question:
PESYSCEN-W-File

already

create

vou

want

exists

new

ddn:filnam.tve

SYSGEN.ANS

file

(N)7

A file already exists with the same name as the answer file vou
have chosen to create.,
If vyou still want to use this name for
vour
output
answer
filey»
the
data
contained
in
the
already
existing file of the same name will be lost.

SYSGEN now checks for protected output files and prints:
vveChecKing

for

protected

outeput

files.

I any are protected, SYSGEN prints:
PSYSGEN~-F-Protected

file

already

exists

<filename3’

ERERRERERERERRRFRRRRRRERERRRERERRRR
R RERERRERREERRRRRRRRRRE R
XS

MONITOR

TYPE

HREREERREERRRREREERERRRRRERERHRRE
R
R R AR R R R RERRERRRRR AR R R RS

You must respond YES to at least one of questions 1 through 3. Each
SYSGEN run must build at least one monitor. You cannot build device
support without building a monitor.
1.

vou

want

the

sindgle-Job

(5J)

monitor

(Y)?

SINGLE-JOB MONITOR:
The single-dJdob (5J) monitor provides an environment suitable for
develorping simple FORTRAN or BASIC aepplications. The SJ monitor
includes many of the same features as the foredround/bacKground
(FB) monitor — it supports all hardware devices (excert the memory
manadement
unit)s,
all
prodrammed
requests
(excert
+MRKT
and
+CMKT)s and all the utility prodrams. It offers the most features
in the smallest size., You can add features during SYSCEN:s but at
the cost of increased monitor size.,

Preparing for System Generation

1-19

Respond YES if you want to generate an SJ monitor. Review Section 1.1.2
of the RT-11 Installation Guide to compare the advantages of the various
monitors. In addition, Appendix A in this manual gives the SYSGEN answers that will duplicate the distributed monitors.
2+

vou

want

the

foredround/bacKdround

FOREGROUND/BACKGROUND
The

that

addition

aid

the

(FB)

real-time

foreground

serialized

asvynchronous

(including

MRKT

and

monitor

(Y)7?

MONITOR:

foredround/bacKkdround

features

(FB)

Job

I/0

monitor
data

offers

carabilitys

and

acquisition

this

additional

set

applications.

extended

monitor

suPPoOrts

prodrammed

resuests

.CMKT).

Respond YES if you want to generate an FB monitor. Review Section 1.1.2
of the RT-11 Installation Guide to compare the advantages of the various
monitors.
3

vou

EXTENDED

want

the

MEMORY

extended

memory

memorys

1is

tion

(the

set

space.

that

memory

The

allow

Howeversy

requires

that

(XM)

monitors

version

(EIS):

requests

(XM)

monitor

(N)7?

MONITOR:

The

hardware

memory

the

which

the

supports

monitor.

manadement

unit)

suppPorts

monitor

vou

extend

and

the

monitor

larder

user

service

routine

124K

words

resquires

KTi1l

extended

additional

prodram’s

than

(USR)

lodical
the
be

instruc-

Prodrammed
addressing
monitor

and

resident.

Respond YES if you want to generate an XM monitor. Review Section 1.1.2
of the RT-11 Installation Guide to compare the advantages of the various
monitors.
RN

RRRRR RN RREERRRRRRRERERRRRFRERERRERRERERRRRRERRERERRR

MONITOR

OPTIONS

HRERRREEERERERERRR
R HRRRERRRRRRERRRRRERRRRRRRERRRERERRERRRRRER

Note that when you select certain options, SYSGEN automatically enables
other options, even if you respond NO to the questions. For example, if you
respond NO to SJ timer support and device timeout support but YES to
multiterminal support, SYSGEN enables SJ timer &upport and device
timeout support anyway.
4,

vou

TIMER

The

want

timer

SUPPORT

monitor

suppPort

the

monitor

(N)?

OPTION:

normally

does

not

include

timer

supPort.

You

include this suprort, which enables vou to use the .MRKT
time) and +CMKT (cancel marK time) prodrammed reauests,

can

(markK

Respond YES if you want to use the .MRKT and .CMKT programmed requests with the SJ monitor. The FB and XM monitors support these programmed requests, which provide timer capability. However, you must spe-

1-20

Preparing for System Generation

cifically select this support for SJ, since it adds approximately 360 (decimal) words to the resident monitor. Timer support reduces response time
slightly because of the additional interrupt-level overhead. If your application requires timer support, you must select it. Note also that the SJ monitor increments the date at midnight only if you select this support. RT-11
does not require it.
S

Do vou want device time-out

support

DEVICE TIME-OQOUT SUPPORT OPTION:
The device time-out option permits
(mark

time)

pProdrammed

requests,

(N)7?

device handlers
DECnet
support

to issue .MRKT
resuires
this

opPtion.

Respond YES if you are a DECnet user or if your application uses device
timeout support. RT-11 does not use this support. This support adds approximately 40 (decimal) words to the resident FB and XM monitors; it
adds approximately 360 (decimal) words to the resident SJ monitor, since
enabling this support automatically enables SJ timer support.
B

vyou want an error messadge on svystem I/70 errors

(Y)7?

ERROR MESSAGE ON SYSTEM I/0 ERRORS OPTION:
The SJ monitor normally halts if a fatal svystem I/0 error occurs.
You can rerplace this halt with a svstem error messade, DIGITAL
hidhly
recommends
this
option
1f
the
system will
be
used
by
anvone but the most experienced individuals.,

Respond YES if you want an error message instead of a system halt when
the SJ monitor detects a fatal I/O error. Although this option adds approximately 30 (decimal) words to the resident monitor, DIGITAL strongly
recommends this option for all but the most space-conscious applications.
The confusion this option saves is well worth the small amount of addi-

tional memory it requires. The FB and XM monitors include this support.
7

Do vyou want system Job surport

(N)7?

SYSTEM JOB OPTION:
The system Job option allows vou to run up to eidht simultaneopusly active Jobs. The error lodder: the SPO0OL prodgrams YTCOM:
and the QUEUE eprodgram can be either foredround Jobs or svstem
Jobs,
If
you want to
run more than one simultaneouslys or if
you want to run any one along with a foredground Jobs vyou need
system Job suPPoOTt.,

Respond YES if you want system job support. You need this support if you
use the error logger, SPOOL, VTCOM, or the device queue program
(QUEUE) as well as a foreground job, or if you use the error logger,
SPOOL, VTCOM, or QUEUE together. (Note that you need not select system job support if you intend to run the error logger only under the SJ
monitor.) You can also use system job support to create application-specific system jobs. This support adds approximately 300 (decimal) words to
the resident monitor.

Preparing for System Generation

1-21

vou want
to use the

(SPCPS

reauest

SAVE/SET MAIN-LINE PC AND
PS5 OPTION:
The
save/set
main-line
PC
and
PS5
assembled

prodrammed

+SPCPS

request

saving

the

main-line

new

values,

resauest

chandes

the

code

This

applications to control

for

(N)7

option

the

flow

control

and

PS5

and

request

and
of

monitors.

main-line

chandind

may

conditionally

the

useful

The

code

main-line

multi-user

switching amond users,

Respond YES if you want to use the .SPCPS request. Refer to the RT-11
Programmer’s Reference Manual for more information about this programmed request.
9.

vou want

global SCCA suprort

GLOBAL SCCA SUPPORT OPTION:
The
SCCA
prodrammed
reqauest
currently

issue

after
a

running

prodrammed

prodram

9lobal

prodram

SCCA

prodrammed

inhibits
Global

control/c’s
support

exits.

reguest

exits,

(N)7?

that

will

Control/c’s
request

SCCA

inhibit

will

the
vou

control/c’s

even

inhibited

until

remain

issued

until
allows

explicitly

turn

off.

10,

Do vou want multiterminal

surprort

MULTITERMINAL SUPPORT OPTION:
The
multiterminal
option
lets
requests
to
do
I/0
to more
than
supports

only

which

shared

select

one

terminal

both

multiterminal

throudh

vou

wuse

one

terminal,

interfaced

bacKdround

suppPort

for

(N)7?

throudh

and

special

the

normally

console

foredround

pProdrammed

RT-11
Jobs,

terminals

(DL11)
You

can

interfaced

choice
of
DL11
and
DZ11
interfaces.
Subsesuent
establish the number and tvyepe of interfaces. Note
that
1f
vou
choose
multiterminal
support
vour
svstem
cannot
support UT11 or VSE60 dgrarhics.,

questions

will

Respond YES if you want multiterminal support and are generating an Sd,
FB, or XM monitor. This option selects monitor support for up to 16 terminals. However, if the application itself provides support for additional terminals and if you require only console support in the monitor, you should
not select this support. MU BASIC-11 requires that you respond YES to
this question.
You need not select multiterminal support to use a hard copy terminal as a
line printer. You need only the serial line printer handler, LS.SYS, which
is included in the software Kkit.
Multiterminal support adds considerably to the space requirements of the
resident monitor. It adds a minimum of 750 (decimal) words for the first
additional terminal and approximately 100 (decimal) words for each additional terminal. However, the exact number of words added depends on the
interfaces, the configuration, and the other options you select.
11,

Do vyou want

asynchronous

terminal

status

ASYNCHRONDOUS TERMINAL STATUS OPTION:
The asvynchronous terminal status option
the
updated
status
of
a
terminal
and

1-22

Preparing for System Generation

(Y)7?

pProvides

modem.

When

prodram
a

with

Pprodram

attaches
the

terminals

the

pProdgram

can

wupdates

chandes

occur

monitor

(double

CTRL/C:

present)s

This

input

availables

surpprort

supPprly
in

outeut

required

status

word

that

the

terminal

status

buffer

emptvys

carrier

for
MU BASIC applications.,

Respond YES if you are an MU BASIC user or if your application uses
asynchronous terminal status information. If you are in doubt about this
option, respond YES. This support applies only to multiterminal applications, so SYSGEN asks you this question only if you respond YES to question 10.
12,

Do vou want multiterminal

time-out support

(Y)7

MULTITERMINAL TIME-QOUT OPTION:
Multiterminal

redgular
This

time-out

intervals)

action

problemss

helps

DIGITAL

application

suppPort

any

causes

terminal

minimize

the

recommends

the

monitor

may

have

that

imepact

selecting

requires maximum terminal

done

static

this

reset

(at

off-line.

and

option

similar
1f

vour

availability.,

Respond YES for maximum terminal availability. If you are an MU
BASIC-11 user, be sure to select this support.
This support applies only to multiterminal applications, so SYSGEN asks
you this question only if you respond YES to question 10. DIGITAL recommends that you select this option unless you have space problems.
13,

Enter the size of the output buffers

QUTPUT RING BUFFER SIZE OPTION:
The RT-11 terminal service requires
for

each

monitor

supported
that

prodram

holds

can

send

terminal,

The

characters

until

characters

(40O)¢

set

outeput
the

faster

outeut

rindg

terminal

than

rindg

buffers

buffer

can

terminal

can

the

them.,

them,)

Respond with the number (decimal) of characters that you want the monitor to hold in the output ring buffers. Each character adds n bytes to the
resident monitor size, where n is the total number of terminal lines. Note
that you must count the carriage return and line feed combination as two
characters. The range for valid responses is from 10 to 134.
14,

Enter the size of the

input buffers

(134):

INPUT RING BUFFER SIZE OPTION:
The RT-11 terminal service requires a set of ineput ring buffers
for each terminal supported, The ineput ring is a buffer in the
monitor that holds the characters that vou tvepe at a terminal
until a prodram requests them, You may want to chande the inpPut
rind sizes in pParticular: since the size vou need derends on the
terminal
‘s width and the amount of tvepe-ahead vyou exrpect.,

Respond with the number (decimal) of characters that you want the monitor to hold in the input ring buffers. If you specify an odd number of characters, SYSGEN rounds the number down. Each character adds n bytes to the
resident monitor size, where n is the total number of terminal lines.

Preparing for System Generation

1-23

You should make the input ring buffers large enough to hold at least one
line of input. If the largest line accepted by an application is greater than
134 characters, you can adjust the size of the input buffers.
The minimum acceptable input buffer size is 74 characters. If you specify
less than 74, an error occurs at monitor assembly time. The monitors require 82-character buffers for efficient command operation. Buffers larger
than 82 characters are useful if you anticipate using the type-ahead feature.

The RT-11 keyboard monitor and the .GTLIN programmed request accept
up to 80 characters. However, if your program uses the VT100 132-character mode, you should select support for an input ring buffer of 134 characters.

The range for valid responses is from 74 to 254.
15,

If
he

Do vou want
to use the

vyou choose +FETCH
fetched
by
wuser

,FETCH

vyou

not

select

Version

by Kernel APR 1

164

this
4

form of
the
+PROTECT directive
setur must be modified to do so.

options

have

all

remain

and handlers must be

+FETCH adds approx.

(V)7

surpport under XMy then device handlers can
bacKdround
prodrams.
Alsos
epre-Version
5

prodgrams which
do not
uwuse
the
which includes automatic vector
woulds

regquest under XM

in-line
clear

service
the

routines

memory

marped

loaded before use.,

400, words to the

resident monitor.

Do vou want end
of month and vear date

rollover (N)?

—

MONTH ROLLOVER OPTION:
When vou run a system continuouslys over a lond period of times
vou normally have to reset the date and time at the bedinning of

each mdnth., You can select a feature that automatically sets
correct date and time, Howevers this option dreatly increases
size of

the
the

the monitor.

Respond YES if you want the date automatically reset at the beginning of a
month or year and if space is not a serious concern. This option adds approximately 50 (decimal) words to the resident monitor.
20

Do vyou want the user command

USER COMMAND LINKAGE
The user command linKade
which
can
be
issued
in
commands
.
21+

Do vyou want high speed

linKage(Y)?

allows vou to define
a
format
similar to

rindg buffer suprort

vour own commands
the
standard
DCL

(N)?

HIGH SPEED RING BUFFER

Whern
the
high
speed
rindg
buffer
is
epresentsy
all
character
processing and
interpretation
is
performed
at
fork
level:.
The
advantadge of having the hidh speed rind buffer is that it allows
short bursts of characters coming in at a very hidh rate, This is
useful
for systems with VYT100 or other
terminals
that
report
their
status
by
sending
a
burst
of
information
to
the
host
computer,
Use
of
the
hidgh
speed
ring
buffer
is
esepecially
a PDT.,
recommended with

1-24

Preparing for System Generation

Do vou want all

the Kevboard monitor commands

(Y)7?

KEYBOARD MONITOR COMMANDS OPTION:
The

Kevboard

monitor

commands

probably

find

reduce

KMON

subset

subsets
subsets

(or

and

the

will

able

the

and

the

set

use only

vyou

choose

You

wuseful,

Howevers

vou

select

have

subsets),
The
PROGRAM
COMMANDS,

any

support

choice

UTILITY

MINIMAL

Kevboard

suepport,.

You

commands

the

will

commands.,

choose

complete
to

time

combination
of
are:
the

can

lets

monitor

commands

assembly

available

any

option

denerated

COMMANDS:

choose
be

size

vou

LANGUAGE

all

the

commands

vour

will

can

for

three

three
command
COMMANDS:
the
If

the

not

subsets:

vou

the RUN command.

Respond YES if you want support for all the keyboard monitor commands.
All the commands available with RT-11 are in the following list. If you

choose the complete set of keyboard commands, the disk (or other device)
file image of the SJ monitor is increased by 14 blocks and the image of the
FB or XM monitor by 18 blocks. If you choose one of the subsets, the monitor disk file images will be smaller.
NOTE

If you want just one or several commands, select the appropriate conditionals in Appendix C.

23,

ABORT

ASSIGN

BACKUP

BOOT
CREATE
DELETE

CLOSE
D
DIBOL

COMPILE
DATE
DIFFERENCES

COPY
DEASSIGN
DIRECTORY

DISMOUNT
EXECUTE

DUMP
FORMAT

E
FORTRAN

EDIT
FRUN

GET

HELP

INITIALIZE

INSTALL

LIBRARY

LINK

LOAD

MACRO

MOUNT

PROTECT

REENTER

REMOVE

RENAME

RESET

RESUME

RUN

SAVE

SET

SHOW

SQUEEZE

START

SUSPEND

TIME

SRUN
TYPE

UNLOAD

UNPROTECT

Do vou want

the UTILITY subset

The

following

commands

are

chosen:

are

(Y)7?

included

BACKUP

BOOT

COrY

DELETE

DIFFERENCES

DIRECTORY

EDIT

FORMAT

INITIALIZE

PROTECT

RENAME

SHOW

TYPE

UNPROTECT

Tvyee

1if

Kevboard
or

vou

vyou

want

support

monitor

commands.,.

wish

specify

Tvyrpe

when

the

UTILITY

commands

CREATE
DUMP
=~

PRINT
SQUEEZE

for

the

individual

vou

UTILITY

not

commands

subset

want

the

subset

setting

svstem

conditionals.

Preparing for System Generation

1-25

Choosing this subset increases the size of the disk (or other device) image of
the monitor file by only six blocks (rather than the 14 to 18 blocks for all
the commands). Note that you can select more than one subset; SYSGEN
asks you about the other subsets. However, SYSGEN does not ask this
question if you respond YES to question 22. Note also that the R and RUN
commands cannot be removed; they are included in all the sets of commands.
24,

Do vou want

the LANGUAGE subset

The

followindg commands

are

chosena:

are

included when the LANCUAGE commands

COMPILE

DIBOL

EXECUTE

LIBRARY

L INK

MACRO

Tyvere

Kevboard

vou

want

monitor

vou

wish

support

commands,

system conditionals

(Y)?

FORTRAN

for

Tvepe

sepecify

the

LANGUAGE

vou

individual

not

subset

want

commands

the

subset

defining

later during this SYSCEN session.

Choosing this subset increases the size of the disk (or other device) image of
the monitor file by only four blocks (rather than the 14 to 18 blocks for all
the commands). Note that you can select more than one subset. SYSGEN
does not ask this question if you respond YES to question 22. The default
response to this question is YES.
25,
The

Do vou want

the MINIMAL subset

followindg

commands

are

(¥)7

included

when

the

MINIMAL

commands

are chosen:

ABORT

HELP

ASSIGN
DATE
FRUN
INSTALL

B
DEASSIGN
GET
LOAD

CLOSE
DISMOUNT
GT
MOUNT

REENTER

REMOVE

RESET

RESUME

RUN

SAVE

SET

SRUN

START

SUSPEND

TIME

D
E

UNLOAD
Tyepe

i1f

Kevboard
or

vou

monitor

vou

wish

want

support

commands,
to

system conditionals

for

Tvee

specify

the

vyou

individual

MINIMAL

not

subset

want

commands

the

subset

defining

later during this SYSGEN session.

The execution code for all the commands in the MINIMAL subset is resi-

dent in KMON. If you select this option but do not select FB or XM monitor
support, SYSGEN does not include the commands FRUN, RESUME, and
SUSPEND. If you select this subset but do not select support for VT-11
graphics display, SYSGEN does not include the GT command. If you do not
select system job support, SYSGEN does not include the SRUN command.
Note, however, that you can select more than one subset. Choosing this
subset increases the size of the disk (or other device) image of the SJ moni-

1-26

Preparing for System Generation

tor file by only six blocks and the FB or XM monitor file by only 10 blocks
(rather than the 14 to 18 blocks for all the commands). SYSGEN does not
ask this question if you respond YES to question 22.
2B

Do vou want the optional 50 Hz clock surpport

(N)7?

50 HZ CLOCK OPTION:
A line clock denerates periodic interrupts to allow the system to
keep track of the time. The number of ticKks per second derends on
the power line freaquencys» B0 Hz or 50 Hz, RT-11 assiumes a GO Hz
line freguencys but vyou can select support for a 50 Hz clocks The
50 Hz frequency has specialized uses and is the common freauency
in Eurore.

Respond YES if your computer’s line frequency is 50 Hz.
27

Do vou want
to use the KW11-P clock as the system clock

(N7

PROGRAMMABLE CLOCK AS SYSTEM CLOCK OPTION:
RT-11 normally wses a line clock for the system clock, You can
substitute the KW11-P prodgrammable clocK as the svstem clocks but
the
KWIi1-P
will
not
then
be
available
for
eprodgram
use,
The
prodgrammable clock normally allows vou to prodgram interrupts at
preset intervals.,

Respond YES if your configuration includes the KW11-P clock and you
want to use it as the system clock. The monitor uses the system clock for
certain functions (time-of-day calculations, timer requests, and FB and XM
scheduling). If the system clock is the programmable clock, your application cannot access the programmable clock or change its rate without affecting monitor function. Therefore, DIGITAL recommends that you use a
line clock, if available, for the system clock.
30,

Do vou want the start-up indirect file

(Y27

STARTUP INDIRECT COMMAND FILE OPTION:
This

option causes the bootstrarp to execute an indirect command
file (with the name STARTx.COM:s where x identifies the monitor)
when
startindg
the
system.
An
indirect
command
file
contains
monitor commands
that
the monitor esrocesses
(in
the
order
in
which they appear) when the file is executed, A starturp indirect
command
file
is
rparticularly
useful
for
setting
up
initial
conditions (for examples assigning the default device to the data
devices
installing
a
device
into
the
system
tables
when
the
device was not oridinally built into the systems or runnindg a
specific Prodram).

Respond YES if you want the monitor bootstrap to execute a start-up indirect file every time you boot the system. If you select this support, the
bootstrap looks for a file STARTx.COM to execute (where x is S, F, or X for
single-job, foreground/background, or extended memory monitor). You create this file, with commands to perform whatever operations you choose. If
no STARTx.COM file resides on a volume, the monitor prints an error
message when you boot that volume. This option requires no additional
resident monitor space.

Preparing for System Generation

1-27

31,

vou want

floatindg point

surport

(N)7

FLOATING POINT OPTION:
If

vour

configuration

application

Floatind

reguires

pPoint
300

for

series
and

floating

features

hardware

Professional
FORTRAN

includes

this

vou

pPoint

should

available

Processors.

BASIC-11

for

This

users

whose

hardware

enable

and

this

many

PDP-11

especially

applications

vour

ortian.

and

useful
rerform

data manipPulations.

Respond YES if your configuration includes the appropriate hardware and
your application uses floating point manipulations. If you try to perform
floating point manipulations but have not selected this support, system
failure results.
If you select this support, the monitor intercepts all floating point traps. If
your program has not set up an exception handler, the monitor prints an
informative message and aborts the program. If your program has set up an

exception handler, that routine is entered with the FPU status (if appropriate) on the stack. The monitor makes sure that the correct job’s context is
set up.

In addition, if you select floating point support, the .SFPA programmed

request (refer to the RT-11 Programmer’s Reference Manual) is enabled. If
you do not choose floating point support, none of the functions of .SFPA is

performed; for example, the floating point registers are never context
switched.

If you do not include floating point support, all programs that use the
floating point instructions must set up and . PROTECT or .CNTXSW the
vector. FORTRAN IV requires monitor floating point support if you use one
of the floating point libraries.
Floating point support adds approximately 200 (decimal) words to the resi-

dent SJ and FB monitors and approximately 300 (decimal) words to the
resident XM monitor.
32

vou want memory parity

support

(N7

MEMORY PARITY SUPPORT OPTION:
If

vour

select

configuration

includes

this

Memory

option.

errors

and

RT-11

issues

when

enable
If

vyou

error

this
an

memory

this

enables

messade

error

occurs,

suPports

the

select
logger

orption
error

error
lods

Parity

have

halts

checks

support

supplies

vou

hardwares

hardware

RT-11

and

svstem

lodd9ing

Parity

memory

parity

the

this

when

for

vou

should

for

memory

the

location

hardware

memory

hardware.
of
but

errors

access
do

not

o0cCCUT.

as well as memory Parity supports
errors
as well as device errors.,

the

Respond YES if your configuration includes memory parity hardware.
Memory parity support adds approximately 8 (decimal) words to the resi-

dent SJ monitor and approximately 25 (decimal) words to the resident FB
and XM monitors. If you have this hardware, you need RT-11 memory
parity support both to make use of the hardware’s capabilities and to avoid
unwanted system halts.

1-28

Preparing for System Generation

Do vyou want power failure messades (N)7?

POWER FAILURE MESSAGE OPTION:

The

monitor

normally

halts

pPower

recovery

startur

after

power failure, You can elect to have the monitor print a messade
explaining that power failure caused the halt, However, vou must
not select this option if vou have semiconductor memorys which is
volatile.

Respond YES if you want an error message on start-up after system halt to
report the cause of the halt. Select this option only if your hardware configuration includes core memory or battery backup, not semiconductor memory (which is volatile). This option adds approximately 90 (decimal) words
to the resident monitor. However, DIGITAL strongly recommends this option, since it quickly identifies the cause of failure. Frequently, system
halts are caused by power failures too brief to detect visually.
34 .

Do vou want BATCH suprport (NJ)7

BATCH SUPPORT OPTION:

You can select support for the BATCH Job control landuade:s» which
allows RT-11 to orerate unattended. Once vou prerpare a BATCH
streams vyou can leave it for an operator to start and runs and
the BATCH stream will
execute eprodrams
oOr monitor commands
Wwithout vour interventions Indirect command file suPrrPorts which
offers similar capabilitiess
1is separately available in all
monitors. You need not select BATCH suprort to obtain indirect
command file surPPOTt.,

Respond YES if you want BATCH support. RT-11 BATCH support is similar to indirect command file support, but it offers certain advantages.
BATCH produces a log file, allows job-stream programmability, and permits the operator to interact with the job during execution. Unless you need
the features not provided by indirect command file support, you need not
select this support.
35,

Do vou want error lodgging (N)7?

ERROR LOGGING OPTION:

The error lodgdingd option creates the error lodgding (EL) svystem
in the device
incorporates error lodgdging supPrort
jobs and
(if
earity
reports devicesr memory
loddgind
Error
handlers.
selected)s and memory cache errors. When error lodgdind 1is
enableds most device handlers call EL on each successful transfer
and on each error., The EL Job retrieves information from the
handlers that is later available to vou in summary report format.

Respond YES if you want to use the error logging system job. This option
adds approximately 2000 (decimal) words to the resident monitor and 50
(decimal) words to each device handler you generate. However, error logging is usefulin monitoring system reliability.
36

How many device units does error log Job support (10)7

NUMBER OF UNITS SUPPORTED BY ERROR LOGGING OPTION:
The error lodgder can handle up to 34 individual device units.
You can conserve space by reducing the number of units the logder

Preparing for System Generation

1-29

can

handle

tardet

the

srpecific

number

suPPorted

units

confidguration.

the

Respond with the number (decimal) of supported device units in the system

you are generating. For example, if the target system has three
RKO05

drives and a dual diskette drive, the response is 5. Each unit adds seven
words to the error logger. The range for valid responses is from 1 to 34.

SYSGEN asks this question only if you respond YES to question 35.
B8 .

Do vou want

define

any

Some

the

conditionals

use

are

not

set

PDT$0P»

oprtimal

which

PDT.

conditionals

are

not

normally

which

result

causes

for

the

included

defined

the

monitors

the

SYSGEN

svstem

Respond

with

be
Y

vour

throudgh

Enter system conditional
symbol

other system conditionals
and

device

suestions.

built
if

with

vou

svystem

(N)7?
handlers

exampele

code

want

which

any

conditional

system

file

which

SYSGEN,

definition

the

form

valuye

Tyere {ESCAPE> <RETURN> for hele,
Tvrpe P<RETURN> to list user system conditional definition
s.,
Tvee +<RETURN> when all user system conditionals
have been defined,
69,

Enter the

Enter
in

svystem conditional

and

valuye:

the

svystem conditional definition as you want
system conditional (,CND) file, For EXample:

the

PDT$0P =

5 Generate

AR R

DEVICE
EREERERRRE R

PDT ortimal

R R

R R R

appear

RRE R

R R R

RN R RRR R R RN

F R R ARERR

R R R R

RRRRR R R R R R R R RN RRER RN X XRRN

Tyre {ESCAPE>» <RETURN> for hele.,
Trre P<RETURN>
to list all devices,
Tvre +<RETURN> when device selection

complete.,

Enter the
The

device name

vou want

device

orptions

let

generated

svystem

will

specific

devices

device

tables»

¥xX+8YGs

(where

vou

have

vou

and
xx

not

the

Cdd s

select

the

perirheral

selectind

maKe

the

for

support.,
the

SYSGEN

select

create

vou

support

Known

denerates

phvsical

specific

device

name)

The

following

list

associated

device

list

time

vou

return

asterisk

(%)

precede

when

have

each

carriade

vou

will

names.

entered

vou want
a list

tvepe

serparately

the

valid

RT-11

SYSGEN

will

diseplay

response
all

4question
to

the

Preparing for System Generation

mark

and

device

name

the

device

names

(Y)7

times

the

(7)

vou

the

want

will

monitor

and

their

device

name

questions

selected,

vou

named

device,

followed

name

monitor’s

the

use

the

for

handler
for

devices

device

the

of available devices

the

this

handler

that

surport

device

devices

INSTALL command before vou can access the device,

1-30

code

OPTIONS

Trre

suprport

a
An

dot

for,

A YES response causes SYSGEN to list all valid RT-11 devices and their
associated device names. An asterisk (*) precedes those devices for which
support has already been selected. Valid RT-11 devices are:
DX
DD
DL
MT
MS
LP
LD
DZ
SP
XC

RXO01 Single-Density Diskette
TU58 DECtape II
RLO1/RL0O2 Cartridge Disk
TM11 (UNIBUS) Magtape
TS11,TU80/TSV05 (UNIBUS/Q-BUS) Magtape
Line Printer
Logical Disk Handler
RX50 PRO300 Series
Transparent Spooling Handler
VTCOM Handler for PC325/350

100,

DY
RK
DM
MM
NL
DU
VM
DW
XL
LS

RXO02 Double-Density Diskette
RKO05 Cartridge Disk
RKO06/RK07 Cartridge Disk
TJU16 (MASSBUS) Magtape
Null Handler
MSCP Disk Class Handler
Virtual Memory Handler
RD50/RD51 PRO300 Series
VTCOM Communication Handler
Serial Line Printer

Do vou want support for a second <device controller (N)7

SYSGEN asks this question only if you request RX01 (DX), RX02 (DY), or

DECtape II (DD) support.

The <RX01/02 diskette or TUSB cartridde> subsvystem supPorts only
two drives for each controller,
If vour system contains four
drivessy
a
second
controller
governs
the
third
and
fourth
unitss and vou must select RT-11 support for it.

Respond YES if your target configuration includes four <device> drives.
Note that you can boot RT-11 only from Unit 0 or Unit 1.
101,

Do vyou want RX02 double density only suppPort (N)7

The R¥02
default.
slidhtly

diskette supports both sindle and double densities by
If
vou select
double-density
only
supPPort:
vyou can
improve the prerformance and
reduce the size of the

device handler.

Respond YES if you plan to use only double-density diskettes. SYSGEN
asks this question only if you request RX02 (DY) support.
102,

What is the CSR address for the <nth>» {device’ (nnnnnn)?

The valid rande for the CSR address is from 1680000 to 177370,

SYSGEN asks this question only if you request RX01 (DX), RX02 (DY), or
DECtape II (DD) support. Respond with the appropriate CSR address(es)
for the device controller(s). The field service representative who installs
your hardware system is responsible for supplying you with a written record of addresses at which he or she installs each device. The default (octal)
addresses appear in parentheses.
103,

What is the vector address for the <nth> <device> (nnn)?

For the first and second RX01, RX02, and DECtape Il controllers:
The valid rande for the vector address is from 100 to 474,

Preparing for System Generation

1-31

SYSGEN asks this question only if you request RX01 (DX), RX02 (DY), or
DECtape II (DD) support. Respond with the appropriate vector address(es)
for the device controller(s). The field service representative who installs

your hardware system is responsible for supplying you with a written rec-

ord of addresses at which he or she installs each device. The default (octal)
addresses appear in parentheses.
104,

How many disk

Respond
vour

with

RF11

the

platters
number

subsystem,

are

installed

(decimal)

The

range

on the RF11

RF11

valid

(1)7

Pplatters

resronses

included

from

SYSGEN asks this question only if you request RF11 support.
105+
Trepe

vou want RJS03

vour

rather than

rather than RJSO4 suprort

targdet

svstem

includes

an RJS04,

(Y)7

RJSO3

disk

subsvstem

If your response is NO, SYSGEN prints the following message:
RJSO4 support

assumed,

SYSGEN asks this question only if you request RJS03/04 MASSBUS fixedhead disk support.
106+

How many RLO1/RLOZ units

Enter the
RLO1/RLOZ

are to be surported

number (decimal)
of
subsystem., The rande

(2)7

RLO1/RLOZ?
of

valid

units included in vour
resronses is from 1 to 4,

SYSGEN asks this question only if you request RL0O1/RL02 cartridge disk
support.
107,
Tyrepe

Do vou want RPROZ
Y

rather

vour

rather than RPROZ/RPO3 surrort

tardet

svstem

includes

than RPROZ/RPO3,

RPROZ

(N)?

disk

subsvystem

If your response is N, SYSGEN prints the following message:
RPROZ2 and RPO3 suprport

are assumed

SYSGEN asks this question only if you request RP11 support.
108,

How many

Enter
to

110,

the

number

are

Ports

supported

vou

want

(1)7

the

MSCP

for banner padges

(Y)?

suPPOIt,

Do vou want

Tvee Y if
handler,

1-32

Ports

support

vyou want

banner

Preparing for System Generation

Pade

supPport

diskKk

class

included

handler

the

SPOOL

120,

Do vou want the file-structured magtare handler (Y)7?

FILE-STRUCTURED MAGTAPE OPTION:
RT-11 madtare surpport is available in two forms. The standard
form is file-structured madtare supports which uses a subset of
ANSI
file
format.
The
file-structured
handler
stores
and
retrieves data in a file format usable with most RT-11 svstem

prodrams. The second form of madtarpe support: hardware handler
data
and writes
reads
structuring and
file
omits
supports
directly in variable length records., While this handler is sidnificantly smaller than the file-structured handlers vou cannot
use it with any svystem prodrams. The file-structured handler can
also perform direct hardware functions.

Select this option only if you intend to use any of the system programs,
RT-11 commands, FORTRAN IV programs, or BASIC-11 programs with
the magtape.
121,

How many madtare units are to be supported (2)7

ER UNITS OPTION:
OF MAGTAPE
NUMB
The magtare handler reauires table space for each madtare unit.
You can minimize the size of the madtare handler by limiting the

number

units

can

simultaneously

actually present on the tardet machine.

handle

the

number

Respond with the number (decimal) of magtape drives included in your
magtape subsystem. SYSGEN asks this question only if you responded
YES to question 120. The range for valid responses is from 1 to 8, and the
default response is 2.
122,

What is the address of the <nth> unit (nnnnnnl?

Each T811 unit
requires two contiguous UNIBUS addresses for
status redisters.s Enter the address (octal) of the <nth> unit.
The rande of valid responses is from 1680000 to 177370,

If you request TS11 support, SYSGEN asks questions 122 and 123 once for
each TS11 tape unit you wish to support. SYSGEN asks you for the addresses of as many units as you specified. Respond with the address (octal)
of each TS11 unit. The field service representative who installs your hardware system is responsible for supplying you with a written record of addresses at which he or she installs each device.

Up to eight TS11 controllers can be supported. Default status register addresses and vector addresses are as follows:

Magtape Unit
1
2
3
4
5
6
7
8

Vector Address

172522
172526
172532
172536
172542
172546
172552
172556

224
300
304
310
314
320
324
330

Preparing for System Generation

1-33

123,

What

the

vector address

Enter

the

valid

responses
is from

130,

Does

vector

the

address

(octal) of
100 to 474,

vour Pprinter have

The

standard

line

CSR

address

vector

printer

177314,

<nth> unit

the

first

a nonstandard
vector

vour

or CS5R addresss specify

the

unit,

The

vector
or CSR

address

Pprinter

(nnn)?

200

installed

correct

and

rande

for

(N)?

the

standard

another

values,

Respond YES if the line printer control register address is not 177514 or
the vector address is not 200. These addresses usually are nonstandard only
if the printer is an LA180S.

SYSGEN asks this question only if you request parallel line printer (LP)
support, and asks questions 131 and 132 only if the response is YES.
131,

What

the CER address

Respond

with

the

printer,

The

rande

address
for

for the

valid

the

printer

control

reseponses

(177514)7
redister

from

for

1680000

the

line

177570,

The field service representative who installs your hardware system is re-

sponsible for supplying you with a written record of addresses at which he
or she installs each device.

SYSGEN asks this question only if the answer to question 130 is YES.
132,

What

Respond

the

vector address

for the

printer

with

for valid

the vector address for the
responses is from 100 to 474,

line

(200)7
printer.

The

rande

SYSGEN asks this question only if the answer to question 130 is YES.
133,

Do vyou want

Tvee

vou

personal

134,

What

Respond
line

surpport

will

for the PC300 printer port

using

the

handler

with

the

computers.,

the CSR for the

with

the

printer,

address

The

rande

serial

of
for

the

line printer

control

valid

(N)7

1775870,

series

(nnnnnn)?

redister

resrponses

PC300

for

the

from

serial

160000

NOTE

vou

173400,

answered
If

YES
vyou

auestion

answered

176300,

nos

133+
the

the

default

CSR

CSR
is

SYSGEN asks this question only if you request serial line printer (LS)

support. The field service representative who installs your hardware sys-

tem is responsible for supplying you with a written record of addresses at

which he or she installs each device.

1-34

Preparing for System Generation

135,

What
is
he vector
for the serial

line printer (nnn)?

Respond with the vector address for the serial
rande for valid responses 1s from 100 to 474,

line

printer,

The

NOTE

If
vou
answered
vector is 220, If

YES
vou

to
«auestion
answered nos

133
the
default
the default vector

is 300,

151,

MWhat

is the CER address for XL (176500)7

Enter the CSR address
152,

(octal)

of XL.

What is the vector address for XL (300)7

Enter the vector address

(octal)

of XL,

SYSGEN asks this question only if you request serial line printer (LS)
support.
Do vou want to add support for any
of vour own devices (N)7?
SYSGEN will
denerate
commands to
assemble
and
linK
any
user
supplied device handlers. SYSGEN also adds the device names to
the system device tables in DEVTBL +MAC.,
Tvere “ESCAPE» «RETURN> for hele,
Tvre P7<RETURN> to list all devices.,
Tvee +<RETURN® when device specification 1s complete,

Eriter the device name vou want support for [ddl:

Enter the 2 character device name
ing handler.
a device
are supplvy

160,

for

the

device

for

which

vou

How many extra device slots do vou want (0)7

EXTRA DEVICE SLOT OPTION:
SYSGEN
allocates
space
1in
the
monitor
for
only
the
devices
specified.
You
can
allocate
additional
sepace
by
reguesting
empty device slotss Allocate one empty slot for each device vou
intend to add to the svystem after it is built, Also Keer 1in mind
that the number of logical device assidnments vou will be able
to makKe in the runnind svstem 1% equal to the number of devices
plus empty dewvice slots in the system vou have denerated., You
may
need
to
allocate
extra
device
slots
for
lodgical
device
assidgnment

PUTPOSES.,

Respond with the number (decimal) of extra device slots you need. If a
device will be supported only by an in-line service routine in a particular
application and not by a system handler, you need not set aside a device
slot for it. Remember also to consider the number of logical device assignments you will want to make. The range for valid responses is from 0 to 32.
I

s 2222222222222
SR R 2 Rt 2 2R
2 22 22 R X X2XXX
222X XXX R0

GRAPHICS
T

R R

OPTIONS
TR
e

170,

Do vou want YT11 or USBO drarhics support (N)7?

Tvee

draphics

vour

tardet

subsvystems

configuration

RT-11

support

display handler:s UTHDLRs supports
special features of VSGRO.,

includes

for

YT11l

VUSBO

but

does

UTI11

minimal.,

not

support

Preparing for System Generation

Y5GO

The
any

1-35

171,

Tvre ¥

vyou want

the

VSB0O suprPort

drarhics

(N)7

subsystem

is YSBO,

If your response is NO, SYSGEN prints the following message:
YT11

hardware

172,

What

The

CSR

such

assumed.

the CSR address

addresses

floatindg

other

floating

Floatind

can

address

floating,

devices

address

for the UT11/USB0

devices

The

affects

Presence

the

must

the

(172000)7
or

addresses
svystem

absence

are

installed

which

the

installed,

standard

SEqUEeNCe.,

The

standard UT11/US60 CS5R

can

use

floating

nonstandard

rande

for

CSR

address

addresses,

addresses:

responses

surpply

from

172000,

vour

the

160000 to

Howevers

VYT11/VUSB0

correct

YT11/USBOs

installed

value,

The

valid

177570,

Respond with the address (octal) of the control register for the VT11 or
VS60. The range for valid responses is from 160000 to 177570. The field
service representative who installs your hardware system is responsible for
supplying you with a written record of addresses at which he or she installs
each device.
173,

What

Many

the vector addres
for the
s VT11/VSB0

devices

absence

which

the

floating

floatindg

other

installed,
standard

have

such

floatind

Floating

addresses,

devices

address

standard UT11/VUSB0O

can

use

floatind

nonstandard

vector

forvalid

vector

addresses,

Presence

the

addresses

the

system

are

installed

devices

must

address

VUT11/VUSB0O

addressess

responses

The

affects

sequence.,

The

randge

vector

address

vour

supply

from

(320)7

320,

Howevers

the

UT11/USEOs

installed

wvalue.

The

correct

100 to 474,

Respond with the vector address (octal) for the VT11 or VS60. The range for

valid responses is from 100 to 474.
AR S

A SRR
S R R R RS
l

TERMINAL

EYXLLTT

INTERFACE

TR LT TR R

R GGGy

OPTIONS

HREREEERRE
R
RR R KRR REEREREEEE
R R AR R RERERRRRRRERERRRE
EER
RE AR AR

vou want

introduction

to terminal

interface

The

introduction explains the DL interfaces
and how SYSGEN assidns the terminal numbers,

oPrtions

(N)?

supported

RT-11

SYSGEN displays the following text if your response is YES.
The

terminal

for

the

interface

terminal

suPpPports

include

the

series,

combination

DLV11,
also

Preparing for System Generation

allow

vou

select

RT-11

installed

vour

system.

RT-11

interfacess

which

serial

DLVILI-E,

supports

modem carpabilities.,

1-36

opPtions

interfaces

asvynchronous

DLVI1I-F:s

DL11-E

and

DLVI1-Js

DLVI1-E

and

surport

the

DL11

interfaces:

with

The dialog asks first for the number of local DLI1 liness» then
the number of remote DLI11 lines, The total number of lines 1is
the sum of local and remote lines and must not exceed 8 lines.
SYSGEN assidgns phvysical unit numbers of the DL11 lines first to
local
lines
and
then
to
remote
lines.,
This
assidnment
1is
permanent and vou cannot chande its order.

After SYSGEN has established the number of lines of each tvrpe it
must establish the CS5R and vector addresses for each line. The
first such «Question corresponds to the first local
line (the
console)y the second to the second local liner etcssr until all
local lines are accounted for. At that point: the next auestion
applies to the first remote lines the second to the second remote
lines etcs» until all remote lines are accounted for.,
If vour interfaces are DL11-W interfacess they should be at REV E
or hidher., If they are not, an Endineering Chande Order (ECO DEC
-0-L0OG M78B56-50002) must be arpplied to the M7B56 module., The
field service representative who installs vour hardware should
arply the ECOy if necessary.

180,

How many

supported (1)7

local DL11

liness

includindg the consolesy are to be

Enter the total number of LOCAL DL1I1 terminals included in the
tardet configurations, Since the console is alwavs a local DL11»
the response is never less than 1. Do not include REMOTE DLI11
lines in this number, Remote DL11 lines are specified in the next
questions The rande for valid responses is from 1 to 8.,
181,

How many remote DLI1 lines are to be suprported (0)7

Enter the total number of REMOTE DL1I1 terminals included in the
tardet configuration. Do not include LOCAL DL11 lines in this
number. This response must not be greater than 7.,

This response must not be greater than 7, and the sum of this response and
the response to question 180 (local DL11 lines) must be less than or equal to
8. If the total exceeds this number, SYSGEN prints the following message:
PSYSGCEN-W-Exceeded total number of valid DL11 lines
182,

What

the

CSR

address

for

the

<nth>»

Enter

the address (octal) of the DL11 interface.
valid responses is from 160000 to 177370,

DLI1
The

(nnnnnn)?
range

for

The field service representative who installs your hardware system is responsible for supplying you with a written record of addresses at which he
or she installs each device.
183,

What is the vector for the <nth> DL11

(nnn)?

Enter the
vector
address
(octal)
of
the
rande for valid responses 1s from
GO to 474,

DLI1

interface.

The

The next questions that SYSGEN asks depend on your responses to questions 180 and 181. SYSGEN repeats questions 182 and 183, asking for the
CSR and vector addresses for as many local interfaces as you specified in
question 180 and for as many remote interfaces as you specified in question

Preparing for System Generation

1-37

181. Respond with the addresses for all the local interfaces before supplying
the addresses for all the remote interfaces. Remember that the default response is in parentheses after the question.

Default CSR and vector addresses for the next local DL11 interfaces are as
follows:

CSR Address

Vector Address

176500

300

176510

310

176520

320

176530

330

176540

340

176550

350

176560

360

Default CSR and vector addresses for the next remote DL11 interfaces are
as follows:

CSR Address

184,

You

can

175610

310
320

175630

330

175640

340

175650

350

175660

360

175670

370

vouwant D211
or DZVI1

multirplexor surport

select

for

RT-11

with

multiplexors

for

four

remote

DZV11

ture

DZ11

maximum
but

RT-11

DZ11-A

DZ11-C

lines.

multieplexors.
1is

limited

suprport

auto-answer

for

mode.

Modem

have

installation).,

Tyepe

been

1if

(N)}7?

DZ11-B

DZ11-D
vou
103

the

select
is

one

available

tvyepe

modems

the

modems

¢to

"commonrn

installed

vour

eight-line
eight-line

can

support

requires

Therefore:s

must

Bell

modems

options

or DZ2V11

185,

one

additional

four-line

send"

support

liness

equivalent,
operate

Vector Address

175620

multirplexor

clear

carrier

(duringd

confiduration

and

manufac-

includes

multirlexor.,

vou want DZ11

multieplexor support

Tyere
¥ if vour confiduration

(YY)
7

includes
a D211 multielexor

SYSGEN asks you this question only if you respond YES to question 184. If
you respond NO, SYSGEN prints the message:
DZ2V11l

four-line multirlexor suprport

186,

How

Enter

the

many

DZ multiplexors

number

assumed.,

are
to be supported

multiplexors

the

(1)7

tardet

confiduration.

SYSGEN asks this question only if you respond YES to question 184.

1-38

Preparing for System Generation

The following dialog asks first for the number of local DZ11 or DZV11

lines,

then the number of remote lines. The total number of lines is the sum of
local and remote lines. SYSGEN assigns physical unit numbers of the DZ11
or DZV11 lines first to local lines and then to remote lines. This assignment
is permanent and cannot be changed.
187,

How many

Enter

the

terminals.,
188,

How

Enter

local

total

The

many

the

terminals.

lines

number

are
to be suprorted altodether

(decimal)

rande

for valid

responses

remote

are

total
The

1lines

number

rande

(decimal)

for valid

lines

from
O to

that

supported

responses

lines

(107

are

local

16,

altodether

that

from
O to

are

(017

remote

16,

The interface vectors and CSR addresses are assigned to the floating device

region and vary with each installation.
189,

What

Enter

the

rande

the

CS5R

CSR for

address

the

<nth>

for

the

DZ multirplexor
(nannnnn)?

<nth>

multiplexor.

The

valid

160000-177570,

The field service representative who installs your hardware system is re-

sponsible for supplying you with a written record of addresses at which he
or she installs each device.
190,

What

Enter

the

rande

the

vector for the <nth> DZ multirlexor

vector

address

for

the

<nth>

(nnn)?

multirlexor,

The

valid

from 60 to 474,

If the response to question 186 was greater than 1, SYSGEN requests the
CSR and vector addresses for the second through fourth DZ multiplexers.
Default values for these addresses are as follows:
a

DZ Multiplexer

CSR Address

160020

310

160030

320

160040

340

191,

What

baud

rate

The

lines

must

vou want

initialized

select 9600, 4dBOO,, 2400

Vector Address

vour

1200 3004+

lines

initialized

sepecific

150 or

baud

(300)7

rate.

You

can

110 baud.

Respond with the specific baud rate at which you want your lines initialized. All DZ11 or DZV11 lines must be initialized to the same baud rate.
The default response to this question is 300. A response other than those
listed above produces the message:
PESYSCEN~E~Invalid

baud

rate

Preparing for System Generation

1-39

At this point, SYSGEN allows you to change any préviaus responses. However, if no changes are necessary, processing continues with the creation of
the SYSGEN.CND file.
Do vou want to chande any of vour
Responses
You

are

have
now

been

diven

obtained
an

for

opPPortunity

monitor

options

which

device

add

support

number

errors

responses

vou

have

for

this

(N)7?

all

make

the

SYSGEN

minor

selected

remove

device.

vou

have

SYSGEN

session

gquestions.

chandes

the

support

for

made

largde

recommended

that

vou

restart the SYSGEN dialog.

Press @ if you do not wish to change any of your previous responses. If you
wish to change one or more dialog responses, answer YES. SYSGEN continues by asking the following questions.

Do vou want to chande monitor/terminal option

responses

(N)7TM

You may make chandes to most of the dialodg guestions concerning
the options to be assembled into the monitor. You mavy not chande
the monitor tvees to be SYSGENed, Alsosy vou may not add or remove
multiterminal support. To maKe these chandesy vou must restart
the SYSGEN dialod.,

If no monitor-related changes are to be made, SYSGEN inquires about
changes to device-related answers. If monitor changes are to be made, SYSGEN continues with the following questions.
What auestion number
do vou want

Respond

with

re-asked.

have

the

number which

re-asked?

precedes

the

The monitor option auestions which vou may

suestion

that

vou wish

chande are:

8J timer support

20+

User command

Device timeout

21+

Hidgh

B+

Svystem

22+

System Job

26+

HKevboard monitor commands
DO Hz clock

supProIt

I/0 error messades
surPPoTt

+SPCPS

89,

Global SCCA suprrPort

request
terminal

linKage

ring buffer

27+

KW11-P as system clock

30,

Startup command file

31+

Floating point

11+

Asynchronous

12,

Multiterminal

Output buffer size

33+

Power failure messade

14,

Input buffer size

34,

Batch surport

15,

+FETCH

under XM

3%+

Error logding

Month and vear

rollover support

160+

Number of empty device

170+

UT11/V8B0

any

additional

request

status

speed

timeout surport

suPPort

Memory Parity support

slots

vou

not

want

modify

grarhics

monitor

ortion

reponsess type CRETURN:
>,

Do vou want
Tyepe

"¥Y"

to chande
1if

vou

vyour device

want

suppaort

removes

add:

(N)7?
or

modify

support

for

anvy

devices.
Do

vou want

remove

suprPpport

for any

You are now given an oppOortunity
for which suprort was requested.,

1-40

Preparing for System Generation

device

(N)?

remove

support

for

any

device

If your response is YES, SYSGEN asks the following question.
What

device

vou NOT want

vou

previously

not

want

that

asKed

support

supported?
to

have

devices

for

device

tvepe

supporteds

the

two

device,

vou want
a list of

available

devices

but

letter

vyou

now

rname

for

(Y¥)7?

After you enter the two-letter device mnemonic, SYSGEN prints the message:

{devicer

will

vou

any

device

want

not

add

re-askKed

support

SYSGEN

will

supported

want

add

question

Tvee

4dive

vou

"Y"

devices

support

for

relating to

vou want

for

anvy

device

have

the

opPortunity

and

devices,

anv

vour

own

device

add

chande

support

vou

for

Tvere

your

for

"Y'

both

reseponse

vou
to

a device.,

to add/modify
a DIGITAL supported device
if

suestions

(N)}7

DIGITAL
to

surrorted,

want

device
or have suestions

add

surpport

anvy

for

any

such

device

(Y)7?

DIGITAL

supPorted

re-askKed,

If you respond YES, SYSGEN prints the following:
Tyrpe {ESCAPE><RETURN:>

for help.,

Tyere P<RETURN>® to

all

Tvrpe

list

+<RETURN» when

devices,

device

specification

Enter the device name to add/modify
Do

vou want

Tyepe
If

"Y"

vou

to
1if

want

and
it will

define or

redefine

vou

want

chande

assume

complete.,

[dd]:

any svstem conditionals

define

additional

the value
the new value.

2SS
R R
X2
R

DEVICE

ASSIGNMENTS

AND

svstem

conditionals.

conditionals

X222

SYSGEN

(N)?

redefine

222X2222222222
X2}

CLEANUP

HRERRRFRRRRRERFRRRRRRRERRRERRRRRRERRRRRRERRRERRRRRERRRRERRRRRRRR

When all responses have been given and no further changes are to be made ¥
SYSGEN begins this phase by asking the following questions:
What

the

name

the

spurce

inPut

device

process

reauires

Lxxnl

(ddn)?

SYSTEM BUILD:

The SYSGEN assembling
device
for

and

monitor

physical
more

binary
linkK

mapss

lodical

explanations

and

linKing

output

name

see

device,

The

name

(for

the RT-11

as
vou

examples

well

specify

RK1,

source

output

can

DP4,

BLD:s

input
device

either

etc.).,

For

SYSTEM GENERATION GUIDE.,

Preparing for System Generation

1-41

Respond with the device and unit number for the device on which you want
the system sources to reside during system generation. SYSGEN assigns
the logical device SRC: to the device you specify. Then, the SYSGEN command files use SRC: for source input. Review Section 1.2.5.1 if you are
unsure of the answer.
What

the

name

o f

the

binary

SYSTEM BUILD:

The
for

and

binary

monitor

physical

link

device

Lxxnl

(ddn)?

SYSCGEN assembling and

device

putrPUut

linKing

output

mars.

logical

The

name

Process

device:
name

(for

requires

well

vou

sepecify

examples

RK1,

a source

ineput

outeput

device

can

DP4,s

BLD:y

either

etcs)s

For

more explanation: see the RT-11 SYSETEM GENERATION GUIDE.,

Respond with the device and unit number for the device that you want to
receive binary and system output. SYSGEN assigns the logical device BIN:
to the device you specify. Then, the SYSGEN command files send to BIN:
the .OBJ and system files output during the system generation process.
This device can be the same as the source input device; it can also be an
independent output device or a system device. In any case, there must be
sufficient space for all the files. Review Section 1.2.5.1 if you are unsure of
the answer.
What

the

name

the

mae

outePut

device

Cxxnl

(ddn
)?

SYSTEM BUILD:

The SYSGEN assembling and
device

for

and

binary

monitor

physical

linK

mars,

lodical

linKind Process

output

devicer

The

name

(for

name

requires

well

vou

specify

exameples

RK1,

source

outrput

can

DP4,y

BLD,y

input
device

either
etcsds

For

more explanations see the RT-11 SYSTEM GENERATION GUIDE.

Respond with the device and unit number for the device that you want to
list the link maps that result when you assemble and link the system
components. SYSGEN assigns the logical device MAP: to the device you
specify. You can specify the console terminal or a line printer. Or, you can
build a file for the map listings by specifying the physical name of a blockreplaceable device such as a disk. Usually, the binary output device is
suitable for the map files as well. Note that if you submit an SPR to DIGITAL for a system that you created through the system generation process,
you must include the link maps (and the file SYSGEN.CND) for that system. Review Section 1.2.5.1 if you are unsure of the answer.
Do vou want to

The

indirect

delete

command

obJect

files

modules

that

Preparing for System Generation

(from

(Y)7?

the

which

SYSGEN
the

eprodram

system

denerates

when
the obJect modules are no londger needed, This measure serves to
conserve disk space while the svystem 15 being built, However:s the
obhdect modules are often useful later when vyou patch the svystem.
If vour output device has sufficient free spaces vou can elect to
retain all svstem obdect modules for future use.,

1-42

the

retain the svstem 0BJs

built)

Respond YES if you have abundant mass storage (approximately 500

blocks per monitor being built) and if you want to retain the system .OBJ
files for later updating purposes. Note that DIGITAL distributes monitor

updates in source form. If in doubt, respond NO. The default response to
this question is YES.
Do vyou want to
SYSGEN
These

retain the work files

creates
are

the

five
3

files

indirect

which

are

command

and

SYSGEN.DEV)

and

the

and

SYSGEN.TBL).,

vou

wish

the

system

eprocedures

build

(Y)7?

source

mount

the

entire

files

systems

SYSGENJ.CND,

user-suprplied

device

$E@SYSGEN.BLDs

To
more

build

Just

informations

Just

device

to
the

the

svystem

files

source

and

runs

tvype

(SYSGEN.CND

deleted
tvyepe

and

binary

sources

volume:

tvepe

builds:

SYSGEN.MON

the

source

monitors:

handlerssy

read the RT-11

END OF SYSGEN PROGRAM

the

SYSGEN.TBL:s

handlers

build

the

these

SYSGEN.BLDs

retained.

build

for

(SYSGEN.BLD:

conditional

have

these work files will not be

cory

used

files

after

"N"

and

volumess

for
and

anvy
tvee

$BSYSGEN.MON.

$BSYSGEN.DEY.

For

SYSTEM GENERATION GUIDE.

Preparing for System Generation

1-43

Figure 1-6:

System Generation Worksheet

Monitor Type

Monitor Options

[] 69.

DECtape

TA11 Cassette

0
]

PR
VM

PR11 Paper Tape Reader
Virtual Memory Handler

[C1100.

Second device controllers:

]
]

RX11 (N)
RX02 (N)

TUS8 (N)

[] 101.

Double-density only RX02 support (N)

SJ timer support (N)
Device timeout support (N)

Message on system /O errors (Y)
System job support (N)
.SPCPS programmed request (N)
Global SCCA support (N)
Multiterminal support (N)
Asynchronous terminal status (Y)
Multiterminal timeout (Y)
Output ring buffer size: ___ (40)
input ring buffer size: ____ (134)
.FETCH request under XM (Y)
Month and year date rollover (N)
User command linkage (Y)
High-speed ring buffer (N)
All keyboard monitor commands ()
Utility subset (Y)
Language subset (Y)
Minimal subset (Y)
50 Hz clock (N)

Programmable clock as system clock (N)
Start-up indirect command file (Y)
Floating point (N)
Memory parity support (N)
Power failure messages (N)
BATCH support (N)
Error logging (N)

Number of units supported by error logging (10)
Define other system conditionals (N)
Enter system conditional and value:
symbol = value

Device Options

O000oooooaoooooaooOoaadd

DW
DX
DY
DZ
DD
PD
RF

RD50/RD51 Winchester Disk
RXO01 Single-Density Diskette
RX02 Double-Density Diskette
RX50 Diskette (Professional 300)
TuUs58 DECtape |l

RKO05 Cartridge Disk

DL
DP
DM
MT
MM

RLO1/RLO2 Cartridge Disk
RP11 Disk Pack
RKO06/RK07 Cartridge Disk
TM11 (UNIBUS) Magtape
TJU16 (MASSBUS) Magtape

PDT-11 Intelligent Terminal
RF11 Disk

TS11 (UNIBUS) Magtape

Card Reader

Null Handler

Line Printer

LS
DU

Serial Line Printer
MSCP Disk-Class Handler

Logical Disk Handler

Single-Line Editor Handler

RJS03/04 Fixed-head Disk

PC11 Paper Tape Reader/Punch

Addresses for Peripheral Device Controllers
(Questions 102 and 103)

Vector

CSR

Controller

____(284)

(177170)

1st RX11

- (270)

(177174)

2nd RX11

___ (264)
(270
___(300)
____(310)

(177170)
(177150)
(176500)
(176510)

1st RX211
2nd RX211
1st TU58
2nd TUS8

[] 104.
] 105.
[[]106.
[]107.
[]108.
[ 110.
(] 120.

No. of disk platters on RF11 controller: __ (1)
RJS03 (not RJS04) support (Y)
No. of RLO1/RLO2 units: __ (2)
RPRO2 (not RPR0O2/RP03) support (N)
No. of MSCP ports supported: _ (1)
SPOOL flag page support (Y)
File-structured magtape handlers (Y)

god

0o000000000 OOO00Oo00oaooooooadb
B3 PO ORI R B —
b ek sedh ok b ek
2ERLBRLIBYRY BEONSOOORPOUN~O0ORNDO

(]

TTMM11 (Y)
TJU16 (Y)
TS11 (Y)

No. of magtape units supported:

O 8.

SJ monitor (Y)
FB monitor (Y)
XM monitor (N)

Transparent Spooler Package Handler
Professional Communication Port
DL(V)-11 Communication Ports

ooa

SP
XC
XL

0
0
O

(2
. )
R )

TM11
TJU16
TS11

Addresses for TS11 Units

(Questions 122 and 123)

CSR

Vector

1
2
3

(172522)
(172526)
(172532)

_(224)
___ (300)
___(304)

5
6

(172542)
(172546)

___(314)
(320

Unit

8
[} 130.
[] 131.
(] 132.
(] 133.
(J 134.

(172536)

(172552)

(172556)

___(310)

__ (324)

___(330)

Printer has nonstandard CSR/vector addresses (N)
(177514)
Nonstandard CSR address for printer:
Nonstandard vector address for printer: ___ (200)
Professional 300 printer port support (N)
(176500)
CSR address for serial line printer:

(continued on next page)

1-44

Preparing for System Generation

System Generation Worksheet (Cont.)

Figure 1-6:
135.

]

] 151.

Vector address for serial line printer: ___ (300)

] 152.

CSR address for XL:
(176500)
Vector address for XL: ___ (300)

] 160.

No. of extra device slots: ___ (0)

Support for your own devices (N)

Graphics Options

[] 170.
[J171.
[(J172.

VT11/VS60 graphics support (N)
VSB0 support (N)
CSR address for VT11/VS60:

(] 173.

Vector address for VT11/VS60: ___ (320)

(172000)

Terminal Interface Options
[]180.

No. of local DL11 lines: __ (1)

[]181.

No. of remote DL11 lines: ____ (0)

CSR and Vector Addresses for Local and Remote DL11
{Questions 182 and 183)

Local DL11 Addresses

Lines

CSR

(177560)

2
3
4
5
6
7
8

e (1786500)
(176510)
(176520)
e (176530)
|
(176540)
e (176550)
(176560)

[] 184.
[] 185.
[] 186.
[] 187.
[] 188.

Vector
— ( 80) (console)

. (300)
— (310)
— (320)
— (330)
. (340)
— {350)
— (360)

Remote DL11 Addresses

CSR

Vector

. (175610)
e (175620)
(175630)
(175640)
(175650)
(175660)
(175670)

— (310)
. (320)
— (330)
— (340)
— (350)
— (360)
— (370)

DZ11 or DZV11 multiplexer support (N)
DZ11 multiplexer support (Y)
No. of DZ muitiplexers: __ (1)
No. of local DZ lines: __ (1)
No. of remote DZ lines: __ Q)

Addresses for DZ Multiplexers
(Qumfimm 189 and 190)
Unit
1
2
3
4

[ 191.

CSR

Vector

(160010)
(160020)
(160030)
(160040)

— (300)
— (310)
— (320)
e (330)

Baud rate of lines: — 300)

Physical Device Selection and SYSGEN Cleanup
[] Source input device:
[7] Binary output device:
7] Map output device:
[] Retain system OBJs (Y)
[7] Retain work files (Y)

(ddn)
(ddn)
(ddn)

Source Files Required

Preparing for System Generation

1-45

Chapter 2

Performing the System Generation Process on a
Disk System
To perform the system generation process on a disk system, perform the
procedures summarized in the following list and described in Sections 2.1
through 2.4.

Run the program IND.SAV.

Collect the appropriate files on the appropriate media.

Assemble and link the monitor(s) and device handler(s).

The following sections correspond to each of these four procedures and describe the steps involved in each procedure. Chapter 3 describes the procedures for performing the system generation process on diskette configurations.

2.1

Running the Program IND.SAV
The first procedure in the system generation process is to run the SYSGEN

program and answer the dialog questions.

Make sure that the files IND.SAV and SYSGEN.COM are on your system
device and that the system device is not write-protected. The .COM files
can reside on another volume (except magtape) as long as the volume has
2000 free blocks and you assign the default DK: to that unit. The steps in
this section assume that these files are on the system volume.
Use the following command:
,RUN IND.SAYV SYSGEN.COMGE

(The dialog prints.)

2-1

Use the worksheet (Figure 1-6) you compiled when you read Chapter 1,
and respond to each dialog question. The dialog asks a question, waits for
your response, and resumes at the appropriate point. SYSGEN may skip
some questions, depending on the responses you give. If you are not familiar with the Version 5§ SYSGEN dialog, type
at the end of any question
to print an explanation. Type
to terminate each response.
Parentheses at the end of each question contain the default response. To

select that default response, simply type ®ED. You can terminate SYSGEN
by typing CTRLC).
If you type CRLO) whenever an explanation is printing, SYSGEN stops
printing the explanation, reprints the question, and waits for your response. Note, however, that you should not type
while SYSGEN is
printing a question; in this case, the end of the question is truncated, and
you will be unable to read the question, but SYSGEN waits for a response.

If you give an inappropriate response to a dialog question, SYSGEN prints
an error message and repeats the question. If you receive any other error
message while running SYSGEN, check the
RT-11 System Message Manual for that message.
If you want to change a response to a question, make a note of it, and
continue through the dialog. After you have answered all questions, SYSGEN will ask you if you wish to change any responses. Most responses can

be changed; however, you cannot change what monitor(s) are being built,
nor can you add or remove multiterminal support. To make these major

changes, you must rerun SYSGEN.
There is no need to edit the file SYSGEN.CND to include system condition-

als not addressed in the SYSGEN dialog. Questions 68 and 69 in the SYSGEN dialog let you define any system conditionals found in Appendix C.
The procedure for defining system conditionals is located in Section 1.2.4.

After you respond to the final system generation question, the end message
prints on the terminal and control returns to the monitor.

2.2 Collecting the Appropriate Files on the Appropriate Media
At this point, prepare to copy files to devices according to the arrangement
you planned in Section 1.2.5. Gather distribution backup copies that contain the source files you will need. Make sure the command files SYSGEN.MON and SYSGEN.DEV (and SYSGEN.BLD, if you can use it) are on
device DK..

2.3

Assembling and Linking the Monitor(s) and Device Handlers
SYSGEN creates command files to assemble and link the monitor(s) and
device handlers you are generating. These command files consist of assembly and link commands (plus file deletion commands if you chose not to

2-2

Performing the System Generation Process on a Disk System

retain the .OBJ files). You can execute the command files as they are, or
you can alter them, as long as the final commands perform the required
functions. For example, you might want to alter the command files as fol|

lows:

1. You can change the map output device to a block-replaceable device
and create a file instead of a listing. You can suppress the link maps by
sending the output to the null device, NL:. However, you will need to

include a link map and answer file listing with any SPR you might
submit to DIGITAL for a monitor created by SYSGEN. DIGITAL
recommends saving the link maps in a file on a disk, if possible, so they
will not be misplaced. You will also need the link maps if you wish to
apply software customizations.

2. You can change the devices on which individual source or binary files
are to reside to optimize mass storage use.

You can choose the indirect command file(s) you want to use to build the
system. SYSGEN creates SYSGEN.MON and SYSGEN.DEV. If you want

to build both the handlers and the monitors in the same operation and you

have sufficient free storage, use SYSGEN.BLD, a distributed indirect command file that invokes SYSGEN.MON and SYSGEN.DEV. On the other
hand, if you want to build the handlers separately from the monitors, use
SYSGEN.MON to build the monitors and SYSGEN.DEV to build the handlers.

Edit the indirect command files at this point, if necessary. Then proceed to
the section that describes the procedure you need to use:

e Using SYSGEN.BLD to build the system (Section 2.3.1)

¢ Using SYSGEN.MON and SYSGEN.DEV to build the system (Section
2.3.2)

¢ Building handlers separately (Section 2.3.3)

2.3.1

Using SYSGEN.BLD to Build the System

Generally, if you have sufficient space on the device BIN: (approximately
2000 free blocks), you should use SYSGEN.BLD to build the system. Make
sure that the disks to be used as SRC: and BIN: are mounted. Refer to
Section 1.2.5 to review your plans for the system build procedure.

Copy the appropriate source files to the device that is to serve as SRC.:. In
the following command, xxn: is your distribution backup device, unless you
put source files on one of your working system volumes when you installed
RT-11, and yyn: is SRC..

COPY xxn:filnam.MAC vyn:filnam.MACED
[]

Performing the System Generation Process on a Disk System

2-3

Then, copy SYSGEN.CND and SYSGEN.TBL to the source disk, if necessary. In the following command, xxn: is the device that contains SYSGEN.CND and SYSGEN.TBL, and yyn: is the device you specified as SRC:
near the end of the SYSGEN dialog.
,COPY xxniSYSGEN.CND vvn:SYSGEN,CNDGED
LOPY

XXniSYSGEN.TBL

v¥Yn:SYSGEN, TBLEED

Now, consolidate the free space on the binary disk. This step is very impor-

tant if you have space problems. In this command, zzn: is the device you

specified as BIN: near the end of the SYSGEN dialog.
SOUEEZE zzn : RED

zzn:/Saueeze’ Are vou sure? VEED
¢

Finally, invoke the indirect command file SYSGEN.BLD. Each command

line in SYSGEN.BLD, SYSGEN.MON, and SYSGEN.DEV logs on the terminal as the system executes the command. The following example shows

terminal output similar to the output that will print on your terminal when

you invoke SYSGEN.BLD.
,$BSYSGEN, BLDGEED
$E@SYSGEN.MON
ASSIGN DL1 SRC

ASSIGN DLO BIN

ASSIGN DLO MAP
ASSIGN DLO OBJ
MACRO/0BJ:0BJ:KMFB SRC: (FB+SYSGEN.CND+EDTGBL+KMON+KMOVLY)
MACRO/0BJ:0BJ:RMFB SRC: (FB+SYSGEN.CND+EDTGBL+USR+RMONFB)
MACRO/0BJ:0BJ:
TBFB SRC: (FB+SYSGEN.CND+EDTGBL+SYSGEN.TBL)

MACRO/0BJ:0BJ:BTFB SRC: (FB+SYSGEN,.CND+EDTGBL+BSTRAP)
MACRO/0BJ:0BJ:MEFB SRC: (FB+SYSGEN.CND+EDTGBL+MTTEMT)

MACRO/0BJ:0BJ:MIFB SRC: (FB+SYSGEN,CND+EDTGBL+MTTINT)
LINK/EXE:OBJ:RT11FB.SYG/BOU:1000/PROMPT/MAP:MAP:RT11FB OBJ:BTFB
OBJ:R
sKkMFB sMEFB sMIFB
MFB
»TBFB//
OVLYO
$@SYSGEN.DEV
ASSIGN DL1

SRC

ASSIGN DLO BIN

ASSIGN DLO OBJ
MACRO/0BJ:0BJ:BA

SRC: (SYSGEN.CND+BA)
LINK/EXE:BIN:BA.SYG OBJ:BA

MACRO/0BJ:0BJ:DX SRC: (SYSGEN.CND+D¥X)
LINK/EXE:BIN:DX.85YG 0BJ:DX
MACRO/0BJ:0BJ:RK SRC: (SYSGEN.CND+RK)
LINK/EXE:BIN:RK,.SYG OBJ:RK
MACRO/0BJ:0BJ:LP SRC: (SYSGEN.CND+LP)

LINK/EXE:BIN:LP.S5YG OBJ:LP
¢

The most common errors that can occur during the build process are listed
in Table 2-1.

2—4

Performing the System Generation Process on a Disk System

Table 2-1:

System Build Errors

Type of Error

Assembly errors

Cause*

Incorrect or conflicting responses to SYSGEN dialog.

Reexamine your responses to SYSGEN. Often,
reading the conditional files helps you spot errors.

If the SYSGEN responses seem correct, make

sure that you have the proper versions of the
source files on the source disk. Check that you

have not introduced an error if you edited the

source files. Compare the files on the source disk
to the originals in the distribution.

eMACRO-F-File not
found DEV:FILNAM.TYP

Failure to copy dev:filnam.typ to source disk,or failure to include all necessary source modules on disk.

‘MACRO-F-Device
full DEV:

Insufficient space on binary output device to accommodate all output files.

‘MACRO-F-1/0O error
on workfile

Insufficient space on default output device. Check
the following possibilities:
You did not squeeze the default device before
starting the build. Try squeezing it and rebuilding.

Try rerunning SYSGEN to specify not retaining

.OBJ files and then rebuild. Try deleting other
unnecessary files on the binary device (but be

sure they are unnecessary).

If all these techniques fail, you must build the
system manually, entering the commands individually and building one component at a time.
Refer to Chapter 3.

MACRO-F-I/0O error
n DEV:FILNAM.TYP

Bad volumes or write-protected devices.
|
|

If the volume is bad, try another.

If the device is write-protected, enable it.
* If you encounter an error you cannot explain or correct, refer to the

RT—11 System Mes-

sage Manual; if you still cannot resolve the problem, send an SPR to DIGITAL with a
listing of the answer files and link maps.

Once you have built the system, copy and store the answer files, and if
possible, the conditional, command, and output files from the generation
process. You should retain at least the answer files, if you use a generated
monitor, since all SPRs must be accompanied by a listing of these files (as
well as link maps). If you keep the object files, you can reassemble a particular component and relink manually, if necessary.

Performing the System Generation Process on a Disk System

2-5

The .SYG files that result from the system build are masters for your generated system and you should preserve them. Refer to the appropriate installation chapter in the RT-11 Installation Guide, and perform the procedures to install the generated system. Rename .SYG files, monitors and
handlers, to .SYS. You can also rename the monitor to distinguish it from

standard monitors. You will have to copy the bootstrap for the generated
monitor to your system device, if you want that monitor to boot. Note that

you can always identify a user-generated monitor by the (S) that prints in
the boot message.

2.3.2

Using SYSGEN.MON and SYSGEN.DEYV to Build the System

If you use SYSGEN.MON and SYSGEN.DEV to build the system, you need
approximately 2000 free blocks on device BIN:. Make sure that the disks
you planned to serve as SRC: and BIN: are mounted. Refer to Section 1.2.5
to review your plans for the system build procedure.
Copy the appropriate source files for building the monitor(s) to the device
that is to serve as SRC.:. In the following command, xxn: is your distribution backup device, unless you included the source files in your working
system, and yyn: is SRC..

,COPY xxn:filnam.MAC yyn:filnam.MACED
¢

Then, copy SYSGEN.CND and SYSGEN.TBL to the source disk. In the
following command, xxn: is the device that contains SYSGEN.CND and
SYSGEN.TBL, and yyn: is the device you specified as SRC: near the end of
the SYSGEN dialog.
,COPY xxn:SYSGEN.CND v»n:SYSGEN,CNDGE

,COPY xxn:SYSGEN.TBL v¥n:SYSGEN, TBLGEE
+

Now, consolidate the free space on the binary disk. In this command, zzn: is
the device you specified as BIN: near the end of the SYSGEN dialog.
,SQUEEZE zzn: @D

zzn:/Squeeze’s Are vyou sure? Y GED
¢

Next, invoke the indirect command file SYSGEN.MON to build the monitor(s). The currently running monitor logs the commands on the terminal
as it executes them. The following example shows terminal output similar
to the output that will print on your terminal when you invoke SYSGEN.MON.

2-6

Performing the System Generation Process on a Disk System

N
. MONGED
+$@SYSGE

ASSIGN DL1 SRC
ASSIGN DLO BIN
ASSIGN DLO MAP
ASSIGN DLO OBJ
MACRO/0BJ:0BJ:KMFB SRC: (FB+SYSGEN.CND+EDTGBL+KMON+KMOULY)

MACRO/0BJ:0BJ:RMFB SRC: (FB+SYSGEN.CND+EDTGBL+USR+RMONFB)
MACRO/0BJ:0BJ:
TBFB SRC: (FB+SYSGEN.CND+EDTGBL+SYSCEN,TBL)
MACRO/0BJ:0BJ:BTFB SRC: (FB+SYSGEN.CND+EDTGBL+BSTRAP)
MACRO/0BJ:0BJ:MEFB SRC: (FB+SYSGEN.CND+EDTGBL+MTTEMT)
MACRO/0BJ:0BJ:MIFB SRC: (FB+SYSGEN,.CND+EDTGBL+MTTINT)
LINK/EXE:0BJ:RT11FB.SYG/BOU:1000/PROMPT/MAP:MAP:RT11FB OBJ:BTFB
MFB
sKMFB »MEFB +MIFB»TBFB//
OBJ:R
OVLYO
¢

The most common errors that can occur during the build process are listed
in Table 2-1.

Now, delete all the source files that you needed to build the monitor(s) from
SRC:. Do not delete SYSGEN.CND or SYSGEN.TBL. In the following command, yyn: is SRC:, and aaaaaa is the file name of the source file.
+DELETE vvn: aaaaaa.MACGRED
¢

Then, copy to SRC: the source files that were used for building the handlers. In the following command, xxn: is your distribution backup device,
yyn: is SRC:, and aa is the file name of the device handler source file.
+COFY xxn:aa.MAC vyvn:aa.MACGRE

+COPY xxn:zz.MAC vy¥n:zz.MACRE
¢

Finally, invoke the indirect command file SYSGEN.DEV to build the device handlers. The monitor logs the commands on the terminal as it executes them. The following example shows terminal output similar to the
output that will print on your terminal when you invoke SYSGEN.DEV.
+$@SYSGEN,DEVEED

ASSIGN DL1 SRC
ASSIGN DLO BIN
ASSIGN DLO OBJ

MACRO/0BJ:0BJ:BA SRC: (SYSGEN.CND+BA)
LINK/EXE:BIN:BA.SYG OBJ:BA
MACRO/0BJ:0BJ:DX SRC: (SYSGEN.CND+DX)
LINK/EXE:BIN:DX.SYG OBJ:D¥X
MACRO/0BJ:0BJ:RK SRC: (SYSGEN,CND+RK)
LINK/EXE:BIN:RK.SYG OBJ:RK
MACRO/0BJ:0BJ:LP SRC: (SYSGEN.CND+LP)
LINK/EXE:BIN:LP,SYG OBJ:LP
¢

Performing the System Generation Process on a Disk System

2-7

The most common errors that can occur during the build process are listed
in Table 2-1.
Once you have built the system, copy and store the conditional, command,

and output files from the generation process, if possible. You should retain
at least the link maps and answer files, if you use a generated monitor,
since listings of these files must accompany all SPRs. If you keep the object
files, you can reassemble a particular component and relink manually, if
necessary.

Preserve the .SYG files that result from the system build; they are masters

for your generated system.
Refer to the appropriate installation chapter in the RT-11 Installation

Guide, and perform the procedures to install the generated system. Rename

SYG files, monitors and handlers, to .SYS. You can also rename the monitor to distinguish it from standard monitors. You will have to copy the
bootstrap for the generated monitor to your system device, if you want that
monitor to boot. Note that you can always identify a user-generated monitor by the (S) that prints in the boot message.

2.3.3

Building Handlers Separately

To keep the monitor as small as possible, you may want to build a monitor
with only a few device slots, or build many device handlers to go along with
that monitor but use only a few devices at a time. When you select a device

during the SYSGEN dialog, SYSGEN allocates a slot for it in the monitor

device tables and adds commands to SYSGEN.DEV that build it. To build
device handlers separately, you need to run SYSGEN twice.
First, execute SYSGEN, selecting monitor options and support for the few
devices for which you want to allocate slots. Use the resulting conditional

and command files to build the basic system. Then, rerun SYSGEN, specifying the identical monitor options but selecting only the additional devices. Use the version of SYSGEN.DEV created during the second SYS-

GEN session to build the additional handlers. Discard SYSGEN.MON and
SYSGEN.BLD files from the second SYSGEN run.
You can use one of two procedures to install additional device handlers for
the devices you want to use during a particular session.
1.

Use the REMOVE and INSTALL commands.

Use the bootstrap routine’s automatic installation capability by simply
replacing device handlers on the system device and rebooting.

Refer to Section 2.7.11 of the RT-11 Installation Guide for a description of

both procedures.

2-8

Performing the System Generation Process on a Disk System

Chapter 3
Performing the System Generation Process on a

Small System

If you intend to perform the system generation process on an RX01, RX02
or RX50 system, follow the procedures in this chapter. If your system has
two diskette units, you can perform the system generation process, but it is
not recommended. It takes a long time and is not automated. If you want to
attempt the procedures, follow all the steps in this chapter very carefully.

Do not try to generate a system for a target configuration that is different
from the diskette configuration on which you are performing the system

generation process. The procedures in this chapter may not work if you try
to generate support for many devices.

3.1

Creating a Working System for This Process
Begin the system generation process by creating a system diskette with the

SJ monitor, or the FB monitor if you are using a Professional 325 computer.

Include the following files (from your working system and distribution

backups) on the system diskette:
RT11SJ.SYS or RT11FB.SYS
|
xx.SYS (DX.SYS, DY.SYS, or DZ.SYS)

SWAP.SYS
TT.SYS
LP.SYS (if appropriate)
IND.SAV

SYSGEN.COM
DIR.SAV
PIP.SAV
DUP.SAV
Be sure to squeeze the diskette and copy the bootstrap to it. Then boot this
system.

3-1

3.2 Running the Program SYSGEN.COM
This procedure describes building only one monitor (and its associated device handlers) at a time. Run SYSGEN.COM once for each monitor you
need. Each time you run SYSGEN, answer YES to only one of the questions
that offer the various monitors. Follow the procedure in this section to build
that monitor and its associated handlers. Then run SYSGEN again to
choose another monitor. Repeat the procedure in this section to build the
monitor and handlers, and so on.

Use the following command to run the SYSGEN program.

.RUN IND,SAY SYSGEN.COMEED
(The dialog prints.)

Use the worksheet (Figure 1-6) you compiled when you read Chapter 1,
and respond to each dialog question. The dialog asks a question, waits for
your response, and resumes at the appropriate point. SYSGEN may skip
some questions, depending on the responses you give. If you are not familiar with the Version 5 SYSGEN dialog, type
at the end of any question to print an explanation. Type
to terminate each response.

Parentheses at the end of each question contain the default response. To
select that default response, simply type ®E). You can terminate SYSGEN
by typing CTRL/C).
If you type
whenever an explanation is printing, SYSGEN stops
printing the explanation, reprints the question, and waits for your response. Note, however, that you should not type
while SYSGEN is
printing a question; in this case, the end of the question is truncated, and
you will be unable to read the question, but SYSGEN waits for a response.

Answer the system build questions near the end of the dialog with the
names of devices in your configuration. Since you will read the indirect
command files (not run them), it does not matter which device is SRC:,
BIN:, or MAP..
If you want to change a response to a question, make a note of it, and
continue through the dialog. After you have answered all questions, SYSGEN will ask you if you wish to change any responses. Most responses can
be changed; however, you cannot change what monitor(s) are being built,
nor can you add or remove multiterminal support. To make these major

changes, you must rerun SYSGEN.

There is no need to edit the file SYSGEN.CND to include system condition-

als not addressed in the SYSGEN dialog. Questions 68 and 69 in the SYS-

3-2

Performing the System Generation Process on a Small System

GEN dialog let you define any system conditionals found in Appendix C.
The procedure for defining system conditionals is located in Section 1.2.4.
After you respond to the final question, the end message prints on the
terminal, and control returns to the monitor.
When SYSGEN completes, the following new files appear in your system
diskette’s directory. (See Figure 1-2.)

SYSGEN.CND
SYSGEN.TBL
SYSGEN.BLD
SYSGEN.MON
SYSGEN.DEV
SYSGEN.ANS (optional)
Using the following command, examine your directory to make sure that
these files have been created.
+DIRECTORYGED

(The directory prints.)

3.3

Collecting the Appropriate Files on the Diskettes
Because you cannot fit all the files required to build your system on two
diskettes, you must arrange the files so that you can copy them to your

system diskette one at a time and perform the component assemblies separately. First, you will need to study the indirect command files to identify
the files you will need for system build. Then, you will need to create four
diskettes to hold the various files during the build procedure.

3.3.1

System Build Indirect Command Files

To ascertain the files you need, list the files SYSGEN.MON and SYSGEN.DEYV on the terminal or line printer. These files contain the names of
all the source files you need to perform the assemblies to build the system.
They also contain all the keyboard monitor commands that assemble and
link it.
On terminal
+TYPE SYSGEN.MONGRED
+TYPE SYSGEN,DEVGEED

On line printer
+PRINT SYSGEN,MONGED
vPRINT SYSGEN.DEVEED

Performing the System Generation Process on a Small System

3-3

Figure 3—1 shows an example of SYSGEN.MON and SYSGEN.DEV (for a
multiterminal foreground/background system). Certain lines in this example are numbered for reference. For example, lines 1, 2, 3, and 4 show the
commands that assign various devices to SRC:, BIN:, MAP:, and OBJ:.

Figure 3-1:

Sample SYSGEN.MON and SYSGEN.DEYV Files

! SYSGEN EDIT LEVEL

SYSGEN.MON CREATED

19-0ct-B2

16:28:35

THIS SOFTWARE

OR COPIED IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE.

IS5 FURNISHED UNDER A LICENSE AND MAY ONLY BE USED

(ec)

ASSIGN DL1

LW DN

|
|

ASSIGN DLO BIN

1982,

1983 BY DIGITAL EQUIPMENT CORPORATION,

SRC

ASSIGN DLO MAP

Utk

ASSIGN DLO OBJ
MACRO/0BJ:0BJ:KMFB SRC: (FB+SYS5GEN.CND+EDTGBL+KMON+KMOUVLY)

=10

MACRO/0BJ:0BJ:RMFB SRC: (FB+SYSGEN.CND+EDTGBL+USR+RMONFB)
MACRO/0BJ:0BJ:TBFB SRC: (FB+5YSGEN,CND+EDTGBL+SYSGEN.TBL)

MACRO/0BJ:0BJ:BTFB SRC: (FB+SYSGEN.CND+EDTGBL+BSTRAP)

MACRO/0BJ:0BJ:MEFB SRC: (FB+SYSCGEN,CND+EDTGBL+MTTEMT)

10
11

MACRO/0BJ:0BJ:MIFB SRC: (FB+SYSGEN.CND+EDTGBL+MTTINT)
LINK/EXE:BIN:RT11FB.SYG/BOU:1000/PROMPT/MAP:MAP:RT11FB OBJ:BTFB

12
13

0BJ:RMFB +KkMFB +MEFB +MIFB +TBFB//
OvLYO
! SYSGEN EDIT LEVEL

SYSGEN.DEV CREATED

19-0ct-82

16:28:35

!
!

THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY ONLY BE USED

OrR COPIED IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE.

(c)

1982,

1983 BY DIGITAL

EQUIPMENT CORPORATION,

FALL RIGHTS RESERVED,
14

ASSIGN
DL1 SRC

15
16
17
18

ASSIGN DLO BIN
ASSIGN DDLO OBJ
MACRO/0BJ:0BJ:BA SRC: (SYSGEN.CND+BA)
LINK/EXE:BIN:BA.SYG OBJ:BA

19
20
21
22
23
24

MACRO/0BJ:0BJ:DX SRC: (SYSGEN,CND+DX)
LINK/EXE:BIN:DX.5YG OBJ:DX
MACRO/0BJ:0BJ:DL SRC: (SYSGEN.CND+DL)
LINK/EXE:BIN:DL.SYG OBJ:DL
MACRO/0BJ:0BJ:LP SRC: (SYSGEN.CND+LP)
LINK/EXE:BIN:LP.SYG OBJ:LP

Line

assembles

the

keyboard

monitor.

this

command

line,

MACRO/OBJ:OBJ: invokes the MACRO-11 assembler and specifies the

output device for the object file that results from this operation. OBJ: is the
device; note that line 2 assigns DLO: to OBJ:. Therefore, if you were to
invoke SYSGEN.MON, the object file would go to DLO:.
KMFB is the output file name. The file type is .OBJ, since MACRO creates
object files by default.

3—-4

Performing the System Generation Process on a Small System

,,,,,,

On the input side of the command string, SRC: is the input device. Line 1
assigns DL1: to SRC:. The parentheses contain the source files to be assembled. The source input files in this command string are FB.MAC, SYS-

GEN.CND, EDTGBL.MAC, KMON.MAC and KMOVLY.MAC. The system
assumes .MAC files as input to MACRO. Because the files are separated by
plus signs (rather than commas), one object file (KMFB.OBJ) results from
this assembly.
SYSGEN.MON contains commands similar to the ones in lines 9 and 10
only if you are generating a multiterminal system.
Lines 11, 12, and 13 link the monitor object modules. In the command
string, LINK invokes the linker. The option /EXE:OBJ:RT11FB.SYG specifies a device (OBJ:) and file specification (RT11FB.SYG) for the executable
file that results from this operation. The monitor created by this example is
RT11FB, but it has the .SYG file type, since it is created through the
system generation process. The option /BOU:1000 specifies the address
boundary on which LINK should start a program section to be named when
LINK asks for its name (line 13). /PROMPT allows additional lines to be
entered when the command string is too long to fit on one line. If you were
to execute SYSGEN.MON, the system would prompt with an asterisk (¥) at
line 12. Additional lines can be entered before the double slashes (//), which
indicate the end of the command string.

On the input side of the command, OBJ: is the input device. The default
LINK input file type is .OBJ. BTFB is the object file BTFB.OBJ that results from the assembly performed at line 8 RMFB is the object file
RMFB.OBJ that results from the assembly performed at line 6; and so on.
Line 13 is the name of the program section whose address boundary is
specified in the /BOU:1000 option. This line responds to the system prompt
Boundary section?, which would appear (if you were to execute SYSGEN.MON) once the command string is completed.
The command lines in the versions of SYSGEN.MON and SYSGEN.DEV
that result from your SYSGEN session are variations of the commands in
Figure 3—1. You can identify all the source files that you will need for your
assemblies if you study the command files.
When you actually assemble components, you will type each command line
in the indirect command file. Before typing the command, however, you
must copy to the system diskette the source files you need to perform that
assembly. When you type the command, you must substitute specific devices (DX0:, DYO:, or DZ0:) for SRC: and (DX1:, DY1:, or DZ1:) for BIN.:.
You will not make the device assignments in lines 1, 2, 3, 4, 14, and 15.

3.3.2

Creating System Build Diskettes

Create four diskettes for the system build procedure. SYSGEN.CND and
SYSGEN.TBL should be on your system diskette (since you have run SYSGEN). The other source files are on your backup distribution diskettes.

Performing the System Generation Process on a Small System

3-5

When you initialize each diskette, give it an identifying volume ID. For
example, to initialize Diskette 1, type:
W INITIALIZE/BAD/VOL xx1:@D
xxls/Initialize’ Are vou sure? YEED
PDUP-I-No bad blocKs detected xx1:
Volume ID? DISKETTE 1GD
Owner?
¢

Then, you can easily identify each diskette. For example, you can type:
WDIRECTORY/VOLRE
DISKETTE

3.3.2.1 Diskette Contents — The four diskettes for this procedure shduld

contain the files (but only the files) in the following lists.
Diskette 1

The system diskette for the assembly procedure should contain:

RT11SJ.SYS or RT11FB.SYS
xx.SYS (DX.SYS, DY.SYS, or DZ.SYS)
SWAP.SYS
TT.SYS
LP.SYS
MACRO.SAV
SYSGEN.CND (from the SYSGEN session you just performed)
PIP.SAV

DUP.SAV
DIR.SAV

SYSMAC.SML
yy.MAC (yy is the monitor you are building: SJ, FB, or XM)
EDTGBL.MAC
KMON.MAC
Diskette 2

The second diskette will store two .MAC source files for the second assembly. It will also receive .OBJ files produced during assemblies. It should
contain;:

USR.MAC
RMONxx.MAC (xx is SJ or FB)
Diskette 3

The third diskette will store most of the .MAC source files for the assemblies until they are needed on the system diskette. It must contain:

3-6

Performing the System Generation Process on a Small System

xx.MAC (DX.MAC or DY.MAC)
SYSGEN.TBL (from the SYSGEN session you just performed)
BSTRAP.MAC

2z.MAC (zz is device name for support specified during SYSGEN)

zz.MAC (zz is device name for support specified during SYSGEN)

Other source files, except KMOVLY.MAC (Refer to SYSGEN.MON and
SYSGEN.DEV.)
LINK.SAV

Diskette 4

The fourth diskette should contain the KMON overlays for the KMON
assembly. It will receive the KMON object file, and you will copy the other
object files to it as you assemble them on Diskette 2. Diskette 4 should
contain:

KMOVLY.MAC

3.3.2.2

Copying the Files —

Review the installation procedures in the

RT-11 Installation Guide, if necessary, when you create these diskettes. If
you run out of room when you create a diskette, squeeze the diskette to
consolidate free space. When you copy files from nonbootable diskettes, use
the COPY/SYSTEM/WAIT command. For example, type:
,COPY/SYSTEM/WAIT xxl:filnamstvp xxO:filnam.tyr@D

Mount inPut volume in xx1l:3 Continue?

Place the diskette that contains the file you want to copy in Unit 1.
Y GED
Mount outPut volume in xx0:% Continue?®

Replace the system diskette in Unit 0 with the diskette to which you want
to copy filnam.typ.

Y GED
Mount system volume in xx0:3% Continue?

Replace the newly created output diskette in Unit 0 with the system diskette.
Y

Do not forget to copy the bootstrap to Diskette 1 and to squeeze the diskettes to consolidate free space. Do not use diskettes with bad blocks. Use
the hardware bootstrap to boot Diskette 1, and set the date and time.

Performing the System Generation Process on a Small System 3-7

3.4

Assembling and Linking the Monitor(s) and Device Handlers
Now that your files are arranged on the four diskettes, you can enter
the
command lines to assemble and link the components. First, assign the logi-

cal name WF: to Unit 1 (RX01 or RX02). The MACRO-11 assembler uses a

work file during some assemblies.
,ASSIGN xx1: WF:Q@D
¢

3.4.1

Assembling Files

Insert Diskette 4 in Unit 1. Refer to your listing of SYSGEN.MON for the

first command. Ignore the command lines that begin with ASSIGN. The
source files required for this assembly are on Diskettes 1 and 4.

When you type the command, you will substitute DXn: or DYn: for OBJ:

and SRC: as shown in the following examples. You must also make other

adjustments to this first command line because of the special size constraints of the keyboard monitor assembly (always the first assembly). For

example, you must add the /ALLOCATE:150 option to the MACRO com-

mand, and you must indicate that KMOVLY resides on the diskette in

Unit 1.

The command varies according to the type of monitor being built. For ex-

ample, if you were building an FB monitor, the first assembly command

line in SYSGEN.MON would be Example 1 below; you would type the
command line displayed in Example 2. Study all these examples and your

SYSGEN.MON listing; then execute the first assembly. Press @D at the
end
of each line.

Example 1
MACRO/0BJ:0BJ:KMFB

SRC: (FB+SYSGEN.CND+EDTGBL+KMON+KMOVLY)

Example 2
,MACRO/0BJ:xx1:KMFB/ALLOCATE:150

xx0: (FB+SYSGEN. CND+EDTGBL+KMO
+xx1:KMOV
N)
L YR

NOTE

Refer to Table 3-1 if errors occur during assemblies.

The first assembly may take as long as half an hour. The exact

time depends on the amount of memory — the more memory

figuration, the faster the assembly.

amount of
in your con-

When the system completes the assembly, delete the source files KMON
from Diskette 1 and KMOVLY from Diskette 4. Leave SYSGEN.CND and
EDTGBL on Diskette 1; you need SYSGEN.CND for all assembli
es and

3-8

Performing the System Generation Process on a Small System

EDTGBL for most assemblies. After you delete these files, squeeze Diskette
1 to consolidate free space.
,DELETE xx0:KMON,MACGED

DELETE xx1:KMOVLY,MACGEED
, SQUEEZE xx0:6D

xx0:/Saueezel Are you sure? '

RT-118J V05,00

(Followed by any start-up file commands.)

Replace Diskette 4 in Unit 1 with Diskette 2. Look at the next command
line in SYSGEN.MON. Among the source files you need for the next assembly are USR.MAC and RMONxx.MAC (where xx is SJ or FB). These two
source files are on Diskette 2. The other source files you need for this
assembly are on Diskette 1. Since some of the source files are on Diskette 1
and some are on Diskette 2, you must alter the command line appropriately. For example, if the command line were Example 1 (line 6 in Figure
3-1), you would type the command line displayed in Example 2.

Example 1
MACRO/0BJ:0BJ:RMFB SRC: (FB+SYSGEN.CND+EDTGBL+USR+RMONFB)

Example 2

.MACRD/OBJ:xxI:RMFB Xxx0: (FB+SYSGEN,CND+EDTGBL) +xx1: (USR+RMONFB) RED
¢

Delete the two source files from Diskette 2 in Unit 1.
DELETE xx1: (USR»RMONFB) . MACEE

Copy the object file from this assembly from Diskette 2 to Diskette 4.
,COPY/WAIT xx1:RMFB.,0BJ xx0O:RMFB.0BJRE

Mount inPut volume in xx1:3% Continue? Y@D
Mount output volume in xx0:35 Continue? lfli
Mount system volume in xx0:3% Continue? RED
Then delete the object file from Diskette 2.
DELETE xx1:RMFB,0BJGD

Look at the next command line in SYSGEN.MON, and copy the source files
you need for that assembly from Diskette 3 in Unit 1 to Diskette 1 in Unit
0. For example, type:

TBL R
.'CDPY xx1:SYSGEN.,TBL xx0Q0:SYSGEN,
¢

Performing the System Generation Process on a Small System

3-9

Replace Diskette 3 in Unit 1 with Diskette 2. Enter the command line from

SYSGEN.MON, making the required substitutions. For example, if the

command line were Example 1 (line 7 in Figure 3-1), you would type the
command line displayed in Example 2.

Example 1
MACRO/0BJ:0BJ:
TBFB SRC: (FB+SYSGEN.CND+EDTGBL+SYSGEN,
TBL)

Example 2

+MACRO/0BJ:xx1:TBFB xxO:(FB+SYSGEN.CND+EDTGBL+SYSGEN.TBL)flfl
¢

Then, delete the source file (that you previously copied) from Diskette 1.
+DELETE xx0:SYSGEN, TBLGD

+ SQUEEZE xx0:GD

Copy the object file created during this assembly from Diskette 2 to Diskette 4, and delete it from Diskette 2.
+COPY/WAIT xx1:TBFB.OBJ xx0:TBFB.0BJGD

Mount inPut volume in xx1:3 Continue? YGED
Mount outpPut volume in xx0:3 Continue? YR

Mount system volume
in xx0:3 Continue? Y&
.DELETE xx1:TBFB.,0BJGEE
¢

Use the same procedure to perform all the assemblies in SYSGEN.MON
and SYSGEN.DEV; do not perform the link operations yet. Copy source
files from Diskette 3 to Diskette 1, and delete them from Diskette 1 after
the assembly is complete. After you perform each assembly, be sure to copy

the object file to Diskette 4 and delete it from Diskette 2.
Ignore the ASSIGN commands. When you perform the link operations, the
object files will already be on Diskette 4. The following list summarizes the
sequence of operations for each subsequent assembly.
1.

Examine the next command line. If the command does not invoke

MACRO, ignore the command line. If it invokes MACRO, establish
which source files you need for the assembly.
2.

Copy these source files from Diskette 3 in Unit 1 to Diskette 1 in
Unit 0.

Replace Diskette 3 in Unit 1 with Diskette 2.

Type the command, substituting xx0: for SRC: and xx1: for OBJ: (where
xx is DX, DY, or DZ).

Delete the source files you copied in step 2 from Diskette 1, unless you
need them for the next assembly.

3-10

Performing the System Generation Process on a Small System

6. Copy the object file from Diskette 2 to Diskette 4.
7. Delete the object file from Diskette 2.
8.

Repeat steps 1 through 7 for each assembly command line.

Now you are ready to perform the link operations.

3.4.2

Linking Files

Copy LINK from Diskette 3 to Diskette 1.
, COPY xx1:LINK.SAY xx0:ED
¢

Mount Diskette 4 in Unit 1. Find the monitor LINK command in SYSGEN.MON. Type the command, substituting xx1: for OBJ:. Substitute LP:
for MAP: if you want to send the link map to the line printer. Substitute
TT: for MAP: if you want to send the link map to the terminal. For example, if the command lines were Example 1 (lines 11, 12, and 13 in Figure
3-1), you would type the command lines displayed in Example 2.
Example 1
LINK/EXE:BIN:RT11FB.SYG/BOU:1000/PROMPT/MAP:MAP:RT11FB OBJ:BTFB
»TBFB//
»MEFB sMIFBFB
:RM
sKMFB
0BJ
OVLYO

Example 2
«LINK/EXE:xx1:RT11FB.SYG/BOU: IUUU/PRDMPT/MQP LP: RTIIFB xx1:BTFBED
#BIN:RMFB
KMFB yMEFB sMIFB +TBFB/ /G

Boundary section? OVLYOGE

NOTE

Save the link map that results. If you ever need to submit an
SPR to DIGITAL for your specially generated monitor, you
must include the monitor link map with the SPR.
Now find the next LINK command in SYSGEN.DEV. The LINK commands
in SYSGEN.DEYV link the device handlers for which you requested support
when you ran SYSGEN. Type all the link commands, making substltutlons
for BIN:.

The resulting linked components on Diskette 4 have the file type .SYG. The
SYG files are masters for your generated monitors and handlers, and you
should preserve them. Back up the generated system and store the backup.
Copy the .SYG files to another diskette, along with any other components

(for example, utility programs) you need in your working system. Refer to
the appropriate installation chapter in the RT-11 Installation Guide, if
necessary, to install the generated system. Rename the .SYG files, monitors and handlers, to .SYS. You can also rename the monitor to distinguish

Performing the System Generation Process on a Small System

3-11

it from standard monitors. You will have to copy the bootstrap for the

generated monitor to your working system device if you want that monitor
to boot. Note that you can always identify a user-generated monitor by the

(S) that prints in the boot message.
Once you have built the system, store the conditional, command, and output files from the generation process. You must retain at least the link

maps and answer files, since a listing of these files must accompany all
SPRs, if a custom monitor is used.

Table 3-1:

System Build Errors

Type of Error

Assembly errors

Cause*

Incorrect or conflicting responses to SYSGEN dia-

log.

Reexamine your responses to SYSGEN. Often,
reading the conditional files helps you spot errors.

If the SYSGEN responses seem correct, make
sure that you have the proper versions of the
source files on the source disk. Check that you
have not introduced an error if you edited the
source files. Compare the files on the source disk

to the originals in the distribution.

MACRO-F-File not
found DEV:FILNAM.TYP

Failure to copy dev:filnam.typ to source disk or failure to include all necessary source modules on the
disk.

¢MACRO-F-Device
full DEV:

‘MACRO-F-1/0 error
on workfile

Insufficient space on binary output device to accommodate all output files.

Insufficient space on default output device. Check
the following possibilities:
You performed the system build manually but
did not assign the work file (or the work file
needs more space).
You did not squeeze the default device before
starting the build. Try squeezing it and rebuilding.

‘MACRO-F-I/0O error

Bad volumes or write-protected devices.

on DEV: :FILNAM.TYP

If the volume is bad, try another.

FILN.

If the device is write-protected, enable it.
* If you encounter an error you cannot explain or correct, refer to the RT—11 System Mes-

sage Manual; if you still cannot resolve the problem, send an SPR to DIGITAL with
listings of the link maps and answer files.

3-12

Performing the System Generation Process on a Small System

Appendix A

SYSGEN Answers That Will Duplicate the Standard
Monitors

Sections A.1 and A.2 list the answers DIGITAL gave to create the standard
(distributed) FB and XM monitors. Section A.3 lists all the SYSGEN questions, without the descriptive text.

A.1

SJ and FB Monitors
1,
2,
3,
4.,
5,

Y
Y
N
N
N

7.
8,
9,
10,

N
N
N
N

B’

\|l

11,

skipped

13,

15,

skipped

20,

14,

134

22,

23,
24,
25,

skipped
skipped
skipped

26,
27,
30,
31,
32,

33,
34,
35,

36,

68,

N
N
Y
Y
N

N
N
N

skipped

A-1

Enter the device name vou want support for [ddl: DX
N
100,
102,
103,

177170
264

Enter the next device name

100,
101,
102,
103,

N
N
177170
264

Enter the next

100,

device name

[ddl: DY

[dd]l:

[dd]:

102,

176300

103.

300

Enter the next device name

Enter the next device name [dd]l: RF
1
104,
Enter the next device name

[dd]:

Enter the next device name

[dd]:

106,

Enter the next device name

107,

Enter the next device name

[dd]: DM

Enter the next

[dd]l:

120,
121,

device name

Y
il

Enter the next device name [dd]: MM

1200
121,

Y
il

Enter the next device name

120,
121,
122,
123,
122,

Y
2
172522
224
172326

123,

300

[ddl:

Enter the next device name [dd]: CR
Enter the next device name

[dd]: NL

Enter the next device name [dd): LP
130,
N
Enter the next device name
1
108,

[dd]: DU

Enter the next

device name

[ddl:

Enter the next

device name

[ddl:

Enter the next

device name

[dd]:

Enter the next device name

[ddl: DW

Enter the next device name [dd]: SP
1100
Y

A-2 SYSGEN Answers That Will Duplicate the Standard Monitors

Enter the next device name [dd]: AL
151,

176500

152,

300

Enter the next device

name

[dd]:

Enter the next device
133,
Y

name

Cddl:

Enter the next device

name

Ldd]:

Enter the next device

name

Cddl:

device

name

Cddl:

Enter the next device

name

Cddl:

134,

173400

135,

220

105,

Enter the next

170,

+ BED

XM Monitor
1,

skipped

10,

11,

skipped
skipped

12,

13,
14,

15,
16,

20,

21,

23
24,
235,

26,

27
30,
31,
32,
33,
34,

35
68,

‘

134

skipped
skipped
skipped
Z2Z2Z2Z2Z2X<XZ2Z2

A.2

160,

Enter the device name You want support for [dd]:
100,
N
102,
177170

103,

264

Enter the next device name
100,

101,

102,

177170

103,

264

[ddl:

SYSGEN Answers That Will Duplicate the Standard Monitors

A-3

Enter the next device name [ddl: pp
1000

102,
103,

176500

300

Enter the next device name [ddl: i
Enter the next device name [ddl:

Enter the next device name [ddl: py
Enter the next device name [ddl: w7
120,

121,

Enter the next device name [dd]: mm
1 20 +

\lf

Enter the next device name [ddl: g
120,

122,

123,

122,
123,

172522

172526

300

Enter the next device name [ddl:
Enter the next device name [ddl: |p
1300

Enter the next device name [ddl: gy
Enter the next device name [ddl: | p
Enter the next device name [ddl: ypy

Enter the next device name [ddl: p>
Enter the next device name [ddl: py
Enter the next device name [ddl: gp
110,

Enter the next device name [ddl: |

151,

1768500

Enter the next device name [ddl: vp
Enter the next device name [ddl: | g
1330

134,

1350

173400

220

Enter the next device name [ddl: , @ED
160,

A—-4

SYSGEN Answers That Will Duplicate the Standard Monitors

A.3

SYSGEN Questions
Do

vou want

Do vyou want
What

introduction

to use

answer file

Do You want

vou want

Do vyou want
Do

created

to use

vou want

vyou want

(N)7?

create

(SYSGEN.ANS)?

(N)7

TYPE

the sindle-Job

(S5J)

monitor

the foredround/backdround
the

MONITOR

extended memory

(XM)

(Y)7

(FB)

(Y)7?

(N)7?

OPTIONS

Do vyou want timer support

vou want device

vou want an error messade

vou

8.,

Do vyou want to use the .SPCPS reguest (N)7

vou want

10,

vou want multiterminal

11+

vou want

12,

Do vou want multiterminal

13+

Enter the

14,

Enter the size of

the

input

15,

vou want

the

FETCH

16.

vou want end
of month and

vear date

20,

vou want

linKade

21,

Do vou want hidh-speed

224

23+

Do vou want the UTILITY subset

24,

Do vou want the LANGUAGE subset

25+

Do vou want the MINIMAL subset

(Y)7

26+

vou want

the

clock

27+

vou want

to use

30,

vou want

the

timeout

the SJ monitor

surpport

suprport
terminal

the

status

(Y)?

buffers

(Y)?

(40):
(134):

request

under ¥M

(N)7?
(YY)
7

(¥Y)7
(Y)7?

the KWI1-P clock

start-ur

(N)?

(N)7?

Kevboard monitor commands

50 Hz

(¥Y)7?

rollover

ring buffer support

optional

(Y)7?

(N)7

timeout support

the user command

all

errors

(N)7?

the output buffers

use

I/0

(N)7?

global SCCA supprort

asynchronous

(N)?

(N)7?

on svystem

svstem
Job support

size of

vou want

monitor

4.,

want

(N)?

(SYSGEN.ANS)?

an answer file

vou want

(N)7?

answer file

to create
a new SYSGEN,ANS file
MONITOR

svstem deneration

a previously

Do vou want to create
What

support

indirect file

(N)7?

the system clock

(N)7

(Y)?

SYSGEN Answers That Will Duplicate the Standard Monitors

A-5

vou want

floating Point support

vyou want memory

pParity

suppaort

(Y)7?
(N)7

Do vou want power failure messades

Do vou want BATCH support

(N)7

Do vou want error lodgding

(N)?

(N)7

How many device units does error lodg Job support
Do vyou want

to define any

(1037

other svystem conditionals

(N)7?

Enter the svystem conditional and value:

DEVICE OPTIONS
Enter the device mame vou want support for [ddl:
Do vyou want a list of available devices

(Y)7?

100,

vou want surport for
a second <devicer controller

101,

vo W want RXO0Z double-density

102,

What

is the CSKk address for the <nth> <device>

103,

What

is the vector address for the <nth> <device>

104,

How many disk platters are

105,

Do vou want RJS0O3 rather than RJS04 suprport (Y)7?

106,

How many RLOL/RLOZ units are to be supported

107,

Do vou want RPROZ rather than RPROZ2/RPO3 support

108,

How many ports are
to be supported

110,

Do vou want support for banner pades

120,

Do vou want the file-structured madtare handler (Y)7?

121¢

How many madgtare units are to be supported

122,

What is the address of the <nth} unit

123,

What

130,

Does

vour printer have a nonstandard vector
or CS5R (N)?

131,

What

is the CS5R address for the printer

132,

What

is the vector address for the printer (200)7

133,

Do vyou want support for the PC300 printer port

134,

What

is the CSR for the serial

135,

What

is the vector for the serial

151,

What

is the CSR address for XL (1768500)7

152,

What

is the vector address for XL

only support

(nnnnnn)?
(nnn)?

(1)7?

(2)7

(N)7?

(1)7

(Y)7

(2)7

(nnnnnn)?

the vector address of the <nth> unit

(nnn)?

(177514)7

line printer

(N)7?

(176500)7

line printer

(300)7

vyour own devices

Enter the device name vou want surpport for [ddl:
160,

(N)7?

installed on the RF11

Do vyou want to add suprport for any of

(N)7?

How many extra device slots do vou want

(0)7

A—6 SYSGEN Answers That Will Duplicate the Standard Monitors

(N)7?

GRAPHICS

DOPTIONS

170,

Do vou want UT11
or USB0 grarhics surport

171,

Do vou want US560 support

172,

What

is the CSR address for the VT11/VSB0O

173,

What

is the vector address for the YT11/VU860
TERMINAL

Do vou want an

INTERFACE

(N)7

(N)7?

(172000)7
(320)7

OPTIONS

introduction to terminal

(N)7?

180,

How many local DL11
supported (1)7

181,

How manvy

182,

MWhat is the CS5R address for the <nth> DL11

183,

MWhat

184,

Do vou want DZ11
or DZV1I1 multirplexer support

185,

Do vouwant DZ11 multirlexer support

186+

How many DZ multiplexers are
to be suppPorted

187+

How many

local DZ lines are
to be supported altogether

188,

How manvy

remote DZ lines are to be surprported altogether

189,

What

is the CSR for the <nth> DZ multirlexer (1B0010)7

190,

MWhat

is the vector for the <nth? DZ multirplexer

191+

What baud

remote DL11

liness

interface orPtions

including the consoles are to be

lines are to be suprported

is the vector for the

<nth>

DL11

(0)7?

(177360)7

(B0O)7?
(N)7?

(Y)
7
(1)7
(1)7
(0)°7

(300)7

rate do vou want vour lines initialized to

(300)7

ba vyou want to chande any of vour responses (N)7?
Do vyou want to chande monitor/terminal
What question number
do vou want

option

(N)?

re-asked?

Do vou want to chande vour device suprPort
Do vou want to

resronses

(N)7?

remove support for any device

(N)7?

What device do vou NOT want supported?

Do vou want a list of available devices

(Y)7

Do vyou want to add suprport for any device or have the suestions for
any device re-asked (N)7?
Do

vyou want to add/modify
a DIGITAL suprorted device

Enter the device name to add/modify

(Y)7?

[ddl:

Do vou want to define or redefine anvy svystem conditionals
DEVICE

SELECTION

AND

SYSGEN

(N)?

CLEANUP

What
is the name of the source input device [xxnl
What
is the name of the binary output device

[xxnl

(ddn)?
(ddn)?

What is the name of the map output device [xxnl (ddn)?
Do vou want to

retain the svystem OBJs

Do vou want to

retain the work files

(Y)7

(¥)7

SYSGEN Answers That Will Duplicate the Standard Monitors

A-7

Appendix B

SYSGEN Answers That Create a Multiterminal
System

This appendix lists SYSGEN answers that create an example of a multiterminal system. Refer to Appendix A for a list of the SYSGEN questions.

Note that this is intended to be only an example. It is highly improbable
that the example would exactly meet your needs or that the CSR and vector
addresses given in the example would be the same for your hardware configuration. DIGITAL does not recommend using this example, as is.
This example creates a foreground/background multiterminal system. Device support includes RK05 disk, RX01 diskette, and eight terminals with a
DZ11-A 8-line multiplexer.
)

skipped

5 +

\l'

skipped

10,

11,

12,

13,

14,

134

15,

skipped

16,

20,

21,

224

23,
24,
25,

skipped
skipped
skipped

27,

30,

33
34,
33,
6G8.
Enter the
100,

102,
103,

222222

31,
32,

device name
N

vyou want surport for [ddl: DX

177170
264

Enter the next

device name

Enter the next device name
130,

[ddl: LP

[dd]: DU

Enter the next
1
108.

device name

Enter the next

device name [dd]:

106,

133,

“

134,

176300

135,

300

[dd]: VM

Enter the next

device name

Enter the next

device name [dd]:

Enter the next

device name [dd]:

Enter the next
4
160,

device name [ddl:

110,

B-2

[dd]:

180,

181,

182.

1773560

183,

182,

176300

183,

300

182,

176310

183,

310

182,

176520

183,

320

182,
183.

330

176530

182,

176540

183,

340

182,

176550

183,

350

182,

176360

183,

360

184.

\Y4

185,

186.

187,

188.

189,

160010

190,

300

191,

300

SYSGEN Answers That Create a Multiterminal System

Appendix C
RT-11 Conditionals

The following listings contain the conditionals that the RT-11 system uses,
with a brief explanation of each conditional. The symbols in these listings
have the following meanings:

Symbol

Meaning

nnnnnn
nnn
n

CSR address
Vector address
Number

Number of remote DL11-E lines

Number of local DL interfaces

C.1

System Conditionals
AISCOD

sAUTOMATIC

BATCSH

iBATCH

CLOCK
CLOCK
CONT$N
CT$CSR
CT$VEC

=
=
=
=
=

50,
BO,
1
nnnnnn
nnn

DD$PRI
DD$CSR
DD$VEC
DD$CS2
DD$UCZ
DDT$0
DL$UN
DL11%L
DL11$M
DL11$N
DLC$0
DLU$0
DLC$1
DLY$1
DLC$2
DLVU$2

=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=

n
nnnnnn
nnn
nnnnnn
nnn
1
n
x
v
x + v
nnnnnn
nnn
nnnnnn
nnn
nnnnnn
nnn

INSTALLATION

MONITOR

SUPPORT

sPOWER LINE FREQUENCY (50 CYCLE)
jPOMER LINE FREQUENCY (B0 CYCLE)
SCONTINUATION INDIRECT FILE
$STATUS REGISTER FOR TA11 CASSETTE
SUECTOR FOR TA11 CASSETTE

sDECTAPE II PRIORITY
3STATUS REGISTER FOR FIRST DECTAPE II CONTROLLER
SUECTOR FOR FIRST DECTAPE II CONTROLLER
3SECOND DECTAPE II CONTROLLER STATUS REGISTER
SUECTOR FOR SECOND DECTAPE II CONTROLLER
sSECOND DECTAPE II CONTROLLER IS PRESENT
SNUMBER OF RLO1/RLO2 UNITS
iINUMBER OF LOCAL DL11 INTERFACES
INUMBER OF REMOTE DL11-E LINES
3$TOTAL NUMBER OF DL11 LINES
3CSR OF FIRST DL11 (CONSOLE)
SUECTOR OF FIRST DL11 (CONSOLE)
3CSR OF SECOND DL11 (LOCAL OR REMOTE)
fUECTOR OF SECOND DL11 (LOCAL OR REMOTE)
3CSR OF THIRD DL11 (LOCAL OR REMOTE)
SUECTOR OF THIRD DL11 (LOCAL OR REMOTE)

DLC$4
DLV$4
DLC%S
DLVU$S
DLC$6
DLVSGE
DLC%$7

nnnnnn

iCSkR

DLV$3

nnn

sVECTOR

DLC$3

nnnnnn

iCSR

FIFTH

DLUS7

FOURTH

DL11

FOURTH

nnn

sWVECTOR

iCER

SIXTH

nnn

iVECTOR

nnnnnn

sCSR

SEVENTH

nnn

sVECTOR

nnnnnn

sCSR

EIGHTH

OF
OF
OF

FIFTH

DL11

SIXTH

DL11

sVECTOR

iSTATUS

EIGHTH

DU$POR
DX$CSR

DX$VEC
DX$CS2

yVECTOR

FOR

nnannnn

iSTATUS

nnn

iVECTOR

FOR

SECOND

nnnnnn

y8TATUS

nnn

'yWECTOR

FOR

iNUMBER

nnnnnn

iSTATUS

nnn

iVECTOR

FOR

MSCP

FOR

DXT#0

sSECOND

RX11

DY$DD

iRAX02

nnnnnn

i8STATUS

nnn

iVECTOR

FOR

nnnnnn

iOSTATUS

nnn

sVECTOR

FOR

iSECOND

RXOZ2

iNO

sVECTOR

A
A
T

DYT$0

AN R
R

N
N

sDZV11
sCSR

R
BN

sVECTOR

iCSR

nnn
nnnnnn
nnn

sVECTOR

nnnnnn

yCSR

nnn

'WECTOR

nnnnnn

sCSR

FOR

PRESENT

THIRD

REMOTE

RATE

sSTOP

UNIT

= 3 =
e

D211

DZV11

iNUMBER

o#H

DZ11

D2ZV11

LOCAL

EIS

SUPPORTED

SUPPORT

SECOND

FOR

EMPTY

RXO02

DZ11

FOURTH

D2Z2V11

LINES
LINES

INSTRUCTIONS

iNO

iNUMBER

iERROR

LOG

iERROR

LOG

BUFFER

iNUMBER

UNITS

Fowe

Hou

Foy

e T

SECOND

SUPPORT

FIRST

iVECTOR

sUSE

RXOZ

DZ11

iNUMBER

iBAUD

Ho#

RT-11 Conditionals

PRESENT

RX02

CONTROLLER

KW11%P

FIRST

FOR

DZV11

FOURTH

sUSE

JOBS%

R¥11

RX02

SECOND

nnn

sHIGH

RX11

ONLY

FOR

FIRST

THIRD

iNUMBER

HELP$B

HSR$B

MSCP

SECOND

CONTROLLER

SECOND

iUSE

GRAFX

FIRST

DENSITY

FIRST

sGRAPHICS

FPU$11

MSCP

RX1t

MULTIPLEXER

FOR

sFLOATING

ERL$U

LETNO$

ERL$G
ERL$S

REMOTE)

RX11
FOR

EMPTY

THIRD
FOURTH

FOR

EISSI

EMPTY

MSCP

OF DZ11 OR DZV11 MULTIPLEXERS
MULTIPLEXER SUPPORT

nnnnnn

DZ11%M

DZS5P$D
DZSTSP

L$ANG

iNUMBER
iDZ11

DZCS5%1
DZVCs1
DZCS%$2
DZVCs2
DZCS$3
DZVC$3
DZ11sL

LETS

DZV$11
DZCS%0
DZVC$0

DZ11

FOR

SECOND

DOUBLE

DZ11%N
DZ11%N
DZV$11

REMOTE)

MSCP

FIRST

iSTATUS

DYsvC2

(LOCAL

REMOTE)

MSCP
PORTS

nnn

DY$CS2

REMOTE)

FOURTH

nnnnnn

DY$VEC

SECOND

REMOTE)

MSCP

FOR

THIRD

DX$VC2

DY$CSR

C-2

nnn

DL11

REMOTE)

(LOCAL

FOR

OR
OR

(LOCAL

DL11

REMOTE)
REMOTE)

(LOCAL

SEVENTH

nnn

A
A

DUusuvC4

DU$CS4

DL11(LOCAL

nnnnnn

DU$CS3
DU$VC3

(LOCAL

DL11

DUsvVC2

(LOCAL

DL11

nnnnnn

DU$CS2

DEVICE

SLOTS

EMPTY

DEVICE

SUPPORT

SPEED

BLOCKS

LOGGED

SUPPORT

SINGLE

LINE

RING

BUFFER

JOBS

KW11$P

SIZE
TO

POINT

LARGE

iLANGUAGE

SLOTS

SUPPORT

EDITOR

SUPPORTED

CLOCK

HELP

DISPLAY

SINGLE

LINE

SYSTEM

CLOCK

(SINGLE

LINE

EDITOR

COMMANDS

iSUPPORT

CCL

iLET

COUNT

LET AS
ASSIGNMENT

(SINGLE

EDITOR)

LINE

EDITOR)

OH
OH

Tl R

OB
OH

o B

LS$VEC
LS$PC

LP$VEC
LS$CSR

LS.CSZ
LS.PSZ
LP$CSR

LIGHS$T
LP.CSZ
LP.PSEZ

nnnnnn

OH O #H

LINGZ%

nnn

LETSZ%

nnn

nnnnnn

SLET STRING LENGTH (SINGLE LINE EDITOR)
iDEFAULT LINE SIZE (SINGLE LINE EDITOR)
sLIGHTS ROUTINE FOR 11745 AND 11770
sDEFAULT VALUE FOR "SET LP WIDTH=nn"
iDEFAULT VALUE FOR "SET LP LENGTH=nn"
iDEFAULT VALUE FOR "SET LS WIDTH=nn"
iDEFAULT VALUE FOR "SET LS LENGTH=nn"
iNON-STANDARD LINE PRINTER CSR
iNON-STANDARD LINE PRINTER VECTOR
iCSR FOR SERIAL LP
iVECTOR FOR SERIAL LP
iLS5 SUPPORT FOR BOTH PRO 300 PRINTER PORT
iAND DL INTERFACES

iFORM PROCESSING (LENs FFs SKIP) LP: LS:
sPDT SUPPORT

iPC11 PP STATUS REGISTER
iPC11 PP VECTOR
iPC11 OR PR11 READER/PUNCH
iPOWER FAIL

W
B
B
W
BB
H
KW

ME$CE2
MS$UCZ

nnn

nnnnnn

MS$UC1

nnnnnn

MPT$Y
MOH$PZ
MS$FSM
MS$UN
MS$CSR
MS$VEC
MS5$CS1

MM$FSEM

[
o =I T

JASYNCHRONOUS TERMINAL STATUS
iTJULIG FILE-STRUCTURE SUPPORT
iNUMBER OF TJU16 UNITS
iMEMORY PARITY SUPPORT
JUSE 2 PARs FOR MQ: AND INTERRUPT FORWARDING
iTS11 FILE-STRUCTURED SUPPORT
iNUMBER OF TS11 UNITS
iSTATUS REGISTER
OF FIRST TS11
SVECTOR OF FIRST TS11
iSTATUS REGISTER
OF SECOND TS11
sVECTOR OF SECOND TGS11
iSTATUS REGISTER OF THIRD TS11
iVECTOR OF THIRD TS11
iSTATUS REGISTER
OF FOURTH T811
SVECTOR OF FOURTH TS11 UNIT
sSTATUS REGISTER
OF FIFTH TS11
sVECTOR OF FIFTH TS11
iSTATUS REGISTER
OF SIXTH TS811
iVECTOR OF SIXTH TS11
iSTATUS REGISTER
OF SEVENTH TG11
SVECTOR OF SEVENTH TS11
iSTATUS REGISTER
OF EIGHTH TS11
sVECTOR OF EIGHTH TS11
iTM11 FILE-STRUCTURE SUPPORT
iNUMBER OF TM11 UNITS
iTERMINAL TIME OUT
IMULTITERMINAL SUPPORT

MAT$S
MME&UN

nnn

nnnnnn

nnn

OB
OH
OB
OHOH
oM

nnnnnn

nnn

nnnnnn

nnn

OB
H
U
B

OH
OH
OH
OB

iSPECIAL FUNCTIONS FOR RKOG/07 DISK
iMONTH ROLLOVER SUPPORT
iRP11 DISK IS RPOZ/RPROZ
iRP11 DISK IS RPO3
iMONITOR RUNNING UNDER RTEM-11

OB
OB
H
H
o#H

SCCA%G
SILNST
SJONLY

RPO%$3
RTE$M

iNUMBER OF RF11 PLATTERS
iNO SYSTEM I/0 ERROR MESSAGE
iADD SYSTEM I/0 ERROR MESSAGE
iRJS DISK IS RJS04
iRJS DISK IS RJS0O3
iBAD BLOCK SUPPORT FOR RKOG/07 DIGK

RKE$B

RKG$S
ROL$OV
RPO$3

RJSO%3
RJSO$3

RDF$L

nnn

$RFNUM
RDFs$L

1
nnnnnn

PDT$0P
PP$CSR
PPSVEC
PR11%X
PWF$L

OFORM

nnn

nnnnnn

MTI$M
MTT#Y

nnn

HOH

MS$UC7
MT$FSM
MTHUN

nnnnnn

Pk
P
b

MS$VC4
MS$CSS
MS$UCS
MS$CS6
MS$UCE
MS$CS7

nnn

nnnnnn

MS$VC3

MS$CS3

MS$CSd

iMINIMAL COMMANDS

Jouks ok TG

MEINI

iGLOBAL SCCA SUPPORT
iBOOT MESSAGE NOT DISPLAYED
sLOGICAL DISK SUPPORT FOR SJ ONLY

RT-11 Conditionals

C-3

OH
oH
B
ou#

iSYSTEM JOB SUPPORT
sADD DEVICE TIMER SUPPORT
iADD §J TIMER SUPPORT
i8I ZE OF INPUT RING BUFFERS

UOK&

yUK MODEM SUPPORT

UsCL

iUSER COMMAND LINKAGE SUPPORT
SUTILITY COMMANDS

UM$BAS

VSBO0%

USTIL

sUT11 DISPLAY SUPPORT
iUTSZ SUPPORT WITH SINGLE LINE EDITOR
iVT100 SUPPORT WITH SINGLE LINE EDITOR

o#
B
oH

iVECTOR FOR VUT11/VSG0

iSUPPORT FOR PRO 300 COMMUNICATIONS PORT
iCSR OF DL(V)-11 FOR XL
sWECTOR OF DL(V) -11 FOR XL

1
nnnnnn
nnn

AKT$PRI

XKT$VCO

nnn

KT$CS1

nnnnnn

AT$UC1

XKT$CS50

nnn

AT&CS2

XKTNCHN

KM$FET

nnn

sVT102Z SUPPORT WITH SINGLE LINE EDITOR
sCSR FOR VUT11/VSG0

ALSVEC

nnnnnn

AL$PC
KL$CSR

nnnnnn

nnn

nnnnnn

RTsUCd

KT$UC3

nnn

KT$CES

nnn

nnnnnn

KT$YCS

KT$UC2

AT$CS3

nnn

AT$CE6

nnnnnn

XT$VCE

nnn

AKTHCS7

nnnnnn

XKT$UC7

KT$C54

nnn

C.1.1

C.1.2

MMGS$T

sYEC
OF SECOND
TOR
DL-TYPE LINE
iSTATUS REGIST
OF THIRD
ER DL-TYPE LINE
yVECTOR OF THIRD DL-TYPE LINE
iSTATUS REGIS
OF TER
FOURTH DL-TYPE LINE

iVECTO
OF FOURTH
R DL-TYPE LINE
iSTATUS REGISTER OF FIFTH DL-TYPE LINE
tVECTO
OF FIFTH
R DL-TYPE LINE
sOTATUS REGISTER OF SIXTH DL-TYPE LINE
iVECTOR
OF SIXTH DL-TYPE LINE
|
iSTATUS REGIS
OF TER
SEVENTH DL-TYPE LINE

sVECT
OF SEVENTH
OR DL-TYPE LINE
iSTATUS REGIS
OF TER
EIGHTH DL-TYPE LINE
iVECTO
OF EIGHTH
R DL-TYPE LINE

5J MONITOR SUPPORT

iNO

5.J MONITOR SUPPORT

XM.MAC
Hou

iSTATUS REGIST
OF FIRST
ER DL-TYPE LINE
sVECTO
OF FIRST
R DL-TYPE LINE
i8TATUS REGIS
OF TER
SECOND DL-TYPE LINE

FB.MAC

C.1.3

i+FETCH SUPPORT IN XM
sNUMB
OF DL-TYPE
ER SERIAL LINES
sPRIORITY OF DL-TYPE SERIAL LINES

SJ.MAC

RT-11 Conditionals

(/B4.)

VT100%

UT10Z2%
UT.VEC

LOWEST ADDRESS TO USE
iUS60 DISPLAY SUPPORT

UTS2%

UT.CSR

iUMX:

UT11%

C—4

iSIZE
OF OUTPUT RING BUFFERS

TIMES$R
TTYIN
TTYOUT

s INDICATE SYSGENED MONITOR

TIM$IT

SYT$K

SYSGEN

iSAVE/SET MAIN-LINE PC AND
PS SUPPORT
i5P00L HANDLER FLAG PAGE SUPPORT
iSTARTUP COMMAND FILE

o o u

STARST

oo S

SP$FLG

15K STATUS REGISTER

iSK VECTOR

SPC$PS

nnnnnn

nnn

SK$CSR
SK$VEC

iNO 5J MONITOR SUPPORT
iMEMORY MANAGEMENT SUPPORT

Individual Keyboard Monitor Command Conditionals
To include or exclude individual keyboard commands, insert the particular
conditional in SYSGEN.CND and substitute 0 (to exclude the command) or
1 (to include the command) for n.
Utility Program Subset
sIF N IS SET EQUAL TO 0 ALL

UsTIL

sUTILITY COMMANDS DEFAULT
= O

W
B
B
B
HH
H
H

353 35533305
33

OB
OB

sINITIALIZE

OB
OB

SEDIT
sFORMAT
sPRINT

iBACKUP
sBOOT

iPROTECT

093

RENA%$$
SHOWS
%
SQUESS$
TYPE$®$
UNPR$%

CREASS
DELE®S$
DIFFss$
DIRES$S
DUMP$%
EDITS%
FORM$$
INITS$%
PRIN®$
PROT$%

BACKS$%
BOOT+$
COPY%$%$

iSHOW

iIF N IS SET EQUAL TO 1 ALL
sUTILITY COMMANDS DEFAULT
= 1

iTYPE
sUNPROTECT

iCOPY

iCREATE
sDELETE

iDIFFERENCES
iDIRECTORY
iDUMP

sRENAME
ySQUEEZE

Language Subset
it

B
H

H
#

O3 3

IEXECUTE
iFORTRAN

o#H

sCOMPILE
sDIBOL

iLIBRARY

COMP$%
DIBO$%
EXECS$
FORT®%
LIBR$%
LINKS$
MACR$$

iIF N IS SET EQUAL TO O+ ALL
iLANGUAGE COMMANDS DEFAULT
= O
iIF N IS SET EQUAL TOD 1+ ALL
iLANGUAGE COMMANDS DEFAULT = 1

iLINK

L$EANG

iMACRO

Minimal Subset
it

OH
oH

3
3

ABOR$$
ASSI%$%
Bes$
CLOS%%
D$%

iIF N IS SET EQUAL
iMINIMAL COMMANDS
iIF N IS SET EQUAL
iMINIMAL COMMANDS

#oH

M&EINI

C.2

TO O ALL
DEFAULT
= 0
TO 1 ALL
DEFAULT = 1

TABORT
FASSIGN
iBASE
sCLOSE
iDEPOSIT

RT-11 Conditionals

C-5

sDISMOUNT

sEXAMINE

i FRUN

sGET

sGT ON/OFF

HELP$%

sHELP

INST$%

E$$

FRUN®%
GET$%
GTé%

y INSTALL

LOAD%%

sLOAD
OB

sMOUNT

sREENTER

REMO%%

MOUN$
%

yREMOVE

RESE$%

B
B
B
o

SUSP%%
TIME$%

UNLO$%

s SRUN

STARSS

iSTART

iSET

SRUN%$$

SAVESS
SET%%

1SUSPEND

i SAVE

RESU$%

i TIME

sRESET
i RESUME

REEN®%

C.3

iDATE

sDEASSIGN

DISM$%

DEAS%$

DATES%

sUNLOAD

Naming-Convention Conditionals
The following conditionals control monitor, handler, and start-up command

NAME$G

NAME$S

NAMES$d

NAME$3

R
1

NAME®Z

NAMES$1

“m

sFIFTH CHARACTER
OF MONITOR NAME

file naming conventions.

s SIATH CHARACTE
OF MONITOR
R NAME

iFIRST CHARACTER
OF MONITOR NAME
sSECOND

s THIRD CHARACTER
OF MONITOR NAME
iFOURTH CHARACTER
OF MONITOR NAME

CHARACTER OF MONITOR NAME

All characters must be both valid ASCII and Radix-50 characters. Default
values are assigned for standard monitor names according to the settings of

the following conditionals:
Conditionals

Monitor Names

BF=0

RT11SJ

BF=1 RTE$M =0

MMGS$T =0

RT11FB

BF=1

MMGS$T =1

RT11XM

BF=1RTE$M =1

MMGS$T =0

RTEMFB

SUFX$H

iSUFFIX CHARACTER FOR HANDLER FILE
iNAME TO INDICATE MONITOR TYPE

All characters must be both valid ASCII and Radix—50 characters. Default
values are assigned for standard handler names according to the settings of
the following conditionals:

C-6

RT-11 Conditionals

Conditionals

Standard Suffix

BF=0

space

BF=1 RTE$M=0
BF =1

MMG$T=0
MMG$T =1

space
X

BF =1 RTESM =1

MMGS$T=0

SUFX$X

sSUFFIX CHARACTER FOR STARTUP FILE

‘N

sNAME TO INDICATE MONITOR TYPE

All characters must be both valid ASCII and Radix—50 characters. Default
values are assigned for standard monitor names according to the settings of
the following conditionals:

Conditionals
BF=1 RTE$M =1

Standard Suffix
MMG$T=0

Otherwise, the NAMES$5 value is used.

RT-11 Conditionals

C-7

Appendix D

Customizations for Specially Generated Monitors

In the following software customizations, lowercase alphabetic x represents
a character that varies according to the specific software component you are
- modifying.

Installing Only the Generated Handlers
Normally, when you bootstrap an RT-11 system, the monitor automatically
installs any device handlers that are present on the system device, if there
are enough device slots for them. Under certain circumstances, you may
want the system to include only the handlers that you named during your
system generation process. To prevent the system from recognizing handlers that you did not specify during system generation, install the following customization.
NOTE

Do not install this customization on any of the distributed
monitors.

" In this customization, monitr.SYS is the name of the monitor file that you

want to modify, and ..INSA is the value of that symbol from the monitor
link map.
+ RUN SIPPGED
#monitr.SYSED
Base?
0GED
Offset?
+ + INSARED
Base

000000
000000

*CTRLIC)

Offset

+ + INSA
+ « INSA+2

Old

010103
020200

New

240@ED
CTRLIY
) RED

If the monitor you want to alter is the hardware bootable monitor, write a
new system bootstrap with the COPY/BOOT command.

D.2 Suppressing the Multiterminal Polling Routines
If you selected DZ—11 modem support or the multiterminal timeout feature
when you performed your system generation, the monitor automatically
polls the terminal lines twice every second. This can cause ODT to malfunction. If you make the following modification to the monitor, it will not do
this periodic polling. This allows you to use ODT, but defeats the value of
the multiterminal timeout feature, and prevents the monitor from recognizing remote DZ-11 or DZV-11 lines.

In the customization, monitr.SYS is the name of the monitor file that you
want to modify, and ..DZOD is the value of that symbol from the monitor
link map.
+RUN SIPPRED
*monitr.SYSRED
Base?
O®ED
Offset?
+ + DZ0ODRED
Offset
Base

000000

000000
#CTRL/C)

+ +DZ0OD

. DZ20D+2

0ld

Q00000

New

1 RED

001002

If the monitor you want to alter is the hardware bootable monitor, write a
new system bootstrap with the COPY/BOOT command.

D.3 Changing the Handler File-Name Suffix
In an ordinary RT-11 SJ or FB system, the monitor recognizes device handlers by the format of their names. Device handler names have the format
dd.SYS. In an XM system, handlers are in files named ddX.SYS. Thus, two
sets of handlers can coexist on one system volume.

If you generate one or more monitors with different combinations of the
device timeout, error logging, and extended memory features, you can have
need of up to eight different sets of device handlers. You can keep such
handlers on one system volume by associating one or more monitors with
the corresponding handlers. Do this by customizing the monitor so that it
recognizes device handler file names of the form ddn.SYS, where n is any

alphabetic character that you choose. Then rename the corresponding han-

dler files.

In this customization, monitr.SYS is the name of the monitor file that you
want to modify, and z is the one-character suffix that you use when you
rename the associated handlers. The old values depend on the system generation options that you chose.
+ RUN SIPPRED
*monitr.SYSREDD
Base?
O @ED
Offset?
477 4@RED

D-2

Customizations for Specially Generated Monitors

Offset
004774
004774

Base
000000
000000

004776

000000

01d
000030
£
X3
<nnny

New

s R @ED
' REPEP
z GED

* GO
¢

If the monitor you want to alter is the hardware bootable monitor, write a

new system bootstrap with the COPY/BOOT command.

D.4

Changing the Default Device for the SRUN Command
When you start a system job (by typing SRUN filnam), the default device
on which the monitor looks for the program file is SY:. (You can run system
jobs under an FB or XM monitor that includes the system job feature.) If
you have a special application, you can change this default to any threecharacter device name.

In this customization, monitr.SYS is the name of the monitor file that you
want to modify, ..SRDK is the value of that symbol from the monitor link
map, and nnn is the new default device name.
+ RUN SIPPGRED

¥monitr.SYSRED

Base?
Offset?

Base

O ®ED
+ + SRDKRED

Offset
+ + SRDK

000000
000000
000000

+ + SRDK
v + SRDK+2

01ld
015270
<8Y >
CAWL >

New
3 REED
s R1innRED
CTRL/Y) RED)

* CTRL/C)

D.5

Changing the Default File Type for the SRUN Command

When you start a system job, the default file type for the program file is

REL. If you have a special application, you can change this default to any
three-character file type.

In this customization, monitr.SYS is the name of the monitor file that you
want to modify, ..SRUX is the value of that symbol from the monitor link
map, and nnn is the new default file type.
+ RUN SIPPGEE

*monitr.SYSRED
Base?

O RED

Offset?

Base

000000
000000
000000

+ + SRUXRED
Offset

+ + SRUX
e + SRUX
Vo SRUX+2

0ld

075273
<{REL >
<xxx»

New

s RRED
s Rnnn @D
ERIVED)

* CTRL/C)

Customizations for Specially Generated Monitors

D-3

D.6 Assigning a Remote Line as the Console Terminal
You can customize your FB and XM monitors to allow a terminal connected
via a dial-up line to be used as the console terminal. The multiterminal
software will answer the line when called (provided appropriate modem
hardware is in place) and connect the remote terminal to the system as the
console terminal.

In this customization, monitr.SYS is the name of the multiterminal monitor file that you wish to modify, and ..CRMT is the value of that symbol
from the monitor link map.
JRUN SIPPRE
#monitr.SYSRED

Base?
Offset?

O RED
+ + CRMT@ED

Base

000000

%CTRLC)

000000

Offset

¢+ +CRMT

+ .CRMT+2

0ld

020000

New?

O RED

XXXXXX

D.7

Changing the Device Name of the UCL File
If you selected user command linkage (UCL) support when you performed
your system generation, you can customize the monitor to change the device name from where the UCL file is run (by default SY:). Use the following alteration to change the contents of location ..UCLF to the RAD50
device name.

In the customization, monitr.SYS is the name of the monitor file that you
wish to modify, ..UCLF is the value of that symbol from the monitor link
map, and yyy is the name of the device from which the UCL file will be run.

,RUN SIPPEE
#monitr.SYSRD

Base?
Offset?

Base

ORED
+ + UCLFGRED

Q00000

Q000000

Offset

0Old

.UCLF

XXXXXX

UCLF+2

XXXXXX

New?

yRy vy ORED

D—-4 Customizations for Specially Generated Monitors

INDEX

/ALLOCATE option, 3-7

Altering system generation
command files, 2—2
Answer file

Conditional files
retaining source files after

BA.MAC, 1-10
Banner page support, 1-28
BATCH, 1-5

build, 1-38
CR.MAC, 1-10
CSR addresses
DL11 lines, 1-33
First DZ multiplexer, 1-34
Local DL11 interfaces, 1-33
parallel printer, 1-29
printer nonstandard, 1-29
Remote DL11 interfaces, 1-33
RX02 diskette, 1-27
serial line printer, 1-30
VT11/VT60, 1-31
XL handler, 1-30
CT.MAC, 1-10
CTRL/C, 2-1, 3-2
CTRL/O, 2-2, 3-2

Batch support, 1-25
Baud rates, 1-35
BIN:, 1-9
Binary output device, 1-11, 1-37
Block-replaceable device, 1-12,

DD.MAC, 1-10
Default SYSGEN responses, 2—1
Deleting .OBJ files, 1-9
Device

creation, 1-15

required with SPR, 3-12
use of previously created, 1-14
Assembling diskette files, 3-7
Assembling monitor and device
handlers, 3—-7
Asynchronous terminal status, 1-5,
1-18

Automatic installation, 2—-8
Automatic system build, 1-9

2-2
Bootstrap routine’s automatic
installation capability, 2—-8
BSTRAP.MAC, 1-10
Building device handlers, 1-38
Building handlers separately, 2—8
Building monitors, 1-38
Changing dialog responses, 2—2
Changing responses to dialog,
1-35

binary output, 1-11
block-replaceable, 1-12, 2-2
map output, 1-12

source input, 1-10
system, 1-10

Device handlers
assembling and linking, 2-2
associated with specific
monitors, D-2
building, 1-38
changing file name suffix, D-2

Index-1

installing generated handlers,
D-1

Device I/O timeout, 1-5

DL.MAC, 1-10
DL11 lines, CSR address for, 1-33

DL11 lines, vector address for,

Device options, 1-26

addresses of magtape units,
1-29

1-33

DL11-W, 1-32
DM.MAC, 1-10

banner page support, 1-28

Double-density only RX02, 1-5

changing, 1-35

Double-density only support, 1-27

CSR addresses, 1-27

DP.MAC, 1-10

disk platters on RF11 subsystem,

DS.MAC, 1-10

1-27

DT.MAC, 1-10

extra device slots, 1-31

file-structured magtape handler,
1-28

MSCP port support, 1-28

how many supported, 1-28
number of magtape units
supported, 1-28
number of RLO1/RL02 units

supported, 1-28

parallel printer CSR address,
1-29

Professional 300 printer port
support, 1-30

RJS03 rather than RJS04 support,

DW.MAC, 1-10
DX.MAC, 1-10
DY.MAC, 1-10
DZ lines supported

baud rates, 1-35
Number of local lines, 1-34
Number of remote lines, 1-34
DZ multiplexer support

Number of, 1-34
DZ.MAC, 1-10
DZ11 multiplexer support, 1-34

DZ11 up to 9600 baud, 1-5
DZ11/DZV11 multiplexer support,
1-34

1-27

RPRO2 rather than RPR0O2/RP03
support, 1-28

RX02 double-density only
support, 1-27

support for second device

controller, 1-26
support for user-supplied
device handlers, 1-30
vector addresses, 1-27

Device selection, 1-37

Device timeout support, 1-17

EDTGBL
required for assemblies, 3-8

EDTGBL.MAC, 1-10
EL.MAC, 1-10

ELCOPY.MAC, 1-10
ELINIT.MAC, 1-10
ELTASK.MAC, 1-11
Error logging, 1-5, 1-25
number of units supported, 1-25
Error messages for SYSGEN, 2-2,

Devices
also see Device options
Adding support for a device,
1-36

asterisk in list, 1-26
list of valid, 1-26
peripheral, 1-4

3-2

Errors

system build, 2—4
ERRTXT.MAC, 1-11

Extended memory monitor, see XM
monitor

Extra device slots, 1-5, 1-31

Removing support for, 1-36
DEVTBL.MAC, 1-30
Dial-up line as console terminal,
D-3

FB monitor, 1-16
duplicating standard, A-1
FB.MAC, 1-11

Disable .FETCH request, 1-5

JFETCH request, 1-20

Disk platters on RF11 subsystem,

Files created by SYSGEN, 3-2

1-27

Diskette

RX01/RX02, 3-1

Floating point support, 1-23
Foreground/background monitor,

see FB monitor

RX50, 1-10, 1-12, 1-26

Free space, consolidating, 2-3, 2-6

working system, 3-1

FSM.MAC, 1-11

Index-2

Global SCCA, 1-5, 1-18

Linking files in diskette system,

Graphics options, 1-31
CSR address for VT11/VT60, 1-31
Vector address for VT11/VT60,

Linking monitor and device

1-31

VT11/VT60 support, 1-31
VT60 support, 1-31

3—-10

handlers, 3-7
Local DL11 lines supported, 1-32
Logical assignments, 1-9
Logical device, 3—7
LP.MAC, 1-11

Handler file-name, changing the

LS.MAC, 1-11

suffix, D-2
High-speed ring buffer, 1-5, 1-20

MACRO, 3-10

50 Hz clock, 1-22
Identifying diskettes (volume ID),
3-5

Identifying specially generated
monitors, 2-5, 3—-11

IND.SAV, 1-2
IND.SAV, running, 2-1
Indirect command file

SYSGEN.BLD, 24
to build device handlers, 2-7
to build monitor, 2—-6
Indirect command file, start-up,
1-23

Indirect command files, 1-8, 1-13
editing, 2—-3
retaining after build, 1-38

to build diskette system, 3—-3

to build system, 2-3
Initializing diskettes, 3—5
Input ring buffer size, 1-19

Installing additional device
handlers, 2-8
Installing generated system, 3-11

Invoking system generation
command file, 2—4

MACRO work file, 3—7
Magtape
file-structured handler, 1-28
number of units supported, 1-28
unit addresses, 1-29
Manual system build, 1-13

Map output device, 1-12, 1-37,
2-2

MAP:, 1-9

Mass storage
optimizing, 1-9, 2-3
Memory parity, 1-6

Memory parity support, 1-24
Monitor

keeping it small, 2-8
Monitor options, 1-16
asynchronous terminal status,
1-18

batch support, 1-25
changing, 1-35
device timeout support, 1-17
error logging, 1-25
number of units supported,
1-25

error message on system /O
errors, 1-17

FETCH request, 1-20

Keeping monitor small, 2-8

floating point support, 1-23

Keyboard monitor command subsets,

Global SCCA support, 1-18
high-speed ring buffer support,

1-6

Keyboard monitor commands, 1-20
KMON overlays, 3—6
KMON.MAC, 1-11

50 Hz clock, 1-22

KMOVLY.MAC, 1-11, 3-6

keyboard monitor commands, 1-20,

KW11-P programmable clock, 1-23
LD.MAC, 1-11
Link map, 3-10

suppression of, 2—-2
Link maps

on map output device, 1-12

1-20

input ring buffer size, 1-19
1-21

language subset, 1-22
minimal subset, 1-22
utility subset, 1-21
memory parity support, 1-24

month and year date rollover,
1-20

required with SPR, 3-12

multiterminal support, 1-18

saved on disk, 1-12

multiterminal timeout support,

suppression, 1-12

1-19

Index-3

output ring buffer size, 1-19
power failure message, 1-24
programmable clock as system

clock, 1-23
save/set main-line PC & PS,
1-18

Sd timer support, 1-16
.SPCPS request, 1-18
start-up indirect command file,
1-23

system job support, 1-17

CSR address, 1-29
vector address, 1-29
serial
CSR address, 1-30
vector address, 1-30
Professional 300 series
printer port support, 1-30
Programmable clock as system

clock, 1-6, 1-23
Programmed request
SPCPS, 1-6

user command linkage, 1-20

Monitor services, 1-7
Monitor type, 1-15
Monitors
assembling and linking, 2-2

associating handlers with

specific monitor, D-2
building, 1-38
customizations, D-1

duplicating standard, A-1
Month and year date rollover,
1-20

Remote DL11 lines supported, 1-33
Removing device support, 1-36
Responses
changing dialog, 2-2, 3-2
inappropriate SYSGEN, 3-2
Retaining work files, 1-38
RF.MAC, 1-11
Ring buffer size, 1-6
RJS03 rather than RJS04 support,
1-27

RK.MAC, 1-11

Month and year rollover, 1-6

RLO1/RL0O2, number of units

MSCP port support, 1-28

supported, 1-28
RMONFB.MAC, 1-11
RMONSJ.MAC, 1-11
RMONzxx.MAC, 3-8
RPRO2 rather than RPR02/RP03

MTTEMT.MAC, 1-11
MTTINT.MAC, 1-11
Multiplexer support, 1-34, 1-35
Multiterminal support, 1-6, 1-18
suppressing polling routines,
D-2
TRMTBL.MAC required, 1-10
Multiterminal system

answers to create, B-1
Multiterminal timeout, 1-6
Multiterminal timeout support,

support, 1-28
RT-11 conditionals, C-1

RUN IND.SAV SYSGEN.COM, 2-1
Running SYSGEN.COM, 3-1

RX01/RX02 diskette, 3-1
RXO02 double-density only support,
1-27

1-19

NL.MAC, 1-11
Object files, 3—6
on binary output device, 1-11

Save/set main-line PC & PS, 1-18
Second controller, 1-6
Second device controller support,
1-26

Serial printer vector address,
1-30

Object modules, retaining system
OBdJs, 1-38
Output ring buffer size, 1-19

Single-job monitor, see SJ

PC.MAC, 1-11
PD.MAC, 1-11

SJ monitor, 1-16
duplicating standard, A-1

Peripheral devices, 1-4

SJ timer support, 1-6, 1-16
SJ.MAC, 1-11
Software Performance report, see
SPR
Source files, 2-2
changing device, 2—-3

SFPA programmed request, 1-24
monitor

Polling routine suppression, D-2
Power failure message, 1-24
Printer
nonstandard addresses, 1-29

parallel, 1-29

Index—4

deleting, 2—6

required for system build, 1-10
Source input device, 1-10, 1-37
SP.MAC, 1-11
SPCPS programmed request, 1-6
SPR, 1-12, 2-7, 3-12
for specially generated monitor,
3—-11

SRC:, 1-9
SRUN command

changing default device, D-3
changing default file type, D-3
Start-up indirect command file,
1-23

Suppressing link maps, 1-12, 2-2
SYG file type, 2-7
renaming, 2-5, 2-7

SYG master files, 3—11
SYSGEN responses, inappropriate,
2-2, 3-2

SYSGEN.ANS, 3-3
SYSGEN.BLD, 1-38, 2-2, 2-3, 2-4,
3-2

SYSGEN.CND, 1-10, 1-11, 2-3, 3-2
required for assemblies, 3—8
SYSGEN.COM, 1-2, 2-1, 3-1
SYSGEN.DEV, 2-2, 2-3, 2-6, 2-7,
3-3

SYSGEN.MON, 2-2, 2-3, 2-6, 3-3
SYSGEN.TBL, 1-10, 1-11, 2-3, 3-2
System build
automatic, 1-9
binary output device, 1-11

creating diskette system, 3-5
default device requirements,
1-10

diskette
assembling and linking, 3-7
assembling files, 3—7
COPY commands, 3—7
errors, 3—11

linking files, 3—10
diskette contents, 3—6
fourth diskette, 3—6
second diskette, 3—6
system diskette, 3—6
third diskette, 3—6
diskette working system, 3-1
errors, 2—4

files to retain, 2-7
free storage requirements, 1-11
indirect command files, 1-8,
1-13, 2-3, 3-3
manual, 1-13

map output device, 1-12
procedure, 1-8
procedure for diskette system,
3-3

required free blocks, 1-10
required source files, 1-10
source input device, 1-10
SYSGEN dialog, 1-37
binary output device, 1-37
build entire system, 1-38
build just monitors, 1-38

device and unit number, 1-37
map output device, 1-37
retaining system OBJs, 1-38
retaining work files, 1-38
using SYSGEN.BLD to perform,
2-3

using SYSGEN.MON and SYSGEN.DEV,
26

System conditionals, C-1
changing, 1-37
defining, 1-37
in SYSGEN dialog, 1-25
individual keyboard monitor
commands, C-5
user defined, 1-8
System device, 1-10
contents, building disk system,
2-1

contents, building diskette
system, 3—5

System diskette, 3—6
System generation
altering command files, 2-2
building one monitor at a time,
3-1

Changing responses to dialog,
1-35

cleanup, 1-37
default answers, 1-13
dialog, 1-13
device options, 1-26
monitor options, 1-16
monitor questions, 1-15

introduction to, 1-14
on RX01/RX02 diskette system,
1-13

performing on small system, 3—1
procedure on disk system, 2-1
summary of questions, A-5
terminating, 2—1, 3-2
System I/O error message, 1-6
System job support, 1-7, 1-17
System source files, 1-10

Index-5

Using SYSGEN.MON and SYSGEN.DEV

Terminal interface options
baud rates of DZ lines, 1-35
CSR address for DL11 lines,

to build system, 2—-6
USR.MAC, 1-11, 3-8

1-33

Vector addresses
DL11 lines, 1-33
First DZ multiplexer, 1-34

CSR addresses
First DZ multiplexer, 1-34

DZ11 multiplexer support, 1-34
DZ11/DZV11 multiplexer support,

1-34

Introduction, 1-32

Local DL11 lines supported,
1-32

Number of DZ multiplexers
supported, 1-34
Number of local DZ lines

supported, 1-34
Number of remote DZ lines
supported, 1-34
Remote DL11 lines supported,
1-33

Vector address for DL11 lines,
1-33

Vector addresses

First DZ multiplexer, 1-34

Local DL11 interfaces, 1-33
magtape units, 1-29

parallel printer, 1-29
printer nonstandard, 1-29
Remote DL11 interfaces, 1-33
RX01,RX02,DECtape II, 1-27
serial line printer, 1-30
VT11/VT60, 1-31
XL handler, 1-30
VM.MAC, 1-11

Volume 1D, 3-5
VT11/VT60 support, 1-31

VT11/VT60,CSR address for, 1-31
VT11/VT60,Vector address for,
1-31

VT60 support, 1-31

Terminating SYSGEN, 2-1
TJ.MAC, 1-11

WEF:, 3-7

TM.MAC, 1-11
TRMTBL.MAC, 1-10, 1-11
TS.MAC, 1-11
TT.MAC, 1-11

Work file

UCL
see user command linkage
User command linkage, 1-7, 1-20

XC.MAC, 1-11

changing default device, D—4
User-generated monitor identifier
(9), 3-11

User-supplied device handlers,
support for, 1-30

Using SYSGEN.BLD to build system, 2-3

Index-6

MACRO, 3-7
Work files, retaining, 1-38

XL handler
setting CSR address, 1-30
setting vector address, 1-30

- XL.MAC, 1-11

XM monitor, 1-16
duplicating standard, A-3
XM.MAC, 1-11

XMSUBS.MAC, 1-11

HOW TO ORDER
ADDITIONAL DOCUMENTATION

From

Call

Chicago

Write

312-640-5612

Digital Equipment Corporation

8:15am to500pm CT

Accessories & Supplies Center
1050 East Remington Road

Schaumburg, IL 60195

San Francisco

408-734-4915
815am to 500pm PT

603-884—-6660

Alaska, Hawaii

830am to 600 pPm ET
or

Digital Equipment Corporation
Accessories & Supplies Center
632 Caribbean Drive
Sunnyvale, CA 94086

408—-734-4915
815am to 500 pm PT

New Hampshire

603—-884-6660

Digital Equipment Corporation

8:30 AaM t0o6:00PMm ET

Accessories & Supplies Center

Rest of U.S.A.,

1-800-258-1710

Puerto Rico*

830 am to 6:00pPm ET

P.O. Box CS2008
Nashua, NH 03061

*Prepaid orders from Puerto Rico must be placed with the local DIGITAL subsidiary (call 809-754-7575)

Canada
British Columbia

Ottawa—Hull

1-800-267-6146

Digital Equipment of Canada Ltd

8:00 Am to 500 pm ET

940 Belfast Road

613-234-7726

Ottawa, Ontario K1G 4C2
Attn: A&SG Business Manager

800 am to 500 pm ET

Elsewhere

112-800-267-6146
8:00 Am to 500 pm ET

Elsewhere

Digital Equipment Corporation
A&SG Business Manager”
*c/o DIGITAL's local subsidiary or approved distributor