Trailing-Edge
-
PDP-10 Archives
-
BB-J696A-BM_1980
-
decnet/decnet.doc
There are 7 other files named decnet.doc in the archive. Click here to see a list.
DECNET.DOC -- Changes from DECnet-20 V1 to DECnet-20 V2
February 1980
COPYRIGHT (C) 1979,1980 BY
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS.
THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND
COPIED ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND
WITH THE INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS
SOFTWARE OR ANY OTHER COPIES THEREOF MAY NOT BE PROVIDED OR
OTHERWISE MADE AVAILABLE TO ANY OTHER PERSON. NO TITLE TO AND
OWNERSHIP OF THE SOFTWARE IS HEREBY TRANSFERRED.
THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL
EQUIPMENT CORPORATION.
DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF
ITS SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL.
DECNET.DOC -- DOC file for DECnet-20 V2 Page 2
DECNET.DOC -- Changes from DECnet-20 V1 to DECnet-20 V2
February 1980
1.0 SUMMARY
DECnet-20 Version 2 is a major functional release. It
provides significant functional improvement to the DECsystem-20
implementation of the corporate Digital Network Architecture
Phase II DECnet family. DECnet-20 consists of three separate
products, shipped on three distribution tapes: DECnet-20 V2,
DECnet-20 V2 for 2020, and RJE-20 V1. This version of the
DECnet-20 product set provides the following new features:
o Support for up to 8 synchronous lines on the DN20
front end.
o DECnet error logging for various line and hardware
errors detected by the DN20 front end.
o A DECnet compatible Remote Job Entry station for use
with DECsystem-20.
o Installation specific network configuration using the
tools provided with this release.
o A DECnet Network File Transfer capability.
o Additional NCP (Network Control Program) commands
implemented as part of the TOPS-20 standard operator
command interface.
o Network topology information available through a
TOPS-20 EXEC command.
o Compatibility with DECnet Phase II and III.
This version supersedes DECnet-20 Version 1. Many new
features of this release require a DN20 with 128K of MOS memory
and do not apply to the DECsystem-2020. A 32K DN20 will be
supported with only a single synchronous line, but most of the
new maintainability features will not be available.
DECnet-20 Version 2 is documented fully in the TOPS-20
DECnet-20 Programmer's Guide and Operations Manual, Order
Number AA-5091B-TM. RJE-20 is documented in the TOPS-20 DN200
Remote Station Guide, Order Number AA-H786A-TM. In addition,
the following manuals provide generic DECnet information that
may be useful:
o DIGITAL NETWORK ARCHITECTURE, General Description,
Order Number AA-H202A-TK. Provides a general overview
of DNA.
DECNET.DOC -- DOC file for DECnet-20 V2 Page 3
o DDCMP, Order Number AA-D599A-TC. Provides a complete
specification of the data link level protocol used in
DNA.
o NSP, Order Number AA-D600A-TC. Provides a complete
specification of the Network Services Protocol.
o DAP, Order Number AA-D601B-TC. Provides a complete
specification of the Data Access Protocol. This
revision of the specification is not available as of
this writing.
DECNET.DOC -- DOC file for DECnet-20 V2 Page 4
February 1980
2.0 EXTERNAL CHANGES
2.1 Support for up to 8 Synchronous Lines
DECnet-20 Version 2 supports up to 8 synchronous lines on
a DN20 front end attached to a DECsystem-2040/50/60.
Communication devices supported on the DN20 are DMC11 and
KMC11/DUP11 (KDP). Only a single DMC11 or DUP11 (not KDP) is
supported on a 32K DN20. The DECsystem-2020 supports 2
synchronous lines using KMC11/DUP11 devices. Remote Job Entry
(DN200) stations are configured with DMC11 communication
devices.
2.2 DECnet Error Logging
This version logs network related line errors detected by
the DN20, front end reloads, and network topology changes in
ERROR.SYS, the TOPS-20 system error file. Control over error
event logging functions is provided by a set of NCP commands.
SYSERR allows the network manager to selectively display the
contents of the network error entries, in order to maintain his
network and track its behavior.
2.3 DN200 Remote Job Entry Station
The DN200 Remote Job Entry Station provides remote line
printer, card reader, and operator command terminal capability
for the DECsystem-20. TOPS-20 batch jobs prepared on punched
cards can be submitted to a host TOPS-20 system for execution.
Spooled output from a host TOPS-20 system can be routed to the
remote line printer for printing. The operator at the remote
station has control over the remote devices. Downline loading
of the DN200 system image is accomplished over the physical
communications line to the host.
2.4 Installation-Tailored DN20 Network Software Generation
Building of the system image, which is loaded into the
DN20 front end, is performed onsite for Version 2. Using tools
provided with this release, the customer or Digital support
personnel can describe specific parameters and hardware
configuration using a network system generation program,
NETGEN, which creates a tailored set of assembler source files.
These source files are then assembled, on the TOPS-20 system,
using the assembler, DNMAC, to produce installation specific
object files. These object files and the distributed object
files are linked using a task builder, TKB20, to produce a set
of symbol files, map files, and task image files. VNP20 merges
DECNET.DOC -- DOC file for DECnet-20 V2 Page 5
February 1980
the resultant task image files to produce a final system image
file to be loaded into the DN20. Configurable items that can
be specified during the generation procedure includes: the
line device types to be used, the node name, the maximum number
of logical links, maximum buffer quotas, etc.
2.5 DECnet File Transfer Utilities
Two programs, NFT and FAL, provide the DECnet file
transfer capability for DECsystem-20. Access to files on
remote systems from the local TOPS-20 system is provided by NFT
(Network File Transfer). Commands provided are COPY, SET
DEFAULT, INFORMATION, SUBMIT, DIRECTORY, and DELETE. FAL (File
Access Listener) acts as the DECnet server process which
provides access to the local hosts TOPS-20 file system for
remote network nodes.
2.6 NCP Operator Commands
Three commands have been added to the NCP command set and
two options have been added to the SHOW command. The ENABLE
EVENT-LOGGING and DISABLE EVENT-LOGGING commands have been
added to allow control of the logging of error event
information on a device basis. The SHOW STATUS LOCAL command
provides parameter information pertaining to the node that
executes the command. The SHOW STATUS LINE or SHOW STATUS
KNOWN LINES command provides status information for a
particular line or lines.
2.7 EXEC Command Support for DECnet Topology Information
An INFORMATION (ABOUT) DECNET command has been added to
the TOPS-20 EXEC to provide the DECnet user with the list of
nodes that are currently accessible to his TOPS-20 system. The
information for this command is maintained by the TOPS-20
Monitor and updated by NETCON, the program that implements
NCP/NCU for DECsystem-20. A task that runs on the DN20
provides the information to NETCON.
2.8 Compatibility with DECnet Phase III
This version of DECnet-20 is compatible with DECnet Phase
III. Compatibility with DECnet-20 Version 1 has been
maintained, however, the internal implementation has been
changed considerably.
DECNET.DOC -- DOC file for DECnet-20 V2 Page 6
February 1980
3.0 KNOWN BUGS AND DEFICIENCIES
Major problems with DECnet-20 Version 2, that might
prevent successful installation or operation, are documented in
the DECnet-20 Beware File. This file, DECNET.BWR, is in the
documentation save set on the distribution tape. The Beware
File is mandatory reading prior to installing this product.
Minor problems with this version that should not interfere
with normal operation of this product are documented here.
3.1 DN20 Bugs and Deficiencies
3.1.1 DN20 Crashes on NSP Message with Null Node Name
An NSP message received by the DN20 with a null node name
causes NSP to overwrite storage and the DN20 will ultimately
crash. Under normal circumstances this situation is not likely
to occur and therefore should not present a problem.
3.1.2 No Link Abort when TOPS-20 Host Crashes
No timeouts are done for transmits across the DTE20
interface between the DN20 and the host TOPS-20 system. If the
host TOPS-20 system crashes, any existing links through the
DN20 will just 'hang' and never be aborted by the DN20. Any
connections for the host TOPS-20 node will be trapped by the
DN20 with no connect confirm returned. The connections will
remain hung until the remote user aborts them or the TOPS-20
host reloads the DN20.
3.2 NFT/FAL Bugs and Deficiencies
3.2.1 Truncation of Byte Count in DIRECTORY Output
A DIRECTORY command truncates the byte count and byte size
field to 10 characters. Thus, if the byte count requires more
than 10 character positions, some digits may not be displayed.
3.2.2 No Facility to Expunge a Remote Directory
The DELETE command does NOT do an expunge after deletion.
If you get an over quota type error from NFT when transferring
files to a remote node, you cannot get under quota by using NFT
to delete files from the remote node, because the disk space
will still be in use. To get around this problem, delete some
DECNET.DOC -- DOC file for DECnet-20 V2 Page 7
February 1980
files, and then submit a 'null' batch job on the remote node.
The files will be expunged when the batch job logs out.
3.2.3 No Facility to Set Default SUBMIT Switches
The NFT SUBMIT command has no switches, and there is no
way to override any default switches on the remote node. The
standard defaults for the SUBMIT command, provided by the
remote system, will be obtained.
3.2.4 Incorrect Wildcard Handling in COPY Command
Under certain conditions NFT copies to a directory other
than the one intended in the command. The following conditions
cause the file to be copied to the connected directory, not the
directory specified in the command:
o The direction of the copy is from remote node to local
node.
o The source file specification contains a wildcard.
o The target file specification's structure and
directory are different from the user's connected
directory.
For user <MIERSWA>, connected to NET:<MIERSWA.MEM>, the
following can happen:
NFT>COPY 4097::LOGIN.* PS:<OPERATOR>LOGIN.*.-1
4097::PS:<MIERSWA>LOGIN.CMD.1 => NET:<MIERSWA.MEM>LOGIN.CMD.1 [OK]
3.3 NCP/NCU (NETCON) Bugs and Deficiencies
3.3.1 Server Links Required by NETCON
A minimum of five server logical links are required by
NETCON to function properly: four NCU servers and one server
link for topology notification. NETCON issues an error message
when it is unable to establish the topology server, however, no
error message is issued when it fails to establish the NCU
server links. NETCON may be unable to open enough servers as a
result of a shortage of system resources and may appear to be
operating correctly when in fact it is not. A possible cause
for the depletion of the system resource pool may be that
establishment of the maximum number of server links had been
DECNET.DOC -- DOC file for DECnet-20 V2 Page 8
February 1980
reached. The solution, in this case, is to close some server
links and restart NETCON.
3.3.2 CHK11 Entries Truncated in SYSERR File
Some of the text output produced by the CHK11 bootstrap
program during load of the DN20 is truncated when written, by
NETCON, into the ERROR.SYS file on the TOPS-20 host. The
amount lost is variable but is always truncated from the end of
the text.
3.3.3 Incorrect Line Counter Output
The line counter display provided by NETCON incorrectly
shows counter values over 127 as a number in the range 65000 to
65535. To reduce the probability of this problem occuring set
the logging interval to a value that will ensure the line
counters are read and zeroed before they reach 128.
3.3.4 Restriction of SHOW STATE LOCAL Command
A SHOW STATE LOCAL command to a DN20 node always shows the
node number as zero even when the node number is generated as
nonzero. If the DN20 configuration image was saved at the time
the DN20 was generated, then the node number may be obtained by
running NETGEN, using the RESTORE command to read in the saved
configuration, and using the INFORMATION command to display the
node information.
3.4 TOPS-20 NSP Bugs and Deficiencies
3.4.1 MTOPR Disconnect Function always Aborts
The MTOPR .MOCLZ function with a zero disconnect reason
code does not do a synchronous disconnect when used after
sending data in stream mode. Any data which has not yet been
transmitted by NSP at the time the MTOPR is issued will be
lost. The CLOSF JSYS will work properly under these
circumstances.
DECNET.DOC -- DOC file for DECnet-20 V2 Page 9
February 1980
3.5 RJE-20 Bugs and Deficiencies
3.5.1 Reversion of DN200 RJE Operator Service to Host
If the operator services logical link from the host to the
DN200 RJE station is aborted for any reason, all operator
service messages destined for the DN200 are rerouted to the
host TOPS-20 operator service program OPR. If a message
requiring a response is rerouted to the host, then it must be
answered by the host system operator. The DN200 RJE operator
will not be able to respond to it.
In addition, the logical link for DN200 operator services
may not be automatically reestablished. To restore operator
services at the DN200 RJE station the remote station operator
should periodically attempt to issue a command at the LA36 to
force the reconnection.
DECNET.DOC -- DOC file for DECnet-20 V2 Page 10
February 1980
4.0 INSTALLATION INSTRUCTIONS
DECnet-20 Version 2 is distributed as a 1600 BPI 9 Track
magnetic tape in standard DUMPER format. There are three
products in the DECnet-20 product set: DECnet-20 V2, QTD01;
DECnet-20 V2 for 2020, QTD20; and RJE-20 V1, QT062. Each is
distributed on a separate distribution tape. General
installation instructions and network generation procedures are
described in the TOPS-20 DECnet-20 Programmer's Guide and
Operations Manual. This section describes the format of the
distribution tapes that are restored to disk.
4.1 Format of DECnet-20 Distribution Tape
The DECnet-20 V2 Distribution Tape, QTD01, consists of the
following six save sets:
DUMPER Save Set Name Directory
Documentation Files for DECnet-20 V2 PS:<DECNET>
Binary Files for DECnet-20 V2 PS:<SUBSYS>
Source Files for DECnet-20 V2 PS:<DECNET>
DN20 Generation Files for DECnet-20 V2 PS:<DNGEN>,PS:<DNGEN.CMDS>
Acceptance Files for DECnet-20 V2 PS:<UETP.LIB>
Sample Files for DECnet-20 V2 PS:<UETP.DECNET>
4.2 Format of DECnet-20 for 2020 Distribution Tape
The DECnet-20 V2 for 2020 Distribution tape, QTD20,
consists of the following five save sets:
DUMPER Save Set Name Directory
Documentation Files for DECnet-20 V2 for 2020 PS:<DECNET>
Binary Files for DECnet-20 V2 for 2020 PS:<SUBSYS>
Source Files for DECnet-20 V2 for 2020 PS:<DECNET>
Acceptance Files for DECnet-20 V2 for 2020 PS:<UETP.LIB>
DECNET.DOC -- DOC file for DECnet-20 V2 Page 11
February 1980
Sample Files for DECnet-20 V2 for 2020 PS:<UETP.DECNET>
4.3 Format of RJE-20 Distribution Tape
The RJE-20 V1 Distribution Tape, QT062, consists of the
following two save sets:
DUMPER Save Set Name Directory
Documentation Files for RJE-20 V1 PS:<DECNET>
DN200 Generation Files for RJE-20 V1 PS:<DNGEN>,PS:<DNGEN.CMDS>
DECNET.DOC -- DOC file for DECnet-20 V2 Page 12
February 1980
5.0 INTERNAL CHANGES
5.1 Changes from DECnet-20 V1 to DECnet-20 V2
Numerous internal changes and additions have been made for
DECnet-20 Version 2, both within TOPS-20 and in the DN20
software. NSPSRV has been divided into three modules: NSPPAR,
a parameter file; FILNSP, the file system interface to NSP;
and NSPSRV the file containing the network specific portion of
NSP on TOPS-20. Some data base restructuring has occurred in
KDPSRV. NETCON has been divided into three modules: NETPAR,
NCU, and NCP. The NODE JSYS has been enhanced with several new
functions to provide topology support. A new BOOT JSYS
function was added.
A topology reporting task, TOPOL, has been added to the
DN20. Device drivers were added for the KMC/DUP combination.
Several tools and procedures were added to support the
configuration of the DN20 software in the field. New
functionality was developed to support the DN200 RJE station.
Many bugs and deficiencies present in Version 1 were fixed
during the development of Version 2.
DECNET.DOC -- DOC file for DECnet-20 V2 Page 13
February 1980
6.0 SUGGESTIONS
6.1 DECnet Phase III Node Name Compatibility
In DECnet Phase III all node names must include at least
one alphabetic character to syntactically distinguish them from
node addresses. The alphabetic character need not be the first
character, and remaining characters may be either alphabetic or
numeric. Customers are urged to adhere to this convention when
naming Phase II nodes, thus providing upward compatibility with
DECnet Phase III.
6.2 Documentation Required on Submission of DECnet-20 SPR's
When submitting documentation for SPR's on DN20 problems,
the user MUST submit the entire contents of the directory in
which the DN20 system image was generated. This should include
the complete set of MAC files, MAP files, STB files, IMAGE
files, and the DMP file along with any other description of the
problem and supporting documentation. The dump cannot be
analyzed without the symbol files that were created when the
system image was generated.
6.3 Proper Method to Perform Line Loopback
Use the following sequence of operations to perform line
loopback:
1. Put the line in OFF state
2. Place the modem in loopback
3. Put the line in MAINTENANCE state
4. Perform the LOOP LINE command until done
5. Put the line in OFF state
6. Take the modem out of loopback
7. Set the line state to ON
[End of DECNET.DOC]