AA K905A TM_DECnet 20_Network_Generation_and_Installation_Procedures_Dec82 TM DECnet 20 Network Generation And Installation Procedures Dec82

AA-K905A-TM_DECnet-20_Network_Generation_and_Installation_Procedures_Dec82 AA-K905A-TM_DECnet-20_Network_Generation_and_Installation_Procedures_Dec82

User Manual: AA-K905A-TM_DECnet-20_Network_Generation_and_Installation_Procedures_Dec82

Open the PDF directly: View PDF .
Page Count: 128

Download
Open PDF In Browser	View PDF

DECnet-20 Network Generation
and Installation Procedures
AA-K90SA-TM

December 1982
This manual describes the procedures for generating and
installing DECnet-20 software on DECSYSTEMs-2040S/2060.
OPERATING SYSTEM:
SOFTWARE:

DECnet-20 V3.0
RJE-20 V2.0

Software and manuals should be ordered by title and order number. In the United States, send orders
to the nearest distribution center. Outside the United States, orders should be directed to the nearest
DIGITAL Field Sales Office or representative.

Northeast/Mid-Atlantic Region

Central Region

Western Region

Digital Equipment Corporation
PO Box CS2008
Nashua, New Hampshire 03061
Telephone:(603)884-6660

Digital Equipment Corporation
Accessories and Supplies Center
1050 East Remington Road
Schaumburg, Illinois 60195

Digital Equipment Corporation
Accessories and Supplies Center
632 Caribbean Drive
Sunnyvale, California 94086
Telephone:(408)734-4915

Telephone:(312)64~5612

TOP8-20 V5.1
GALAXY V4.2

First printing, December 1982

The information in this document is subject to change without notice and should
not be construed as a commitment by Digital Equipment Corporation. Digital
Equipment Corporation assumes no responsibility for any errors that may
appear in this document.
The software described in this document is furnished under a license and may
only be used or copied in accordance with the terms of such license.
No responsibility is assumed for the use or reliability of software on equipment
that is not supplied by DIGITAL or its affiliated companies.
The following are trademarks of Digital Equipment Corporation:

~D~DD~DTM
DEC
DECmate
DECsystem-10
DECSYSTEM-20
DECUS
DECwriter
DIBOL

MASSBUS
PDP

P/OS
Professional
Rainbow
RSTS
RSX

UNIBUS
VAX
VMS
VT
Work Processor

The postage-prepaid READER'S COMMENTS form on the last page of this
document requests the user's critical evaluation to assist us in preparing future
documentation.

CONTENTS

PREFACE
CHAPTER 1
1.1
1.2
1.2.1
1.2.2
1.2.3
1.2.4
1.2.5
1.3
1.3.1
1.3.2
1.4
1.4.1
1.4.2
CHAPTER 2
2.1
2.2
2.3
2.3.1
2.3.1.1
2.3.1.2
2.3.1.3
2.3.1.4
2.3.2
2.4
2.4.1
2.4.2
2.4.3
2.4.4
2.4.5
2.4.6
2.4.7
2.4.8
2.4.9
2.4.10
2.4.11
2.4.12
2.4.13
2.4.14
2.4.15
2.4.16

INTRODUCTION
HARDWARE/SOFTWARE ENVIRONMENT
. . . . . . . 1-2
OVERVIEW OF CONFIGURATION PROCEDURES .
. . . 1-3
Overview of Procedure: . . .
. . 1-3
Generating a DN20 Node:
. . . . . . . 1-4
Generating DN200 Nodes:
. . . .
. . . 1-4
Running NIPGEN:
....
. . . . . 1-7
Loading and Verifying Nodes: .
. . . . 1-7
DISTRIBUTION TAPES . . .
. . . .
1-10
DECnet-20 Distribution Tape
. . . .
1-10
DN200 Remote Job Entry (RJE) Distribution Tape 1-11
PREPARING TO CONFIGURE .
. . . . .
1-11
DECnet-20 Installation Worksheet .
. • . . 1-12
Network Nodes for NIPGEN . . . . . . . . .
1-14
NETGEN OVERVIEW
PARAMETERS . . . . . . . . . .
. . . 2-2
REPRESENTATIVE CONFIGURATIONS
. . . . . . . 2-5
NETGEN COMMANDS
. . . . . . . ..
. . • • • . 2-7
NETGEN Help and Recognition Features .
. . 2-8
Requesting a List of Commands
. . 2-8
Requesting a List of Arguments and Values
. 2-8
Requesting a Guideword for the Argument
. 2-9
Using Recognition . . . . . . . . •
. . . 2-9
Syntax Errors
. . . .
. . . . . .
2-10
NETGEN COMMAND SYNTAX
. . . . . .
2-10
DEFINE EXECUTOR: Defining the Executor
2-11
EXCLUDE: Removing a Device
.....
2-12
EXIT: Exiting from NETGEN
. . . . .
2-13
FINISHED: Finishing the Configuration . . . .
2-14
HELP: Displaying a NETGEN Description
2-15
INCLUDE: Adding a Device . . . . • . . .
2-16
INFORMATION: Displaying Node Information.
2-17
LIST: Displaying Characteristics .
2-18
LOG: Logging NETGEN Commands .
2-20
NODE: Specifying the Node Type.
2-21
PURGE: Removing a Parameter
2-22
PUSH: Entering the TOPS-20 Executive .
2-23
RESTORE: Restoring a Saved Configuration .
2-24
SAVE: Saving a Configuration.
2-25
START: Entering NETGEN Dialog
2-26
TAKE: Taking a File . . . . .
....
2-27
iii

CONTENTS (Cont.)

CHAPTER 3
3.1
3.1.1
3.1.2
3.1.3
3.1.4
3.1.5
3.2
3.2.1
3.2.2
3.2.3
CHAPTER 4
4.1
4.2
4.2.1
4.2.2
4.2.3
4.2.4
4.2.5
4.3
CHAPTER 5
5.1
5.2
5.3
5.4
APPENDIX A
A.l
A.2
A.3
APPENDIX B

INSTALLATION OVERVIEW
DN20 CONFIGURATION . . . . . . . . . . . .
. . 3-1
Initial System Setup. . . . .
. . . . . 3-2
Generating Front-End Software
. . . . . . . . . 3-3
Creating Front-End Software
. . . . . 3-9
Putting the Files in System Directories
3-10
Complete and Repeat the Configuration
. . ..
3-11
REMOTE JOB ENTRY CONFIGURATION .
. . . .
3-12
Generating RJE Software
. . . . . .
3-12
Creating RJE Software
. . . . . . . . . . ..
3-18
3-19
Putting Files in System Directories
NETWORK CHECKOUT
. .
NIPGEN OVERVIEW
. . . . . . . .
NIPGEN COMMAND AND CONTROL FILES .
NCP.CMD: DN20 Command File . .
NCPRJE.CMD: DN200 Command File.
NIPLCL.CTL: Node Verification File.
NIPNM.CTL: Loopback Verification File
NIPNFT.CTL: NFT Verification File
SYSTEM FILE EDITS
. . . . . . . . . . .

.
·
·
·

.
.
.
.
.

. .
..
. .
. .
. .

4-2
4-8
4-8
4-9
4-9
4-10
4-11
4-14

NETWORK NODE STARTUP
NODE CHECKOUT
. . . .
NODE TROUBLESHOOTING .
RJE STARTUP
. . . . . . .
FILE TRANSFER CHECKOUT •

.
.

. . . . .
.....

. 5-1
5-2
. 5-4
. 5-5

ERROR MESSAGES
NETGEN MESSAGES
. . ..
NIPGEN MESSAGES
. . . . .
TKB36 AND VNP36 MESSAGES .

.....
. . A-I
. . . .
. . . . A-9
. . . . . . . . . . A-9

GLOSSARY
Index-l

INDEX
FIGURES
FIGURE

1-1
1-2
2-1
2-2
4-1
5-1

General Outline of Configuration Procedures
. . . 1-6
Installing DECnet-20 V3.0
. • • . . .
1-10
Configuration of DN20 Nodes m and n
. . • . . . . 2-5
Configuration of DN20 Node nand DN200 Node a
. . 2-5
System Startup . . . . . . .
. . . .
4-15
Path from Terminal to DN20 .
. . . . . . 5-4

CONTENTS (Cant.)

TABLES
TABLE

1-1

Supported Devices . . . . . . . . . . . . . . . . 1-15

PREFACE

This manual describes the configuration of DECnet-20 nodes in a DECnet
network and details all generation, verification, and installation
steps. It describes the DECnet-20 configuration tools, the procedures
to generate DN20 and DN200 subsystems, the NETGEN (NETwork GENeration)
and NIPGEN (Network Installation Procedure GENerator) program commands
and parameters, and illustrates a sample system configuration.
Audience Requirements

Before reading this manual, you should be familiar with the network
concepts, monitor commands, and utility programs described in the
following TOPS-20 companion manuals:
•

TOPS-20
update

Commands

and

its

•

TOPS-20 Operator's Command Language Manual (AA-H600A-TM)
its update

and

•

TOPS-20 User Utilities Guide (AA-D850A-TM) and its update

•

TOPS-IO/TOPS-20 Batch Reference Manual (AA-H374A-TK)

•

DECnet-20

•

DECnet-20 System Manager's and Operator's Guide (AA-J678A-TM)

•

TOPS-20 DN200 Remote Station Guide (AA-H786A-TM)

User'~

Reference

Manual

(AA-5ll5B-TM)

Guide (AA-J579A-TM)

Organization

If you have never performed a network generation and installation
procedure, be sure to read this manual. Even if you have previously
done a DECnet-20 installation, the procedures have changed so much
that you should reread the entire manual. The chapters of this manual
are summarized below:
•

Chapter I provides an overview of
the
entire
system
configuration procedure, describes the distribution tapes,
and presents hints for performing a successful configuration.

•

Chapter 2 provides an overview of NETGEN, its commands, their
parameters, and help and recognition features.

vii

•

Chapter 3 has an installation overview, with sections on
configuration of your DN20 and DN200 processors.

•

Chapter 4 contains an overview of the checkout procedures you
will use to verify the parts of your network.
It describes
the NIPGEN program, which generates the command and control
files used in verifying the system.
After successfully
following the procedures, you will have created the files
needed for system verification.
This chapter ends with
procedures for editing your system files and for bringing up
your new monitor and your new network software.

•

Ch2pter 5 presents procedures for checkout of the software in
each node.
After completing these procedures, your network
should be up and running.

•

Appendix A summarizes the error messages
displayed during the system build procedure.

•

Appendix B provides
terms.

glossary

that

hardware

may

the

and

software

command

Graphic Conventions
The following conventions
descriptions and examples:

are

used

this

manual

Meaning

Convention/Symbol
UPPER CASE

Upper case letters indicate actual input
required in a command string. You must type
an upper case element in full or with an
abbreviation acceptable to the system.

Lower Case

Lower case letters in a command string
(name,
indicate
an input variable type
number,
for example),
not
the
actual
variable determined by the operation.

Spaces

Spaces separate elements of a command. Tabs
or multiple spaces may also be used. Spaces
must be input where shown.

Red

Red characters indicate information that you
specify in typing the command.

Black

Black characters
information.

indicate

system-supplied

Indicates the place where you press the
labelled RETURN or CR.
the pl~ce where you press the
labelled ESC, ALT, or SEL.

Indic~tes

viii

KEY

CHAPTER 1
INTRODUCTION

DECnet-20 V3.0 is a software product that extends the capabilities of
TOPS-20 operating systems so that they may be interconnected with
other DIGITAL operating systems to form networks. The protocols that
govern message communication under DECnet-20 allow any task running
under the TOPS-20 operating system to communicate with any other task
in the network.
Tasks communicate with each other through nodes in the network.
Within a network, each node has a name and a unique identifying
address. You configure your network node by identifying the nodes in
the network and describing the hardware and software characteristics
of the nodes.
Network configuration is a semi-automated procedure that
the following steps:

consists

•

Creating the directories and data structure needed for
network generation, and restoring the distribution tapes to
disk.

•

Running the NETGEN (NETwork GENeration) program to describe
the DN20 front-end node and the DN200 remote job entry nodes
in your network.

•

Submitting DN20SYS.CTL and DN200SYS.CTL to complete node
generation. These batch jobs use files output by NETGEN.

•

Running the NIPGEN (Network Installation Procedure GENerator)
program.
NIPGEN creates the command and control files used
to build the network database and to verify and install the
DN20 and DN200 nodes configured by NETGEN, as well as the KL
host node and the remote nodes described to NIPGEN.

•

Verifying the connectivity between the configured
the adjacent nodes in the network.

1-1

nodes

and

INTRODUCTION
1.1

HARDWARE/SOFTWARE. ENVIRONMENT

This manual assumes that you will be running DECnet-20 on
a
DECSYSTEM-2040S/2060.
The same procedure is followed for each of
these machines. To run DECnet-20, the Version 5.1 monitor of the
TOPS-20 operating system must be available. You can either install
Version 5.1 first and have it running as you do this installation, or,
if you are upgrading from a previous TOPS-20 or TOPS-20/DECnet-20
release, you can do your installation with the previous release and
bring
up Version 5.1 when you reboot the system during your
installation.
You may be running in
either
time-sharing
or
stand-alone mode.
Network configuration files are provided on two distribution tapes:
•

DECnet-20 Distribution Tape

•

DN200 Remote Job Entry (RJE) Distribution Tape

The RJE tape is supplied only if your installation supports remote job
entry stations.
The distribution tapes are DUMPER tapes.
The
contents of these tapes are discussed in Section 1.3.1 and 1.3.2.
You must create directories on disk for storage of the generation and
installation files as discussed in Section 1.2. You will need the
following space allocations:
For DECnet-20 software:
3750 pages for working storage
3750 pages for permanent storage
For RJE-20 software:
1750 pages for working storage
1750 pages for permanent storage
For RJE dump files:
1000 pages for working storage
1000 pages for permanent storage
Be sure you
procedures.

have

enough

space

before

you

You use the following programs to perform the
installation:

begin
system

the

generation

•

DUMPER, a TOPS-20 file copy utility, which is
files from tape to disk.

•

NETGEN, an interactive software generation program, which
allows
you
to
describe
the
hardware
and software
characteristics of your DECnet-20 front end
(DN20)
and,
optionally, any remote job entry stations (DN200s). NETGEN
generates the appropriate .MAC files.

1-2

used

and
copy

INTRODUCTION
•

DNMAC, a cross-assembler for PDP-ll macro source files.

•

TKB36, a PDP-ll Task Builder, which builds the files used
generate the system.

•

VNP36, a Virtual Network Program, which generates the DN20 or
DN200 system image.

•

NIPGEN, an interactive network installation program, which
generates command and control files used to verify your
generated system and define your node database.

These programs are collectively known as the DECnet-20
tools."

1.2

"configuration

OVERVIEW OF CONFIGURATION PROCEDURES

To perform a system configuration, you must follow the steps described
in this manual.
These steps are illustrated in the flow charts in
this chapter.
If your installation is to support the remote job entry (RJE)
capability, you must use the RJE generation procedures. The RJE
procedure generates the RJE software for the DN200. The DN200 is a
remote station based on a PDP-ll/34A connected by a synchronous line
to a DN20. The DN200 provides an operator's console and may also
include a line printer, a card reader, or both. The software that
runs on the DN200 is called RJE-20.
Note that you must run the DN20 generation procedures before
the RJE generation procedures.

1.2.1

you

run

Overview of Procedure:
1.

Log into TOPS-20 with OPERATOR or WHEEL privileges.

If you are already a DECnet-20 user, verify that
and are on your system. If they are not, create
them. Be sure that and are empty
when you begin, and remember to use for
and for where necessary.

Create the following directories on disk:
•

PS: for generation files

•

PS: for
customized
files;
user-specified name and you can use
but as a convention, it is recommended
the 4-digit serial number of your
preceded by "D" and followed by "A" to
front end.

1-3

DxxxxA
is
a
any name you like,
that you specify
TOPS-20 KL system,
specify the DN20

INTRODUCTION
•

PS:, or PS: if you are upgrading, for
documentation and source files

•

PS: for source files

•

PS: for DECnet tools

Restore the generation files from the
the appropriate directories.

Read the Beware file.

1.2.2

distribution

tape

Generating a DN20 Node:

Connect to .

Run the interactive NETGEN program to describe the hardware
and software characteristics of your DN20 node. Note that
you must rerun NETGEN whenever you change your configuration
for example, when you add a line. The specifications you
enter to NETGEN must reflect the hardware at your site.

Check the output from NETGEN, using NETGEN's INFORMATION and
LIST commands, and change parameters if necessary until the
node configuration information is
correct.
When
the
information is correct, give the NETGEN SAVE and FINISH
commands to create your configuration files.

Use a SUBMIT command with the DN20SYS.CTL file to build
DN20 software. This also creates the DN20SYS.LOG file.

the

10.

Check the log file produced by the batch job for any errors
in the build process. Correct any errors and rerun NETGEN if
necessary.

11.

Copy DxxxxA.SYS to , or, if upgrading, .

1-4

INTRODUCTION
1.2.3
12.

Generating DN200 Nodes:
To support RJE stations, create directories:
•

PS:, or PS: if upgrading

•

a directory for each RJE station
named
,
,
and so on.
(You can use any name you like;
is only suggested.)

•

a directory called to receive dump files
from each RJE station.

•

a directory called PS: for source files.

13.

Restore files from tape.

14.

Connect to .

15.

Run NETGEN.
only.

16.

Check its output. When your configuration
correct, give the NETGEN FINISH command
configuration files.

17.

Submit the DN200SYS.CTL file to build the RJE software.

18.

Check the log file, correct any errors and
rerun NETGEN if
necessary.
You must repeat the RJE generation for each
station your system supports.

19.

Copy any DN200x.SYS files to ,
upgrading.

Note that the DN200 supports 1 DMR11 or 1

1-5

DMC11

information is
to create your

INTRODUCTION

Boot from
5.1 tape

5.0 or 4.x
i Have empty
PS:
PS:

for
5.1 files

Put 5.1 files
on

PS:
PS:

5.0 or 4.x
Reboot to
bring up
5.1

Put OECnet files
on

PS:
PS:
PS:
PS:
PS:

Run NETGEN
SUBMIT
ON20SYS
ON200SYS
Copy to System
areas
Edit System Files

Boot to
bring up
5.1 with
OECnet 3.0

MR-S-2241-62

Figure 1-1

General Outline of Configuration Procedures

1-6

INTRODUCTION

Revert to
5.0,
DECnet 2.1

Correct,
start net
manually
yes

Do
l . . - - - - - - - - - - - - - - - - . t NIPGEN
Tests

correct
errors

Edit NCP.CMD
to set up
node database

Run OPR, TAKE
NCP.CMD

MR·S·2242·82

Figure 1-1

General Outline of Configuration Procedures (Cant.)

1-7

INTRODUCTION
1.2.4
20.

1.2.5

Running NIPGEN:
Run the interactive NIPGEN program (described in Chapter 4)
to create the command and control files used to verify and
load your qenerated system.

Loading and Verifying Nodes:

21.

Copy the command files created by NIPGEN from your connected
directory to
< NEW-SUBSYS >

Create on PS:

Create on ps:

27·29

< DN200x·DUMPS >

30·31

Restore from
RJE·20
tape

Define SYS:
as ,

SYSTEM: as
,

9-12

Restore from
tape to
designated
directories

33·38

16·23

Run
NETGEN

SUBMIT
DN200SYS.CTL

no
no

SUBMIT
DN20SYS.CTL
41

Copy DN200x.SYS
to
PS: or
PS:

yes

Copy DxxxxA.SYS
26

PS:~~UBSYS:'> or
PS:

Figure 1-2

Installing DECnet-20 V3.0

1-10

INTRODUCTION

Copy files to
PS: SYSTEM' or
PS: containing documentation files
containing binary files
containing generation files
containing source files
containing decnet tools

The documentation includes:
•

.BWR (beware), .HLP (help)
associated with DECnet-20

and

.DOC

(documentation)

files

The binary files include:
•

Files needed to support the task-to-task, file transfer, and
network command terminal capabilities for your configuration.

•

Files needed to generate your front-end code, and
control files to check out your installation.

•

DNMAC.EXE, a cross-assembler for PDP-II macro source files.

•

NETGEN.EXE, a program that allows you to enter parameters for
your site and to construct the configuration files NETPAR.MAC
and CETAB.MAC, the system parameters and data base for the
node you are configuring, and NMLACC.MAC, which defines
access information that remote sites must furnish before they
can
issue certain commands to local DECnet-20 Network
Management.

•

NIPGEN.EXE, a program that enables you to generate files
verifying and loading your system.

•

TKB36.EXE, a program that constructs
images from object files.

1-12

PDP-II

formatted

create

for
task

INTRODUCTION
•

VNP36.EXE, a program that creates the front-end system image.

The generation files include:
•

PDP-II files for all modules needed for any configuration of
the DN20;
this includes task files, symbol tables, and
memory maps.

•

DN20SYS.CTL, a control file for building a DN2n front end for
DECnet-20 systems. When the commands in this file have been
executed, your front-end directory will contain the necessary
.STB, .MAP, .TSK, .SYS, and MCBMAP.TXT files for the DN20.

The source files contain source and control files needed to build
The tools contain unsupported
NFT.EXE, FAL.EXE, and NCPTAB.REL.
programs that may be useful.

1.3.2

DN200 Remote Job Entry (RJE) Distribution Tape

The RJE tape contains the following files:
•

PDP-II files for all modules needed for any configuration of
the DN200i
this includes task files, symbol tables, and
memory maps.

•

DN200SYS.CTL: a control file for building a DN200 front
for RJE systems.

end

When the commands in this file have been executed, your
front-end
directory
will
contain
the
necessary
.STB, .MAP, .TSK, .SYS, and MCBMAP.TXT files for the DN200.

1.4

PREPARING TO CONFIGURE

If you prepare carefully before performing the configuration procedure
described in this manual, these procedures will run more smoothly.
Observe the guidelines summarized below before you begin to configure
your system:
1.

Read this entire
manual.
Configuring
the
DECnet-20
communications
front
end requires an understanding of
parameters with which you may not be familiar. Terms used in
NETGEN and NIPGEN may also have a meaning which is specific
to the programs. This manual provides an introduction to
both hardware and software terms, a step-by-step summary of
the procedures used to generate, verify, and load the system,
a flowchart, examples of configuration operations, and a
glossary of terms.

1-13

INTRODUCTION
2.

Ensure that the hardware parameters accepted as defaults or
entered by you when running NETGEN reflect the cctual
hardware installed at your site.
Also ensure that software parameters are within the ranges
described in this manual.
You may rhoosp to accept the
defaults supplied by NETGEN for software parameters; this is
a safe procedure, but one which may not result in optima]
performance, particularly if you have high network usage and
the maximum number of lines.
Do not enter a value other than the defauJt
without
understanding the tradeoffs involved in each specification.

Collect the information
you
will
need
during
your
configuration of nodes.
Use Llle Installation Worksheet
provided on the next page as a guide to the information you
must have before you begin. Some of this informction may be
available only from field service.

Ensure that you are familiar with the aPR-ORION facilities
under
GALAXY
(See TOPS-20 Operator's Command Language
Reference Manual). You can successfully complete procedures
by following system directions. However, you will be better
prepared to handle unexpected situations if you are familiar
with the aPR-ORION facilities.

Review the capabilities provided by the DUMPER program and
the batch system,
if you are not familiar with these
programs. Both DUMPER and the batch system are used during
this installation. Refer to the TOPS-20 Operator's Guide for
information on DUMPER and batch processes.

Secure a terminal and location where you will not be
interrupted during the on-site configuration, and set aside
at least two hours for
the
configuration
procedure.
Depending upon your own rate of progress, the characteristics
of your configuration, and the response time
of
the
timesharing system being used, the actual time may be less or
more than this period. Most of the steps in this procedure
can be done with a system under normal timesharing. However,
to activate any edits to PTYCON.ATO and 5-l-CONFIG.CMD, you
must shut the system down temporarily and bring it up again.

1-14

INTRODUCTION

1.4.1

DECnet-20 Installation Worksheet

You must know your
hardware
configuration
to
perform
thlS
installation.
The
maximum
number of each type of supported
communications device is shown in Table 1-1.
For more information,
see the DECnet-20 V3.0 SPD (Software Product Description).
Table 1-1
Supported Devices
Up to

Device

DMClls

2 at lOOOkb
4 up to 56kb

DMRlls

2 above 56kb
4 up to 56kb

KDPs

DUPlls for each KDP

Hardware:
DN20:
DTE20 number (DTE-O-l, -2, or -3):
Cost:
Number of DMClls (0 to 5):
DMC-O Duplex (full,half):
Cost:
Cost:
DMC-l Duplex (full,half):
DMC-2 Duplex (full,half):
Cost:
DMC-3 Duplex (full,half):
Cost:
DMC-4 Duplex (full,half):
Cost:
Number of DMRlls (0 to 5)
DMR-O Duplex (full,half):
Cost:
DMR-l Duplex (full,half):
Cost:
DMR-2 Duplex (full,half):
Cost:
DMR-3 Duplex (full,half):
Cost:
DMR-4 Duplex (full,half):
Cost:
Number of KDPs (0 to 2)
KDP-O: Number of DUPlls (0 to 3)
KDP-O-O Maximum Baud Rate:
Cost:
KDP-O-l Maximum Baud Rate:
Cost:
KDP-0-2 Maximum Baud Rate:
Cost:
KDP-0-3 Maximum Baud Rate:
Cost:
KDP-l: Number of DUPlls (0 to-3f
KDP-I-O Maximum Baud Rate:
Cost:
KDP-l-l Maximum Baud Rate:
Cost:
KDP-1-2 Maximum Baud Rate:
Cost:
KDP-1-3 Maximum Baud Rate:
Cost:
DN200:
Card Reader (yes or no)
Line Printer (yes or no)
DMCll or DMRll:
Cost:

1-15

INTRODUCTION
NOTE

In your DN20, hardware addresses for
DMClls must precede hardware addresses
for DMRlls to
be
compatible
with
DECnet-?O NETGEN.
Tf your DN20 contains
both types of devices, and you are not
sure if this addressing rule has been
followed, consult your Field Service
representative.

Software:
Tapes~

DECnet-20
RJE-20
TOPS-20 5.1 Monitor

Disk Space Needed:
For DECnet-20 Software:
3750 pages
For RJE-20 Software: 1750 pages
For RJE-20 Dumps: 1000 pages
DN20 Node:
Name:
Address (1 to 255):
Buffer Size (290 to 576):
Identification (1 to 32 characters)
Inactivity Timer (1 to 65535 seconds)
Management Account:
Management Password:
Management User:
Maximum Address (2 to 255):
Maximum Cost (1 to 1022):
Maximum Hops:
(1 to 30)~______________________
Maximum Visits (16 to 255)
Maximum Links (3 to 16):
Maximum Phase-II Links (0 to 40):
Outgoing Timer (1 to 65535 seconds)
Routing Timer (1 to 65535)
Phase-II Transmit Password (1 to 8 characters)
Retransmit Factor (1 to 15)

Initial Settings
None
None
576
DECnet-20 V3.0 Release
30
None
None
None
255
100
16
32
8
20
30
60
DECNET20
5

DN200 Nodes:
Name:
Address (1 to
255) :
Host User Name:

-DUMPS
-----DUMPS

Host Account:
DN20 Data Link:

1-16

-DUMPS
-----DUMPS

INTRODUCTION

1.4.2

Network Nodes for NIPGEN
Host Node Address:
Name:
User Name:
Account:
Password:
Host Data Link:

Remote Node Address:
Name:
Ph a s e I I I (y ,n) :
File Xfer (FAL) (y ,n) :
User Name:
Account:
Password:

DN20 Node Address:
Name:

Remote Node Address:
Name:
Phase I II (y ,n) :
File Xfer (FAL) (y ,n) :
User Name:
Account:
Password:

DN200A Node Address:
Name:
DN20 Data Link:

Remote Node Address:
Name:
Phase III(y,n):
File Xfer (FAL) (y ,n) :
User Name:
Account:
Password:

DN200B Node Address:
Name:
DN20 Data Link:
DN200C Node Address:
Name:
DN20 Data Link:

Remote Node Address:
Name:
Phase III (y ,n) :
File Xfer (FAL) (y ,n) :
User Name:
Account:
Password:

DN200D Node Address:
Name:
DN20 Data Link:
Remote Node Address:
Name:
Phase III(y,n):
File Xfer (FAL) (y ,n) :
User Name:
Account:
Password:
Remote Node Address:
Name:
Phase III (y ,n) :
File Xfer (FAL) (y ,n) :
User Name:
Account:
Password:

1-17

CHAPTER 2
NETGEN OVERVIEW

This chapter describes the hardware and software terms that are used
in performing network configuration procedures.
You may not be
familiar with some of the terms or with the specific meaning which
these terms have for NETGEN or the other DECnet-20 configuration
tools.
The NETGEN (NETwork GENeration) program enables you to describe the
hardware and software characteristics of your DN20 and DN200 nodes by
specifying values for a variety of hardware/software parameters.
NETGEN supplies defaults for all of these parameters. You may accept
the defaults for many of these parameters or may specify new values
that are more appropriate for your own configuration. You may specify
a parameter by issuing NETGEN commands and responding to prompts.
The NETGEN LIST command may be issued at any time to display the
values currently in effect for all of your configuration's hardware
and software parameters.

2.1

PARAMETERS

This section summarizes the parameters you enter when running NETGEN.
Parameters are described in their order as seen with the NETGEN LIST
EXECUTOR CHARACTERISTICS command. Only parameters you can change with
NETGEN are listed. Others are not user settable. Hardware is listed
at the end of this section.
Meaning

Parameter
Node type

DN20
for
a
Type of node being generated:
DECnet-20 front end or DN200 for a remote job
entry (RJE) station. Using the DN20 node type
implies use of the DTE20 device; using the DN200
node type implies use of the DMC or DMR device.
Default:

Node name

DN20

Name for the node you are generating with NETGEN.
The name must include at least one alphabetic
character and cannot exceed six characters.

2-1

NETGEN OVERVIEW
Parameter

Meaning

Node address

Number which identifies the address of node being
generated. This address must be unique within the
network.
Any decimal number in the range 1
throuqh 255 may be specifipo, provided that it
does not duplicate an address assigned to another
node in the network. Generally, you should use
low numbers for addresses of nodes in a small
network.
You cannot use a node address larger
than the Maximum Andress you specify.
If you
enter an address incompatible with your Maximum
Address or Buffer Size, NETGEN warns you.

Identification

A string you can use to identify the software you
~re
generating.
The string can be seen Wlth the
NCP SHOW EXECUTOR CHARACTERISTICS command.
You
can specify any text string of 1 to 32 characters.
Default:

Outgoing Timer

The number of seconds to wait for acknowledgement,
from a remote node, to a connect request issued
locally. The range is 1.
to 65535. seconds.
Default:

Maximum Links

The number of times the node software retransmits
a message without receiving acknowledgement before
the DECnet-20 software running in
the
node
determines that the physical link supporting a
logical link has failed.
The range is 1 to 15.
Default:

Routing Timer

supported

Number of seconds to wait before exercising a
logical link when there is no received traffic on
the link. This can happen, for example, because
the
network is disconnected, or because the
physical line went down. When the timer runs out,
NSP sends a data request message over the logical
link. If, after a certain amount of time
(see
Retransmit
Factor)
there
has
been
no
acknowledgement of the message, NSP decides that
the physical network supporting the logical link
has failed. The range for the inactivity timer is
1 to 65535 seconds.
Default:

Retransmit Factor

The maximum number of logical links
DECnet-20. The range is 3 to 16.
Default:

Inactivity Tirrer

DECnet-20

Maximum
routing

5
time

mpss~ge.

Default: 60

2-2

elapse before transmitting a
The range is 1 to 65535 seconds.

NETGEN OVERVIEW
Parameter

Maximum Address:

Meaning

Maximum address for a node in the same network as
the node you are configuring. The specified value
must be at least equal to tne node address of the
node
you
are
configuring.
This parameter
determines the highest node address
in
the
network.
The range is 2 to 255. The Maximum
Address, node Address, and the Buffer Size you use
must be compatible. NETGEN computes buffer size
depending on the maximum address you enter, and
warns you if they are incompatible.
Defaul t:

Maximum Cost

Highest allowable "cost"
associated
with
a
particular
logical
path.
This parameter is
dependent Qn the individual line costs (the costs
of transferring a message over a line) and path
costs. The range is 1 to 1022.
Defaul t:

Maximum Hops

The maximum number of visits to network nodes that
any message can make.
A node that receives a
message with a visit count greater than the value
of Maximum Visits set discards the message. The
Maximum Visits value set must be greater than or
equal to the Maximum Hops set. The range is 16 to
255.
Default:

Buffer Size

100

The maximum number of hops allowed between any
pair of nodes in the network. The largest value
for maximum hops in a network is the network
"diameter".
You cannot set the value of Maximum
Hops lower than the value of Maximum Visits.
The
range is 1 to 30.
Default:

Maximum Visits

255

2 times Maximum Hops:

The size of buffers used to transmit and receive
data over any physical link in the network. The
size you specify must be the same on every node in
the network. A DECnet-20 node cannot communicate
with any node whose buffer size differs from its
own.
The smallest buffer size useable in a given
network depends on the number of nodes in the
network.
The buffer size is (2* Maximum Address)
+5, but not less than 290. The range is 290 to
576.
NETGEN computes the minimum buffer size depending
on the maximum address you enter. If you enter a
buffer size that is less than the
computed
minimum, NETGEN warns you.
Defaul t:

576

2-3

NETGEN OVERVIEW
Parameter
Maximum Phase-II
Links

Meaning
Maximum number of logical links to be supported
for communication with adjacent Phase II nodes.
The number can be 0 to 40.
Defaul t:

Phase-II Transmit
Password

Optional parameter identifying the password sent
to a remote node during a Phase II initialization
sequence.
The password must be a text string
consisting of I to 8 characters.
DECnet-20 does
not check passwords on received messages, but
other DECnet implementations
may.
Set
the
transmit password to match the password expected
by other Phase I I nodes.
Default:

Management
Parameters:

DECNET20

Three parameters you can set to restrict users at
remote terminals from giving NCP commands at your
local DN20 node. The parameters are:
Up to 16 characters long.
Up to 16 characters long.
Up to 8 characters long.

Account
User I.D.
Password

The default for each is a null string. If you do
not enter any of these access control parameters,
any user at any remote terminal has unrestricted
access to local Network Management commands. Each
non-null string must be matched by the remote user
before
the remote user can execute any NCP
command, other than SHOW, on your local node.
Character strings can be null, or contain any
alphanumeric characters including "" and "-"
The account parameter is not checked by DECnet-20.
The management parameters are not displayed with
LIST EXEC CHAR unless set by the user. You will
also use these parameters when you run NIPGEN.
Default:
KDPs

Number of KDPs on your DN20 (0 to 2). A KDP is a
combination of a KMC1I controller and one to four
DUPll's (the default is two DUP1I's).
With the
KMC, the DUPll functions as a direct memory access
device (DMA). The interface is synchronous.
Default:

DUPlls

Number of DUPlls on your KDP (0 to 4).
Default:

DMClls

null strings

if no KDP)

Number of DMClls on your DN20 (0 to 4). The DMC1I
is a single-line microprocessor-based interface. to
the network.
The DMCll is a synchronous DMA
device.
Default:

2-4

NETGEN OVERVIEW
Parameter

Meaning

DMRlls

Number of DMRlls on your DN20 (0 to 4).
The DMRll
is a single-line microprocessor-based interface to
the network.
The DMRll
is a
synchronous DMA
device.
Default:

DTE20 number

Number of the DTE20 with which the DN20 interfaces
to the DECSYSTEM-2040S/2060 processor.
This is
not the number of DTE20s.
Normally, the DN20 used for DECnet-20 uses DTE20
number 1, 2, or 3.
You cannot use DTE20 number 0
which is always dedicated
to the console front
end.
Default:

Line printer

Line printer in your configuration.
parameter only for a DN200.
Default:

Default:

Specify

this

Specify

this

Card reader in your configuration.
parameter only for a DN200.

Card Reader

2.2

DTE-O-l

REPRESENTATIVE CONFIGURATIONS

The following diagrams illustrate possible configurations that you can
specify with NETGEN.

KLx

KLy

MR-S-2298-82

Figure 2-1

Configuration of DN20 Nodes m and n

KLx

MR-S-2299-82

Figure 2-2

Configuration of DN20 Node nand DN200 Node a

2-5

NETGEN OVERVIEW
2.3

NETGEN COMMANDS

The NETGEN (NETwork GENeration)
program is an interactive program
which
helps
you
to configure your installation by producing
configuration files for a DN20 or DN200 DECnet-20 node. You can use
NETGEN commands to display and/or change the network node type,
parameters, and communications equipment.
The files produced by
NETGEN are used in later steps of the network generation procedure.
NETGEN is the core of the configuration procedure described in this
manual.
Use of this program requires that you be familiar with the
hardware and software concepts discussed in Chapter 1, and with the
characteristics of your own configuration.
NETGEN must be run once without errors to generate the basic DN20
capability.
III
addition, I I tne remote job entry (RJE) (DN200)
feature is to be generated at your installation, NETGEN must be run
once for each DN200 in your configuration. You must also repeat these
configuration procedures whenever you
change
the
local
node
configuration - for example, when you add a line to the configuration.
NETGEN commands are of two types:
•

NETGEN-only commands such as STAFT and INCLUDE

•

NCP-type commands such as DEFINE and LIST

NETGEN-only commands apply only to NETGEN and are unique to NETGEN.
NCP-type commands are designed to contain the same parameters and
syntax as the NCP commands of the same form you can execute th~ough
OPR.
NCP-type commands do not provide the same guideword facilities
as NETGEN-only commands.

2.3.1

NETGEN Help and Recognition Features

NETGEN provides several features that
commands and arguments:

help

you

enter

necessary

•

You may type a question mark in response to the NETGEN prompt
to display a list of NETGEN commands.

•

You may follow a command name with a question mark to display
a prompt for the valid arguments.

•

You may follow a command name with an ESCAPF key to display a
guideword for the argument.

•

You may take advantage of NETGEN's recognition input feature.

2.3.1.1 Requesting a List of Commands - You may ask NETGEN to display
a list of valid commands by responding to the NETGEN> prompt with a
question mark (?). An example is shown below:
NETGEN>? one of the following:
Define'
Exclude
Exit
Include
Information List
Purge
Push
Restore
Take

2-6

Finished
Log
Save

Help
None
Start

NETGEN OVERVIEW
2.3.1.2 Requesting a List of Arguments and Values - When you specify
a particular command and are not certain about its valid arguments,
you may type the command name, followed by a space, followed by a
question mark. NETGEN responds by displaying the valid arguments for
the command. For example:

NETGEN>include (in configuration) ? one of the following:
Card-Reader
DMCll
DMRll
DTE20 KDP
Line-Printer
NETGEN>include (in configuration)
You may also use the question mark to request that NETGEN display the
values for a particular argument. For example, suppose you wish to
specify that the controller in your configuration is a KDP. Type KDP,
press the space bar, and type a question mark. NETGEN responds with a
prompt for more information about the KDP and the legal range of
values for your response. After you enter an appropriate response,
NETGEN will continue to prompt for additional information. An example
is shown below.

NETGEN>include (in configuration) kdp (number) ? KDP number, 0 to 2
NETGEN>inc1ude (in configuration) kdp (number) 0 ? confirm with carriage return
NETGEN>include (in configuration) kdp (number) 0 ~
Number of DUPll 1 ines on this KDP: 1 ~
KDP-O-O Maximum Baud Rate: ? one of the following:
1200
1800
19200
2400
3600
4800
7200
9600
KDP-O-O Maximum Baud Rate: 2400 ~
KDP-O-O Cost: 2 ~
NETGEN>

If you type? at the end of a command, when no further
expected, NETGEN displays the message shown below.
NETGEN>include kdp (number) O?
NETGEN>include kdp 0

response

confirm with carriage return

Respond by pressing the RETURN key.

2.3.1.3 Requesting a Guideword for the Argument - If you follow KDP
by pressing the ESCAPE key (~ ) instead of a question mark, NETGEN
displays a guideword indicating the type of response
(for example,
"number") that is required. An example is shown below.

NETGEN>include kdp (number)
If you type ~ at the end of a command, that is, when no further
response is expected or if no guideword is provided, NETGEN ignores
the ~ character. However, for the INCLUDE and EXCLUDE commands,
NETGEN supplies defaults.

2-7

NETGEN OVERVIEW
2.3.1.4 Using Recognition - The TOPS-20
recognition
feature
is
provided for NETGEN and operates according to standard TOPS-20
conventions. The recognition feature allows you to use the ESCAPE key
to complete commands. Because you may not be familiar with the NETGEN
commands, recognition is likely to be very helpful when you use
NETGEN.
An example of recognition is included below.
In this example, the
same instructions require more than twice as many key strokes for full
input as for recognition input. Notice how the guidewords in this
example lead you to enter the correct response.
Full input:
NETGEN>save PS:CONFIG.CNF

Using recognition:

~
NETGEN>SAve (configuration on) PS:CCNFIG.CNF

2.3.2

NETGEN Error Messages

NETGEN provides error messages both for syntax errors and for assembly
errors.
NETGEN error messages are described in Appendix A, "Error
Messages." If you enter an incorrect command or argument, NETGEN
displays an appropriete message. For example, the following shows an
invalid command:
NETGEN>pop ~
? Does not match switch or keyword
NETGEN>
The following shows another common error message:
NETGEN>node address ABC
? First nonspace character is not a digit
NETGEN>
In this example, NETGEN expected but did not receive a numeric value.

2-8

NETGEN OVERVIEW
2.3.3

NETGEN Reconfiguration Facilities

NETGEN provides a RESTORE facility to simplify reconfiguration of a
network node.
When you use this facility, you must have a .CNF file
containing your front-end configuration created earlier.
You tnen
RESTORE the .CNF file, make the changes you need to the configuration
with INCLUDE or DEFINE commands, SAVE the edited file and use the
FINISH command to generate all the other NETGEN output files. Use
INCLUDE to change your hardware configuration, DEFINE to change any
software specifications.
You can find an example of using the RESTORE/SAVE/FINISH
Chapter 3, "Installation."

2.4

commands

NETGEN COMMAND SYNTAX

The syntax for the individual NETGEN commands is described on the next
few pages.

2-9

NETGEN OVERVIEW
CCBS

2.4.1

DEFINE EXECUTOR:

Defining Executor Characteristics

Description:
Defines the characteristics of your
eXecutor
nUJle.
The
management arguments restrict users at remote locations from
giving NCP commands at your local node. All numeric values to
the arguments are decimal.
Arguments:
Address: numeric value, 1 to 255
Buffer Size: numeric value, 290 to 576
Identification: text, 1 to 32 characters
Inactivity Timer: numeric value, 1 to 65535 seconds
Management Account: string, 0 to 16 characters, " " and " - "
Management Password: string, 0 to 8 characters, " " and " - "
Management User-Id: string, 0 to 16 characters, " " and " - "
Maximum Address: numeric value, 1 to 255
Maximum Cost: numeric value, 1 to 1022
Maximum Hops: numeric value, 1 to 30
Maximum Links: numeric value, 3 to 16
Maximum Phase-II Links: numeric value, a to 40
Maximum Visits: numeric value, 1 to 255
Nome: node name, 1 to 6 characters
Outgoing timer: numeric value, 1 to 65535 seconds
Phase-II Transmit Password:
text, 1 to 8 characters
Retransmit Factor: numeric value, 1 to 15
Routing Timer: numeric value, 1 to 65535 seconds
Example:
NETGEN)cef exec

2~d

1 eRfT)

2-10

NETGEN OVERVIEW
EXCLUDE

2.4.2

EXCLUDE: Removing a Device

Description:
Removes a device from the configuration.
In certain cases, default is provided for
If you type:

the

EXCLUDE

command.

NETGEN will automatically fill
in the most recently
device number. This applies to the following:

included

~
exclude dmrll (number)

exclude kdp
exclude dmell
exclude dmrll
Arguments:
Card-Reader
DMCll: number of
DMRll: number of
DTE20 : number, 1
number, 0
KDP:
Line-Printer
Example:

DMCll, 0 to 5
DMRll, 0 to 5
to 3
to 2

NETGEN>exclude (from configuration) ? one of the following:
DTE20
KDP
DMRll
Card-Reader DMCII
Line-printer

NETGEN>exclude (from configuration) KDP (number)
NETGEN>

2-11

0 ~

NETGEN OVERVIEW
EXIT
2.4.3

EXIT: Exiting from NETGEN

Description:
Exits from NETGEN procedure.
Saves no files.
To save your
configuration files, use SAVE and FINISH before ty?ing EXIT.
Argument:
None
Example:
NETGEN>exit CEQ (from NETGEN)

2-12

NETGEN OVERVIEW
FINISHED
2.4.4

FINISHED: Finishing the Configuration

Description:
Indicates that you have finished with the confiquration.
When
you
give
this
command, NETGEN writes its- output files,
NMLACC.MAC, CETAB.MAC and
NETPAR.MAC,
to
your
connected
directory.
If you have generated a system that is not a
supported configuration, NETGEN warns you.
Argument:
None
Example:

GD
~

NETGEN)finished (with configuration) ~
[Generating PS: help (wi th NETGEN)

NETGEN-20 is the tool that produces configuration files for a
DN20 or DN200 DECnet-20 node.
Using its commands, you can
display and/or change network node
type,
parameters
and
communications configuration. NETGEN allows recognition (use of
ESC key) and help text (use of? key) to aid your selection of
le?al options.
Typically, you will use NETGEN to:
-select node type: DN20
or DN2 00

(task-to-task node) - (defaul t)
( r em 0 t e job en try s tat ion)

-include synchronous communication line(s)
-optionally, change parameter settings
configuration to suit local needs
-write the configuration
which
will
be used
Installation Procedure.
NETGEN>

files CET,l'1l3.MAC
by later steps

2-14

tailor

your

and NETPAR.MAC,
in the Network

NETGEN OVERVIEW
INCLUDE
2.4.6

INCLUDE: Adding a Device

Description:
Adds a device to the configuration.
In certain cases, an automatic
INCLUDE command. If you type:
include kdp

default

provided

for

(number)

NETGEN will provide as a default 0 or the next available
This applies to the following:
include
include
include
include

the

number.

kdp
dmcll
dmrll
dte20

Note that INCLUDE DTE20 ~ always defaults to 1 if the
type is DN20. There is no default DTE number for DN200s.

node

If you include a KDP, NETGEN prompts you to specify the number of
lines on the KDP and the maximum baud rate and cost for each.
If
you include a DMCll or DMRll, NETGEN prompts you for transmission
mode (full or half duplex) and cost for each.
Arguments:
Card-Feader (1 for a DN200)
DMCll:
number of DMCll, 0 to 5; duplex, full or half~ cost,
1 to 25
DMRll:
number of DMRll, () to 5 ; duplex, full or half~ cost,
1 to 25
number, 1 to 3 ; cost, 1 to 25
DTE20:
number, 0 to 2 ~ maximum baud rate, 1200 to 19200~ cost,
KDP:
1 to 25
Line-Printer ( 1 for a DN200)
Example:

GD
~

NETGEN> include (in configuration) ? one of the following:
Card-reader
DMC11
DMR11
DTE20
KDP
Line-l)[ inter
NETGEN>inc1ude (in configuration) kdp ~ (number) ? KDP Number, 0 to 2
NETGEN>inc1ude (in configuration) kdp (number) 0 ? confirm with carriage return
NETGEN>inc1ude (in configuration) kdp (number) 0 ~
Number of DUPll 1 ines on this KDP: 1 (RET)
KDP-O-O Max imum Ba ud Ra te: ? one of the-To llow ing:

1200

1800

19200

2400

3600

4800

KDP-O-O Maximum Baud Rate: 24no (RET)
KDP-O-O Cost: ? Cost of this circu-rf, 1 to 25
KDP-O-O Cost: 1 ~
NETGEN>inc1ude (in configuration) DMCll (number)
DMC-O Duplex: ? one of the following:
Full
Half
DMC-O Duplex: full (RET)
DMC-O Cost: ? Cost or-this circuit, 1 to 25
DMC-O Cost: 2 ~
NETGEN>

2-15

7200

GIO

9600

NETGEN OVERVIEW
INFORMATION
2.4.7

INFORMATION: Displaying Node Information

Description:
nic:nl:=!uc:
.

---,--~.l-

information

I'"'n

.L.

the

t-.. ..... J-

LilCi L

l- ...... __ .......
tlCi v C

1-. ____ __
UCCLI

--'':)e
L

•

A.rguments:
Card-Reader
Line-Printer
Node
Node-Type
Example:

~
.
NETGEN>INFormatlon (about) Noce ? confirm with carriage return
NETGEN>INFOrmation (about) Nooe (RET)
KKLLMM
Node name is:
Node address is:
2
Node type is:
DN20 (defaul t)
Line printers:
o (default)
CRlls:
o (default)
NETGEN>

2-16

NETGEN OVERVIEW
INFORMATION

2.4.8

LIST: Displaying Characteristics

Description:
Displays the characteristics you have set for your executor or
your known circuits. The management parameters do not appear if
you have not set them.
Arguments:
Executor characteristics
Known Circuits characteristics
Known Lines characteristics
Examples:
N'ETGEN> List executor characteristics

Executor Node = 2 (KKKLLL)
Identification = hhh
Management Version
3.0.0
Loop Count = 1
Loop Length = 127
Loop With = Mixed
Incoming Timer = 10
Outgoing Timer = 30
NSP Version = 3.2.0
Maximum Links = 8
DeJay Factor = 2
Delay Weight = 3
Inactivity Timer = 30
Retransmit Factor = 5
Routing Version = 1.3.0
Type = Routing
Routing Timer = 60
Maximum Address = 255
Maximum Circuits = 1
Maximum Cost = 100
Maximum Hops = 16
Maximum Visits = 32
Buffer Size = 576
Maximum Phase II Links = 20
Phase II Transmit Password
DECNET20
Management User = klh
Management Account = 341
Management Password = (password set)
NETGEN>list known circuits characteristics
Circuit = DTE-O-l
Cost = 1
Hello timer = 10
Listen timer = 60
Owner = Node / 2 / KKKLLL
Line = DTE-O-l

2-17

NETGEN OVERVIEW
INFORMATION

Circuit = DMR-O
Co s t = 1
Hel]o Timer = 10
Listen timer
60
Owner = NODE / 2 / KKKLLL
Line
DMR-O
Type = DDCMP-DMC
NETGEN>lis':- Kr.own lines characteristics

Line = DTE-O-l
Device = DTE-O-l
AA''
U
Controller Register _ ' ' iIA"t'f"t
Interrupt Vector = 770
Interrupt Priority = 7
Pause Timer = 30
-

Line = DMR-O
Device = DMR-O
Receive Buffers = 10
Controller = Normal
Duplex = Half
Protocol = DDCMP-DMC
Clock = External
Service Timer = 3000
Retransmit Timer = 3000
Controller Register = 160740
Interrupt Vector = 670
Interrupt Priority = 5
Line = KDP-O-O
Device = KDP-O-O
Controller = Normal
Duplex = FuJI
Protocol = DDCMP-DMC
Clock = External
Service Timer = 3000
Retransmit Timer = 3000
Controller Register = 160540
Unit Register = 160300
Interrupt Vector = 540
Interrupt Priority
5
Baud Rate = 2400

2-18

NETGEN OVERVIEW
INFORMATION
2.4.9

LOG: Logging NETGEN Commands

Description:
Logs all of your NETGEN commands in a disk file.
If you make a
mistake in your NETGEN procedure, you can TAKE this log file
instead of reentering all of the commands.
Argument:
output filespec
Example:
~

NETGEN> log (TTY input to file)
NETGEN>log (TTY input to file)

? name of output file to record TTY input
marl.LOG ~

NETGEN>

2-19

NETGEN OVERVIEW
NODE
2.4.10

NODE: Specifying the Node Type

Description:

Spprifips the node type for the i.:08e bcin?
Argument:
Type

DN20 or DN200

Example:

GD
NETGEN>node type
DN20
DN200
NETGEN>node type
NETGEN>

(is)

one of the following:

(is)

dn20

2-20

NETGEN OVERVIEW
NODE
2.4.11

PURGE EXECUTOR: Removing a Parameter

Description:
Removes a parameter you have previously set for your executor.
Arguments:
Identification
Management Account
Management Password
Management User
Outgoing Timer
Phase-II Transmit Password
Example:
NETGEN> purge executor outgoing timer
NETGEN>

2-21

NETGEN OVERVIEW
NODE

2.4.12

PUSH: Entering the TOPS-20 Executive

Description:
Transfers you from NETGEN command level to the TOPS-20 Command
Processor
(EXEC).
While at this level, you can issue any
necessary TOPS-20 commands. The NETGEN commands that you have
entered are not lost.
You can return to NETGEN by giving the
TOPS-20 command, POP.
Argument:
None
Example:
NETGEN>push

TOPS-20 Command processor 5(711)
@pop~

NETGEN>

2-22

NETGEN OVERVIEW
RESTORE
2.4.13

RESTORE: Restoring a Saved Configuration

Description:
Restores the file saved from a file on ~isk.
You may override
the default by specifying a different directory or file name.
For example, the command:
RESTORE PS:

Restores the configuration from the previous .CNF file you have
used.
When you use the RESTORE command, cumulative updates are
done in order.
Argument:
input filespec
Example:

NETGEN>restore (configuration from) ? input filespec
NETGEN>r estore (conf igur at ion from) rna r 1. c nf ~
[Configuration Restored From: PS:MARL.CNF.ll
NETGEN>

2-23

NETGEN OVERVIEW
SAVE
2.4.14

SAVE: Saving a Configuration

Description:
SaveS lhe currenl parameter seLlings in a file on Jisk.

Argument:
output filespec
Example:

•

NETGEN>save (configuration on) ? output filespec
NETGEN>save (configuration on) marl.cnf ~
[Configuration Saved On: PS:MARL.CNF.l]
NETGEN>

2-24

NETGEN OVERVIEW
SAVE

2.4.15

START: Entering NETGEN Dialog

Description:
Engages the user in an interactive dialog with which he/she gives
node configuration specifications.
NETGEN gives warning and
fatal error messages as necessary, and, if there are no fatal
error messages, writes output files to the user's connected
directory. The user may need to give additional configuration
commands and enn the task with SAVE and FINISH commands. NETGEN
provides defaults for some parameters when you use the START
d i a 1 og . View the r) e fa u 1 t s wit h the ~ key .
.n.rgument:
None
Example:
raNETGENC§)
TOPS-20 Network Confiqurator for DN20 or DN200, Version 3(56)
[Type START to begin configuration dialog]
~

~
NETGEN)start (dialog for performing configuration)
Node type: dn200 ~
Node name: new2 @)
Node address: 20 ~
Do you have a card reader on this DN200? n

Do you have a line printer on this DN200? y ~
What is the communications line interface on the DN200?
Specify either DMCll or DMRll: dmcll ~
[Configuration Saved On: PS:take (commands from) ? input filespec
NETGEN>take (commands from) :llarLCTG G£)
NETGEN>

2-26

CHAPTER 3
INSTALLATION

This chapter describes how you use NETGEN to prepare configuration
software that will run in your communications.processor. Each section
in this chapter describes the configuration process for a separate
product. The products described in this chapter are:

3.1

•

DECnet-20 for a DN20

•

DECnet-20 for a DN200

DN20 CONFIGURATION

This chapter describes the procedures that you must follow to
configure the DN20 capability on any DECSYSTEM-2 n40S/2060. This is
the first step in generating and installing DECnet-20<. Steps in the
procedures nescribed in this and subsequent sections are numbered
sequentially throughout.
To perform an on-site configuration, you must have available the
Version 5.1 monitor of the TOPS-20 operating system. You can either
install Version 5.1 first and have it running as you do your on-site
configuration, or,
if you are upgrading from a previous TOPS-20 or
TOPS-20/DECnet-20 release, you can do your configuration with the
previous release and bring up Version 5.1 when you reboot the system.
Because command files, control files,
and logical definitions may
refer to certain files, you should ordinarily name and locate these
files as shown in the descriptions and examples shown below. If your
installation's conventions allow it, file names and locations may be
changed after the configuration and installation procedures have been
successfully completed. You should be aware, however, that should you
subsequently wish to reconfigure the system or to run validation or
certification tests for diagnostic purposes, you will have to resolve
references to files and data structures.
The parameters that appear in the commands below
characteristics:

the

following

•

All parameters have been chosen to ensure that the
runs efficiently.

procedure

•

Specified space parameters allow for expansion.

•

Specified actual and
referencing.

logical

3-1

names

have

permit

inter-directory

INSTALLATION
3.1.1

Initial System Setup

~ STEP 1:

If you are a new customer, you must bring up your TOPS-20 Version
monitor

hpforp

YOl]

('rln pprform

th;~

~tpr-

Haul?

yOllr

~y~tl?rn

5.1

files on

PS:,

If you are upgrading from a previous version of DECnet-20, use the
~

Determine if the PS: OR PS: DIRECTORY

If PS: DIRECTORY

The DN20 configuration files are located on the DECnet-20 distribution
tape in the directory PS:. Create a directory on disk named
PS:. Later in the generation procedure, you will copy the
generation files on the distribution tape to this disk directory.
This is your DECnet system directory.
Type:
$AECREATE PS: ~
[Newl
$$WORKING 1 one ~
$$PERMANENT 100(1 ~
$$PROTECTION 777740 ~
$$FILES-ONLY ~
$$MAXIMUM 1 ~
$$ ~

~STEP 6:

CREATE THE PS: DIRECTORY

Create a separate front-end directory on disk.
This directory will
contain only those files that are specific to the front-end software
you are generating.
You may give this directory any name you wish.
For purposes of
standard naming conventions, however, it is recommended that you use
the format PS:, where xxxx in the directory name corresponds
to the 4-digit serial number of your TOPS-20 KL system.
Type:
$AECREATE PS:
[Newl
$$WORKING 750 C§)
$$PERMANENT 750 ~
$$FILES-ONLY ~
$$ ~

~STEP 7:

CREATE THE PS: DIRECTORY

Create a directory for the DECnet sources.
Type:
$ AECREATE PS:
[NewJ
$$WORK 7 50 ~
$$PERM 750 ~
$$FILES-ONLY ~
$$ ~

3-3

INSTALLATION
~STEP 8:

CREATE A DECNET-TOOLS DIRECTORY

If you do not already have a DECnet tools directory, create one.
$ AECREATE PS: IDENTIFY tape-id REQ reauest-id
The specified request-id appears on the
operator's
console.
.The tape-id is
entered in the form MTAn, where
n
identifies the tape drive from which the
files are to be copied.
The system
associates the physical device MTAn with
your logical assignment to MTn.
Refer
to
the
TOPS-20
Operator's Command
Language Reference Manual for a complete
discussion of IDENTIFY and the other aPR
commands.
Note that the logical name used below
may be your first or last name or any
other valid string that you will be able
to remember.
~STEP 11:

RESTORE FILES FROM TAPE

Use DUMPER to restore files
directories created on disk .
•

from

the

distribution

tape

the

Remember to use PS: instead of
PS: instead of , if upgrading.

and

NOTE
Restoring the save sets not related to
configuring the front end is performed
at this time to avoid your handling the
tape a second time.

$ DUMPER C§)
DUMPER>TAPE MTAO:
C§)
DUMPER> REWIND C§)
DUMPER> .r"CCOUNT GD
(OF RESTORED FILES FROM) :::YS':'EM-DEF~,CLT QIiJ
DUMPER> RESTORE (ls()
(TAPE FILES) PS: GD <*>*. *. * (TO) ~
(or to RESTORE ~
(TAPE FILES)
(or to i f upgrading)
(Restores Binary files.)

PS:

DUMPER>RESTORE GD
(TAPE FILES)
(Restores DN20 Generation files)

PS:

DUMPER> RESTORE GD
(TAPE FI LES)
(Restores DECnet-20 source files)
DUMPER>RESTORE GD
(TAPE FILES)
(Restores DECnet-20 tools)
DUMPER> REVi"IND CE:D
DUMPER> EXIT CE:D

PS:

<*>*.*.*

PS:

3-5

(TO)

~ *.*.*

PS:

(TO)

C§)

PS:
*. *. *

(TO)

PS:

CE:D

INSTALLATION
~ STEP 12:

DISMOUNT THE TAPE

If you have tape-drive allocation enabled, type:
$DISMOUNT TAPE logical name:
$

If you do not have tape-drive allocation enabled, type:
$DEASSIGN MTl\O:
~ STEP 13:

READ THE BEWARE FILE

Before proceeding, read the DECnet-20 BEWARE file,
have restored to PS:(DECNET> or PS:(NEW-DECNET> .
. . STEP 14:

you

CONNECT TO
. . STEP 15:

DECNET.BWR,

For example:

CREATE THE FILE DSK.CMD

You must create a file called DSK.CMD to define the DSK: search list
for a batch job you will submit later.
Create DSK.CMD ,in the
directory where you build the front-end, PS:.
DSK.CMD must
contain the entry:
DEFINE DSK:

DSK:, PS:

PS:(DN20> is the directory where you have restored the DN20 files from
your DECnet-20 oistribution tape. If you are using another directory
for the DN20 files, specify that directory in DSK.CMD instead of
PS:(DN20>.
~

STEP 16:

RUN THE NETGEN PROGRAM

Run NETGEN, which is the heart of
Type:

the

system

generation

procedure.

$NETGEN C§)
NETGEN responds with an identifying message:
TOPS-20 Network Configurator for DN20 or DN200, Version 3(56)
[Type START to begin configuration dialog]
The program prompts for each NETGEN command by displaying:
NETGEN>
The procedure shown in this section serves only as a model. You must
use the NETGEN options that are appropriate to the hardware and
software in your configuration. The specifications you enter with
NETGEN must reflect the hardware at your site.
Do not specify
hardware devices not on your system. Use your Installation Worksheet.

3-6

INSTALLATION
~STEP 17:

DISPLAY NETGEN DEFAULTS

Display the node type default by issuing the INFOBMATION command.
the LIST command to see the initial settings of all parameters.

Use

NETGEN) information (about) node ~
Node name is:
(default)
Node address is:
0 (default)
Node type is:
DN20 (defaul t)
Line printers:
0 (default)
CBlls:
0 (default)
NETGEN)

~STEP 18:

SPECIFY YOUR PARAMETERS

Describe your own configuration by entering your parameters. You can
either use the dialog triggered by the STABT command, enter your own
list of commands individually, or both. To use commands other than
the START command, see Chapter 2, NETGEN. You will need to enter
parameters summarized in the Installation Worksheet. With the START
command, some parameters have defaults you can obtain with ~ .
Note that if you respond that there are KDPs on your DN20, NETGEN
immediately asks for information regarding the lines on the first KDP.
For example, use the STABT command for the following dialog:
NETGEN) START ~
Node type: DN2 0 ~
Node name: NEWER ~
Node address: 12 ~
What DTE port number is used for this DN20:

The total number of DMClls and DMRlls must not exceed 6
How many DMCll lines are on this DN20:
1 ~
DMC-O Duplex: full ~
DMC-O Cost: 2 ~
How many DMRll lines are on this DN20:
How many KDPs are on this DN20:
1 ~
Number of DUPll lines on this KDP:
2 ~
KDP-O-O Maximum Baud Rate: 19200 ~
KDP-O-O Cost: 3 ~
KDP-O-l Maximum Baud Rate: 2400 ~
KDP-O-l Cost: 6 ~
[Configuration Saved On: PS:information (about) NODE ~
Node name is:
NEWER
Node address is:
12
Node type is:
DN20
Line printers:
o (default)
CRlls:
o (default)
NETGEN>list executor characteristics

(RET)

Executor Node = 12 (NEWER)
Identification = DECnet-20 V3.0 Release
Management Version = 3.0.0
Loop Count = 1
Loop Length = 127
Loop With = Mixed
Incoming Timer = 10
Outgoing Timer = 30
NSP Version = 3.2.0
Maximum Links = 8
Delay Factor = 2
Delay Weight = 3
Inactivity Timer = 30
Retransmit Factor = 5
Routing Version = 1.1.0
Type = Routing
Routing Timer = 60
Maximum Address = 255
Maximum Circuits = 4
Maximum Cost = 100
Maximum Hops = 16
Maximum Visits = 32
Buffer Size = 576
Maximum Phase II Links = 20
Phase II Transmit Password = DECNET20
NETGEN>list known circuits characteristics
Circuit

= DTE-O-l

Cost = 1
Hello timer = 10
Listen timer = 60
Owner = Node / 2 / KKKLLL
Line = DTE-O-l

3-8

INSTALLATION

NETGEN> list known 1 ines character ist ics

G!)

Line = DTE-O-l
Device = DTE-()-l
Controller Register = 174440
Interrupt Vector = 770
Interrupt Priority = 7
Pause Timer = 30
Lin e

Dr1 R- 0

Device = DMR-O
Receive Buffers = 10
Controller = Normal
Duplex = Half
Protocol = DDCMP-DMC
Clock = External
Service Timer = 3000
Retransmit Timer = 3000
Controller Register = 160740
Interrupt Vector = 670
Interrupt Priority = 5
. . STEP 20:

ADJUST THE PARAMETERS

If you find any errors in the configuration described by the LIST or
INFORMATION command, you can modify the NETGEN parameters until you
are satisfied that your own configuration has been
accurately
described. Repeat steps 18 and 19 as many times as necessary .
•

STEP 21:

SAVE THE NETGEN RESULTS

If you have used the START command, entered all the correct values,
and made no changes to the NETGEN parameters, you can EXIT from NETGEN
(use the EXIT command). The .CNF and .MAC files have already been
saved. However, if you change any parameters, use the SAVE and FINISH
commands before you exit from NETGEN.
Otherwise your changes are
lost. SAVE keeps the .CNF file, FINISH keeps all the others.
If you do not specify an argument in the command, your results are
saved in the file named PS:nodename.CNF, where PS: is
your connected directory, and nodename is the node name
(1-6
characters) specified in the NETGEN procedure. Alternatively, you may
specify the directory and/or file name.
You may restore the configuration you create with the START command
and make changes to it by using the RESTORE command. For example,

NETGEN> restore (configuration from) ? input filespec
NETGEN>restore (configuration from) PS:Dxxxxll.CNF.l G!)
[Configuration Restored from PS:DxxxxA.CNF.l]

3-9

INSTALLATION

Use DEFINE or INCLUDE commands, or whatever commands you need,
to
change devices on your configuration or to change any parameters. For
example, the dialog in Step 18 shows a configuration of 2 DUPlls on
KDP-O-O.
To add a third DUP11, the following sequence would do the
job:
NETGEN>:RES'I'OPE NEWER. CNF ~
[Configuration Restored From: PS:NEWER.CNF.l]
NETGEN> exclude kdp 0 ~
NETGEN> include krlp 0 ~
Number of DUPII lines on this KDP: 3 ~
KDP-O-O Maximum Baud Rate:
lQ200 ~
KDP-O-O Cost: 3 ~
KDP-O-l Maximum Baud Rate:
4800 ~
KDP-O-l Cost: 6 ~
KDP-O-2 Maximum Baud Rate:
48(10 (RET)
KDP-O-2 Cost: 6 ~
NETGEN>Save NEWEP.CNF ~
[Configuration Saved On: PS:NEWER.CNF.l]
NETGEN>finished (with configuration) ~
[Generating PS:NMLACC.MAC.2] [OK]
[Generating PS:CETAB.MAC.2] [OKl
[Generating PS:NETPAR.MAC.2] [OK]
NETGEN> exi t ~
NOTE
If you set any Management Parameters
(User, Account, Password) they are not
restored when you use
the
RESTORE
command. To retain them, use the DEFINE
command
whenever
you
change
your
configuration.

If you want to change the configuration, you
procedures to restore and change your file.
~STEP 22:

must

repeat

the

above

FINISH THE NETGEN PROCEDURE

To complete the configuration
NETGEN.

the

FINISH

command

After you have saved the NETGEN results, you must
and exit from the procedure. Type:

finish

the

~onfiguration

process,

use

GD
NETGEN>finished (with configuration) ( RET )
[Generating PS:NMLACC.MAC.2] [OK]
[Generating PS:CETAB.MAC.2] [OK]
[Generating PS:NETPAR.MAC.2] [OK]
NETGEN>
This couscs NETGEN to write its output files.

3-10

NETGEN

INSTALLATION

If you have not issued a SAVE command, NETGEN displays:
%Have you issued a SAVE command for this configuration?
If you did not INCLUDE a synchronous line, NETGEN displays:
%You have not configured any communications lines
For more information on error messages, see Appendix A.l, NETGEN Error
Messages .
•

STEP 23:

EXIT FROM NETGEN

To finish this part of your DN20configuration, exit from NETGEN.
NETGEN> exi t

After you have concluded the NETGEN procedure, the following files are
in your connected directory, PS::
Name

3.1.3
•

File

CETAB.MAC

Configuration file

NMLACC.MAC

Node-specific access
information
for control of local NML functions.
Remote
sites
must
this
use
information
when
connecting to
DECnet-20.

nodename.CNF

Saved network
(created
if
issued)

NETPAR.MAC

System-specific parameters

configuration file
SAVE
command was

Creating Front-End Software

STEP 24:

SUBMIT THE DN20SYS.CTL FILE

Submit the DN20SYS.CTL file,
the control file supplied on your
distribution tape, to the batch system. First reset its protection:
$ SET FILE PROTECTION PS:DN20SYS.CTL 777752

This changes the protection on the control file so it can be
by the batch system.
$ SUBMIT PS: DN2 OSYS. CTL/TIME: 3 O/NOTIFY: YES

accessed

The system displays a message in the form:
[Job DN20SY Queued, Request-ID #60 Limit 00:30:00]
When the job has completed, the system displays a message in the form:
[From SYSTEM:

Job DN20SY Request-ID #60 Finished Executing at hh:mm:ss]

3-11

INSTALLATION

This job does the following:
•

lists logical names

•

takes a checksummed directory of all required files

•

assembles MACRO-II source modules

•

creates TSKs and STBs (tasks and symbol tables)

•

builds the DN20 system image, DxxxxA.SYS

•

deletes OBJ files

•

deletes the file NMLACC.MAC, having used
system image

~STEP 25:

create

the

CHECK THE DN20SYS.LOG FILE FOR ERRORS

Examine the DN20SYS.LOG fiJe produced by the batch job for two things:
•

fatal errors

•

system image larger than 124K

The batch processor flags errors as follows:
Flag

Meaning

Fatal error

Warning

]

Comment

For fatal errors:
A successful job produces the DN20 system image; an unsuccessful
job creates no system image. If your log file contains error
messages, assembly errors, or undefined globals, determine the
cause of the error, correct it, and resubmit the DN20SYS.CTL
file.
For system-image size:
Your DN20 system image may be too large.
In the log file,
examine the area under the heading "Build the DN20 system image."
Find the words "The conjured system image is xxxK words.
Considering buffers, yyyK words of memory will be required during
execution." If the value of yyy is greater than 124, your system
image is too large. To reduce the value to l24K or less, omit
devices from your configuration or make the Buffer Size less than
576.
Rerun NETGEN to reduce the complexity of your DN20
configuration, and repeat all subsequent steps in the procedure.

3-12

INSTALLATION
3.1.4

Putting the Files in System Directories

~STEP 26:

COpy TO PS: OR PS:

Put the DxxxxA.SYS file on PS:
(or,
if
PS:D2l02A.SYS ~

Complete and Repeat the Configuration

If you are configuring a system with remote job entry
(RJE)
facilities, you will have to perform the generation procedure for each
remote station. Follow the procedures outlirted in Section 3.2.
If
you are generating a system without the RJE capability, continue your
system installation by skipping to Chapter 4.
You must repeat
configuration.

3.2

the

generation

whenever

you

change

the

network

REMOTE JOB ENTRY CONFIGURATION

This section describes the procedures that you must follow to
configure software for any DN200 remote job entry (RJE) stations
connected to
your
DECSYSTEM-2040S/2060.
Tn
performing
this
configuration, you use the RJE distribution tane described in Section
I. 3.

This section is only relevant if your installation supports remote job
entry. If your installation does not support RJE features, proceed to
Chapter 4.
Most of the steps performed for RJE configuration are basically the
same as those performed for the DN20 (see Section 3.1). For RJE,
however, you build the DN200 directory rather than the DN20 directory,
and the directory rather than the DxxxxA directory. You
should build a separate directory for each RJE station your
system is to support.

3.2.1

Generating RJE Software

The remote configuration files are located on the RJE-20 distribution
tape in the directory PS:. Create a directory on disk named
PS: or, if upgrading from a previous version of DECnet-20, as
PS:.
Later in the generation procedure, you will copy the
generation files on the distribution tape to this disk directory.
This is your RJE system directory.

3-13

INSTALLATION
~ STEP 27:

CREATE THE PS:(DN200> DIRECTORY or (NEW-DN200>

Type:
$AECREATE PS: ~
[New]
$$WORKING 1000 ~
$$PERMANENT 1000 G!D
$$ PROTECTION 777740 ~
$S FILES-ONLY ~
S$ MAXIMUf>1 1 ~
$$ G!D
$

~STEP 28:

CREATE THE PS:(DN200x> and PS:(DN200x-DUMPS> DIRECTORIES

Create two directories on disk for each RJE station. Call the primary
directory PS:, where x is A for the first RJE station, B for
the second, and so on. Each directory will contain only those files
for the corresponding RJE node whose software you are building. Call
the dump directory , where nodename is the name of the
DN200 node. This directory must be kept available to receive dumps of
DN~OO memory.
When you create the dump directories, use passwords of
your own choice.
You must enter these passwords again when you run
NIPGEN. Only the DN200 can initiate dumps.
Type:
$ AECREATE PS: ~
[New]
$ $ WORK ING 750 G!D
$ $ PERMANEt\T 750 G!D
$$ FILES-OKLY ~
$$ ~
$A ECREATE PS: G!D
[New]
$$ Work 1000 G0
S$ Perm 1 DOO ~
$$ Pass [your choicel ~
$$ Generations (TO KEEP) 5 ~
$$
$

~STEP 29:

CREATE THE PS:(DN200-S0URCES> DIRECTORY

Create a directory named to contain source
the last saveset from the RJE-20 tape.
Type:
$AECREATE PS:
[New]
$$WORK 300 ~
$$PERM 300 ~
$$?ILES-OXLY G£)
$$
S

3-14

code

from

INSTALLATION

•

STEP 30:

RESTORE FILES FROM TAPE

Use the DUMPER utility to restore files from the RJE-20 distribution
tape to disk. The RJE-20 distribution tape contains three savesets:
documentation, binaries, and sources
for
generation.
Restore
documentation
to
PS:
(or PS: (or PS: if you are upgrading from DECnet-20
V2.1 to DECnet-20 V3.0), and sources for generation to PS:.
•

Mount the RJE-20
drive.

distribution

•

Use the INFORMATION SYSTEM-STATUS command
(see the TOPS-20
Commands
Reference
Manual)
to ~etermine whether tape
allocation is enabled for your system.

If tape-drive allocation is enabled,
below uses MTAO:

tape

use

available

MOUNT

TAPE;

the

use

ASSIGN

MTAx:;

tape

example

Type:
$ MOUNT TAPE MTAO: ~
[MTAO: assigned to MTO]
If tape-drive allocation is
example uses MTAO:.
$ ASS IGN

~1TAO:

not

enabled,

this

Mount the RJE-20 Distribution Tape on an available tape drive and
the drive on line.

put

$DUMPER ~
DUMPER>TAPE MTAO: ~
DUMPER>REWIND ~

~
DUMPER>ACCOUNT (OF RESTORED FILES FROM)
~

SYSTEM-DEFAULT

~
DUMPER> RESTORE (TAPE FILES) PS: < *>*. *. * (TO)
(or to if upgrading)
(Restores Documentation files.)

GD
~

DUMPER>RESTORE (TAPE FILES) PS:*.* (TO)
(or to if upgrading)
(Restores binaries)

PS:*.*

GD
DUMPER)RESTORE (TAPE FILES) PS: * * * (TO)
(or to if upgrading)
(Restores DN200 Generation files)

DUMPER>RESTORE (TAPE FILES)
(Restores source files)
DUMPER>REWIND ~
DUMPER>EXIT ~

PS:

PS:<*>*.*.* (TO)

3-15

PS:

INSTALLATION

NOTE
If you are working on a stand-alone
system with no operator in attendance,
go to the operator's console and enter
the IDENTIFY commano in thp form shown
below:
OPR IDENTIFY tape-id REO reguest-id
The specified request-id appears on the
operator's
console.
The tape-id is
entered in the form MTAn, where
n
identifies the tape drive from which the
files are to be copien.
The system
associates Crle pl-lysical device MTAn wi th

your logical assignment to MTn.
Refer
to
the
TOPS-20
Operator's Command
Language Reference Manual for a complete
discussion of IDENTIFY and the other OPR
commands.
Note that the logical name used below
may be your first or last name or any
other valid string that you will be able
to remember .

. . STEP 31:

DISMOUNT THE TAPE

If you have tape-drive allocation enabled, type:
$DISMOCNT TAPE logical name:

If you do not have tape-drive allocation enabled, type
$lDEASSIGN MTAO:

G!D

Once your tape is rewound, remove it from the tape drive.
~STEP 32:

CONNECT TO (ON200x)

Type:
$CONNECT PS:

NOTE
Repeat Steps 32 through 41 for each RJE
station.
Where the instructions refer
to PS:, specify PS: for
the first,
PS: for the second,

1~~dt~040~~E ~~~~~~n:~ftware can

3-16

support,

INSTALLATION

. . STEP 33:

RUN THE NETGEN PROGRAM

Run NETGEN to define the DN200 configuration.

Type:

SNETGEN C§)
NETGEN responds with an identifying message:
TOPS-20 Network Configurator for DN20 or DN200, Version 3(55)
[Type START to begin configuration dialog]
The program then prompts for each NETGEN command by displaying:
NETGEN)
You may now enter any of the NETGEN commands to configure
nodes.

your

DN200

NOTE
Ensure that you configure all nodes.
For example,
if you have three DN200's
in your configuration, you must run
NETGEN once for the DN20 front-end while
connected to PS: start ~
Node type:
c1n20() @)
Node name:
rjel @)
68

t.J"ode add ress:

(RET)

Do you have a card reader on this DN200? no @)
Do you have a line printer on this DN200? yes

What is the communications line interface on the DN200?
Specify either D~1CII or DMRIl:
dmcll ~
[Configuration Saved On: RJEI.CNF.I]
[Generating PS:NMLACC.MAC.3) [OK]
[Generating PS:CETAB.MAC.3] [OKl
[Generating PS:NETPAR.MAC.3] [OKl
[Configuration complete]
Type SAVE and FINISH after any additional changes
Type EXIT to terminate NETGEN
NETGEN> exi t

After you have identified the node as a DN200, NETGEN adjusts
default parameters to values appropriate for RJE stations.
~ STEP 35:

the

CHECK THE PARAMETERS

Check the output from the LIST or INFORMATION command to determine
which parameters correctly describe your planned RJE configuration and
which parameters must be changed. To change the physical link for a
DN200, you may need to use the INCLUDE or EXCLUDE command. For
example,
EXCLUDE DMC
INCLUDE DMR
~

~
NETGEN> information (about) NODE
Node name is:
RJEl
Node number is:
68
Node type is:
DN200
Line printers:
1 (default)
CRlls:
0 (default)
NETGEN>

~STEP 36:

ADJUST THE PARAMETERS

Adjust the parameters displayed for the DN200 node to reflect any
additions or changes to your configuration. For example, to include a
card reader in the configuration, enter:
NE'l'GEN> include care-reader

(RET)

Repeat the previous two steps until the configuration
satisfactory.

3-18

parameters

are

INSTALLATION
~STEP 37:

SAVE THE NETGEN RESULTS

When the output from the LIST or INFORMATION command accurately
describes your planned configuration, exit from NETGEN.
If you have
used the START command, entered all the correct values, and made no
changes to the NETGEN parameters, you can EXIT from NETGEN (use the
EXIT command). The .CNF and .MAC files have already been saved.
However,
if you change any parameters, use the SAVE and FINISH
commands before you exit from NETGEN.
Otherwise your changes are
lost.
Check your output carefully. If you do not save the results and find
that you must make a correction after you issue the FINISHED command,
you will have to rerun NETGEN from the beginning.
When you are ready to save the NETGEN results, enter a SAVE command.
If you do not enter an argument in the command, your results are saved
in the file named PS: ex i t (f rom NETGEN)

After you have concluded the NETGEN procedure, the following files are
in your connected directory, PS::
Name

3.2.2

File

CETAB.MAC

Configuration file

nodename.CNF

Saved network configuration file (created if
command was issued)

NMLACC.MAC

Node-specific access information
local NML functions.

NETPAR.MAC

System-specific parameters

for

Creating RJE Software

. . STEP 39:

SUBMIT THE DN200SYS. CTL FILE
NOTE
The control file DN200SYS.CTL used to
build the DN200 image TAKEs a file named
DSK.CMD.
DSK.CMD defines
the
DSK:
search list for the batch job. Before
you SUBMIT DN200SYS.CTL, create DSK.CMD
in the directory. The DSK.CMD
file should contain the entry:
DEFINE DSK: DSK:,
PS:,PS:
PS: is the directory to which you
restored the DN200 files from the RJE
tape, and PS: is the directory to
which you restored the DECnet-20 files
from the DECnet-20 tape.
If you are
using directories other than PS:
and PS: for
the
distribution
directories,
your DSK.CMD file must
specify your directories instead.

3-20

control

SAVE
of

INSTALLATION
Submit the DN200SYS.CTL file,
the control
distribution tape, to the batch system.

file

from

the

RJE-20

Enter the following:
$ SET FILE PROTECTION PS:DN200SYS.CTL

777752

This changes the protection on the control file so
can access it.

the

batch

system

$ SUBMIT PS:DN200SYS.CTL/TIME:30/0UTPUT:NOLOG/NOTIFY:YES

The system displays a message in the form:
[Job DN200S Queued, Request-ID #61 Limit 00:30:00]
This job does the following:
•

lists logical names

•

takes a checksummed directory of all required files

•

assembles MACRO source modules

•

creates TSKs and STBs

•

builds the DN20 system image, DN200x.SYS

•

deletes OBJ files

•

deletes the file NMLACC.MAC, having used
system image

You must submit this
network.

~STEP 40:

control

(tasks and symbol tables)

file

for

each

RJE

create

station

the
your

CHECK THE DN200SYS.LOG FILE

Examine the DN200SYS.LOG file
things:

produced

•

fatal errors

•

system image larger than l24K

3-21

the

batch

job

for

two

INSTALLATION
For fatal errors:
~
successful
job produces the
DN200
system
image.
An
unsuccessful job creates no system image.
If your log file
contains error messages, assembly errors, or undefined globals,
determine the cause of the error, corre~t it, and resubmit the
DN200SYS.CTL file.

For system-image size:
Your DN200 system image may be too large.
In the Jog file,
examine the area under the heading "Build the DN200 system
image." Find the words "The conjured system image is xxxK words.
Considering buffers, yyyK words of memory will be required during
execution." If the value of yyy is greater than 124, your system
lmage is too large. To reduce the value to 124K or less, omit
devices from your configuration or make the Buffer Size less than
576.
Rerun NETGEN to reduce the complexity of your DN200
configuration, and repeat all subsequent steps in the procedure.

3.2.3

Putting Files in System Directories

~STEP 41:

COpy TO PS:(SUBSYS> OR PS:(NEW-SUBSYS>

For each RJE station, prepare a file in PS:(DN200x> that is free of
errors.
When done, copy all the individual DN200x.SYS files to
PS:(SUBSYS> with copy commands,
or,
if
upgrading,
copy
to
PS:(NEW-SUBSYS>.
Remember that the input file name and the directory
name of each RJE system image is the same.
Remember to copy to
PS:(NEW-SUBSYS> if upgrading.
For example:
SCOPY DN200A.SYS PS:

3-22

CHAPTER 4
NETWORK CHECKOUT

This chapter describes how to setup the control and system files
needed to check out DECnet capabilities between certain nodes in your
network.
Before you can load the nodes and test their connectivity, you must
run the NIPGEN program described in this chapter. NIPGEN creates the
command and control files utilized by the procedures discussed below.
To perform verification and installation procedures, you must have a
fully installed TOPS-20 operating system, Version 5.1 or later. This
must be the system you will bring up at the beginning of Chapter 5.
Before beginning the procedures described below, you must be logged in
as a user with OPERATOR or WHEEL privileges, and have your privileges
enabled.
Because command files and control files and logical definitions may
refer to certain files, you should ordinarily name and locate these
files as shown in the descriptions and examples shown below. If your
installation's conventions allow it, file names and locations may be
changed after the configuration and installation procedures have been
successfully completed. You should be aware, however, that should you
subsequently wish to reconfigure the system or to run validation or
certification tests for diagnostic purposes, you will have to resolve
references to files and data structures.

4.1

NIPGEN OVERVIEW

After you have created your front end and optionally your remote job
entry (DN200) software, you are ready to describe the host and remote
nodes and to verify and install the system.
This chapter describes
the interactive NIPGEN (Network Installation Procedure GENerator)
program, which creates the command and control files used to verify
your generated DECnet-20 node.
The next chapter describes the
detailed steps which you must follow to install the system.
Before you invoke the NIPGEN program, you must ensure that you have
configured your front end and RJE software and that the appropriate
configuration files have been produced. You should have the following
files on PS:, or, if upgrading, on PS:.
•

For the DN20:

DxxxxA.SYS

•

For each RJE station:

DN200x.SYS

You must have a fully installed TOPS-20 operating system, Version 5.1
or later. If you are upgrading, Version 5.1 need not be running until
you reboot the system.
4-1

NETWORK CHECKOUT
~STEP 42:

BE SURE YOU ARE CONNECTED TO (DxxxxA>

To proceed with the next steps, be connected to .
. . STEP 43:

RUN NIPGEN

Invoke the NIPGEN program typing:
$NIPGEN C§)
in response to the TOPS-20 enabled prompt ($).
NIPGEN responds by displaying the following message:
NIPGEN (V2.6) for DECnet-20 V3.0
The program now prompts you to enter the name,
information about the following nodes:

address,

and

•

Host node

•

DN20 node

•

DN200 nodes

•

All remote nodes with which you plan to communicate

The prompts and
follow.
~STEP 44:

responses

are

described

the

subsections

that

SPECIFY YOUR HOST NODE
NOTE
You cannot use ~
0 r
(CTRLll)
wi th
NIPGEN.
If you make an error when
entering a value, use the DELETE key to
back up.
If you have already pressed
C§) and a new prompt is displayed, you
cannot return to a previous line. You
must rerun NIPGEN, unless
you
are
entering values for a DN200.

NIPGEN first prompts you to enter information about
For example:
Host Node Address:
Name:
User Name:
Account:
Password:
Host Data Link:

120 ~
KL2102 ~
THE-USER ~
341 ~
GUEST ~
DTE-O-l ~

4-2

your

host

node.

NETWORK CHECKOUT

These entries must be specified as follows:

•

The host node address must correspond to the node address
the host TOPS-20 computer at your installation.

•

The host node name must correspond to the node name
TOPS-20 KL system.

•

The user name 4 account, and password are your own, or a
temporary set of, TOPS-20 name, account number, and password.

•

The host data link is the DTE20 device
specification
representing the interface between the DECSYSTEM 2040S/2060
and the DN20 front end.

•

You should have collected the information needed
in your Installation Worksheet.

for

NIPGEN

Note that in this chapter, node name examples follow
conventions for the front-end node described earlier .

the

naming

STEP 45:

of
your

SPECIFY THE DN20 NODE

Next, NIPGEN prompts you to enter the node address
front end (DN20) node, as shown below.
DN20 Node Address:
Name:
User Name:
Account:
Password:

and

name

the

67 ~
D2102A ~
-j ake ~
3 ~

-jill

The address and name must correspond to the specifications entered for
the front end during the NETGEN procedure. The user name, account,
and password must correspond to the values entered for the Management
Parameters when running NETGEN .
•

STEP 46:

SPECIFY YOUR DN200 NODES

Next, NIPGEN displays an informational message and prompts you to
enter the node address, name, and data link of the DN200 nodes. If
remote job entry is not supported for your configuration, simply
respond to the prompt below by pressing ~
Terminate DN200 node address/name input
questioning with a null node address.
~

DN200 Node Address:

If you have generated one or more DN200s, enter
the following form:
DN200 Node Address:
Name:
Host User Name:
Host Account:
Host Password:
DN20 Data Link:

RJEI GD
RJEI-DUMPS ~
~

rick ~
DMC-O ~

4-3

node

information

NETWORK CHECKOUT
The node address, name, and DN20 data link must correspond to the
address, name, and link specified for this node with NETGEN. NIPGEN
creates the host user name as nodename-DUMPS; you must enter the host
password you used when creating the directory in an
earlier step.
•

The DN20 data link must correspond to the name and number of
the synchronous line which serves as an interface between the
DN200 and the front end.

You must specify entries for all DN200's in your configuration.
NIPGEN prompts for DN200 node information until you
response to the prompt:

press

RETURN

DN200 Node Address:
Note that you can correct a mistake in a DN200 node specification by
reentering a previously specified node address in response to the
"DN200 Node Address:" prompt.
NIPGEN will replace the previously
entered name and data link with the newly entered information.
~STEP 47:

SPECIFY ADJACENT NODES IN YOUR NETWORK

Next, NIPGEN displays an informational message and prompts you to
enter information for the remote nodes in the network with which you
want to communicate. Specify adjacent nodes you wish to test against.
Terminate remote node address/name input
questioning with a null node address. A
file of pre-prepared inputs may be read
via an indirect file, i.e.,
@FILENAME.EXT
Remote Node Address:
Name:
Phase III?
F i 1 e Xfer ( F AL ) ?
User Name:
~ccount:

Password:

l03~

MILL20 ~

NO~
YES~

SOME-USER ~
MONITOR ~
SECRET ~

These entries describe the remote node as follows:
•

For remote node address, enter
remote node.

•

For name, enter the name of the remote node.

•

Enter YES for the Phase III entry if the current Phase III
software is installed at this remote node; enter NO if phase
II software is installed.

•

Enter YES for the file Xfer (FAL) entry if the FAL (File
~ccess
Listener) program resides at the remote node and is
used to process transfer requests initiated by the NFT
(Network File Transfer) program;
enter NO if FAL is not
used. Consider DECnet-20 hosts as Phase III nodes in answer
to this question.

4-4

the

DECnet

address

the

NETWORK CHECKOUT
NOTE

YOUI

For each remote Phase III DECnet-20 node pair,
must make an entry for both the host KL and its DN20
front end.
For the Phase III remote host KL,
answer
YES to the FAL question:
for the remote DN20, always
answer 'NO' to the FAL question.
A Phase II KL node
requires only one entry:
a Phase III DECnet-20 node
requires
two NIPGEN
specifications.
(See
the
examples below for KL2ll6-and KL2l37.)

•

Enter the user name, account, and password for any node using
FAL.
This
information
is not requested for nodes without
FAL.

You should have collected
Installation Worksheet.

this

information

part

your

NIPGEN continues to prompt you for
remote node entries until
you
indicate that you are done by typing in response to the prompt:
Remote Node Address:
NIPGEN then creates the files described in Section 4.2 and responds by
displaying the following:
Writing CMD and CTL files--NIPGEN Completed.
$

4-5

NETWORK CHECKOUT

An example of entering remote node specifications is shown below.
Remote Node Address:
Name:
Phase III ?
File Xfer (FAL) ?
User Name:
Account:
Password:
Remote Node Address:
Name:
Phase III ?
File Xfer (FAL) ?
User Name:
Account:
Password:
Remote Node Address:
Name:
Phase III ?
File Xfer (FAL) ?
User Name:
Account:
Password:
Remote Node Address:
Name:
Phese III?
File Xfer (FAL) ?
User Name:
Account:
Pessword:
Remote Node Address:
Name:
Phase III?
File Xfer (FAL) ?
Remote Node Address:
Name:
Phase III?
File Xfer (FAL) ?
User Name:
Account:
Password:

C§)

103

MILL20

NO GD
YES (RET)
SOME-USER GD
MONITOR GD
SECRET GD

III

KL2137

YES GD
YES ~
ANOTHER-USER

341

(RET)

SHHH

116

KL2116 G!D
NO (§)
YES GD
A-USER G!D

341

QUIET

(§)

118

SYSR80 @)
YES GD
YES G!D
[200,200] ~

@)
PRIVY

123 @)
~

D2137A

YES
NO

C§)

VX1522

NO G!D
YES ~
SOME-USER

C§)
SECRET

Remote Node Address:
Writing CMD and CTL files--NIPGEN completed
$

4-6

NETWORK CHECKOUT

You can set up a command file to supply responses to the NIPGEN
prompts for remote node specifications. If you use such a file, you
will not have to enter specifications from the terminal, as shown in
the examDle above. SimDlv resoond to the last remote node prompt with
a~ @ ~n~L~he file~ame ~~d·exte~sion.
An example is include~ below.
Remote Node Address: @NIPGEN.CMD

Writing CMD and CTL files -NIPGEN completed
$

The contents of NIPGEN.CMD are shown below.
103
MILL20
NO
YES
SOME-USER
MONITOR
SECRET
113
KL2137
YES
YES
ANOTHER-USER
341
SHHH
116
KL2116
NO
YES
A-USER
341
QUIET
118
SYS880
YES
YES
[200,200]
PRIVY
123
D2137A
YES
NO
33
VX1522
NO
YES
SOME-USER
SECRET

4-7

NETWORK CHECKOUT
The final
~
ends the list.
If the command file contains
specifications for a remote node that has already been defined, the
information in the file will supersede the previously
entered
information.
If the command file contains a remote node specification
for a node previously defined as the host, DN20, or DN200 node,
the
duplicate specification will hp ignnrpd.
For convenience, you might
wish to set up a file which describes all of the nodes in the network,
including your DN20 node.
This file can then be invoked from any
TOPS-20 node.

4.2

NIPGEN COMMAND AND CONTROL FILES

NIPGEN creates five command and control files which are used to verify
and load the conIlgured nodes and to test connectivity to the
specified remote nodes.
These files are listed below and are
discussed in greater detail
in the subsections that follow.
It is
good practice to look at these files,
to be sure they contain no
errors, before using them.
File

Name
NCP.CMD

Command file defininq the front end
(DN20) data base for-input to OPR.

NCPRJE.CMD

Command file defining the remote job
entry
(DN200) data base(s) for input
to OPR.

NIPLCL.CTL

Control file which will be used to
2nd DN200
verify host,
front end,
nodes.

NIPNM.CTL

Control file which will use the Phase
III
loopback
facility
for
verification.

NIPNFT.CTL

Control file which will use NFT for
Phase II and Phase III verification.

4.2.1

NCP.CMD: DN20 Command File

NCP.CMD is a command file which is input
contains a series of commands which:

the

OPR

program.

•

Define the node names and addresses of all of the nodes in
the configured network in a format readable by the host
system.

•

Define the data base for the network front end (DN20).

These definitions are made in the volatile data base.

4-8

NETWORK CHECKOUT
A sample NCP.CMD file, based
below.

the

preceding

input,

included

!NCP.CMD
ENTER NCP
SET NODE 67 NAME D2102A
SET NODE 68 NAME RJEl
SET NODE 103 NAME MILL20
SET NODE 113 NAME KL2137
SET NODE 116 NAME KL2116
SET NODE 118 NAME SYS880
SET NODE 120 NAME KL2102
SET NODE 123 NAME D2137A
SET NODE 33 ~AME VX1522
SET NODE D2102A CPU PDP-l1
SET NODE D2102A SERVICE CIRCUIT DTE-0-1
SET NODE D2102A SECONDARY LOADER SYS:DTEMPS.SYS
SET NODE D2102A TERTIARY LOADER SYS:DTEMPT.SYSSET NODE D2102A LOAD FILE SYS:D2102A.SYS
SET NODE D2102A HOST KL2102
SET NODE D2102A SECONDARY DUMPER SYS:DTEDMP.SYS
SET NODE D2102A DUMP FILE SYS:D2102A.DMP
RETURN

4.2.2

NCPRJE.CMD: DN200 Command File

NCPRJE.CMD is a command file which is input to the OPF program.
It
contains a series of commanos which define the remote job entry data
bases for all DN200's configured in the network.
These definitions
are made in the volatile data base;
no permanent data base processing
is performed for the DN200.

4-9

NETWORK CHECKOUT
NCPRJE.CMD will be created only if one or more DN200 nodes were
generated by NETGEN. A sample NCPRJE.CMD file is included below.
!NCPRJE.CMD
ENTER NCP
SET EXECUTOR NODE D2l02A USER JAKE PASSWORD JILL
SET NODE 68 NAME RJEl
WAIT 2
SET NODE RJEl CPU PDP-II
WAIT 2
SET NODE RJEl SERVICE CIRCUIT DMC-O
WAIT 2
1\1 f"'IT"\
n "'Tn'
Ct;'fTI
L'cuD..!.
rlVL:'l
KL2102
L'VUL
WAIT 2
SET NODE RJEl SECONDARY LOADER KL2l02"THE-USER GUEST 341": :SYS:DMCMPS.SYS
WAIT 2
SET NODE RJEl TERTIARY LOADER KL2l02"THE-USER GUEST 341": :SYS:DMCMPT.SYS
WAIT 2
SET NODE RJEl LOAD FILE KL2l02"THE-USER GUEST 341": :SYS:RJEl.SYS
WAIT 2
SET NODE RJEl DUMP FILE KL2l02"RJEl-DUMPS RICK ":: PS:,
or,
if upgrading, to PS:.
These files
are:
NCP.CMD:
NCPRJE.CMD:

definitions for DN20 node
definitions for DN200 nodes

Note that if your installation does
there will be no NCPRJE.CMD file.

not

support

remote

job

entry,

To copy to PS:, enter the following from the EXEC:
For

the DN20:

$COpy
For

(FRuM)

PS:NCP.CMD ~

(or

PS:l\CPRJE. CMD

(or

PS: ;

SYSTEM FILE EDITS

To set up your system to bring the network up automatically, you must
edit certain system files.
The files you must edit or create are:
PTYCON.ATO (NETWRK.ATO)
5-l-CONFIG.CMD
SYSJOB.PUN
SYSTEM.CMD
When the system comes up, the monitor
invokes CONFIG.CMD and
runs
SYSJOB.
SYSJOB starts PTYCON,
executes commanns in the PTYCON.ATO
file and starts copies of LPTSPL and CDRIVE.
PTYCON starts OPP and
executes commands in SYSTEM.CMD and NCP.CMD (see Figure 4-1).

4-14

NETWORK CHECKOUT

If you are upgrading from a previous version of DECnet-20, use the
directory in place of , and the
directory in place of . Save the previous version on tape or
disk until the current version runs successfully in a normal working
environment.

x-CONFIG.CMD
Sets up KL
nodenamel
number

SYSJOB.RUN

·Runs GALAXY
modules
Runs PTYCON
GET
PTYCON.ATO

PTYCON.ATO
Runs:
NMLT20
NODES
MCBNRT
FAL
OPR TAKE
SYSTEM.CMD

SYSTEM.CMD
START
RJE nodes

NCP.CMD
Set up
database for
network nodes
Set up DN20
MR·S·228S·82

Figure 4-1 System Startup

4-15

NETWORK CHECKOUT
~STEP 49:

EDIT AND RENAME NETWRK.ATO

You must now set up PTYCON.ATO to start network programs on TOPS-20
automatically when the system is restarten.
You have received a
NETWRK.ATO file on your DECnet-20 tape.
It will be in PS: (or
,
if you are upgrading)
if you have followed these
procedures.
NETWRK.ATO contains the commands to start the network
support programs NMLT20, NODES, MCBNRT, and FAL.
It also contains an
OPR command to take the file SYSTEM.CMD, and the NCP command to SET
SERVICE ENABLED on the DTE connected
to your DN20.
NETWRK.ATO
contains:
.. X

DEFINE . . SNML
CONN NML
LOG IN OPE Rl', TOR

Faa

nn~n7\mf"\n

Vi:'" LJJ.'M..lVn

ENABLE
SYS:NMLT20.EXE
.. X

DEFINE . . $NODES
CONN NODES
LOGIN OPERATOR FOO OPERATOR
ENABLE
SYS:NODES.EXE

.. X

DEFINE . . SMCBNRT
CONN MCBNRT
LOGIN OPERATOR FOO OPERATOR
ENABLE
SYS:MCBNRT.EXE

.. X

DEFINE . . SFAL
CONN FAL
LOGIN OPERATOR FOO OPERATOR
ENABLE
SYS:FAL.EXE

CONN OPR
LOGIN OPERATOR FOO OPERATOR
ENABLE
TAKE SYSTEM:SYSTEM.CMD
NCP SET CIRCUIT DTE-O-l SERVICE ENABLED

If your DN20 is not on DTE number 1, you must edit NETWRK.ATO.
the command

Change

NCP SET CIRCUIT DTE-O-l SERVICE ENABLED
to reference DTE-O-2 or DTE-O-3 as appropriate.
If you have previously made changes to
incorporate those changes into NETWRK.ATO.

4-16

your

PTYCON.ATO

file,

NETWORK CHECKOUT
If you want to collect CHKll output automatically, and have it logged,
add the following lines to NETWRK.ATO after the SET SERVICE ENABLED
command. This will place CHKll output in the PTYCON log file.

"x
DEFINE "$CHK
CONN CHK
LOGIN OPERATOR FOO OPERATOR
TYPE DLl:
"X
Once you have all necessary commands in your NETWRK.ATO file,
rename
it as PTYCON.ATO and put it on PS:NETWRK. ATO PS:
on the DECnet-20 Distribution Tape.
Use the same
procedures you used before when you rebuilt OPR.EXE, but use the new
NCPTAB.REL.
Be sure to save a backup copy of your old NCPTAB.REL in
case you need to rebuild an OPR compatible with DECnet-20 Phase II.
To rebuild NCPTAB.REL from the
NCPTAB.MAC
sources
from
the
saveset on the DECnet-20 Distribution Tape, use the
file NCPTAB.CTL. Then rebuild OPR using OPERAT.CTL and your new
NCPTAB.REL.
You can use OPERATOR.CTL only if all the correct
universal files are on your system. If this is not the case, use the
GALAXY.CTL file to rebuild all your GALAXY components.
The standard procedure for shutting down and restarting the GALAXY
system is described in the TOPS-20 Software Installation Guide. Check
the GALAXY Beware file,
if any, for additional pointers--on this
procedure.
~STEP 54:

USE THE LATEST NFT and FAL

The versions of NFT and FAL on the DECnet-20 V3.0 tape have been built
with GALAXY 4.2. To rebuild these programs with a-different version
of GALAXY, examine NFTFAL.CTL, resolve any logical name definitions,
and submit it as follows:
SUBMIT NFTFAL/TIME:O:30:00
When the batch job completes successfully, move the
FAL.EXE to SYS:.

4-18

new

NFT.EXE

and

NETWORK CHECKOUT
~STEP 55:

FOR RJE STATIONS, USE THE LATEST NURD.REL

NURD.REL is required to build both LPTSPL.EXE and CDRIVE.EXE.
Before
you can use any DN200; you must rebuild both LPTSPL and CDRIVE using
the NURD.REL or NURD.MAC file supplied on the RJE-20 tape.
The
LPTSPL.EXE and CDRIVE.EXE shipped on the TOPS-20 VS.I tcpe were NOT
built with the latest version of NUFD.REL. If you have followed these
procedures, you have restored the source and control files needed to
build NURD.REL from the
fourth
saveset
of
the
RJE-20
to
PS:.
Included with the GALAXY software on the TOPS-20 Monitor tape are the
control files LPTSPL.CTL and CDRIVE.CTL. Use them to rebuild LPTSPL
and CDRIVE. Read the instructions at the beginning of each control
file to be sure you have all the required universal and source files
in the correct directories.
Then use a SUBMIT command with a
reasonable time limit to submit the control files to the batch system.
If you wish, you can use the GALAXY.CTL file to rebuild all GALAXY
components instead of rebuilding only LPTSPL and CDRIVE. You should
note, however, that rebuilding all GALAXY components takes about two
hours and requires considerable disk storage. For more information on
rebuilding GALAXY, see the TOPS-20 Software Installation Guide.

4-19

CHAPTER 5
NETWORK NODE STARTUP

~STEP 56:

SHUTDOWN AND REBOOT

You now reboot the TOPS-20 system by
bringing the system back up again.
network.

performing a shutdown and
This will also bring up the

To reboot the system in an orderly fashion, do the following:
•

Inform system users that timesharing will end in a
time.

•

Shutdown the KL10.

•

Reboot from disk.

•

ENABLE capabilities.

•

CONNECT to directory.

AA K905A TM_DECnet 20_Network_Generation_and_Installation_Procedures_Dec82 TM DECnet 20 Network Generation And Installation Procedures Dec82

AA-K905A-TM_DECnet-20_Network_Generation_and_Installation_Procedures_Dec82 AA-K905A-TM_DECnet-20_Network_Generation_and_Installation_Procedures_Dec82

Navigation menu

Versions of this User Manual:

Views

Navigation