Trailing-Edge
-
PDP-10 Archives
-
BB-W661B-BM_1984
-
documentation/psi.bwr
There is 1 other file named psi.bwr in the archive. Click here to see a list.
TOPS-20 PSI Beware File
February, 1984
COPYRIGHT (C) 1982, 1983, 1984 BY
DIGITAL EQUIPMENT CORPORATION,
MAYNARD, MASSACHUSETTS
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.
TOPS-20 PSI Beware File
C O N T E N T S
__________________________
1.0 INTRODUCTION . . . . . . . . . . . . . . . . . . . . 1
2.0 INSTALLATION INFORMATION . . . . . . . . . . . . . . 1
2.1 Public Packet Switching Network Names . . . . . . 1
2.2 Typing In Installation Parameters . . . . . . . . 1
2.3 DTE Addresses . . . . . . . . . . . . . . . . . . 1
2.4 Using The DMC/DMR Line Device . . . . . . . . . . 2
2.5 Network Size And Performance . . . . . . . . . . . 2
2.6 European Sites And 50Hz. . . . . . . . . . . . . . 3
2.7 Loopback Test . . . . . . . . . . . . . . . . . . 3
3.0 NETWORK MANAGEMENT INFORMATION . . . . . . . . . . . 3
3.1 OPR/NCP . . . . . . . . . . . . . . . . . . . . . 3
3.2 CLEAR MODULE X25-PROTOCOL Command . . . . . . . . 3
3.3 SET MODULE X25-SERVER Command . . . . . . . . . . 4
4.0 PROGRAMMING INFORMATION . . . . . . . . . . . . . . 4
4.1 MACRO-20 Gateway Access Library . . . . . . . . . 4
5.0 DOCUMENTATION . . . . . . . . . . . . . . . . . . . 4
5.1 TOPS-20 PSI User's Guide . . . . . . . . . . . . . 4
5.2 DECnet-20 System Manager's And Operator's Guide . 6
TOPS-20 PSI Beware File
INTRODUCTION
1.0 INTRODUCTION
This document supplements the TOPS-20 PSI manuals by pointing out
hints and potential problems discovered too late for inclusion in the
documentation.
NOTE
READ THIS FILE BEFORE STARTING THE
INSTALLATION, SINCE IT CONTAINS
IMPORTANT CHANGES TO THE INSTALLATION
PROCEDURE.
2.0 INSTALLATION INFORMATION
2.1 Public Packet Switching Network Names
In addition to the network names defined in the TOPS-20 PSI manuals,
the TOPS-20 PSI Gateway software also recognizes other network names
defined in the Software Product Description (SPD 21.22.xx).
2.2 Typing In Installation Parameters
All installation parameters should be typed using uppercase letters.
This is particularly important for the destination object of Step 24
and the passwords in Steps 24 and 43 of the TOPS-20 PSI Installation
Guide.
2.3 DTE Addresses
In the installation procedure as described in the TOPS-20 PSI
Installation Guide, you must specify the DTE address assigned to you
by your PPSN (see Sections 1.4.3, Step 24 of 3.1.2, and Step 43 of
4.3). In some countries, you must supply the full international DTE
address. In others, you specify only the national number. The
national number does not include the country code.
In the United States you are connected to Telenet or Tymnet and you
must specify the full international DTE address. The first 4 digits
must be 3110 for Telenet and 3106 for Tymnet. For Telenet, the next
ten digits are divided into two fields: the Area Code Field and the
DTE Address Field. The Area Code Field is a three digit field modeled
after the telephone network style area code. For example, in Boston,
1
TOPS-20 PSI Beware File
INSTALLATION INFORMATION
Massachusetts, it is 617. The DTE Address Field is from 1 to 5 digits
assigned by Telenet. You must expand this field to 5 digits by
supplying leading zeroes. For example, if your Area Code Field is 202
and your DTE Address Field is 32, the DTE address which you supply
during the installation procedure is 311020200032. For Tymnet, the
remaining ten digits are assigned by the network using its own
convention.
In the United Kingdom you are connected to PSS and you must specify
the full international DTE address. The first 4 digits must be 2342.
The remaining digits follow the convention similar to that of Telenet.
In France you are connected to Transpac and you must specify the
national number only. The first digit is 1 followed by an 8 digit
field assigned to you by Transpac. For example, if your Transpac
assigned number is 94000725, you supply 194000725 for the DTE address
during the installation. Note that 208, which is the country code for
France, is not included.
In Germany you are connected to DATEX-P and you must specify the
national number only. This is a string of up to 11 digits supplied by
DATEX-P. The first digit is always a 4 indicating the national
network is DATEX-P and the second is always a 5 indicating an X.25
port. An example of a DTE address for DATEX-P is 45611023456. Note
that 262, which is the country code for Germany, is not included.
2.4 Using The DMC/DMR Line Device
If you wish to use a DMC/DMR for the DECnet line, you must restrict
the EXECUTOR MAXIMUM ADDRESS to 140 or less and the EXECUTOR BUFFER
SIZE to 290. After completing Step 24 of the installation procedure,
issue the following X25GEN commands in this order:
X25GEN>DEFINE EXECUTOR MAXIMUM ADDRESS 140
X25GEN>DEFINE EXECUTOR BUFFER SIZE 290
2.5 Network Size And Performance
Even though your installation does not use the DMC/DMR device for a
DECnet line, the default values of 255 for EXECUTOR MAXIMUM ADDRESS
and 576 for EXECUTOR BUFFER SIZE can be too large if you have a small
network. If your network has less that 140 nodes, you will obtain
better performance if you set the EXECUTOR MAXIMUM ADDRESS to 140 and
the EXECUTOR BUFFER SIZE to 290.
2
TOPS-20 PSI Beware File
INSTALLATION INFORMATION
2.6 European Sites And 50Hz.
If you are a European site, immediately following Step 31 of the
installation procedure, you should do the following so that the timers
in the front-end run at 50Hz:
$RENAME DN20:RSX11S-50HZ.TSK (to be) DN20:RSX11S.TSK
2.7 Loopback Test
When performing the LOOP LINE command of Step 64, do not use a COUNT
greater than 1000 or a LENGTH greater than 127. Failure to observe
this restriction may cause the loop test to take longer than Network
Management's timeout period of 3 minutes.
If in response to the LOOP command, you receive the message:
Loop Line Failed, Operation failure
Timed out waiting for response
You will have to reload the DN20 before the DN20 will respond to
Network Management commands. You will receive this response if the
loop line test takes longer than 3 minutes or if the line is not
operational. If the line is functioning properly, this response will
not occur.
3.0 NETWORK MANAGEMENT INFORMATION
3.1 OPR/NCP
If your installation supports down-line load and up-line dump of
remote RSX-11S systems, you will need to re-link OPR.EXE using the new
NCPTAB.REL module on the distribution tape. The new NCPTAB.REL module
contains bug fixes relevant to RSX-11S system support. Refer to the
GALAXY documentation for instructions how to re-link the OPR.EXE
program.
3.2 CLEAR MODULE X25-PROTOCOL Command
The Network Managment command:
NCP>CLEAR MODULE X25-PROTOCOL GROUP name DTE address
does not clear the DTE address. To circumvent this, the entire group
name must be cleared and redefined for those DTE addresses where still
valid.
3
TOPS-20 PSI Beware File
NETWORK MANAGEMENT INFORMATION
3.3 SET MODULE X25-SERVER Command
In the Network Management command:
NCP>SET MODULE X25-SERVER NODE node-id DESTINATION destination
the destination node-id may only be a node name. The appropriate
sequence of commands to set up the node parameter for a destination
entry is:
NCP>SET EXECUTOR NODE gateway-node
NCP>SET NODE node-number NAME node-name
NCP>SET MODULE X25-SERVER NODE node-name DESTINATION destination
4.0 PROGRAMMING INFORMATION
4.1 MACRO-20 Gateway Access Library
When a subroutine call requires an ASCIZ byte pointer as an argument,
the byte pointer needs not be restricted to a 7-bit byte pointer. The
ASCIZ byte pointer may be of any byte size greater than or equal to 7
bits and up to 36 bits. The ASCIZ string must however be terminated
by a binary zero byte.
5.0 DOCUMENTATION
5.1 TOPS-20 PSI User's Guide
o The last function in Table 2-6 on page 2-12 should read "NO
COMMUNICATION SEEN".
o Table 3-2 on page 3-28 should read:
Decimal Meaning
Value
1 Unknown error
2 Insufficient gateway resources
3 Circuit in use (reserved)
4 Undefined circuit name
5 Undefined network name
6 No communication with the Public Network
4
TOPS-20 PSI Beware File
DOCUMENTATION
7 Data field truncated
8 Facilities field truncated
9 Source DTE subaddress is too long
10 Destination DTE address is too long
11 Version skew
12 Invalid user group
o Table 4-3 on page 4-27 should read:
Bit Symbol Meaning
6 XE%IUG Invalid user group
7 XE%VSK Version skew
8 XE%DDL Destination DTE address is too long
9 XE%SDL Source DTE subaddress is too long
10 XE%FFT Facilities field truncated
11 XE%DFT Data field truncated
12 XE%NCM No communication with the Public Network
13 XE%UNN Undefined network name
14 XE%UCN Undefined circuit name
15 XE%INU Circuit in use (reserved)
16 XE%IGR Insufficient gateway resources
17 XE%UNK Unknown error
o The second line of Section A.1.1 on page A-1 should read:
"program, SVCXMI. SVCRCV starts by declaring itself available
to"
o The first paragraph on page A-2 should read:
"current port state to 3 (LISTENING). Note that there are other
subroutines that upon successful execution change the port
state. When one of these subroutines has been successfully
executed, you do not need to execute X25RPS to determine the
port state. For example:"
5
TOPS-20 PSI Beware File
DOCUMENTATION
o The second paragraph on page B-4 should read:
"After accepting the incoming call, the program has updated its
copy of the current port state to XS%RUN (RUNNING). Note that
there are other subroutines that upon successful execution
change the port state. When one of these subroutines has been
successfully executed, you do not need to execute X%RPS to
determine the port state. For example:"
5.2 DECnet-20 System Manager's And Operator's Guide
o In Table A-8 on page A-15, parameter 320 should have the
restriction of "Node name only" in the DECnet-20 V3.0
Implementation column.
o The standard text in Table B-4 for counter 1210 should read "Fast
selects received" and for counter 1211 should read "Fast selects
sent".
o In Section E.2 on page E-3, the middle close and open curly
brackets in the command syntax definition should be removed.
[End of PSI.BWR]
6