Digital PDFs

AA-EF20B-TV

April 1986

109 pages

Original

6.4MB

Document:	DECnet-DOS Installation Guide
Order Number:	AA-EF20B-TV
Revision:	0
Pages:	109
Original Filename:	AA-EF20B-TV_DECnet-DOS_Installation_Guide_Apr86.pdf

OCR Text

Networks -Communications

DECnet-DOS
Installation Guide
AA-EF20B-TV

SOE 0GE0

DECnet-DOS
Installation Guide
Order No. AA-EF20B-TV

April 1986
This manual details procedures for installing DECnet-DOS on the IBM
Personal Computer, the IBM Personal Computer XT, and the IBM Personal Computer AT.

Supersession/Update Information:

This is a revised manual.

Operating System and Version:

MS-DOS V2.11
PC DOS V2.10
PC DOS V3.10

Software Version:

DECnet-DOS V1.1

SOS0020

AA-EF20B-TV
First Printing, April 1986

The information in this document is Subject to change without notice and should not be construed
as acommitment 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 postage-prepaid Reader’s Comments form on the last page of this document
user’s Critical evaluation to assist us in preparing future documentation.

requests the

The following are trademarks of Digital Equipment Corporation:
DEC
DECmate
DECnet
DECUS
DECwriter
DIBOL

PNSOCSD

MASSBUS

PDP
P/OS
Professional
Rainbow
RSTS
RSX

ULTRIX-32
ULTRIX-32M
UNIBUS
VAX
VAXcluster
VMS

ULTRIX

Work Processor

MS™ and XENIX™ are trademarks of Microsoft Corporation.

IBM is a registered trademark of International Business Machines Corporation.
PC/XT and Personal Computer AT are trademarks of International Business Machines
Corporation.

This manual was produced by Networks and Communications Publications.

Contents
Preface
Introduction
1.1
1.2

Hardware Components for DECnet-DOS Nodes
2.1
2.2
2.2.1
2.2.2
2.2.3
2.2.4

2.3

2.3.1
2.3.2

2.3.3

2.3.4

Hardware Components ....... 0.0...
e eee ees
Hardware Components for Asynchronous DDCMP
COMMUNICATION...
cc
cece cece teen tenn eens

Loopback Connector Plug .......... 0.0...
ees
Hardware Components for Ethernet Communication ..............
Ethernet Communications Adapter .................
000 c cece eens
Ethernet CONNECtOL .. 1...
eee nent ees
Ethernet Cable ..... 0.0...
e eee ees
Ethernet Loopback Connector Plug.................
0000 cece eee eee

Connecting to the DECnet Network
3.1
3.2
3.3
3.4
3.5
3.5.1
3.5.2
3.6
3.6.1

The IBM PC-DOS Operating System ...........
0... cece ees
Where to Find DECnet—-DOS Software Components ................
Setting Up Your Node...
2.1...
cc
e nt eeeeee en ees
Choosing the Connection Scheme ..............
0.00. cece eee
Asynchronous DDCMP Communications ....................0
00 eee
Ethernet Communications .............
0...
cette tte ees
Specifying the Location of Files .............
0... cece eee ee
Assigning a Device Specification ....... 0... cece es

Contents-1

3.6.2
3.6.2.1
3.6.2.2

Assigning Path Specifications ............
00... ccc cece enn
Installation Destination Path.............. 000s
DECnet Database Path ......... 0.0 cence
nnenes

3.7
3.8
4.9

Verifying the Installation............0
000. c ccc
eens 3-6
Reboot Line State. 2.0... cence
tent teen en ees 3-6
Selecting DECnet-DOS Utilities.........
0.0.
3-6

3.6.2.3

3.10

Programming Library Sources Destination Path.....................

Completing Preinstallation Check

............
0... ccc eee

3-5
3-5
3-6
3-6

3-8

Installing the DECnet-DOS Software
4.1

Before You Install DECnet-DOS ...........0
0.000

4—]

4.2.1
4.2.2
4.3
4.4
4.5

Understanding DIP Conventions...............
00.00 c cece eee eee
Installing DECnet—DOS Software .........
0.06.0
Updating System Startup Files.......0...0 000s
Completing the Installation 0.0.0.0... 000s
Rerunning the DECnet—DOS Installation Procedure ................

4-2
4-2
4-2
4-3
4-3

4.2

Using the DECnet—DOS Installation Procedure

.....................

4-]

Verifying DECnet-DOS Installation
5.1
5.2
5.3

LOOP EXECUTOR ..... 2.0.
nen ete n eens
LOOP NODE ...... 2...
tent ennt teen nnn eees
Diagnosing Problems .................0
000 c cece eee
eens

5-2
5-2
5-3

Contents of the Distribution Diskettes

DECnet-DOS Utilities
B.1
B.2
B.2.1
B.2.2
B.2.3

Copying Files from the Distribution Diskette .......................
Individual DECnet-DOS Components ................
000... e eee eee
Installation Tools 2.0.0.0... 0.0...
e ee nes
Real-Time Scheduler ..............
0...
nes
Data Link Layer Process .......... 0...
es

B.2.7
B.2.8

Set Host Utility 0.0.0.0...
Local Area Transport.........

B.2.4
B.2.5
B.2.6

Contents-—2

The DECnet-—DOS Network Process .............
000 e cece eee ees B-4
DECnet Database Files ........ 0.0.0
n eens B-4
Network File Transfer Utility 0.0.00... 0.0.0
c cece cence ene ee B-5
0...

e neta B-5
en nee eees B-5

B.2.9

Network Control Program ....... 0.06.

B.2.10
B.2.11
B.2.12
B.2.13

Network Test Utility 0.0.0.0... 00. eens
Transparent File ACCESS ......... 0...
eee
nnnas
Transparent Task-to-Task........
0.0...
es
Transparent Network Task Control ........ 0.00...

B.2.14

B-1
B-2
B-2
B-3
B-3

Network Device Utility .......00 0.00 ect

ees B-6
B-7
B-7
B-7
B-8

e es B-8

B.2.15

Network Virtual Disk Driver ........0 000000000 ccc ccc

B.2.16

Network Virtual Printer Driver

cece ee

B-9

.......00..000
0.0
eee

B-9

B.2.17

DECnet Test Receive and Send Utilities

.........0..00..00..0.0.00...

B-10

B.2.18
B.2.19
B.2.20
B.2.21

DECnet—DOS Mail Utility 2.0.0.0... 0. eee
ees
File Access Listener ......00 0000 cc
ccc ccc cece eee ees
Programming Interface Library Sources............0......00000
000:
Break Source Utility .2...0
000.00

B-10
B-10
B-11
B-11

Specifying a DECnet Database Path
C.1
C.2

Ethernet Configurations .........0...
0.0...
ees C-1
Asynchronous DDCMP Configurations ...................
0c eee eee C-2

Sample Installations Using DIP
Example 1 — Asynchronous DDCMP Configuration ................. D-1

Example 2 — Ethernet Configuration ........................
000 eee D-22

Installation Checklist

Tables
A-1

DECnet—-DOS Files 0... eect

eee A-1

Contents-3

Preface

DECnet—DOS is a communications software product that enables you to use your IBM
personal computer to communicate in a DECnet network. DECnet—DOS Version 1.1
runs on the IBM PC, IBM PC/XT, and IBM Personal Computer AT personal computer
systems using the PC—DOS operating system V2.10 or V3.10.
Manual Objectives
The DECnet-—DOS Installation Guide describes how to install, set up, and use DECnet—DOS. It also discusses the procedures for verifying software and hardware installation.
Before reading the DECnet-DOS Installation Guide, it is required that you read the
DECnet—DOS Release Notes for information pertinent to installation.
Intended Audience

This manual is designed for IBM personal computer users who want to expand their
system capabilities by sharing data and other resources with other DECnet systems.
_ This manual assumes that the user has a working knowledge of the IBM PC, IBM PC/XT,
or IBM PC AT personal computer and the PC-DOS operating system. This manual is
also designed for application developers who are responsible for creating DECnet—
DOS applications.

Preface—1

Structure of This Manual
This manual consists of five chapters and five appendices.
Chapter 1 introduces DECnet—DOS terms and concepts.
Chapter
node.

2 describes

the hardware

necessary

for configuring

the DECnet-DOS

Chapter 3 outlines the steps you must complete before you can install the DECnet
software on your IBM personal computer.
Chapter 4 describes how to use the DECnet—DOS
install DECnet—DOS software.

Installation Procedure (DIP) to

Chapter 5 describes how to verify your DECnet—DOS installation.
Appendix A lists the contents of each distribution diskette and provides the disk
and memory requirements for each DECnet-DOS file.
Appendix B details how to install individual DECnet—DOS files.
Appendix C explains how to specify the DECnet database path.
~ Appendix D provides sample installation sessions.
Appendix E provides a preinstallation checklist.

Preface-2

Conventions

Used

in This Document

The following graphic conventions are used in this manual:
Convention

Meaning

Monospaced
type

Monospaced type indicates examples of system output or user input.
System output is in black; user input is in red.

UPPER

Represents acceptable abbreviations, for example
abbreviations are printed as bold characters.

CASE

DELETE.

The

UPPERCASE

Uppercase in commands and examples indicates that you should
enter the characters as shown (enter either uppercase or lowercase).

italics

Italics in commands and examples indicate that either the system
supplies or you should supply a value.
Square brackets indicate that the enclosed text is optional. If there is
more than one option, you can choose one and only one of the
options. Do not type the brackets when you enter the command.
Braces indicate that the enclosed text is required and you must
choose one and only one of the options. Do not type the braces
when you enter the command.
Indicates that you should press the specified key.
indicates
that you should hold down the
key while you press the x key,
where x is a letter.

KEY

Note that unless otherwise specified, you should end every command line by pressing the
key. This key is labeled —_/ on the IBM
PC and IBM PC/XT personal computers, and —_! ENTER on the IBM
Personal Computer AT.
Ellipses in commands indicate that you
item one or more times.
Associated

can repeat the preceding

Documents

You should have the following documents available for reference:
¢

DECnet-DOS Installation Guide, which you are reading

DECnet-DOS Getting Started

DECnet-—DOS

DECnet-DOS Mini-—Reference Guide

DECnet-—DOS Programmer’s Reference Manual

DECnet—DOS Release Notes

Any introductory manuals for your personal computer.

User’s Guide

Preface-3

4
Introduction

1.1.

Introduction

Digital offers capabilities that permit the linking of computers into flexible configurations called networks. Networking allows computer systems to share resources and
exchange information, files and programs. All of the computers participating in the
network are called nodes.
DECnet is the name given to the family of software and hardware communications
products that enable individual computer systems to communicate with one another in
a network.
DECnet-—DOS software allows IBM PC, IBM PC/XT, and IBM Personal Computer AT
systems to participate as end nodes in a DECnet network. DECnet—DOS enables users
to perform the following high level network functions:
e

Task-to-Task communication. Programs running under different operating systems and written in different languages can exchange data. Using DECnet—DOS,
task-to-task communication can take place between an IBM PC, IBM PC/XT, or IBM
PC AT and any DECnet Phase III system connected to a DECnet router, or any other
DECnet Phase IV system.

Network management. Network management and maintenance functions allow
you to control, monitor, and test DECnet—DOS software to ensure correct operation of the network.

Remote file access. Transport facilities permit programs to access remote files.
You can create, store and retrieve information on remote nodes.

1-1

Resource sharing. Virtual device capabilities enable you to define devices on a
remote system, and use them as if they were directly connected to your computer.
Remote terminal services allow you to use your IBM personal computer as if it were
a terminal directly connected to another node in the network.

1.2

DECnet-DOS Concepts

Before using the DECnet—DOS software, you should understand how different terms
are used in the manual to describe the DECnet—DOS network. The following definitions should be helpful:

The DECnet-DOS environment. The DECnet—DOS environment consists of the
entire network of DECnet systems that include systems running the DECnet—DOS
software.

A routing node. A DECnet routing node can receive and forward information from
one node to another. It can perform other functions that are not limited strictly to
routing information.
An end node. The DECnet—DOS node is an end node. It can only receive information for its own use. An end node
intended for another node.

cannot

receive and then forward

information

A local node. A local node is the node you are working on when you enter commands. Your local node is connected to the DECnet network with an asynchronous communications line or Ethernet controller. Once the connection is made
and the DECnet—DOS software has been installed, you can communicate with any
other node in the DECnet network.
A remote node. Any node in the network other than your local node is called a
remote node.
An executor node. An executor node performs network management functions.
This node enables you to obtain information about the network. For DECnet—DOS,
the executor node is your local node.
An adjacent node. In an asynchronous configuration, an adjacent node is a node
that your system is physically connected to by an asynchronous communications
line. To communicate with any node in the network, DECnet—DOS requires that
the adjacent node must bea routing node. A routing node forwards your messages

to the proper remote node.

Logical links. Tasks that run on different nodes and exchange data are connected
by logical links. Logical links are temporary software information paths established
between two communicating tasks in a DECnet network.
In addition to understanding the terms just defined, you must also know where to find
the relevant information for installing DECnet—DOS. The following chapters present
this information.

1-2

DECnet—DOS Installation Guide

Hardware Components for DECnet-DOS Nodes

This chapter briefly describes the hardware components necessary for configuring
your IBM PC, IBM PC/XT, or IBM Personal Computer AT system as aDECnet node.

2.1

Hardware Components

Any supported IBM PC, IBM PC/XT, or IBM Personal Computer AT configuration,
with 256KB memory, can run the DECnet-—DOS software. While DECnet—DOS runs on
diskette-based systems, it is recommended that you use an IBM system that includes
one of the fixed (hard) disk options for the most convenient and efficient software
operation. A physical connection, either directly to baseband Ethernet or to an adjacent node, allows communication between your IBM system and other DECnet systems to take place. You must install the following hardware components according to
the physical communication method you choose.

2.2

Hardware Components for Asynchronous DDCMP
Communication

You must install the following hardware components if you use an asynchronous communications scheme:
e

IBM’s asynchronous communications adapter (model number 2074 for IBM PC —standard for the IBM PC/XT)
or
IBM’s serial/parallel adapter (model number 0215 for the IBM PC AT)

IBM Communications Adapter cable Model 2067 or Electrical Industry Association
RS232C/V.24 cable

Amodem,

a pair of modems, or a null modem/null modem cable

Loopback connector plug

You should be able to install each of these components with the help of the appropriate
installation/owner’s manual. How your IBM system is connected to the network will
depend upon your application needs and the configuration of the network. Contact the
person responsible for configuring your network for assistance.

2.2.1

Asynchronous Communications or Serial/Parallel Adapter

The asynchronous communications adapter (IBM PC and IBM PC/XT), or the serial/parallel adapter JBM PC AT), provides you with a channel to communicate with other I/O
devices and systems. The asynchronous communications adapter comes standard with
the IBM PC/XT personal computer. However, the adapter is an option for the IBM PC
and requires a System Expansion Slot in the System Unit. The serial/parallel adapter is
an option for the IBM PC AT and also requires a System Expansion Slot in the System
Unit.
Your IBM system can be connected, directly or through a modem, to another computer. The connections are made using a cable that is directly attached to the asynchronous communications adapter or serial/parallel adapter.

2.2.2

Asynchronous Communications Adapter Cable

The Asynchronous Communications Adapter cable and/or the EIA RS232C/V2.4 cable
serves as a physical connection between terminals, personal computers and modems.
Each include the specifications necessary for carrying modem signals, circuit functions, and electrical functions between the devices.

2.2.3

Modem

To relay electrical signals over telephone lines, the signals must be changed from digital
(produced by the computer) to analog (transmitted by a telephone line). Modems are
devices that are capable of changing signals from digitalto analog, then back to digital.
This process involves modulation and then demodulation of the electrical signals. The
word modem is a combination of the first letters of the two terms. You connect the
modem to your IBM system using the asynchronous communications adapter cable or
the EIA cable.

2.2.4

Loopback Connector Plug

Loopback tests allow you to verify that your node is operating correctly. These tests
check hardware and software components. Some loopback tests require the use of a
loopback connector plug. A loopback connector is a hardware device which is temporarily attached to a hardware component or to a cable. You use the connector to test
each component section. Loopback plugs are discussed in more detail in the DECnetDOS User’s Guide.
2-2

DECnet—DOS Installation Guide

2.3

Hardware Components for Ethernet Communication

You must install the following hardware components if you use an Ethernet communications scheme:
e

Ethernet Communications Adapter

Ethernet Connector

Ethernet Cable

Ethernet Loopback Connector Plug

2.3.1

Ethernet Communications Adapter

The Ethernet communications adapter provides you with a channel to communicate
with other I/O devices and systems. Your IBM system can be connected to the Ethernet
connector using a cable that is directly attached to the Ethernet communications
adapter. One of the following adapters is required for direct connection to an Ethernet
network:
e

3Com IE4 EtherLink/IBM PC Ethernet Network
imprinted on the face of the card)

Interface (‘Assembly

1221-00”’

3Com JE2 EtherLink/IBM PC Ethernet Network
0O’’ imprinted on the face of the card)

Interface (“‘Assembly 34-0780-

MICOM Systems NI5010-1 Ethernet Data Link Controller

MICOM Systems NI5010-2 Ethernet Data Link Controller

You should refer to Chapter 3 for specific hardware configuration requirements.
2.3.2

Ethernet Connector

Ethernet connectors, the H4000 transceiver or a DELNI, are devices that connect one
node directly to Ethernet cabling. The transceiver exchanges coded signals among
nodes by converting data and control signals into signals that can be transmitted over
the Ethernet network.
2.3.3

Ethernet Cable

Standard Ethernet cable is a coaxial cable system that physically connects individual
nodes. Ethernet allows nodes to exchange data, messages, and signals with other nodes
on the same cable. (Multiple nodes can be connected to the cable at the same time.)

Hardware Components for DECnet-DOS Nodes

2-3

2.3.4

Ethernet Loopback Connector Plug

Loopback tests allow you to verify that your node is operating correctly. These tests
check hardware and software components. One loopback test requires the use of a
loopback connector plug. A loopback connector is a hardware device which is temporarily attached to a hardware component or to a cable. Loopback plugs are discussed in
more detail in the DECnet—DOS User’s Guide.

2-4

DECnet—DOS Installation Guide

Connecting to the DECnet Network

DECnet—DOS software allows you to connect your personal computer to the DECnet
network. This chapter outlines the steps you must complete before you can install the
DECnet—DOS software on your IBM personal computer. For your convenience, this

outline is presented at the end of this chapter in the form of a checklist. Use this check-

list to collect the information you will need to provide during installation. (Chapter 4
provides you with step-by-step instructions for installing DECnet—DOS.) Also use this
checklist to track your progress throughout the procedure.

3.1

Do You Have an IBM PC, IBM PC/XT, or IBM PC AT System?

Before you can begin to install the DECnet—DOS software, you must be sure that:
Your personal computer is an IBM PC, IBM PC/XT, or IBM Personal Computer AT.

3.2

ThelBM PC-DOS Operating System

The IBM PC-DOS Operating System is a collection of instructions that controls the
overall operation of your IBM personal computer. You must install PC-DOS Version
2.10 or PC-DOS Version 3.10 in order for DECnet—-DOS Version 1.1 software to work
properly.
Refer to the IBM Disk Operating System User’s Guide to install the PC—DOS operating
system.

3.3

Where to Find DECnet-DOS Software Components

You use DECnet—DOS software to establish your IBM system as a DECnet—DOS node.
The DECnet—DOS software is distributed on four RX31 diskettes. An RX31 diskette is a
5.25 inch flexible disk that provides low-cost, compact, and reliable mass storage. Each
diskette is identified with a volume label. They are DECNETPCI11A, DECNETPC11B,
DECNETPC11C, and DECNETPC11D, respectively. Check to make sure you have the
four diskettes. You should create backup copies of each diskette and use these backup
copies during installation. Be sure to leave the write protect tabs off of your backup
copies.

3.4

Setting Up Your Node

Before connecting your node to the network, you must identify your node with a
unique name and address. Obtain these node names and node addresses from the person responsible for setting up networks in your facility. Node names and addresses
should be assigned as follows:
1.

Node Name. A node name is a unique identification string consisting of one to six
alphanumeric characters, including at least one alphabetic character.
Note that the name must not already be assigned to another node.

Node

Address.

A node address is a unique numeric identification of a specific

node. The node’s address includes an area number and a node number:
area.number
where

area is a number in the range of 1 to 63.
number can be in the range of 1 to 1023. It is separated from the area number
with a period.
The area number for your node must match the number for your adjacent node.
The node address must not already be assigned to another node.

Node User Name. A unique identification string consisting of 1 to 16 alphanu-

meric characters. The local node user name is used by DECnet—DOS as access control information required for outgoing proxy logins.

Remember to enter this node information in the checklist provided at the end of this
chapter to aid you at installation time.

3-2

DECnet—DOS Installation Guide

3.5

Choosing the Connection Scheme

Communication between your DECnet—DOS node and other DECnet systems is possible through a physical connection either directly to baseband Ethernet or to an adjacent routing node. Choose one of the following communications types and enter your
selection in the checklist found at the end of this chapter.

3.5.1

Asynchronous DDCMP Communications

To connect your DECnet—DOS node to an adjacent routing node you must follow these
steps:
1.

Select an adjacent node. The adjacent node that you select must be a Phase IV
routing node supporting asynchronous DDCMP connections:
e

=6VMS Version 4.2 or later

¢ = RSX-11M Version 4.2 or later
e

RSX-11S Version 4.2 or later

RSX-11M-PLUS Version 3.0 or later

Ethernet DECnet Router Server Version 1.1 or later.

Install appropriate hardware. Install one of the following:
e

null modem/null modem cable

apair of modems

Select a communications speed for the line. The maximum baud rate is 9600 for
an IBM personal computer system. Enter this rate in the checklist provided at the
end of this chapter.
Configure the adjacent node for asynchronous DDCMP communication. The
DECnet product at the adjacent node must be able to communicate with the DECnet—DOS software. Contact the person responsible for configuring the network for
assistance.
Configure the adjacent node to meet the following requirements.
e

The software and hardware must support a full duplex asynchronous DDCMP
line; communication with the IBM system is either direct or modem controlled. (Use the same method as selected for the IBM system.)
§6Be sure that the baud rate selected for the communications

line matches

the

rate to be used by the IBM system.

Connecting to the DECnet Network

3-3

3.5.2

Ethernet Communications

To connect your DECnet—DOS node directly to a baseband Ethernet local area network, you must follow these steps:
1.

Select a Communications Adapter. Select one of the
adapters for connection to standard Ethernet cabling:

following

supported

3Com IE4 EtherLink/IBM PC Ethernet Network Interface
4Com JE2 EtherLink/IBM PC Ethernet Network Interface
MICOM Systems NI5010-—1 Ethernet Data Link Controller
MICOM Systems NI5010-2 Ethernet Data Link Controller
2.

Install the appropriate hardware. Refer to the manufacturers documentation for
general instructions in installing either the MICOM or 3Com Ethernet adapter.

Configure hardware options. To run the DECnet—DOS
certain hardware options as follows:

software, you must set

4Com

Set the option which determines whether the BNC or DIX (15 pin transceiver)
cable will be used.
Set the interrupt line to 3.
Set the I/O address to 300 (hex).
Disable the memory enable option.
Set the DMA request channel and the DMA ACK channel to 1.
NOTE
These options are factory default options.
MICOM
Set the option which determines whether the BNC
transceiver) cable will be used.

cable or the DIX (15 pin

Set the interrupt request option to 3.
Set the I/O base address to 300 (hex).
Set the DMA request channel and the DMA ACK channel to 1.
Choose AC (not DC) coupling.

DECnet-DOS Installation Guide

Important
The use of interrupt request option 3 possibly conflicts with the secondary communications adapter (COM-2). If you encounter problems
you should check that the COM-2 is not plugged into any device or
remove it.

3.6

Specifying the Location of Files

You can use system startup files (CONFIG.SYS and AUTOEXEC.BAT) to automatically
execute programs when you start PC-DOS. The installation procedure will create or
modify these files for you to add information needed to correctly configure and run
DECnet—DOS.

3.6.1

Assigning a Device Specification

You must specify the device on which the system files reside. This is the drive from
which you ‘“‘booted”’ or started your personal computer. These files must reside in the
root directory of this drive. You can use the default parameter offered by the installation procedure or choose your own device. The default device is C:. Enter the device
name in the checklist provided at the end of this chapter.

3.6.2

Assigning Path Specifications

You must specify where files will be found or written to during installation. A path
specification indicates where files are located by working as a pointer to a specific
directory. A valid path specification should always include a device name. For example:
C:\DECNET

In the above example, C: represents the device name; \DECNET
name.

represents the path

You must assign path specifications for each of the following:
e

§=6Installation destination path

e¢

DECnet database path

Programming Library sources destination path

3.6.2.1.
Installation destination path — This is the path into which the DECnetDOS utilities and network functions will be copied. You may assign a path specification or use the default specification C: \DECNET. The DECnet—DOS Installation Procedure (DIP) will automatically provide this path specification to the PATH command in
the file AUTOEXEC.BAT.

Connecting to the DECnet Network

3-5

3.6.2.2
DECnet database path — DECnet-—DOS requires several database files to
run DECnet—DOS components. The DECnet database path is the path into which the
database files will be stored. You may assign a path specification or use the default
specification C:\DECNET. DIP will automatically add this path specification to the
DECnet process command line in the file AUTOEXEC.BAT. Refer to Appendix C for
detailed instructions on specifying a DECnet database path.
3.6.2.3
Programming library sources destination path
— This is the path into
which the DECnet C programming library sources will be copied. You may assign a
path specification or use the default specification C: \DECNET.
Enter the path names in the checklist provided at the end of this chapter.

3./

Verifying the Installation

You can verify the DECnet—DOS installation by running tests using the Network Test
Utility (NTU). You may choose to run these tests manually or have them run automatically as part of the installation procedure. If you choose to have the tests run automatically, you must specify at least one “‘reachable’’ remote node to be used for testing. Use
the guidelines in section 3.5 when assigning remote node names and addresses, then
enter this node information in the checklist provided at the end of this chapter.
If you choose to run the verification tests manually, refer to Chapter 5 of this manual
and the chapter “‘Testing the Network”’ in the DECnet—DOS User’s Guide for more
information.

3.8

Reboot Line State

You have the option of automatically starting DECnet—DOS upon system reboot. Setting the ‘‘Reboot Line State’ to ON enables the automatic startup of DECnet—DOS
when your system is rebooted.
Select an option and enter your choice in the checklist provided at the end of this chapter.

3.9

Selecting DECnet-DOS Utilities

The DECnet-DOS software kit consists of many separate components which enable
you to perform high-level network functions. When installing DECnet—DOS software,
you can install the entire kit or you may install individual components. Whether you
choose to copy the entire kit or individual components will depend upon how your
system is configured (hard- or floppy-based) and whether you have sufficient disk and
memory space. Each DECnet-DOS component takes up disk and memory space on
your personal computer. Some components require memory all the time while others
require memory space only when used. (See Appendices A and B for detailed information.)

3-6

DECnet—DOS Installation Guide

Select some or all of the following DECnet—DOS utilities and record your choices in the
checklist provided at the end of this chapter:
Programming Utilities:
e

Transparent Task-to-Task (TTT)

Transparent File Access (TFA)

e §6©<C

Programming Library (Programming Interface)

Network Utilities:
e

Network Control Program (NCP)

=6©—Network File Transfer (NFT)

SETHOST

Local Area Transport (LAT)

e = =6©=Network Virtual Disk (NVD)
e

=6—Network Virtual Printer (NVP)

Network Test Utility (NTU)

e = =©6©MAIL Sender
e = File Access Listener (FAL)
e

=6Job Spawner

Connecting to the DECnet Network

3-7

3.10

Completing Preinstallation Check

The following checklist summarizes the preinstallation requirements presented in this
chapter. This checklist is also reproduced in Appendix E for easy removal. Use the
information you prepare with this checklist, along with the information presented in

Chapter 4, to install DECnet—DOS software.

Preinstallation Check
Hardware
L]

Personal Computer
e

§6IBM PC

IBM PC/XT

IBM PCAT

Software
[]

Operating System —- PC-—DOS Version 2.10 or Version 3.10

[|]

DECnet—DOS Software Kit — four RX31 diskettes labeled:
DECNETPC11A
DECNETPC11B
DECNETPC11C
DECNETPC11D

3-8

DECnet—DOS Installation Guide

Configure Network Parameters
Node Parameters
[|

Local Node
Node Name
Node Address
Local Node
User Name

[|]

Remote Node(s)
Node Name
Node Address
Node Name
Node Address
Node Name
Node Address

Communications Type
Choose one of the following communication schemes:
[|]

Asynchronous DDCMP - (line speed)

[]

Ethernet — (interface installed)

Connecting to the DECnet Network

3-9

Device and Path Specifications

Boot Drive (system startup files)

Destination Path (kit files)

Destination Path (DECnet database files)

Destination Path (programming library sources)

Reboot Line State

[I]

OFF

oOo eo
oOboU
OB
OOOO

Select DECnet-DOS

Utilities

TTT -— Transparent Task-to-Task
TFA — Transparent File Access
SETHOST
LAT —- Local Area Transport
NFT — Network File Transfer
FAL — File Access Listener
NTU — Network Test Tool
DTS — Data Test Sender
DTR — Data Test Receiver
NVD — Network Virtual Disk
NVP — Network Virtual Printer
C Programming Library (Programming Interface)
MAIL — Mail Sender Utility
Job Spawner Utility

DECnet-—DOS Installation Guide

Installing the DECnet—DOS Software

The DECnet-—DOS Installation Procedure (DIP) is an automated procedure that offers
an installation method for the experienced as well as the inexperienced user. This
chapter describes how to use DIP to install the DECnet—DOS software on your IBM PC,
IBM PC/XT, or IBM Personal Computer AT. See Appendix D for sample installation sessions.

4.1

Before You Install DECnet-DOS

If you already have an earlier version of DECnet—DOS
must remove it by completing the following steps:
1.

installed on your system, you

Delete all files in the old DECnet directory, then remove the directory. For example, if your old DECnet files are found in \DECNET you should type:
c>DEL \DECNET\*. *
c>RMDIR \DECNET

4.2

Reboot your system and proceed with the installation

Using the DECnet-DOS Installation Procedure

During the installation procedure, you will be asked to reply to a set of questions and
then prompted to make selections from a series of menus. The checklist you prepared
in Chapter 3 will help you answer questions and make menu selections. Before proceeding, make sure you have completed that checklist and have it at hand.

4-1

4.2.1

Understanding DIP Conventions

DIP’s Yes/No queries include a question mark (?) and indicate your choices and the
default response within square brackets [Y/N Default:
Y]. Some answers will cause you
to enter into one or more menus. One of the selections in each menu is HELP. When
you choose HELP, DIP displays information you may need to aid you in the selection
process. When menu selections result in an installation configuration change, a confirmation of the change will be displayed.
You can exit the installation procedure at any time by entering a (CTRUC). Before exiting
you will be given the opportunity to permanently save any selections or changes you
made to the file DIP.SAV (located on the first distribution diskette). When you rerun
the installation, DIP will give you the opportunity to use your previously selected
options. See Appendix D for sample installation sessions.

4.2.2

Installing DECnet—-DOS Software

Complete the following steps to install DECnet—DOS software:
1.

Insert the diskette labeled DECNETPC11A

into drive A:, and close the door.

Set your default drive to A: by typing:
C>A:

Type DIP after the PC—DOS prompt.
A>DIP

Answer questions posed by DIP and make selections from subsequent menus.

After you have proceeded through the series of questions and menu selections, DIP
will prompt you to insert some or all of the remaining diskettes (DECNETPC11B,
DECNETPC11C, and DECNETPC11D). DIP will then give you the opportunity to save
your answers to the file DIP.SAV located on the diskette labeled DECNETPCI1A.
(Remember to leave the write protect tab off of this diskette.)

4.3

Updating System Startup Files

DIP automatically updates, or creates if necessary, your system startup files
(CONFIG.SYS and AUTOEXEC.BAT) to include commands necessary to correctly configure, test, and run DECnet—DOS.

These files are located in the root directory of the

boot drive and are tailored specifically according to the configuration you selected.
If you copy DECnet—DOS files manually, you must update your system startup files.
See Appendix B for more information on the commands you should include in the system startup files.

4-2

DECnet—DOS Installation Guide

4.4

Completing the Installation

After completing the installation, you must reboot your system from the drive you
specified during the installation procedure. The Network Control Program (NCP) will
configure your DECnet node and, if selected, the Network Test Utility (NTU) will run
verification tests. A message will be displayed at your PC when your system is initializing (after it is rebooted). The following message is a sample only — the message you
receive will vary depending upon your selected configuration.
DECnet

Warning:

DECnet
DECnet
DECnet

Version
1.1
installed
~ Network Disk Driver Version 1.1
installed
- Network Printer Driver Version 1.1
installed

DECnet

DECnet
DECnet

Warning:

~
-

TTT
TFA

Database,

Uninitialized

Version
Version

1.1
1.1

using
Node

defaults

Address

installed
installed

If problems appear while NCP or NTU are running, you may enter a
to abort the
procedure. See the chapter, ‘“Testing the Network’’, in the DECnet—DOS User’s Guide
for solutions to your problem(s), if you receive any error messages from NCP or NTU.
After you solve your problem, you must reboot your system to allow NCP and/or NTU
to be run again.

4.5

Rerunning the DECnet-DOS Installation Procedure

You may wish to rerun DIP if you aborted the installation procedure or encountered
problems after installing and initializing the software. Follow the instructions provided
in section 4.2.2 to rerun DIP. DIP searches for the file DIP.SAV. If you saved the previous installation selections to the file DIP.SAV, DIP allows you to use your saved
answers or to enter new selections.

Installing the DECnet-DOS Software

4-3

Verifying DECnet-DOS Installation

The Network Test Utility (NTU) can assist you in verifying your installation of the DECnet—DOS product. NTU can diagnose problems you may have when connecting your
IBM system to the network. It allows you to display information about your node and
how it is interacting with the network. You do not need any special technical knowledge to use NTU. At this point, it is not necessary to have a thorough understanding of
the NTU commands. The DECnet-—DOS User’s Guide can provide you with more
details.
|
During the installation procedure, you can choose to have diagnostic tests run automatically or manually. If you choose to have diagnostic tests run automatically and one
or more

of the verification tests fail, refer to the DECnet—DOS

User’s Guide for assis-

tance in solving any problems that arise.
The following NTU are used to verify the DECnet—DOS installation:
e

LOOP EXECUTOR - to check the operation of your local node.

LOOP NODE — to check the communication with a specified remote node. (It is
recommended that you test against the adjacent node if using an asynchronous
configuration.)

The following sections describe these tests in more detail. Make sure that the connection to your IBM system, and the remote node is in place.

5.1

LOOP EXECUTOR

The LOOP EXECUTOR command invokes the loop test for your local (executor) node.
It verifies the operation of your local node by checking the local network software.
When you execute this command, NTU performs the test 1 times, as long as the test is
successful. (The default value for m is 1. You can change this value using the SET
COUNT command.)
You should refer to the DECnet—DOS
commands.
Enter the LOOP
NTU>LOOP

EXECUTOR

User’s Guide for more information about these

command:

EXECUTOR

The following example requests that the loop test be performed 10 times, with mixed
ones and zeroes, and a message length of 50.
C>NTU
NTU>LOOP

5.2

EXECUTOR

COUNT

WITH

MIXED

LENGTH

LOOP NODE

The LOOP NODE test determines whether the IBM system can communicate with a
specified remote node. The following example illustrates the LOOP NODE command
and a possible system response.
NTU>LOOP
NODE GRAHAM
COUNT
10 LENGTH
Connect
complete
to node GRAHAM

40(C ENTER)

Remote

loopback:

LOOP

node

NODE

maximum

test

buffer

started

size

for

4-FEB-1986

Sending
loop message
1, 40 bytes.
Receiving
loop message
1, 40
bytes.
Successful
send
and
receive,
message
Sending
loop message
2, 40 bytes.
Receiving
loop message
2, 40 bytes.
Successful
send
and
receive,
message
Sending
loop message
3, 40 bytes.
Receiving
loop message
3,
40 bytes.
Successful
send
and
receive,
message
Sending
loop message
4,
40 bytes.
Receiving
loop message
4,
40 bytes.
Successful
send
and
receive,
message
Sending
loop message
5, 40 bytes.
Receiving
loop message
5, 40 bytes.
Successful
send
and
receive,
message
Sending
loop message
6,
40 bytes.
Receiving
!oop message
6,
40 bytes.
Successful
send
and
receive,
message
Sending
loop message
7,
40 bytes.
Receiving
loop message
7,
40 bytes.
Successful
send
and
receive,
message

(continued

5-2

4096

14:32:14

2.
3.
4.

5.
6.

on next page)

DECnet—DOS Installation Guide

Sending
loop message
8,
40 bytes.
Receiving
loop message
8,
40 bytes.
Successful
send
and
receive,
message
Sending
loop message
9,
40 bytes.
Receiving
loop message
9,
40 bytes.
Successful
send
and
receive,
message
Sending
loop message
10,
40 bytes.
Receiving
loop message
10,
40 bytes.
Successful
send
and
receive,
message

LOOP

NODE

test

finished

8.
9.
10.

4-FEB-1986

14:32:44

The LOOP NODE test was successful. The IBM system was able to communicate with
the remote node GRAHAM. To exit from NTU, type:
NTU> EXIT

5.3

Diagnosing Problems

If the verification tests fail, check the following list for possible solutions to your problem or problems.
1.

Are all cables and other hardware components properly installed?

Are your network parameters properly configured?
e

The area number for your IBM system and the adjacent node must be the same.
(asynchronous only)

Your line must be state ON.

e §6© The line speed for your IBM system and the adjacent node must be the same.
(asynchronous only)

Node passwords (if used) for your IBM systems and the adjacent node must be
the same. (asynchronous only)

Network parameters must be properly defined on the adjacent node.

Your IBM system must have a unique node name.

Are you sending and receiving any messages to and from the adjacent node?
e

Use NCP or NTU to display line and circuit counters and events.

Use a breakout box or a line monitor to check if you are sending and receiving
messages. (asynchronous only)

§=6©Also check by putting your IBM system in terminal emulation mode and watching the screen. The binary DDCMP start messages appear as regularly timed
sequences of strange characters. (asynchronous only)

Verifying DECnet-—DOS Installation

5-3

After solving your problem, you should rerun the verification tests by entering the
command VERIFYDN. This command will rerun NCP to configure your node and
rerun NTU to verify your installation. If the verification tests still fail, see the chapter,
‘Testing the Network’”’ in the DECnet—DOS User’s Guide for details on running the
Network Test Utility. If you require additional help, contact the person at your site
who is responsible for DECnet at the adjacent node. To isolate the problem, this person
may use data communications test equipment, and perform network management tests
at the adjacent node.

5-4

DECnet—-DOS Installation Guide

Contents of the Distribution Diskettes

This appendix lists the contents of the distribution diskettes. The description of each
DECnet—DOS file includes required disk size and how much memory is required.
Table A-1:

DECnet-DOS

Facility

Files

File Name

Disk
Size
Bytes*

Memory
Size
Bytes*

never copied
never copied

66000

DECNETPC11A
Installation Tools

DIP. EXE
DIP.DAT

Real-Time

SCHPC.EXE****

4000

3000

Data Link Layer

DLL3COM.EXE****
DLLMICOM.EXE****

11000
11000

50000
50000

Permanent Database

DECPARM.DAT***

400

Node Name

DECNODE.DAT* **

14/node

DECALIAS.DAT***

121/node

Scheduler

Database

Access Control
Information

Network Control
Program

NCP.EXE
NCPHELP.BIN

Access Control

DECACC.DAT***

Database

95000
17000
82/username

(continued

on next page)

A-1

Table A-1 (cont.):

DECnet-DOS

Files

Facility

File Name

Disk
Size
Bytes*

DECnet Network

DNPDCPPC.EXE* ***
DNPETHPC.EXE****

44000
48000

70000
51000

Set Host Utility

SETHOST.EXE

96000

121000

Network File
Transfer Utility

NFT.EXE

82000

106000

Network Test

NTU.EXE
NTUHELP.BIN

88000
10000

100000

Utility
Network Device

NDU.EXE

46000

56000

Network Virtual
Disk Driver

NDDRV.SYS**

3000

7000

Network Virtual

NPDRV.SYS**

2600

8000

LAT.EXE****

10000

13000

FAL.EXE

49000

102000

DTR.EXE

21000

26000

DTS.EXE

65000

72000

MAIL.EXE

67000

84000

Process

Memory
Size
Bytes*

DECNETPC11B

Utility

Printer Driver

DECNETPC11C
Local Area
Terminal
File Access
Listener
DECnet Test

Receive Utility
DECnet Test Send

Utility
DECnet Mail

Utility

MAIL.DAT***

100

Transparent File
Access

TFA.EXE****

27000

47000

Transparent
Task-to-Task

TTT.EXE****

17000

22000

Transparent
Network Task

TNT. EXE

14000

17000

DECnet Mail
Database

(continued

on next page)

DECnet—DOS Installation Guide

Table A-1 (cont.):

DECnet-DOS

Files

Facility

File Name

Disk
Size
Bytes*

Job Spawner

SPAW NER.EXE

19000

Job Spawner

DECSPAWN.DAT™***

Memory
Size
Bytes*
22000

100

Database

DECNETPC11D
DTS.TXT

15000

Release Notes

RELEASE.NOT

40000

Break Source

BREAKSRC.EXE

never copied

12000

Utility
DNETLIB.SRC
**
*

**K

* OK OK OK

227000

The amount of disk space and memory requirements are given as approximate sizes.
Resident in memory; must be installed at boot time.
Not included in kit; may be created during installation or when using utilities.
Resident in memory; may be installed at any time.

Contents of the Distribution Diskettes

DECnet-DOS

Utilities

The DECnet—DOS Installation Procedure (DIP) allows you to automatically install
DECnet—-DOS files and utilities onto your IBM PC, IBM PC/XT, or IBM Personal Computer AT. You may, however, copy these files and utilities manually if you wish to do
so. This appendix provides you with the information you need to successfully copy
portions of the DECnet—DOS software kit.

B.1

Copying Files from the Distribution Diskette

Each DECnet-DOS utility may require more than one file. Appendix A lists the contents of all distribution diskettes.
Complete the following steps to install only portions of the DECnet—DOS product:
1.

Create a DECnet directory on the disk to which DECnet—DOS files will be copied.
Enter the MKDIR command at the keyboard. Type:
C>MKDIR

\DECNET

Insert the diskette labeled DECNETPC11A

into drive A:, and close the door.

Select the files to be copied (using Appendix A as a guide).
Files needed for a specific DECnet—DOS utility can be copied into any directory of
your choice. The directory must be in your path. However, if the DECnet—DOS
utility requires *.BIN files, you must copy them into the DECnet database path.
(See Appendix C.)

For example, to copy the Network Control Program utility, move the *.BIN files to
the \DECNET directory and the NCP.EXE file to any other directory in your path.
Type:

C> COPY
C> COPY

A:NCPHELP.BIN
A:NCP.EXE

\DECNET

Repeat the copy operation until you have finished copying the required files for
each DECnet—DOS utility from the diskette.

Once step 4 is complete, you can remove the diskette from the drive. Repeat the
above directions, beginning with step 2, if you want to copy files from any other
diskette.

Update your system startup files to include the command lines necessary to install
DECnet—DOS software.

B.2

Individual DECnet-DOS Components

You may need to copy one or more files in order to run some DECnet—DOS components correctly. This section provides you with the detailed information you need to
copy portions of the DECnet—DOS files and utilities, including:
e

how to run the specific DECnet—DOS utility Gif applicable)

any DECnet or PC—DOS parameter(s) that must be modified before the utility is run
(if applicable)

Refer to Appendix A for disk and memory requirements for each DECnet—DOS file and
utility.

B.2.1

Installation Tools

Required Files
DIP.EXE
DIP.DAT
DIP.SAV
These files are used only during installation. They are never automatically copied from
the software kit. The file DIP.SAV is created if the user runs the DECnet—DOS Installation Procedure (DIP) and chooses to save answers.

B-2

DECnet-—DOS Installation Guide

B.2.2

Real-Time Scheduler

Required File
SCHPC.EXE

Installation Requirements
The Real-Time Scheduler is required for all other DECnet—DOS services and utilities.
SCHPC.EXE is a terminate and stay resident task which is loaded into memory the first
time it is run. It remains resident in memory. SCHPC.EXE must be run before the Data
Link Layer (DLL) (if using Ethernet configuration) and the DECnet Network Process
(DNP).
SCHPC.EXE can be copied to any directory as long as that directory is in your path. You
may install the scheduler by including the following line in the file AUTOEXEC.BAT:
SCHPC

NOTE
SCHPC.EXE is always automatically selected by DIP.

B.2.3

Data Link Layer Process

Required Files
DLL3COM.EXE
DLLMICOM.EXE
The Data Link Layer (DLL) process is required (for all DECnet—DOS services and utilities) for Ethernet configurations only. DLL is a terminate and stay resident task which is
loaded into memory the first time it is run. It remains resident in memory. DLL must be
installed after SCH but before LAT and DNP.
You can install DLL in any directory as long as that directory is in your path. You can
specify the DECnet database path as a command line argument. (See Appendix C for
details on specifying the DECnet database path.) During initialization, DLL reads the
permanent database file, \DECPARM.DAT in the DECnet database path. If you plan to
install DLL, you may install the file by including the following line in the file
AUTOEXEC.BAT:
DLL3COM

<DECnet

database

path>

DLLMICOM

<DECnet

database

path>

NOTE
DLL is automatically selected by DIP for Ethernet configurations.

DECnet-DOS Utilities

B-3

B.2.4

The DECnet-—DOS

Network Process

Required Files
DNPDCPPC.EXE (asynchronous)
DNPETHPC.EXE (Ethernet)
Installation Requirements
The DECnet network process is required by all other DECnet—DOS services and utilities. It is loaded into memory and initialized the first time it is run. The DECnet process
remains resident in memory.
During initialization, DNP reads the permanent database file, \DECPARM.DAT in the
DECnet database path. DNP can be copied to any directory as long as that directory is in
your path. (See Appendix C for more details on specifying a DECnet database path.) If
you plan to install DNP, you may install the file by including the following line in the
file AUTOEXEC.BAT:
DNPCPPC
or

<DECnet

DNPETHPC

<DECnet

database

path>

database

path>

When your system is rebooted, the line comes up in the state last defined by NCP
before the reboot. When the line state is OFF, the asynchronous communications port
can be used by any other software, even with the DECnet—DOS process loaded.
NOTE
DNP is always automatically selected by DIP.

B.2.5

DECnet Database Files

Required Files
DECPARM.DAT (Permanent Database)
DECNODE.DAT (Node Name Database)
DECALIAS.DAT (Access Control Information)
DECACC.DAT
DECSPAWN.DAT (Job Spawner Database)
MAIL.DAT (DECnet Mail Database)
VT102.DAT (SETHOST Database)
Installation Requirements
The files DECPARM.DAT,

DECNODE.DAT,

and DECLIAS.DAT

are created automati-

cally during
installation.
DNP
or DLL
reads the permanent
database
file
DECPARM.DAT. DECNODE.DAT and DECALIAS.DAT are never read or written by
DNP. All database files are read and written by utility programs. They are created and
changed by NCP and read by the utilities. No memory space is required for these data
files. Refer to the DECnet—DOS User’s Guide for more information on how these files
are created.
B-4

DECnet-DOS Installation Guide

The database files must be in the DECnet database path. See Appendix C for details on
specifying the DECnet database path.

NOTE
All files with the file extensions

*.DAT

and

*.BIN must be located in

the DECnet database path.
Use the NCP command SHOW
net database path.

B.2.6

EXECUTOR

CHARACTERISTICS

to display your DEC-

Network File Transfer Utility

Required File
NFT.EXE

Installation Requirements
NFT.EXE can be copied to any directory as long as that directory is in your path. NFT
uses memory only when it is running.

B.2.7

Set Host Utility

Required File
SETHOST.EXE
Installation Requirements
SETHOST.EXE can be copied to any directory. SETHOST uses memory only when it is
running.
When you define parameters using the SET-UP display, the parameters are saved in the
file VT102.DAT. SETHOST then uses the DECnet database path to find the DECnet
directory.

B.2.8

Local Area Transport

Required File
LAT.EXE
Installation Requirements
LAT.EXE can be copied to any directory as long as that directory is in your path. It must
be run after SCH and DLL but before DNP. This process is used by SETHOST if you are
using an Ethernet configuration. LAT is a terminate and stay resident task which is
loaded into memory the first time it is run. It remains resident in memory.

NOTE
This file is automatically selected by DIP if an Ethernet and SETHOST
configuration is selected.

DECnet-DOS Utilities

B-5

If LAT is not installed, SETHOST makes all connections using the DECnet CTERM protocol.
If you plan to install LAT, you must install the file by including the following line in the
file AUTOEXEC.BAT:
LAT

Four command line switches are provided:
1.

/D:nn — This is used to increase the default size of the LAT Service Directory,
where 7 is an unsigned integer. Each additional entry will cause an extra 47 bytes
of memory to be allocated (rounded to the nearest 16 byte paragraph). The default
size of the directory is 50 entries = 470 bytes.

/G:bytel,byte2,byte3,...byte32 — Each byte represents a byte in the group code
field. Omit a byte by using a comma. Groups are numbered from 0 to 255 starting at
the rightmost bit of byte number one. All group codes are enabled by default.

/R:n — This is used to set the number of retransmits permitted for a circuit. Eight
retransmits are allowed by default before the circuit is stopped.

/N — This switch stops LAT from listening for announcements of services. If this
switch is used, all LAT services must be declared using the NCP SET NODE ADDR
LAT command. Load balancing will not work.

B.2.9

Network Control Program

Required Files
NCP.EXE
NCPHELP.BIN
Installation Requirements
NCP.EXE can be copied to any directory as long as that directory is in your path. However, the NCP.BIN file must be in the DECnet database path. (See Appendix C for more
details on specifying a DECnet database path.)
NCP opens many files when it runs. For NCP to run, you must increase the number of
FILES in CONFIG.SYS. Edit the command line FILES = 7 in CONFIG.SYS with EDLIN or
any editor. The value must be at least 20.

NOTE
The FILE value in CONFIG.SYS
using DIP to install the software.

is automatically adjusted if you are

NCP uses memory only when it is running.

B-6

DECnet-DOS Installation Guide

B.2.10

Network Test Utility

Required Files
NTU.EXE
NTUHELP.BIN
Installation Requirements
NTU.EXE can be copied to any directory as long as that directory is in your path. However, the NTU.BIN file must be in the DECnet database path. (See Appendix C for more
details on specifying a DECnet database path.)
NTU opens many files when it runs. For NTU to run, you must increase the number of
FILES in CONFIG.SYS. Edit the command line FILES = 7 in CONFIG.SYS with EDLIN or
any editor. The value must be at least 20.

NOTE
The FILE value in CONFIG.SYS
using DIP to install the software.

is automatically adjusted if you are

NTU uses memory only when it is running.

B.2.11

Transparent File Access

Required File
TFA.EXE

Installation Requirements
TFA can be copied to any directory as long as that directory is in your path.
TFA is a terminate and stay resident task which is loaded into memory the first time it is
run. It remains resident in memory. TFA can be removed from memory by TNT. If you
plan to use TFA, you may install the file by including the following line in the file
AUTOEXEC.BAT:

TFA
NOTE
This line will automatically be added to your AUTOEXEC.BAT
you are using DIP to install the software.

B.2.12

file if

Transparent Task-to-Task

Required File
TTT.EXE
Installation Requirements
TTT can be copied to any directory as long as that directory is in your path.

DECnet-DOS Utilities

B-7

TTT is a terminate and stay resident task which is loaded into memory the first time it is
run. It remains resident in memory. TTT can be removed from memory by TNT. If you
plan to use TTT, you may install the file by including the following line in the file
AUTOEXEC.BAT:

TTT
NOTE
This line will automatically be added to your AUTOEXEC.BAT
you are using DIP to install the software.

B.2.13

file if

Transparent Network Task Control

Required File
TNT.EXE

Installation Requirements
TNT.EXE can be copied to any directory as long as that directory is in your path. TNT
reports errors from the use of TFA and TTT. Do not install TNT if you do not use TFA
and TTT.

NOTE
TNT.EXE is automatically selected if TTT
when running the installation procedure.

and/or TFA

are selected

TNT uses memory only when it is running.

B.2.14

Network Device Utility

Required File
NDU.EXE

Installation Requirements
This utility is required if you plan to use the network virtual disk and/or the network
virtual printer. The NDU.EXE file can be copied to any directory as long as that directory is in your path.

NOTE
NDU.EXE is automatically selected if Network Virtual Disk and/or Network Virtual Printer are selected during the automatic installation procedure.

B-8

—

DECnet—DOS Installation Guide

B.2.15

Network Virtual Disk Driver

Required File
NDDRV.SYS

Installation Requirements
The driver is required for the Network Virtual Disk utility. It is loaded into memory
and initialized at boot time as a result of the DEVICE=NDDRV.SYS statement in
\CONFIG.SYS. The driver must be on the hard disk if it is booted from the hard disk.
Once installed, the driver remains resident in memory. If you plan to use Network Virtual Disk utility, you must install the driver by including the following command line in
the system startup file CONFIG.SYS:
DEVICE

<DECnet

database

path>\NDDRV.SYS

Although NDU controls your use of virtual disks, the network virtual disk driver actually performs the input and output for you. You must install this program before you
can run NDU. Refer to the DECnet-—DOS User’s Guide on how to run the Network
Device Utility, and use the NDU commands.
If you want to frequently access files from an existing virtual disk, you can update your
current \AUTOEXEC.BAT file and include the NDU OPEN command. This should
automatically establish the necessary link to the remote DECnet node where the virtual
disk is stored. To do this, include the NDU OPEN command in your current
\AUTOEXEC.BAT file. Refer to the DECnet—DOS User’s Guide for an explanation of
the NDU OPEN command.

B.2.16

Network Virtual Printer Driver

Required File
NPDRV.SYS

Installation Requirements
The driver is required for the Network Virtual Printer utility. It is loaded into memory
and initialized at boot time as a result of the DEVICE=NPDRV.SYS statement in
\CONFIG.SYS. The driver must be on the hard disk if it is booted from the hard disk.
Once installed, the driver remains resident in memory. If you plan to use Network Virtual Printer utility, you must install the driver by including the following command line
in the system startup file CONFIG.SYS:
DEVICE

<DECnet

database

path>\NPDRV.SYS

Although NDU controls your use of virtual printers, the network virtual printer driver
actually performs the input and output for you. You must install this program before
you can run NDU. Refer to the DECnet—DOS User’s Guide on how to run the Network
Device Utility, and use the NDU commands.

DECnet—DOS Utilities

B-9

If you want to frequently access the virtual printer, you can update your current
\AUTOEXEC.BAT file and include the NDU OPEN command. This should automatically establish the necessary link to the remote DECnet node where the virtual printer
file is located. To do this, include the NDU OPEN command in your current
\AUTOEXEC.BAT file. Refer to the DECnet—DOS User’s Guide for an explanation of
the NDU OPEN command.

B.2.17

DECnet Test Receive and Send Utilities

Required Files
DTR.EXE (DECnet Test Receiver Utility)
DTS.EXE (DECnet Test Sender Utility)
DTS.TXT
Installation Requirements
DTR and DTS are used for testing the network. They do not need to be copied for normal operations. DTR.EXE and DTS.EXE can be copied to any directory as long as that
directory is in your path. DTS.TXT provides documentation (not found in the User’s
Guide) on the use of DTS and DTR.
DTR and DTS use memory only when they are running.

B.2.18

DECnet-DOS Mail Utility

Required File
MAIL.EXE

installation Requirements
MAIL.EXE can be copied to any directory as long as that directory is in your path.
MAJIL.EXE uses memory only when it is running.
NOTE
MAIL.EXE is automatically selected by DIP.

B.2.19

File Access Listener

Required File
FAL.EXE

Installation Requirements
FAL.EXE can be installed in any directory as long as that directory is in your path.
FAL.EXE uses memory only when it is running.
NOTE
FAL.EXE is automatically selected by DIP.
B-10

DECnet—DOS Installation Guide

B.2.20

Programming Interface Library Sources

Required File

DNETLIB.SRC
Installation Requirements
This file contains the source and header files for the programming interface library.
After building the proper object or library file for your compiler, this file can be
deleted. You should also refer to the DECnet-DOS Programmer’s Reference Manual
on how to create your own programming interface library.
If you are not involved in writing any programs which access the network directly, this
file is not needed.

B.2.21

Break Source Utility

Required File
BREAKSRC.EXE

Installation Requirements
Use this file to break the DNETLIB.SRC file into separate source files for compiling and
assembling your programs.

DECnet-DOS Utilities

B-11

Specifying a DECnet Database Path

You need several database files to run DECnet—DOS software components. Your system startup file AUTOEXEC.BAT contains a path specification that enables DECnetDOS software to access these database files. This appendix provides instructions you
need to specify a DECnet database path if you want to change the existing path specification or if you are manually installing portions of the DECnet—DOS software components.
DECnet database device and path names are specified as input arguments to the Data
Link Layer (DLL) and/or the DECnet Network Process (DNP) command lines in
AUTOEXEC.BAT. Upon system reboot, DNP and DLL use their command line arguments as path specification for accessing the database files. To change the DECnet database path, you must enter a new path specification to the DLL and/or the DNP command lines. (Use EDLIN or a similar text editor to edit the command lines in the file
AUTOEXEC.BAT.)

C.1

Ethernet Configurations

If you have an Ethernet configuration, the Data Link Layer (DLL) and the DECnet Network Process (DNP) will be installed and require the database path specification. Enter
the path specification on the DLL and DNP command line in AUTOEXEC.BAT. For
example:
PATH

C:\DECNET;

REM
***
Ethernet
SCH
DLL C:\DECNET
LAT
DNP C:\DECNET
TTT
TFA

Configuration

***

C.2

Asynchronous DDCMP Configurations

If you have an asynchronous DDCMP configuration, the DNP will be installed and
requires a database path specification. The DECnet database path specification should
be entered on the DNP command line in AUTOEXEC.BAT. For example:
PATH

C:\DECNET;

REM
SCH
DNP

***

Asynchronous

Configuration

***

C:\DECNET

A default path will be used if no path specification is entered on either command line.
NOTE
The default path is built using the default drive (when DLL and/or DNP
are run) and the directory ‘“‘“\DECNET’’. For example, if C: is the
default drive and the user enters DNP with no command line argument, the database path will be C:\DECNET.
The DECnet database path does not have to match the path in which the DECnet software is copied. However the path into which the DECnet software is copied should be
added to the path environment variable string. For example:
PATH

C-2

C:\DECNET ;C:\;C: \utility

DECnet-DOS Installation Guide

Sample Installations Using DIP

This appendix provides sample procedures which illustrate how to use the DECnet—
DOS Installation Procedure (DIP) to install DECnet—~DOS software on your IBM personal computer. The answers used are for demonstration purposes only and will probably differ from the answers that you will supply during your actual installation.
Example 1 —- Asynchronous DDCMP

Configuration

This example presents the screens and menus that you will see when you use DIP to
copy the entire DECnet—DOS software kit to your IBM PC AT personal computer, configured for asynchronous communications. Many screens are self explanatory. Where
necessary, explanatory text is inserted to help explain the process.
First, insert the diskette labeled DECNETPC1

1A into drive A: and type:

A> DIP

DIP displays:
DECnet-DOS
Press

any

key

continue

Installation
or

Procedure
to

exit...

(DIP)

V1.1

The first series of screens provide an overview of the installation procedure:
OVERVIEW
KRK

KKK

During
the DECnet-DOS
installation
you will
to a set
of questions
and prompted
to make
a series
of menus.
You may
select
any one
in each menu.
On-line
HELP
is
included
as
When
your
change,
a
You
the
KEK

Press

KKK

any

KKK

key

KKK

continue

pressing

KKK

OVERVIEW
KRKKKKKKKK

KKK

KOK

KKK

be asked
to
reply
selections
from
of the
items
listed
an
item
in each menu.

menu
selection
results
in an
installation
configuration
confirmation
of your
selection
is displayed.

can
back
out
of any menu
by
"Enter
selection?"
prompt.
KKK

KKK

The
For

default
example:

"Do

you

KKK

answer

want

displayed
it

KKK

after

KOK OK KK

KKK

KOK

KKK

exit...

(continued)

KKK

change

KKK

<ENTER>

KKK

with

[Y/N

KKK

OK KKK

each

OK KKK

OK KOK

question.

Default:

Y]"

You may
exit
the
installation
procedure
at any time
by
entering
a <CTRL/C>.
Before
exiting,
you will
be given
the
chance
to permanently
save your
answers
to the
file
DIP.SAV
located
on the
first
distribution
floppy.
Leave
the write
protect
tab off
of the
floppy.
Have
your
Installation
installation
procedure.

Guide

handy

KKKKKKK

KKK

Press

D-2

KKK

any

KKK

key

KKK

continue

during

this

KKK

KOK OK KOK

KKK

exit...

DECnet-DOS Installation Guide

OVERVIEW
KKKKKKK

Release

KKK

notes

KKK

contain

KKK

(continued)
KKK

information

KKK

about

KKK

KOK

KKK

DECnet-DOS

that
may
not
have
been
included
in any of the other
forma!
documentation.
Such
things
as hints
on
installation,
configuration
and
troubleshooting
as well
as some
additional
information
about
software
components
and
reporting
problems
are
included
in the
release
notes.
If you
have
not
read
the
release
notes
yet,
do so at this
time.
Release
Notes
(4 of 4).

are

KRKEKKKKKKKK

Press

any

KKK

key

the

KKK

file

continue

Sample Installations Using DIP

RELEASE.NOT

KKK

KOK

KKK

kit

floppy

KOK

RK KOK

DECNETPC11D

RK KK

KOK

exit...

D-3

The next set of screens pertain to setting up your personal computer as a DECnet—DOS
node:

SET
KKK

KKK

LOCAL

KKK

NODE
KKK

INFORMATION

KKK

KR KKK

KKK

OK KOK

To
run your
IBM PC AT personal
computer
as a DECnet-DOS
node,
you must
give
it a node
name and
a
unique
node
address.
Obtain
this
information
before
continuing
with
this
installation
procedure.
KKK

KKK

Press

KKK

any

KKK

key

KKK

continue

KKK

KOK

KOK OK KK

KOK

exit...

DIP prompts you for your node name and address, then displays a summary of your
responses. Use the information you recorded in your preinstallation checklist to
answer these questions.

Node
name
(Example:
ANODE)
?
Node
address
(Example:
10.55)
Local

node

Node
Node

Change

D-4

wtpIlns <ENTER>
? 55.63 <ENTER>

information

[Y/N

WTPLNS
55.63
Default:

<ENTER>

DECnet—DOS Installation Guide

Here DIP prompts you to enter your local node user name:
SET
KKEKKKKK

KKK

UP
KKK

LOCAL

NODE

KEK

KKK

USER
KKK

NAME

KKK

KEK

KKK

You must
set
up a local
node
user
name
to be used
by
DECnet—~DOS
as the access
control
information
required
for
logins.
Upper
and
lower
case
characters
make
a
difference,
therefore
take
care when
entering
this
name.
(See
the Programmer's
Reference
Manual
for more
information.)
KKK

KKK

Press

any

Enter

name

Local

node

Change

name

key

user

User

is:

KOK

KKK

KOK

continue

name

? adams

from

KKK

KOK OR KOK

KOR OK OK KOK

name

[Y/N

Default:

<ENTER>

Sample Installations Using DIP

KOK

exit...

characters.

proxy

KOR OK OK OK OK OK KOK OK KOK OK KOK OK OK OK KOK

alphanumeric

<ENTER>

user

"adams"

KOK OK

You can communicate with other DECnet nodes by physically connecting your node
directly to the baseband Ethernet or to an adjacent routing node. DIP prompts you to
enter your communications type.

KKKRKAKKKKKKKKK

KKK

SET

KKK

COMMUNICATIONS
KKK

KKK

You may
run DECnet-DOS
using
Ethernet
communications.
The
following menus
the appropriate
communication
type.
KKKK

Press

KKK

any

KKK

key

KKK

continue

KKK

KKK

TYPE
KOK

KOK

Enter

D-6

selection?

KR KKK

KOK

or Asynchronous
DDCMP
allow you
to select

KKK

OK KOK OK

KR KOK OK KOK OK KOK

KOK OK KK

exit...

COMMUNICATIONS
1.
2.
3

KKK

TYPE

Select
from the
following:
Help
Ethernet
Asynchronous
DDCMP

<ENTER>

DECnet—DOS Installation Guide

To connect your DECnet node to an adjacent routing node
DDCMP, you must select a communications speed for the line.
DDCMP

from

the

Select
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
Enter

selection?

1/7

DIP displays a summary
making further changes.

[Y/N

SPEED

following:

<ENTER>

of your communications

Communications
Type:
Communications
Line Speed:
it

asynchronous

Help
50
75
110
134
150
200
300
600
1200
1800
2000
2400
3600
4800
7200
9600

SUMMARY

Change

LINE

using

Default:

Sample Installations Using DIP

COMMUNICATIONS

Asynchronous
9600
Y]

type and offers you the option of

PARAMETERS

DDCMP

<ENTER>

D-7

Your system startup files (CONFIG.SYS and AUTOEXEC.BAT) contain information
needed to correctly configure and run DECnet—DOS. Here DIP supplies a summary of
the default choices for device and path specifications.
SUMMARY
Boot

drive

DECnet-DOS

kit

DECnet-DOS
DECnet-DOS
Change

(location

files

will

PATH
of

SPECIFICATIONS
CONFIG.SYS

copied

kit
files will
be copied
TO
default
database
files wil!
[Y/N

Default:

and

FROM

drive

AUTOEXEC.BAT).

C:\DECNET\
be
located

C:\DECNET\

n <ENTER>

You may use the Network Test Utility (NTU) to verify your installation. You may
‘choose to have verification tests run automatically or you may run them manually.
AUTOMATIC
KKKKK

KKK

INSTALLATION

KKK

VERIFICATION

KR KKK

KKK

KR KKK

KKK

OK KKK

KOK

You
can verify
the DECnet-DOS
installation
by
running
tests
using
the Network
Test
Utility
(NTU).
You may
choose
to have
these
tests
run automatically
Or you may
run tests manually.
If you
choose
to
run
the tests manually,
please
refer
to the
chapter
on NTU
in the User's
Guide.
KKKKKK

KKK

Automatic

verification

Change

[Y/N

D-8

KEK

Default:

KKK

installation
Y]

KKK

currently

KOK

KKK

set

KKK

OFF

<ENTER>

DECnet-DOS Installation Guide

SET
KKKRK

KKK

UP
KK

REBOOT

KKK

Setting
startup

"Reboot
Line State"
to
of DECnet-DOS
upon
IBM

KOK

KKK

Reboot

line

Change

KK OK KK

state
[Y/N

KOK

KOK OK OK KKK

SELECTING
KHKKKKKKK

KKK

Use

following

the

DECnet-DOS
of

KRKRKKKK

Press

any

KKK

kit

KKK

menus

components

KKK

<ENTER>

KKK

key

KKK

any

KKK

KOK

KKK

KOK OK KK OK OK OK OK OK KOK

KKK

Sample Installations Using DIP

KOK

COMPONENTS

copy

KOK OK ROK

SOFTWARE

continue

KOK

OK KOK

KOK OK OK OK OK OK OK

enables
the automatic
AT system
reboot.

(files).
KK

STATE

KKK

OFF

<ENTER>.

KKK

ON
PC

set

pressing
KKK

KK OK OK KOK OK OK KK

currently
Default:

LINE

You

KKK

KKK

all

may
KK

KOK

back

KOK

KR KK

KOK

KOK OK KOK OK OK OK

KOK

KK OK KK

KOK OK KOK OK

the

KKK

exit...

out
KKK

KOK

KOK OK KK

You may choose to copy the entire DECnet—DOS software kit or select individual components. A minimum configuration is necessary to run DECnet—DOS on your system.
The files and utilities that make up this minimum configuration will always be copied.
Before you copy files however, you may review your current software and hardware
configuration with the ‘‘Summaries’’ menu selection. The following series of screens
illustrate how to use the summary menus.
COPY

WN ke

Select

Enter

selection?

from

KIT
the

FILES
following:

Help
Summaries
Copy
Entire
Kit
Select
Individual

Components

<ENTER>
SUMMARIES

OmnhWNMYFH

Select

Enter

D-10

selection?

from

the

following:

Help
Begin Copying
Kit
Files
General
Information
Summary
Node
Information
Summary
Communications
Information
Summary
Software
Summary

<ENTER>

DECnet—DOS Installation Guide

The following screen displays asummary of your software and hardware configuration
and the choices you made for copy path, database path, reboot line state, and automatic installation verification.

SUMMARY
Personal
Kit

Computer

DOS

Type:

Version:

Boot
drive:
File(s)
to be Copied
to:
DECnet
Database
Path:
Reboot
Line State:
Installation
Verification:

Minimum
DECnet
Memory
Usage:
Available
Bytes
of Memory:
Available
Bytes
of Memory:
Available
Available
Press

any

DECnet
Bytes
Bytes

key

Disk
Usage:
on Drive C:
on Drive C:
continue

Sample Installations Using DIP

GENERAL

INFORMATION

IBM PC AT
3.10
C:
C:\DECNET\
C:\DECNET\
OFF
OFF
167374
486160
318786

(estimated)
(before
installing
DECnet)
(after
installing
DECnet)

172700
237568
(before
copying
files)
64868
(after
copying
files)
<CTRL/C>

exit...

SUMMARIES

OOnBR

WDM

Select

Enter

selection?

from

the

following:

Help
Begin
Copying
Kit
Files
General
Information
Summary
Node
Information
Summary
Communications
Information
Summary
Software
Summary

<ENTER>

The following screen displays the names and addresses you entered for each node during the installation procedure. It also displays the local node user name.
SUMMARY
WITPLNS
Press

D-12

any

55.63
key

—~
to

Local

continue

Node
or

(User

DEFINED
Name:
to

NODE(S)

adams)

exit...

DECnet—DOS Installation Guide

SUMMARIES

Ooh

WNHH

Select

Fnter

selection?

The following
Ethernet).

screen

key

following:

<ENTER>

summarizes

Communications
Type:
Communications
Line Speed:
any

the

Help
Begin
Copying
Kit
Files
General
Information
Summary
Node
Information
Summary
Communications
Information
Summary
Software
Summary

SUMMARY

Press

from

continue

Sample Installations Using DIP

your

communications

COMMUNICATIONS

Asynchronous
9600
or

type

(asynchronous

PARAMETERS

DDCMP
to

exit...

D-13

SUMMARIES

OomhWNF

Select

Fnter

selection?

from

the

following:

Help
Begin
Copying
Kit
Files
General
Information
Summary
Node
Information
Summary
Communications
Information
Summary
Software
Summary

<ENTER>

The following screen summarizes the individual DECnet—DOS files and utilities to be
copied based upon your current configuration. The information displayed here
includes the file name, the location of, and disk and memory requirements for each
component.
If you have not yet selected any DECnet—DOS components, the files which make up the
minimum configuration will be displayed at this time and subsequently copied.
SUMMARY
File

Name

Press

D-14

any

key

SELECTED

SOFTWARE

COMPONENTS

Found
on
Labeled

Disk
Usage

Memory
Usage

DECNETPC11A
DECNETPC11A
DECNETPC11A
DECNETPC11A

91412
15872
3968
56448

97268

Kit

NCP. EXE
NCPHELP.BIN
SCHPC . EXE
DNPDCPPC. EXE

continue

0
3334
66772

[memory
[memory

resident]
resident]

exit...

DECnet—DOS Installation Guide

You can back out of the SUMMARIES
‘Enter Selection ?”’ prompt.

by pressing

in response to the

SUMMARIES

OoORWNE

Select

Enter

selection?

from

the

following:

Help
Begin
Copying
Kit
Files
General
Information
Summary
Node
Information
Summary
Communications
Information
Summary
Software
Summary

<ENTER>

You may proceed with the installation procedure when you are satisfied with your
configuration selections.
COPY

BWN Fe

Select

Enter

selection?

<ENTER>

Sample Installations Using DIP

from

KIT
the

Help
Summaries
Copy
Entire
Kit
Select
Individual

FILES
following:

Components

If you have an earlier version of DECnet—DOS installed on your system, DIP automatically deletes the old DECnet directory and creates a new one.

Insert

into

drive

exit...

[<CTRL/C>
disabled
while
a file
is being
[Deleted
old C:\DECNET\DECPARM.
DAT |
[Created
directory
C:\DECNET]

copied]

Press

diskette
any

key

labeled
to

DECNETPC11A

continue

Copying

file

A:NCP.EXE

Copying

file

A:NCPHELP.BIN

Copying

file

A:SCHPC.EXE

Copying

file

A:DNPDCPPC.EXE

Insert

diskette

Press

any

[<CTRL/C>

key

disabled

continue

C:\DECNET\DNP.
EXE

or
a

into

drive

exit...

being

copied]

<CTRL/C>
file

C:\DECNET\LAT.EXE

Copying

file

A:NFT.EXE

C:\DECNET\NFT.EXE

Copying

file

C:\DECNET\NTU.EXE

Copying

file

Copying

file

Copying

file

Copying

file

A:LAT.EXE

A:NTU.EXE

file

A:NTUHELP.BIN

Copying

A:NDU.EXE
A:NDDRV.SYS

C:\DECNET\NDDRV.SYS

A:NPDRV.SYS

C:\DECNET\NPDRV.SYS

C:\DECNET\SETHOST
. EXE

A:SETHOST.EXE

file

D-16

C:\DECNET\SCH.
EXE

Copying

C:\DECNET\NCPHELP.BIN

DECNETPC11B

while

C:\DECNET\NCP.EXE

labeled

C:\DECNET\NTUHELP.BIN

C:\DECNET\NDU.EXE

DECnet-DOS Installation Guide

Insert
Press

diskette
any

[<CTRL/C>

key

labeled
to

DECNETPC11C

continue

disabled

while

or
a

into

drive

exit...

being

copied]

<CTRL/C>
file

Copying

file

A: TNT.EXE

Copying

file

A: TTT.EXE

C:\DECNET\TTT.EXE

Copying

file

A:TFA.EXE

C:\DECNET\TFA.
EXE

Copying

file

A:FAL.EXE

C:\DECNET\FAL.
EXE

Copying

file

A:DTS.EXE

C:\DECNET\DTS.
EXE

Copying

file

A:DTR.EXE

C:\DECNET\DTR.EXE

Copying

file

A:MAIL.EXE

C:\DECNET\MAIL.EXE

Insert

diskette

Press

any

[<CTRL/C>

Copying

key

labeled
to

disabled

file

DECNETPC11D

continue
while

C:\DECNET\TNT.EXE

A:SPAWNER.EXE

or
a

Sample Installations Using DIP

file

into

drive

exit...

being

copied]

C:\DECNET\SPAWNER.
EXE

KKK

ROK

KKK

KOK OK OK

KKK

KOK

KKK

KOK

KOK OK KOK

KOK

KOK OK

KKK

You
have
selected
to copy C Programming
Library.
The
library will
be broken
out
into separate
source
files.
Enter
a destination
path
for these
source
files
if different
from the default.
You
can
interrupt
the break
up procedure
by entering
a <CTRL/C>.
You will
have
the option
to start
again
or to continue
with
the
installation
procedure.
KKRKKKKKKKKK

you

KKK

want

[Default:

KKK

copy

the

KKK

Programming

Library

(30475

Enter

? f:\decnet

path

<ENTER>
disk
space

drive

[Created
directory
F:\DECNET\]
[Executing:
BREAKSRC.EXE
A:DNETLIB.SRC

Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing

Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing

file:

file:
file:
file:
file:
file:
file:
file:
file:
file:
file:
file:
file:
file:
file:

[Y/N

KKK

Default:

? Y

<ENTER>

file:
file:
file:
file:
file:
file:
file:
file:
file:
file:
file:
file:
file:
file:
file:
file:
file:
file:
file:

additional

bytes

required).

F:\DECNET\...]

F >: (DECNET\BCMP
. C
F > \DECNET\GETSNENI.C
F >: \DECNET\BZERO.C
F > \DECNET\DNETADDR.C
E >: \DECNET\BCOPY
.C
F >: \DECNET\DNETEOF
.C
F : \DECNET\DNETHTOA.C
F > \DECNET\DNETPATH.C
F >: \DECNET\DNETNTOA.C
F >: \DECNET\PRGBND.C
F : \DECNET\GNODEADD
. C
F > \DECNET\FILEDIR.C
F > \DECNET\GETDATE
.C
F >: \DECNET\GETTIME.C
F >: \DECNET\GKNONOD
. C
F F:\DECNET\GNODENAM.C
F F:\DECNET\GNODEBAD.C
F:\DECNET\GNODEBNM.C
F F:\DECNET\HWRITE.C
F F:\DECNET\PRGCON.C
F F:\DECNET\GREMNOD.C
F F:\DECNET\HSEEK.C
F F:\DECNET\HOPEN.C
F F:\DECNET\GNODEENT
.C
F F:\DECNET\HCLOSE
.C
FE F:\DECNET\HREAD.C
F F:\DECNET\GETCNE.C
F F:\DECNET\PAUSEC.C
F F:\DECNET\PRGGPN.C
F F:\DECNET\PRGGSN.C
F F:\DECNET\PRGGSO.C
FE F:\DECNET\DNETALIA.C
F F:\DECNET\HCREATE.C
F F:\DECNET\PRGCLS.C
(continued

D-18

KKK

C:\DECNET\]

Enter
path
Insufficient

Writing

KE KK

on next page)

DECnet—DOS Installation Guide

Finished

Copy
Press

> \DECNET\PRGLSN.
>: \DECNET\PRGRCV.
> \DECNET\PRGSEL.
> \DECNET\PRGSHD.
>: \DECNET\PRGSIO.
>: \DECNET\PRGSND.
: \DECNET\PRGSOC.
: \DECNET\PRGSSO.
> \DECNET\DNET
INST .C
> \DECNET\SETDATE.C
> \DECNET\SETT
IME .C
>: \DECNET\UPPER.C
>: \DECNET\PTRCONV
.C
> \DECNET\GETCNENI
.C
> \DECNET\PRGACC
.C
>: \DECNET\PERROR
. C
>: \DECNET\DNETCONN.C
>: \DECNET\NERROR.C
: \DECNET\DSREG.
ASM
: \DECNET\MSDOS.
ASM
>: \DECNET\FBCOPY
.ASM
: \DECNET\DNETSES.ASM
>: \DECNET\DECNET
. ASM
>: \DECNET\SOCKET
.H
>: \DECNET\BEGIN.H
: \DECNET\DERRNO.H
: \(DECNET\DN.H
>: \DECNET\DNETDB.H
>: \DECNET\DNPREFIX.H
> \DECNET\ TYPES .H
> \DECNET\FINISH.H
>: (DECNET\PRGPRE
.H
>: \DECNET\ IOCB.H
> \DECNET\SCBDEF
.H
> \DECNET\SIOCTL.H
> \DECNET\SIZE.H
> \DECNET\TIME.H
: \DECNET\PROTOSW.H
>: \DECNET\ERRNO.H
> \DECNET\STRINGS.H
: \DECNET\DNMSDOS
.H

breaking

DECnet-DOS

any

key

ANDAADAADAAAINDAN

oT
TT
NNN NAN NT
TDMNANNANNNNNANNNDNNNNANNANNNN

Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing
Writing

A:DNETLIB.SRC

files

completed.

continue

Sample Installations Using DIP

exit...

DIP now automatically updates (or creates if necessary) your system start-up files:

wR OK

KR KOK

KOK OK

Startup
created
KKKK

KKK

boot

KOK

KKK

disk

KKK

ready

any

key

KKK

updated

C:\AUTOEXEC.BAT

D-20

KOK

KR OK KOK OK OK KOK OK OK OK OK

files,
CONFIG.SYS
and
if necessary)
itn root

C:\CONFIG.SYS

Press

KOK OK OK OK OK OK

KKK

drive

updated
to

AUTOEXEC.BAT,
directory
of

KKK

for

continue

KR OK OK OK OK OK OK OK OK OK

KKK

[Y/N

KKK

will
drive
KK

Default:

KKK

KOK OK OK OK OK OK OK OK OK OK OK OK

KOK OK KK

be updated
C:....

(or

KOK OK KOK

KOK

KKK

KOK

<ENTER>

DECnet-DOS...
for
or

DECnet-DOS...
<CTRL/C>

exit...

DECnet—DOS Installation Guide

Here you may save your installation configuration answers. If you need to rerun DIP,
you will be able to use these saved answers or enter new selections.

you

want

Insert

the

Press
Saving
To

any

save

installation

diskette
key

labeled

continue

installation

configuration
answers
[Y/N Default:

DECNETPC1IA
or

configuration

(1
to

any

key

continue

answers

Finished

***

Now

Sample Installations Using DIP

REBOOT

<ENTER>

tnto

drive

the

file

A:DIP.SAV

into

answer

drive

file,

A:\DIP.SAV

exit...

DECnet-—DOS
Copying
and

Your

exit...

rerun
DIP:
1.
Insert
the diskette
labeled
DECNETPCI11A
(1
2.
Set
your
current
(default)
drive
to A:
3.
Enter
the command
"DIP"
DIP will
automatically
look
for the saved

Press

System

Editing

from

Files

drive

***

D-21

Example 2 - Ethernet Configuration
This example presents the screens and menus that you will see when you use DIP to
copy the entire DECnet—DOS software kit onto an IBM PC AT personal computer, configured for Ethernet communications. Many screens are self-explanatory. Where necessary, explanatory text is inserted to help explain the process.
First, insert the diskette labeled DECNETPC1I1A into drive A, set your default drive to
A, then type:
A> DIP

DIP displays:

DECnet-DOS

Press

any

key

continue

Installation

Procedure

exit...

(DIP)

V1.1

If you have previously saved any installation configuration selections, DIP displays:

There
is
The date
Do

you

D-22

a saved
installation
configuration
answer
of the
file
is:
FRI
FEB
14 12:39:14
1986.

want

use

the

saved

answers

[Y/N

Default:

file.
Y]

N <ENTER>

DECnet—DOS Installation Guide

You may use the saved answers or enter new selections. If you choose to enter new
selections, the first series of screens provide an overview of the installation procedure:
OVERVIEW

During
the DECnet-DOS
installation,
to a set
of questions
and
prompted
a series
of menus.
You may
select

each

menu.

When
your
change,
a
You
the

On-line

HELP

Press

included

KKK

any

key

menu
by
prompt.

KKK

continue

pressing

KKK

The
For

default
example:

"Do

you

KKK

answer

want

change

KOK

item

each

menu.

KKK

<ENTER>

KKK

OK KKK

exit...

after

KOK

KOK OK OK KOK

KOK

KOK OK OK KOK OK OK KOK

KOK

KKK

(continued)
KKK

displayed
it

OVERVIEW
KKK

menu
selection
results
in an
installation
configuration
confirmation
of your
selection
is displayed.

can
back
out
of any
"Enter
selection?
"

KKKKK

you will
be asked
to
reply
to make
selections
from
any one of the
items
listed

KOK OK KOK

with

[Y/N

KOK

each

Default:

KOK

question.
Y]"

You may
exit
the
installation
procedure
at any time
by
entering
a <CTRL/C>.
Before
exiting,
you will
be given
the
chance
to permanently
save
your
answers
to the
file
DIP.SAV
located
on the
first
distribution
floppy.
Leave
the write
protect
tab off
of the
floppy.
Have
your
Installation
installation
procedure.
KRKKKKKKKKK

Press

any

KKK

key

KKK

Guide

KKK

continue

KEK

handy

KKK

during

KKK

this

KKK

exit...

KKK

(continued

Sample Installations Using DIP

KKK

on next page)

D-23

OVERVIEW
KKRKKKKK

KKK

(continued)
KERR

EKER

KERR

RRR

KKK

KOK

Release
notes
contain
information
about
DECnet-—DOS
that
may
not
have
been
tncluded
in any of the other
formal
documentation.
Such
things
as hints
on
installation,
configuration
and
troubleshooting
as well
as some
additional
information
about
software
components
and
reporting
problems
are
included
in the
release
notes.
If you
have
not
read
the
release
notes
yet,
do so at this
time.
Release
Notes
(1 of
1).
KKKRKRKKKK

Press

D-24

any

KKK

are

KKK

key

KKK

the

file

KKK

continue

RELEASE.NOT

KKK

KKK

kit

floppy

KOK

DECNETPC11A

KK OK KOK

exit...

DECnet—DOS Installation Guide

The next set of screens pertain to setting up your personal computer as a DECnet—DOS
node:
SET
KKKK

KKK

run

KKK

your

KKK

IBM

KKK

node,
you must
give
unique
node
address.
continuing
with
this

KKK

Press

KKK

any

KKK

key

KKK

LOCAL

KKK

NODE

KKK

computer

KKK

INFORMATION

KKK

KOK

continue

KOK

KKK

KK OK KK

DECnet-DOS

a node
name
and a
Obtain
this
information
installation
procedure.
KK

KKK

KOK

KOK

KOK OK OK KOK

before

KOK

KK OK OK KK

KOK OK KK

KK OK OK KK

exit...

DIP prompts you for your node name and address, then displays a summary of your
responses. Use the information you recorded in your preinstallation checklist to
answer these questions.
Node

name

(Example:

ANODE)

Node

address

(Example:

Local

node

information

Node
Node

Change

[Y/N

PCDOS

10.55)

<ENTER>

55.49

<ENTER>

PCDOS
55.49
Default:

Sample Installations Using DIP

<ENTER>

D-25

Here Dip prompts you to enter your local node user name:
SET
KREKRKKKKKK

KKK

LOCAL

KKK

NODE
KKK

KKK

USER

NAME

KKK

You must
set
up a local
node
user
name
to be used
by
DECnet-DOS
as the access
control
information
required
for
logins.
Upper
and
lower
case
characters
make
a
difference,
therefore
take
care when
entering
this
name.
(See
the Programmer's
Reference
Manual
for more
information.)
KKK

KKK

Press

any

Enter

KR KKK

key

user

KOK

KKK

name

Local
name

node
user
name
is:
"adams"

D-26

? adams

name

[Y/N

KK OK KOK OK KOK OK KKK

continue

User

Change

KKK

from

OK KOK

<ENTER>

KKK

KOK

KKK

KOK

proxy

KK OK OK K

exit...

alphanumeric

characters.

<ENTER>

Default:

DECnet—DOS Installation Guide

You can communicate with other DECnet nodes by physically connecting your node
directly to the baseband Ethernet or to an adjacent routing node. DIP prompts you to
enter your communications type.
SET
KKRKKKKK

KKK

KEK

UP
KKK

COMMUNICATIONS

KKK

ROK

You may
run DECnet-DOS
using
Ethernet
communications.
The
following menus
the appropriate
communication
type.
KR

Press

KKK

any

KKK

key

ROKK

KKK

continue

KOK

ROK

KOK

TYPE
ROK OK OR RK OK OK RK

or Asynchronous
DDCMP
allow you
to select

KK OK KOK

KK OK OK KOK

exit...

COMMUNICATIONS

Select

Fnter

selection?

KOK OR KOR OR OK OK OK OK OK OK OK

from

Help
Ethernet
Asynchronous

the

KR KOK OK OK KOK OK OK KOK OK KOK

KOK

TYPE

following:

DDCMP

<ENTER>

Sample Installations Using DIP

D-27

To connect your DECnet node to an Ethernet network you must have already installed
the appropriate hardware interface. DIP prompts you to enter the hardware you have
installed:
ETHERNET
Select

selection?

of your communications

SUMMARY
Communications
Type:
Communications
Controller:

D-28

[Y/N

following:

<ENTER>

DIP displays a summary
making further changes.

Change

the

Help
3Com Controller
Micom Controller

WNhNrFe

Enter

from

CONTROLLER

Default:

COMMUNICATIONS

Ethernet
3Com Ethernet
Y]

type and offers you the option of

PARAMETERS

Interface

Board

<ENTER>

DECnet-DOS Installation Guide

SUMMARY
Boot

drive

DECnet-DOS
DECnet-DOS

DECnet-DOS

Change

kit
kit

(location

files
files

default
[Y/N

will
will

database

Default:

Sample Installations Using DIP

OF
of

be
be

PATH

CONFIG.SYS

copied
copied

files
?

SPECIFICATIONS
and

AUTOEXEC.BAT).

FROM drive A:
TO C:\DECNET\

will

located

C:\DECNET\

<ENTER>

D-29

The next series of menus provide a means of choosing your own device and path specifications. You may use the default values or choose your own. After you make your
selections, DIP displays asummary of your choices and offers the option of making further changes.
SET
KKEKKKK

KKK

correctly

KKK

configure

KKK

PATH

KKK

and

run

INFORMATION
KKK

KKK

KOK OK OK KOK OK K

DECnet-DOS

some
information
is required
to be contained
in the system
boot
(or startup)
files ~ CONFIG.SYS
and AUTOEXEC.BAT.
This
installation
procedure
will
automatically
create
or modify
these
files
for you.

Enter
the
the drive

drive
on which
from which
you

KKKK

KKK

[Default:
Enter

KKKK

KKK

The
kit
Enter
a
KKK

K KKK

D-30

KKK

reside.
started

This
is
your
IBM

KOK

KR KKK

KKK

OK KOK OK KOK OK KOK

path

KOK

KKK

<ENTER>

KKK

KOK

files will
be copied
from the disk
in drive C.
destination
path
into which
these
files will
be
KKK

AT.

C: ]|

drive

[Default:

Enter

KKK

these
files
"booted"
or

KKK

KR KK

KKK

KOK

KOK OK KK

KK OK OK KKK

KOK

copied.
KOK

KOK

C:\DECNET\]

? —&:\DECNET\

<ENTER>

DECnet-DOS Installation Guide

KKRKKKKKKK

KKK

KEKE

KKK

DECnet-DOS
requires
several
DECNODE .DAT or DECPARM.DAT.
the database
files will
be
KKKKKKK

KKK

[Default:
Enter

path

KKK

KEKE

KKK

EKER

KKK

database
files
such
as
Enter
the path
into which
stored.

KKK

KK OK OK

KOK

KKK

all

OK OK KK

KOK

C:\DECNET\ |
?

E:\DECNET\

<ENTER>

DIP displays a summary of your choices for device and path specifications.
SUMMARY
Boot drive
DECnet-DOS
DECnet-DOS
DECnet-DOS

Change

PATH

SPECIFICATIONS

is E: (location of CONFIG.SYS and AUTOEXEC.BAT).
kit files wil!
be copied FROM drive A:
kit files will
be copied TO E:\DECNET\

default
[Y/N

database

Default:

Sample Installations Using DIP

files

will

located

E:\DECNET\

N <ENTER>

D-31

AUTOMATIC
OR OK OR Oe OK OOK oO OK OB

You

can

INSTALLATION

OK OK OK OK OK OK OK OK OK OK OK OK OK OK OK OK

verify

the

KOK OK OK KOK

DECnet-DOS

KK OK OR

VERIFICATION
KOK

KOK OK OK OK OK OK OK OK OK

KOK OK OK OK KK OK KOK OK OK OK KOK

installation

by
running
tests
using
the Network
Test
Utility
(NTU).
You may
choose
to have
these
tests
run automatically
Or you may
run tests manually.
If you
choose
to
run
the tests manually,
please
refer
to the chapter
on NTU
in the User's
Guide.
KKK

KKK

Automatic

verification

Change

[Y/N

KEK

KKK

installation

Default:

KOK

currently

OK OK

KOK OK

set

KOK

OK OK OK OK

KOK

OFF

<ENTER>

If you choose to have the verification test run automatically,
define one or more nodes to be used for testing.

DIP prompts

KKKKKKKK

KOK

KOK OK OK KOK

KOK

KKK

KOK

KKK

KOK

KOK OK KOK OK KK

you to

You must
define
at
least
one
remote
node
for use by
the
installation
verification
test(s).
You
should
define
only
"reachable"
remote
nodes
to be used
for
the testing.
Press
<ENTER>
entering
node
KRKKKKK

Press

D-32

KKK

any

in response
information.

KKK

key

KKK

continue

the

KKK

prompt

KKK

stop

KKK

KOK

KK OK KK OK OK

exit...

KOK

KOK OK OK

DECnet—DOS Installation Guide

Here DIP prompts you to enter the name and address for each remote node and displays a summary of the information that you enter. Press
to proceed with the
installation when you have finished adding nodes.

Press

Node
Node

<ENTER>

name

when

(Example:

finished

ANODE)

address

(Example:

node

information

Node
Node

ORION
4.30

Change

Remote

[Y/N

4.30

verification

Change

[Y/N

Default:

Sample Installations Using DIP

nodes...

<ENTER>

finished
entering
ANODE)
? <ENTER>

Automatic
it

10.55)

Default:

Press
<ENTER> when
Node
name
(Example:

entering

? ORION

nodes...

installation
Y]

currently

set

<ENTER>

D-33

SET
KKK

KKKK

Setting
startup
KKK

KKK

REBOOT

KKK

"Reboot
Line State"
to
of DECnet-DOS
upon
IBM

ON
PC

enables
the automatic
AT system
reboot.

KKK

Reboot

lIine

Change

KKK

state
[Y/N

KKK

KEK

KKK

currently
Default:

KKK

KEKE

KOK

set

OFF

<ENTER>

SELECTING
KKKK

LINE

SOFTWARE

KKK

ERK

KEK

Use
the
following menus
to copy
any or
DECnet-DOS
kit
components
(files).
You
of a menu
by pressing
<ENTER>.
KKRKK

Press

D-34

KKK

any

key

KKK

continue

KERR

KKK

STATE
KKK

KOK

KKK

KOK

KKK

KOK

COMPONENTS
KKK

KKK

all
may

KKK

KOK

KKK

KOK

of the
back
out

KKK

KEK

exit...

KKK

DECnet-DOS Installation Guide

You may choose to copy the entire DECnet—DOS software kit or select individual components. A minimum configuration is necessary to run DECnet—DOS on your system.
The files and utilities that make up this minimum configuration will always be copied.
Before you copy files however, you can review your current software and hardware
configuration with the “‘Summaries’’ menu selection. The following series of screens
illustrate how to use the summary menus.

COPY

BWD

Select

Enter

selection?

from

KIT
the

FILES
following:

Help
Summaries
Copy
Entire
Kit
Select
Individual

Components

<ENTER>

SUMMARIES

OmHhWNHYHe

Select

Enter

selection?

from

the

following:

Help
Begin
Copying
Kit
Files
General
Information
Summary
Node
Information
Summary
Communications
Information
Summary
Software
Summary

<ENTER>

Sample Installations Using DIP

D-35

The following screen displays 4 summary of your software and hardware configuration
and the choices you made for copy path, database path, reboot line state, and automatic installation verification.

SUMMARY
Personal

GENERAL

INFORMATION

Computer
Type:
PC-DOS Version:
Boot
drive:
Kit
File(s)
to be Copied
to:
DECnet
Database
Path:
Reboot
Line State:
Installation
Verification:

IBM PC AT
3.10
E:
E:\DECNET\
E:\DECNET\
OFF
ON

Minimum
DECnet
Memory
Usage:
Available
Bytes
of Memory:
Available
Bytes
of Memory:

171536
(estimated)
245296
(before
installing
DECnet)
73760
(after
installing
DECnet)

Available
Available
Press

D-36

any

DECnet
Bytes
Bytes
key

Disk
Usage
on Drive C
on Drive C
continue

267144
8445952
8178808
<CTRL/C>

(before
copying
files)
(after
copying
files)
exit...

DECnet-—DOS Installation Guide

SUMMARIES

OonRWNH

Select

Enter

selection?

from

the

following:

Help
Begin
Copying
Kit
Files
General
Information
Summary
Node
Information
Summary
Communications
Information
Summary
Software
Summary

<ENTER>

The following screen displays the names and addresses you entered for each node during the installation procedure. It also displays the local node user name.
SUMMARY
PCDOS
ORION
Press

any

55.49
4.30
key

— Local Node (User
—~ Remote Node
to

continue

Sample Installations Using DIP

DEFINED
Name:
to

NODE (S)

adams)

exit...

D-37

SUMMARIES

OmBWNYF

Select

Enter

selection?

The following
Ethernet).

screen

D-38

key

following:

<ENTER>

summarizes

Communications
Type:
Communications
Controller:
any

the

Help
Begin
Copying
Kit
Files
General
Information
Summary
Node
Information
Summary
Communications
Information
Summary
Software
Summary

SUMMARY

Press

from

continue

your

communications

COMMUNICATIONS

Ethernet
3Com Ethernet
or

Interface

type

(asynchronous

PARAMETERS
Board

exit...

DECnet—DOS Installation Guide

SUMMARIES

Ooh

WwNFe

Select

Enter

selection?

from

the

following:

Help
Begin
Copying
Kit
Files
General
Information
Summary
Node
Information
Summary
Communications
Information
Summary
Software
Summary

<ENTER>

The following screen summarizes the individual DECnet—DOS files and utilities to be
copied based upon your current configuration. The information displayed here
includes the file name, on which diskette it is located, and disk and memory requirements for each component.
If you have not yet selected any DECnet—DOS components, the files which make up the
minimum configuration will be displayed at this time and subsequently copied.
SUMMARY
File

Name

Press

any

key

SELECTED

SOFTWARE

COMPONENTS

Found
on
Labeled

Disk
Usage

Memory
Usage

DECNETPC11B
DECNETPC11B
DECNETPC11A
DECNETPC11A
DECNETPC11A
DECNETPC11A
DECNETPC11A

83200
6272
92416
15872
3712
9728
50944

89288

Kit

NTU.EXE
NTUHELP.BIN
NCP .EXE
NCPHELP.BiN
SCH. EXE
DLL3COM. EXE
DNPETHPC. EXE

continue

Sample Installations Using DIP

98258

O
3126
8704
61448

[memory
[memory
[memory

resident |
resident |
resident]

exit...

D-39

After displaying a summary, DIP returns you to the SUMMARIES menu. You can back
out of this menu by pressing
in response to the “Enter Selection?’’ prompt.

SUMMARIES

OmBWNE

Select

Enter

selection?

from

the

following:

Help
Begin
Copying
Kit
Files
General
Information
Summary
Node
Information
Summary
Communications
Information: Summary
Software
Summary

<ENTER>

You may proceed with the installation procedure when you are satisfied with your
configuration selections.
COPY

HhWNMeH

Select

Enter

D-40

selection?

from

KIT
the

Help
Summaries
Copy
Entire
Kit
Select
Individual

FILES
following:

Components

<ENTER>

DECnet-—DOS Installation Guide

When you choose to copy the entire kit, DIP checks to see if your PC AT has sufficient
memory. Here DIP has determined that your system does not and gives you the opportunity to return to the software components menu.

COPYING
***

WARNING! !

MAY

NOT

ENOUGH

Minimum
DECnet
Memory
Usage:
Available
Bytes
of Memory:
Additional
Bytes
Required:
Review

software

components

BWNF

Select

selection?

MEMORY

287219
245296
41923
[Y/N

COPY

Enter

DECNET

KIT
from

FILES
INSTALL

AND

(estimated)
(before
installing
Default:

RUN

DECNET

***

DECnet)

<ENTER>

FILES
the

Help
Summaries
Copy
Entire
Kit
Select
Individual

following:

Components

<ENTER>

Sample Installations Using DIP

D-41

Here DIP allows you to select utilities from the kit on a file-by-file basis. Only the files
you select will be copied.
Select
Select
Select
Select
Select
Select
Select
Select
Select
Select
Select
Select
Select
Select

D-42

Transparent
Task-to-Task
(TTT)
[Y/N Default:Y]
? N <ENTER>
Transparent
File Access
(TFA)
[Y/N Default:Y]
? Y <ENTER>
SETHOST
[Y/N Default:Y]
? Y <ENTER>
.
Local
Area Transport
(LAT)
[Y/N Default:Y]
? Y <ENTER>
Network
File Transfer
(NFT)
[Y/N Default:Y]
? Y <ENTER>
File Access
Listener
(FAL)
[Y/N Default:Y]
? N <ENTER>
Network
Test
Utility
(NTU)
[Y/N Default:Y]
? N <ENTER>
Data Test
Sender
(DTS)
[Y/N Default:Y]
? N <ENTER>
Data Test
Receiver
(DIR)
[Y/N Default:Y]
? N <ENTER>
Network
Virtual
Disk
(NVD)
[Y/N Default:Y]
? N <ENTER>
Network
Virtual
Printer
(NVP)
[Y/N Default:Y]
? N <ENTER>
C Programming
Library
[Y/N Default:Y]
? N <ENTER>
Mail
Sender
[Y/N Default:Y]
? Y <ENTER>
Job Spawner
[Y/N Default:Y]
? N <ENTER>

DECnet-DOS Installation Guide

If you have an earlier version of DECnet—DOS installed on your system, DIP automatically deletes the old DECnet directory and creates a new one.

Insert
Press

diskette
any

[Deleted
[Created

key

labeled
to

DECNETPC1I1A

continue

into

drive

exit...

old E:\DECNET\DECPARM.
DAT ]
directory
E:\DECNET
]

[<CTRL/C>
disabled
while
a file
is being
copied]
Copying
file A:NCP.EXE
to E:\DECNET\NCP.
EXE

Copying

file

A:NCPHELP.BIN

Copying

file

A:SCHPC.EXE

Copying

file

A:DLL3COM.EXE

E:\DECNET\DLL.EXE

Copying

file

A:DNPETHPC.EXE

E:\DECNET\DNP.
EXE

Insert

diskette

Press

any

key

labeled
to

E:\DECNET\NCPHELP.BIN

E:\DECNET\SCH.EXE

DECNETPC11B

continue

[<CTRL/C>
disabled
while
a
Copying
file A:SETHOST.EXE

into

drive

exit...

file
is being
copied]
to E:\DECNET\SETHOST
.EXE

Copying

file

A:LAT.EXE

E:\DECNET\LAT.EXE

Copying

file

A:NFT.EXE

E:\DECNET\NFT
.EXE

Sample Installations Using DIP

D-43

Insert

diskette

Press

any

key

labeled
to

DECNETPC11C

continue

into

drive

exit...

[<CTRL/C>
disabled
while
a file
is being
copied]
Copying
file A: TNT.EXE
to E:\DECNET\TNT.EXE

Copying

file

A: TFA.EXE

E:\DECNET\TFA.EXE

Copying

file

A:MAIL.EXE

E:\DECNET\MAIL.EXE

Copy

DECnet-DOS

Press

D-44

any

key

files
continue

completed.
or

exit...

DECnet-DOS Installation Guide

DIP now automatically updates (or creates if necessary) your system start-up files:

KREK

KKK

Startup
created
KKKKKK

boot

KKK

files,
CONFIG.SYS
if necessary)
in
KKK

KKK

disk

KKK

ready

C:\CONFIG.SYS

any

key

KKK

updated

C:\AUTOEXEC.BAT
Press

KOK

and
root
KKK

drive

for

KOK

KKK

OK KK

KOK

AUTOEXEC.BAT,
directory
of

KKK

updated
to

KOK

KKK

[Y/N

KEK

KOK OK KOK

will
drive

be
C:

KEK

KKK

Default:

KOK OK OK KOK

updated

KKK

KOK OK OK OK OK OK

(or

KOK

KOK OK KOK

<ENTER>

DECnet-DOS...
for

continue

Sample Installations Using DIP

DECnet-DOS...
<CTRL/C>

exit...

D-45

Here you may save your installation configuration answers. If you need to rerun DIP,
you will be able to use these saved answers or enter new selections.

you

Insert
Press
Saving
To

want

the
any

save

diskette
key

installation

labeled

continue

installation

configuration

DECNETPC11A
or

configuration

(1
to

answers
[Y/N Default:

any

key

continue

Finished

*«**

D-46

Now

REBOOT

answers

DECnet-DOS

into

drive

file

A:DIP.SAV...

<ENTER>

exit...
to

the

rerun
DIP:
1.
Insert
the diskette
labeled
DECNETPC11A
(1
2.
Set
your
current
(default)
drive
to A:
3.
Enter
the command
"DIP"
DIP will
automatically
look
for the saved

Press

answer

tnto
file,

drive

A:\DIP.SAV

exit...

Copying

and

Editing

your

System

from

Files

drive

* OK OK

DECnet—DOS Installation Guide

Installation Checklist

This appendix provides a checklist to record your preinstallation and network configuration requirements. This checklist is reproduced here for easy removal. Refer to Chapter 3 in this manual for instructions in using this checklist.

Preinstallation Check
Hardware
L]
—¢

Personal Computer
IBM PC

e¢

IBM PC/XT

IBM

Software
[|

Operating System — PC—DOS Version 2.10 or Version 3.10

DECnet—DOS Software Kit — four RX31 diskettes labeled:
DECNETPCII1A
DECNETPC11B
DECNETPC11C
DECNETPC11D

Configure Network Parameters
Node Parameters
L]

Local Node
Node Name
Node Address
Local Node
User Name

Remote Node(s)
Node Name
Node Address
Node Name
Node Address
Node Name
Node Address

E-2

DECnet-DOS

Installation Guide

Communications Type
Choose one of the following communication schemes:
[J]

Asynchronous DDCMP - (line speed)

[]

Ethernet — (interface installed)

Device and Path Specifications
[|

Boot Drive (system startup files)

Destination Path (kit files)

Destination Path (DECnet database files)

Destination Path (programming library sources)

Reboot Line State
[|

OFF

TFA — Transparent File Access

oOo oo
oUoO
UO
MOU

TTT — Transparent Task-to-Task

Select DECnet-DOS Utilities

SETHOST
LAT — Local Area Transport
NFT - Network File Transfer
FAL — File Access Listener
NTU — Network Test Tool
DTS — Data Test Sender
DTR — Data Test Receiver
NVD — Network Virtual Disk
NVP — Network Virtual Printer
C Programming Library (Programming Interface)
MAIL — Mail Sender Utility
Job Spawner Utility

Installation Checklist

E-3

Index

A
Asynchronous DDCMP
configuring adjacent node, 3-3
connecting to adjacent node, 3-3
required hardware, 2-2
selecting line speed, 3-3
Asynchronous DDCMP configuration
example installation, D-1
AUTOEXEC.BAT file
specifying DECnet database
path, C-1

C
Communications type
asynchronous DDCMP,
Ethernet, 3—4
CONFIG.SYS file

3-3

updating, 4-2

Copying files
from distribution diskette, B-1

D
Data Link Layer, B—3
DECnet database files
DECALIAS.DAT, B-4
DECNODE.DAT, B-4
DECPARM.DAT, B-4
specifying DECnet database
path, C-1

DECnet database path, C-1
and system startup files, C-1
asynchronous communications, C—2
Ethernet communications,

C-1

DECnet network
connecting your IBM pc, 3-1
connecting your IBM personal
computer, 3-3
DECnet Test Receive Utility, B—10
DECnet Test Send Utility, B—10
DECnet—DOS
* DAT and *.BIN files, B—5
DECnet—DOS components
Data Link Layer, B-3
DECnet database files, B—4
DECnet Test Receive Utility, B—10
DECnet Test Send Utility, B—10
DECnet-—DOS Mail utility, B—10
DECnet—DOS Network Process, B-—4
File Access Listener, B—10
installation tools, B-2
Local Area Transport, B-5
locating distribution files, 3-2

Network Control Program, B-6

Network
Network
Network
Network

Device Utility, B-8
File Transfer, B-5
Test Utility, B—7
Virtual Disk Driver, B—9

Network Virtual Printer Driver, B—9

Programming Interface Library, B-11
Real-Time

Scheduler, B—3

Index—1

DECnet—DOS components (Cont.)
Set Host utility, B-5
software requirements for, 3-2
Transparent Error Log, B-8
Transparent File Access, B—7
“Transparent Task-to-Task, B—7

IBM personal computer (Cont.)
selecting modems or cables, 3-3
system start-up files, 3-5
IBM system
selecting baud rate, 3-3
Identifying your node

DECnet-DOS files

node address

contents of distribution
diskettes, A-1
memory requirements, A-1
required disk space, A-1
DECnet—DOS Installation Procedure
sample installations, D-1
DECnet—DOS Mail utility, B—10
DECnet—DOS Network Process,

format of, 3-2
node name
format of, 3-2
Installation tools, B—2
Installing DECnet—DOS software, 4-1
individual files, B—1
preinstallation checklist, 3-8, E-1 |
using DIP, 4-1

B-4

verifying installation, 5-1

DECnet—DOS nodes
connecting to the DECnet

network, 3-1

Local Area Transport, B-5

hardware requirements, 2-1
DECnet—DOS software
and reboot line state, 3-6

Loopback connector
loopback tests, 2-2, 2-4

introduction to, 1-1

network concepts, 1-2
network functions, 1-1

Memory requirements, A-1

preinstallation requirements
for, 3-1

verifying installation of, 3-6

Network concepts, 1-2
adjacent node, 1—2

DECnet—DOS

File Access Listener, B—10

end node, 1-2

local node, 1-2
logical links, 1-2

executor node,

Hardware

requirements

remote node,

asynchronous communications

1-2

Network Control Program, B-6

adapter, 2-2

Network Device Utility, B-8

IBM PC AT personal computer,

Network

2-1
IBM PC personal computer, 2-1
IBM PC/XT personal computer,

File Transfer, B—5

Network functions, 1-1
network management, 1-1
remote file access, 1-1

2-1]
IBM personal computer, 2—2

resource sharing, 1-2
task-to-task communications,

loopback connector, 2-2, 2-4
modem,

environment,

Network Test Utility, B-7

2-2

1-1

see NTU

Network Virtual Disk Driver, B—9
Network Virtual Printer Driver, B—9

IBM personal computer
connecting to the DECnet network,

Index-2

Node
2-1

end node,

3-3

NTU
commands, 5-1
LOOP NODE, 5-2
diagnosing problems, 5-3
verifying DECnet—DOS installation,
5-1

p
Preinstallation requirements, 3-1
checklist, E-1
communications type, 3-3
Operating system, 3-1
setting up local node, 3-2
software components, 3-2
Programming Interface Library,
B-11

R
Real-Time Scheduler, B-3

S
Sample installations, D-1
Set Host Utility, B—5
System start-up files
AUTOEXEC.BAT, 3-5
CONFIG.SYS, 3-5
specifying device and path names,
3-5, C-1

Transparent File Access, B—7
Transparent Network Task Control,
B-8
Transparent Task-to-Task, B—7

Index-3

DECnet-DOS
Installation Guide
AA-EF20B-TV
READER’S

COMMENTS

What do you think of this manual? Your comments
the quality and usefulness of our publications.
Please

rate this

manual:

Poor
1
1
1
|
|

Accuracy
Readability
Examples
Organization
Completeness
Did you find errors in this manual?

General

and suggestions will help us to improve

If so, please specify the error(s) and

4
4
4
4
4
page

for improvement:

Name

Date
Department

Company
City

3
3
3
3
3

comments:

Suggestions

Title

2
2
2
2
2

Street
State/Country

Zip Code

Excellent
5
5
5
5
5
number(s).

NOT

CUT

FOLD

HERE

AND

TAPE

FIRST

POSTAGE

CLASS
WILL

PERMIT

PAID

REPLY LABEL

NO.

33 MAYNARD

MASS.

BY ADDRESSEE

SOEHGE0

HERE

ino

FOLD

SNOW

CUT

dailod

NOT

ANIn

eeee

SOFTWARE DOCUMENTATION
950 KING STREET
LITTLETON, MA 01460-1289

eee

BUSINESS

@eeceoee

NO POSTAGE
NECESSARY
IF MAILED
IN THE
UNITED STATES

Seeoeoeeeeoeoeeseeceeeeoeeoeeeeeeonvneeseoseeene45ge

@eeee0e