💾 Archived View for spam.works › mirrors › textfiles › programming › release.not captured on 2023-07-22 at 20:45:42.
⬅️ Previous capture (2023-06-16)
-=-=-=-=-=-=-
CONTENTS
CHAPTER 1 CHANGES BETWEEN V1.0 AND V1.1
1.1 DECnet-DOS and DECnet-Rainbow NFT . . . . . . . . 1-1
1.2 DECnet-DOS and DECnet-Rainbow SETHOST . . . . . . 1-2
1.3 DECnet-DOS and DECnet-Rainbow NDU . . . . . . . . 1-2
1.4 DECnet-DOS and DECnet-Rainbow NTU . . . . . . . . 1-3
1.5 DECnet-DOS and DECnet-Rainbow TFA . . . . . . . . 1-3
1.6 DECnet-DOS and DECnet-Rainbow TTT . . . . . . . . 1-3
1.7 DECnet-DOS and DECnet-Rainbow TNTERR . . . . . . . 1-3
1.8 DECnet-DOS and DECnet-Rainbow DTR/DTS . . . . . . 1-4
1.9 DECnet-DOS and DECnet-Rainbow SPAWNER . . . . . . 1-4
1.10 DECnet-DOS and DECnet-Rainbow MAIL . . . . . . . . 1-4
1.11 DECnet-DOS and DECnet-Rainbow FAL . . . . . . . . 1-4
1.12 DECnet-DOS and DECnet-Rainbow DIP . . . . . . . . 1-5
1.13 Revisions to the DECnet-DOS Programmer's Reference
Manual . . . . . . . . . . . . . . . . . . . . . . 1-5
1.14 DECnet-DOS and DECnet-Rainbow Programming
Interface . . . . . . . . . . . . . . . . . . . . 1-9
CHAPTER 2 SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
2.1 Asynchronous Installation Problems . . . . . . . . 2-1
2.2 Asynchronous Performance and Tuning . . . . . . . 2-6
2.3 Asynchronous Configuration Problems . . . . . . . 2-7
2.4 Ethernet Performance and Tuning . . . . . . . . . 2-8
2.5 Ethernet Configuration Problems . . . . . . . . 2-10
2.6 General Problems . . . . . . . . . . . . . . . . 2-10
2.6.1 Problems with Rainbow Only . . . . . . . . . . 2-13
2.6.2 Problems with IBM PCs Only . . . . . . . . . . 2-13
2.7 NFT - Network File Transfer . . . . . . . . . . 2-14
2.8 Error Messages and Warnings . . . . . . . . . . 2-15
2.8.1 Error Messages . . . . . . . . . . . . . . . . 2-15
2.8.2 Warnings . . . . . . . . . . . . . . . . . . . 2-17
2.9 SETHOST . . . . . . . . . . . . . . . . . . . . 2-18
2.9.1 CTERM ONLY . . . . . . . . . . . . . . . . . . 2-18
2.9.2 LAT ONLY . . . . . . . . . . . . . . . . . . . 2-19
2.10 NDU - Network Device Utility . . . . . . . . . . 2-21
2.10.1 NPDRV - Virtual Printer Driver . . . . . . . . 2-21
2.10.2 NDDRV - Virtual Disk Driver . . . . . . . . . 2-22
2.11 NCP - Network Control Program . . . . . . . . . 2-22
2.12 NTU - Network Test Utility . . . . . . . . . . . 2-24
2.13 TFA - Transparent File Access . . . . . . . . . 2-25
2.14 TTT - Transparent Task-to-Task . . . . . . . . . 2-25
2.15 DTR/DTS . . . . . . . . . . . . . . . . . . . . 2-25
2.16 MAIL . . . . . . . . . . . . . . . . . . . . . . 2-25
2.17 FAL (File Access Listener) . . . . . . . . . . . 2-26
2.18 DIP - DECnet-DOS Installation Procedure . . . . 2-28
1
2.19 C Programming Library . . . . . . . . . . . . . 2-29
CHAPTER 3 MODEM CONTROL
3.1 Using Modem Control . . . . . . . . . . . . . . . 3-1
3.2 Modem States . . . . . . . . . . . . . . . . . . . 3-2
3.2.1 General . . . . . . . . . . . . . . . . . . . . 3-5
3.2.2 State 1 . . . . . . . . . . . . . . . . . . . . 3-5
3.2.3 State 2 . . . . . . . . . . . . . . . . . . . . 3-5
3.2.4 State 3 . . . . . . . . . . . . . . . . . . . . 3-5
3.2.5 State 4 . . . . . . . . . . . . . . . . . . . . 3-6
3.2.6 State 5 . . . . . . . . . . . . . . . . . . . . 3-6
3.2.7 State 6 . . . . . . . . . . . . . . . . . . . . 3-6
3.2.8 State 7 . . . . . . . . . . . . . . . . . . . . 3-6
3.3 Interface Requirements . . . . . . . . . . . . . . 3-8
3.4 Modem Option Selections . . . . . . . . . . . . 3-10
CHAPTER 4 REPORTING PROBLEMS
FIGURES
3-1 Modem States . . . . . . . . . . . . . . . . . . . 3-4
3-2 Minimum Implementation of V.24 Circuits for Full
Duplex Modem Control . . . . . . . . . . . . . . . 3-7
TABLES
1-1 Extended Error Messages - Unable to Make a
Connection . . . . . . . . . . . . . . . . . . . . 1-6
1-2 Extended Error Messages - Disconnecting a Logical
Link . . . . . . . . . . . . . . . . . . . . . . . 1-8
3-1 Asynchronous Mode, Direct Connection . . . . . . . 3-8
3-2 Asynchronous Mode, Modem Connection . . . . . . . 3-9
3-3 User-selectable Modem Options . . . . . . . . . 3-10
2
Preface
The following release notes include updated information for DECnet-DOS
V1.1 and DECnet-Rainbow V1.1. You should use these notes in
conjunction with the material presented in the DECnet-DOS
documentation set.
Intended Audience
These release notes are intended for users of the Rainbow series of
personal computers and for users of the IBM PC, IBM PC/XT, and IBM
Personal Computer AT. Some of the information presented in this
document is very technical. If you do not understand the material,
you should seek assistance from the person who is responsible for
configuring your network.
ALL-IN-1 is a trademark of Digital Equipment Corporation.
IBM is a registered trademark of International Business Machines
Corporation.
IBM PC/XT is a trademark of International Business Machines
Corporation.
IBM Personal Computer AT is a trademark of International Business
Machines Corporation.
MS is a trademark of Microsoft Corporation.
Symphony is a trademark of Lotus Development Corporation.
3
CHAPTER 1
CHANGES BETWEEN V1.0 AND V1.1
This chapter describes the software changes made from DECnet-DOS and
DECnet-Rainbow Version 1.0 to DECnet-DOS and DECnet-Rainbow Version
1.1.
For DECnet-DOS only, DECnet-DOS V1.1 adds support for IBM Personal
Computer ATs, support for PC-DOS V3.1, and Ethernet support.
In Version 1.0, the background network task was installed as an MS-DOS
device driver. In Version 1.1, a number of tasks cooperate to provide
background network processing. All of these tasks are terminate and
stay resident tasks, not device drivers. They include: the interrupt
Scheduler (SCH); the Ethernet Data Link Layer (DLL); the LAT protocol
handler (LAT); and the DECnet Network Process (DNP). Note that DLL
and LAT apply to DECnet-DOS only.
The processes communicate using software interrupts. The interrupts
__________
used by each process are listed in an appendix to the DECnet-DOS
____________ _________ ______
Programmer's Reference Manual.
The following sections describe changes to the DECnet-DOS and
DECnet-Rainbow utilities.
1.1 DECnet-DOS and DECnet-Rainbow NFT
o NFT now provides the PRINT and SUBMIT commands which queue
remote files at the remote node, and /PRINT and /SUBMIT
switches which can be used with the COPY command to copy
local files to remote nodes to be queued at the remote node.
o The /FULL switch for the DIRECTORY command now provides a VMS
style full directory listing for remote files.
1-1
CHANGES BETWEEN V1.0 AND V1.1
o NFT will now allow you to copy remote files directly to the
local printer, for example:
NFT COPY REMOTE::FOO.BAR PRN
or
NFT COPY REMOTE::FOO.BAR PRN:
o NFT can now do block mode file copies. Block mode file
copying is an image mode file transfer which moves the data
in 512 byte units independent of any record characteristics.
The end of file byte position is properly retained. This
file copy mode may be necessary to copy files with very long
records. To use block mode when copying, specify /BLOCK as
the only switch.
o The date and time of creation of copied files is now
preserved.
1.2 DECnet-DOS and DECnet-Rainbow SETHOST
o SETHOST now allows you the ability to interrupt a session to
perform some local task and then continue the session where
you left off. Multiple interrupted sessions are supported
(CTERM connections only). Local tasks include any MS-DOS
command or sequence of commands, starting or stopping logging
of the terminal session, and getting help.
o SETHOST now provides VMS style command line editing.
o SETHOST provides on-line help.
o LAT support is now provided by SETHOST (Ethernet
configurations only). When SETHOST attempts to connect to
the remote node it first attempts to use LAT protocol. If
that fails, SETHOST attempts a CTERM connection. There is no
multiple session LAT support.
1.3 DECnet-DOS and DECnet-Rainbow NDU
o NDU can now CREATE virtual disk volumes in 4 different sizes,
1.2, 10, 20, and 32 MB.
1-2
CHANGES BETWEEN V1.0 AND V1.1
1.4 DECnet-DOS and DECnet-Rainbow NTU
o The SET RECORDING command is no longer available. Use the TO
file option instead.
o LOOP command syntax has been changed to be more consistent
with other DECnet implementations. The LOOP commands are
now: LOOP EXECUTOR, LOOP CIRCUIT, LOOP NODE, and LOOP LINE
CONTROLLER.
1.5 DECnet-DOS and DECnet-Rainbow TFA
o TFA now has on-line help.
o TFA can now be unloaded after use to make memory available
for other tasks. TNT unloads TFA.
1.6 DECnet-DOS and DECnet-Rainbow TTT
o TTT now has on-line help.
o TTT can now be unloaded after use to make memory available
for other tasks. TNT unloads TTT.
1.7 DECnet-DOS and DECnet-Rainbow TNTERR
o TNTERRs name has been changed to TNT.
o TNT provides on-line help.
o TNT can unload TTT or TFA from memory.
1-3
CHANGES BETWEEN V1.0 AND V1.1
1.8 DECnet-DOS and DECnet-Rainbow DTR/DTS
o DTR now has on-line help.
1.9 DECnet-DOS and DECnet-Rainbow SPAWNER
o The DECnet Job Spawner is a new utility with DECnet-DOS V1.1.
The job spawner runs as a foreground task waiting for
incoming connections. When a connection arrives, the spawner
looks up the requested object name or number in its database
and runs the program which services that type of request.
When the program finishes, the spawner again waits for
incoming connections. The spawner supports FAL, DTR, and
user-written servers.
1.10 DECnet-DOS and DECnet-Rainbow MAIL
o MAIL is a new utility with V1.1. MAIL provides you the
ability to transmit messages or files to other non MS-DOS
nodes in your network. MAIL does not allow you to receive
mail directly at your personal computer node.
1.11 DECnet-DOS and DECnet-Rainbow FAL
o The File Access Listener (FAL) allows other nodes in your
network access to files local to your personal computer node.
Access is password controlled. FAL can be run with the Job
Spawner.
1-4
CHANGES BETWEEN V1.0 AND V1.1
1.12 DECnet-DOS and DECnet-Rainbow DIP
o DECnet-DOS and DECnet-Rainbow can now be completely installed
by running the DECnet Installation Procedure (DIP) and
answering a few simple questions. Refer to the appropriate
installation guide for instructions.
__________ ____________ _________ ______
1.13 Revisions to the DECnet-DOS Programmer's Reference Manual
The following tables are revised Versions of Table D-1 and Table D-2,
which are in Appendix D ("SUMMARY OF EXTENDED ERROR CODES") of the
__________ ____________ _________ ______
DECnet-DOS Programmer's Reference Manual.
DECnet-DOS supports extended error support to certain socket
__________
operations. When you write a program which uses the getsockopt
__________
function call, extended error codes can be returned in opt_status, a
__________
data member of optdata_dn. This can occur following an attempted
connection request or after disconnecting a logical link.
Table 1-1 lists extended error codes which can be returned following
an attempted connection. It lists the error messages found in
________
derrno.h, the decimal value for each message, their equivalent error
_________ _____
message that dnet_conn returns in errno, and the error reason.
1-5
CHANGES BETWEEN V1.0 AND V1.1
Table 1-1: Extended Error Messages - Unable to Make a Connection
Decimal derrno.h dnet_conn
Error Code Mnemonic In errno Reason
0 EREJBYOBJ ECONNREFUSED Connect failed.
Connection
rejected by object.
1 EINSSNETRES ENOSPC Connect failed.
Insufficient network
resources.
2 EUNRNODNAM EADDRNOTAVAIL Connect failed.
Unrecognized
node name.
3 EREMNODESHUT ENETDOWN Connect failed.
Remote node
shutting down.
4 EUNROBJ ESRCH Connect failed.
Unrecognized object.
5 EINVOBJNAM EINVAL Connect failed.
Invalid object
name format.
6 EOBJBUSY ETOOMANYREFS Connect failed.
Object too busy.
10 EINVNODNAM ENAMETOOLONG Connect failed.
Invalid node
name format.
11 ELOCNODESHUT EHOSTDOWN Connect failed.
Local node
shutting down.
32 ENODERESOURCES ENOSPC Connect failed. No
node resources for
new logical link.
33 EUSERESOURCES ENOSPC Connect failed. No
user resources for
new logical link.
34 EACCONREJ ECONNABORTED Connect failed.
Access control
rejected.
1-6
CHANGES BETWEEN V1.0 AND V1.1
Decimal derrno.h dnet_conn
Error Code Mnemonic In errno Reason
36 EBADACCOUNT ECONNABORTED Connect failed.
Bad account
information.
38 ENORESPOBJ ETIMEDOUT Connect failed.
No response
from object.
39 ENODUNREACH ENETUNREACH Connect failed.
Node unreachable.
43 ECONNTOOBIG ECONNABORTED Connect failed.
Connect image
data field too
long.
1-7
CHANGES BETWEEN V1.0 AND V1.1
Table 1-2 lists extended error codes which can be returned following a
________
disconnection. It lists the error messages found in derrno.h, the
decimal value for each message, and the error reason.
Table 1-2: Extended Error Messages - Disconnecting a Logical Link
Decimal derrno.h
Error Code Mnemonic Reason
0 EREJBYOBJ The remote node end user
disconnected a running logical
link.
8 EABTBYNMGT The logical link was
disconnected by a third party.
9 EUSERABORT The remote end user has aborted
the link.
38 ENORESPOBJ The end user or node at the
other end of the link has
crashed or failed.
39 ENODUNREACH The connection has been lost due
to a local timeout.
41 ENOLINK The connection has been lost due
to a protocol failure, no such
link found at remote.
42 ECOMPLETE No error. A local end
user-initiated disconnect has
completed.
1-8
CHANGES BETWEEN V1.0 AND V1.1
1.14 DECnet-DOS and DECnet-Rainbow Programming Interface
o The assembler language interface to the network process in
Version 1.0 was software interrupt 2A (hex). In Version 1.1
the interface to the network process is software interrupt 6E
(hex). The 2A interface has been retained for compatibility,
but may be removed in a future release.
o A new technique for doing I/O which does not block is being
provided in Version 1.1, asynchronous I/O. Asynchronous I/O
provides a call back mechanism to notify the application
program that a request has been completed. Please refer to
__________ ____________ _________ ______
the DECnet-DOS Programmer's Reference Manual for more
information.
o SCBDEF.H
The symbol definition SCBS_SETOSTAT was changed to
SCBS_GETOSTAT.
o DN.H
The following definitions for DECnet software components were
added:
/*
* Define DECnet modules as TLA (three letter acronym) strings.
*/
#define DNMOD_LAT "LAT" /* LAT driver */
#define DNMOD_PDV "PDV" /* Port driver */
#define DNMOD_SCH "SCH" /* Real-time Scheduler */
#define DNMOD_DLL "DLL" /* Data Link Layer */
#define DNMOD_DNP "DNP" /* DECnet Network Process */
/*
* Define DECnet software module interrupt vectors.
*/
#define DNMODULE_LAT 0x6a /* LAT driver */
#define DNMODULE_PDV 0x6b /* Port driver */
#define DNMODULE_SCH 0x6c /* Real-time Scheduler */
#define DNMODULE_DLL 0x6d /* Data Link Layer */
#define DNMODULE_DNP 0x6e /* DECnet Network Process */
1-9
CHANGES BETWEEN V1.0 AND V1.1
o DERRNO.H
The following symbol definitions were added (note that these
are not supported by DECnet-ULTRIX V1.1):
EUSERABORT 9 - Disconnect: Abort by user
ENODERESOURCES 32 - Connect: No node resources for new logical link
EUSERESOURCES 33 - Connect: No user resources for new logical link
EBADACCOUNT 36 - Connect: Bad account information
ENOLINK 41 - Disconnect: Protocol failure, no such link
ECOMPLETE 42 - Disconnect: No error, disconnect completed
ECONNTOOBIG 43 - Connect: Connect image data field too long
o NERROR.C
Error text for additional DECnet connect errors was added.
(see new definitions in DERRNO.H)
The array of character strings, *dnet_errlist[], has changed.
The text, "Connect failed, ", which was repeated in every
string, has been removed and placed in a single, separate
character string, 'connect_error[]'. If your code indexed
directly into this global array of strings, you must account
for the "Connect failed, " string in your display code or
else use the connect_error[] string. If you used the
function 'nerror()', this change will be transparent to your
program.
o DNET_CONN.C
A 'signal()' function was added for support of non-blocking
connects. If a 'signal()' function is not supported by your
C compiler, comment out all references to 'signal' in this C
source file before compilation.
__________ ____________ _________ ______
Appendix C of the DECnet-DOS Programmer's Reference Manual
should include the following entry:
EINTR 4 Interrupted system call.
1-10
CHANGES BETWEEN V1.0 AND V1.1
Automatic outgoing proxy support was added. This was done by
issuing a 'bind()' call to the client socket under the
following conditions:
1. No access control information passed in the 'node'
argument to 'dnet_conn()'.
2. No default access control information found in the local
node's node database for the remote node specified in the
'node' argument to 'dnet_conn()'.
3. A user name has been set up for local node in the local
node's database.
o The internal function 'dnet_errconvert()' was modified to
reflect changes made in DECnet connect errors (see new
definitions in DERRNO.H) This function maps DECnet connect
errors to their equivalent 'errno' system error codes so that
connect error returns from 'dnet_conn()' will have the
correct errno system error code in 'errno' for use by the
function 'nerror()'.
o DNMSDOS.H
____________
localinfo_dn was revised to support the complete path
specification for the DECnet database path by adding a new
member to the data structure:
1. The complete database path specification is contained in
_______________
lcl_decnet_path.
_________________
2. lcl_decnet_device is still supported for backwards
compatibility.
3. See the file for more details on the structure format.
1-11
CHANGES BETWEEN V1.0 AND V1.1
o DNET_PATH.C
_________
dnet_path now supports getting the complete DECnet database
path specification. Note that the function's interface has
not changed.
o IOCB.H
A new data structure, CIOCB, was added which supports
ASYNCHRONOUS NETWORK I/O. This structure is identical to the
IOCB structure except for one additional member,
'io_callback'. See the file for more details on the
structure's format.
o TIME.H
Three new external definitions were added:
int daylight;
long timezone;
char *tzname[2];
It is ASSUMED that these are defined by the user's C
compiler. If not used, comment them out of header file
before compilation(s); otherwise, if not defined, then define
them in applications programs.
o SOCKET.H
New flag definitions for the CIOCB / IOCB 'io_flags' member
were added:
#define MSG_ASYNC 0x8 /* perform function asynchronously */
#define MSG_CALLBACK 0x10 /* perform callback */
#define MSG_NEOM 0x20 /* do not perform end of message */
#define MSG_NBOM 0x40 /* do not set beginning of message */
New address family definitions were added:
#define AF_SES 6
#define AF_MAX 6
o BEGIN.H & FINISH.H
Segment names were changed in this file.
o SIZE.H
SIZE.H is NOT necessary for V1.1 assemblies.
1-12
CHANGES BETWEEN V1.0 AND V1.1
o DNETDB.H
The use of the flags byte in the structure, 'dnet_nodeent'
has been modified. It is now interpreted as a bit field
flags byte. The new flag symbols are:
/*
* dnet_nodeent.dne_delflag - flags
*/
#define DNET_NODE_DEL 0x2 /* deleted entry */
#define DNET_NODE_CRY 0x4 /* encrypted entry */
#define DNET_NODE_LAT 0x8 /* LAT preferred host */
A new data structure has been added, 'dnet_accent'. It is
the incoming access control information entry. It uses the
new database file DECACC.DAT.
o PRGPRE.H
The list of header files was modified.
o ERRNO.H
New symbol definition for ASYNCHRONOUS NETWORK I/O errors was
added: Check CIOCB 'io_status' field for this value.
#define NOTHING -2 /* request not complete - asynch i/o */
o TYPES.H
More type definitions were added:
/*
* Defines types used in defining values returned by system level
* calls for file status and time information.
*/
typedef unsigned short ino_t; /* i-node number (not used on DOS) */
typedef long time_t; /* time value */
typedef short dev_t; /* device code */
typedef long off_t; /* file offset value */
1-13
CHANGES BETWEEN V1.0 AND V1.1
o New function dnet_installed():
This is a C library function found in source file DNETINST.C.
It performs installation checking of various software
components. See file DN.H for component symbol definitions.
o New function dnet_getacc():
This is a C library function found in source file DNETACCE.C.
It fetches incoming access control information.
o New function csreg():
This is an assembly function found in source file CSREG.ASM.
It returns the current CS (code segment) register value and
works with the 2 segment model only.
o New function dnetses():
This is an assembly function found in source file
DNETSES.ASM. It currently returns an incorrect Version
number of 0.0 if SESSION is installed.
o New function fbcopy().
This is an assembly function found in source file FBCOPY.ASM.
It performs a FAR byte copy. It does not check for
source/destination buffer overlap conditions.
o New function decnet():
This is an assembly function found in source file DECNET.ASM.
(V1.0 file name was INTIOCTL.ASM) It provides direct
interface to the DECnet Network Process (DNP) via interrupt
vector 6EH. V1.0 interrupt interface to DNP was via 2AH -
this interface is still supported in V1.1 for backwards
________ _______
compatibility. decnet() replaces the V1.0 ioctl() function.
o New format for DECNODE.DAT
The format for the file DECNODE.DAT is different in Version
1.1 than it was in Version 1.0. Passwords are now encrypted,
so that other users cannot read any of the passwords you have
defined.
1-14
CHAPTER 2
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
This chapter describes known problems, restrictions, and
troubleshooting hints.
2.1 Asynchronous Installation Problems
o When connecting your Rainbow or IBM personal computer to the
adjacent node using an Asynchronous DDCMP connection through
a null modem cable, remember to switch the send and receive
leads properly.
o The use of a terminal switch or a terminal server running LAT
for connection of your Rainbow or IBM personal computer to
the adjacent node is not supported.
o When using the DECnet Router Server for asynchronous
connections, the circuit must be full duplex and must be set
to the same line speed as your machine.
For example:
Direct: SET LINE LC-1L SPEED 9600 DUPLEX FULL MODEM NO
Modem: SET LINE LC-1L SPEED 1200 DUPLEX FULL MODEM YES
The circuit cost and hello timer values can be set to any
reasonable values. The state should be set to ON.
o When making a direct Asynchronous DDCMP connection to an
RSX11 system, note that entire controllers must support
either terminals or DDCMP lines, but not both. Insure that
your sysgen or system configuration does NOT include the
chosen controller and that your DECnet gen DOES include the
chosen controller.
2-1
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
o When using Asynchronous DDCMP and connecting directly to a
VAX/VMS system, note that VAX/VMS can share the lines on a
controller between terminal support and asynchronous DDCMP
support.
o When configuring your VAX/VMS adjacent node, use the
following commands as a GUIDE for your VMS system manager.
These commands establish the chosen terminal lines as
dedicated DDCMP lines.
__ ____ ______ _____ ______ _______ ____ ____ __ ____ _____
$! Load asynch DDCMP device driver. This must be done after
__ _____ ______ _____
$! every system boot.
_ ___ _________________
$ run sys$system:sysgen
_______ ______________
connect noa0/noadapter
____
exit
__ ____ ___ _____ _____ ___ __ __ _________ __ _____
$! Tell VMS which lines are to be dedicated to DDCMP
__ ____ ____ __ ____ _____ _____ ______ ____
$! This must be done after every system boot
____ ____ ___________________________________________ _____
$set term /protocol=ddcmp/speed=9600/notypeahead/perm ttb4:
____ ____ ___________________________________________ _____
$set term /protocol=ddcmp/speed=9600/notypeahead/perm ttb5:
__ ___ ___ __ ________ _________ ___ _____ ___ ________
$! Use NCP to properly configure the lines and circuits
__ ________ ____ ______ _______ ___ _________ ________
$! Remember that DEFINE changes the permanent database
__ ___ ___ _____ ____________
$! and SET works immediately.
_ ___
$ ncp
______ ____ ______ _____ __ _______ _______ _
define line tt-1-4 state on receive buffers 4
______ ____ ______ _____ __ _______ _______ _
define line tt-1-5 state on receive buffers 4
______ _______ ______ _____ __
define circuit tt-1-4 state on
______ _______ ______ _____ __
define circuit tt-1-5 state on
____
exit
o When configuring your VAX/VMS adjacent node, use the
following commands as a GUIDE for your VMS system manager.
These commands establish all terminal lines as switchable
DDCMP lines (V4.2 and later only).
ON THE VAX
1. The asynchronous DDCMP driver, NODRIVER, must be loaded
on the VAX system.
_______ _______ ______________
SYSGEN> CONNECT NOA0/NOADAPTER
2. DYNSWITCH, the image that controls the switching of the
line, must be installed as a shareable image on the VAX.
________ ______ _______________________________________________
INSTALL> CREATE SYS$LIBRARY:DYNSWITCH/SHARE/PROTECT/HEADER/OPEN
2-2
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
3. A virtual terminal must be created in order for the
physical terminal connection to be broken without
actually losing the logical connection between the two
systems.
_______ _______ ______________________________
SYSGEN> CONNECT VTA0/NOADAPTER/DRIVER=TTDRIVER
4. The terminal line must be set for 8 bit characters with
no parity and have the attribute DISCONNECT on the VAX.
NOTE
The DISCONNECT attribute enables the virtual
terminal to be used. The DISCONNECT attribute
must be permanent; it must either be set /PERM
after every boot, or the default terminal
characteristics must be set properly. If you set
the terminal characteristics for your own
terminal, you must log out and log back in again
for them to take effect. Also note that if modem
control is enabled, hangup must also be enabled.
You know that this step has been performed
properly if your terminal device designator
begins with VT.
5. In the node database, the following parameters must be
set for the node that will be switching the asynchronous
connection:
- The INBOUND parameter must be set to either ROUTER or
ENDNODE.
- The RECEIVE PASSWORD must be set to match the remote
node's EXECUTOR TRANSMIT PASSWORD.
NOTE
The password will be converted to uppercase
unless it is defined as a quoted string.
_______ ____ _______ _ _ _______ ________
NCP>SET NODE node-idINBOUND [router/endnode] RECEIVE PASSWORD password
2-3
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
ON THE PERSONAL COMPUTER
1. On a personal computer, the DECnet line must be set OFF,
either by default or by command with NCP.
2. The terminal line/terminal emulator must be set for 8 bit
characters with no parity.
3. The EXECUTOR TRANSMIT PASSWORD must be set to match the
RECEIVE PASSWORD specified for the node definition on the
remote system. The password must be entered in uppercase
since the password defined on the VAX is converted to
uppercase unless it is entered as a quoted string.
NOTE
The EXECUTOR RECEIVE PASSWORD must not be set;
when DYNSWITCH is used, DECnet-VAX will not send
a password during routing initialization. If the
receive password is set, the line will not come
up.
4. Both the terminal line and the DDCMP line must be set to
the speed of the line to be used; they will not share
line characteristics.
5. Connect to the VAX as a normal terminal user using a
terminal emulator.
6. When the line is to be switched from a terminal line to a
DDCMP line, the following DCL command is entered:
____ ________ ____________________________________
$SET TERMINAL /PROTOCOL=DDCMP/SWITCH=DECNET/MANUAL
NOTE
/MANUAL is only used when DECnet must be turned
on manually. When the switch is initiated, a
message appears on the terminal indicating that
the switch is taking place on the VAX and the
user must exit terminal emulation mode and turn
on the DECnet line. If the line is not turned on
within approximately 4 minutes, a static
asynchronous line will return to terminal mode
and a dial-up asynchronous line with hangup will
be disconnected.
2-4
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
Terminating a Switched DDCMP Connection
A DDCMP connection created using DYNSWITCH can be terminated
from either end of the connection by setting the line or
circuit (VAX/uVAX only) OFF. The following are the various
scenarios that will occur when the line is disconnected:
1. The personal computer user sets the line OFF or the line
drops due to noise, etc.
If the switched line is a hardwired line between the
personal computer and the VAX, or a modem is used with
/NOHANGUP specified, the circuit on the VAX side will go
into an ON/STARTING state for approximately 4 minutes.
This enables the personal computer user to set the line
back ON and have it operational without having to go
through the entire DYNSWITCH procedure again.
2. The system manager on the VAX or uVAX can set either the
circuit or the line OFF.
If either the circuit or the line is set OFF on the
VAX/uVAX, both the circuit and line information are
removed from the volatile database and the asynchronous
line is returned to terminal mode.
Miscellaneous Information
1. If a modem is used for a DYNSWITCH connection, the modem
signal will not be dropped during the switch.
2. If /NOHANGUP is specified on the terminal line, the modem
signal will not drop after the DDCMP circuit is set OFF.
The line will return to terminal mode.
3. If DECnet is being turned on manually, a <CTRL/C> or a
<CTRL/Y> after the switch message aborts the switch, and
the line is returned to terminal mode.
4. For a dynamic connection, the line and circuit will
automatically be added to the volatile database on the
VAX when the line is switched from terminal mode to DDCMP
mode. It does not have to be manually added to the
database.
5. An asynchronous terminal connection to a VAX through a
switch or a LAT terminal server cannot be switched to a
DDCMP line using DYNSWITCH.
2-5
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
2.2 Asynchronous Performance and Tuning
o If you have a poor Asynchronous DDCMP connection (such as a
noisy phone line between modems), the following suggestions
may help:
_
Set the line speed lower (NCP SET LINE SPEED n).
Set the personal computer's executor retransmit factor higher
_
(NCP SET EXECUTOR RETRANSMIT FACTOR n). The default is 6;
try 10. This is the number of times that a message is
retransmitted before the logical link is declared broken.
Setting this parameter higher allows the network more times
to retry messages with errors.
Set the personal computer's segment size smaller (NCP SET
_
EXECUTOR SEGMENT BUFFER SIZE n). A smaller segment size
improves the chances that messages will be sent with no
errors. A smaller segment size also means that the loss of
one character causes fewer characters to be retransmitted.
The VMS minimum is 192. Try 200 first. The minimum of the
peers is used. NFT may produce "buffer too small" errors at
low values.
Set the Host's EXECUTOR HELLO TIMER longer. This affects how
long DECnet will wait for any traffic before declaring the
line to be down.
On VMS, SET CIRCUIT MAX TRANSMITS controls the retransmit
count before recycling the line. Default is 4, set it to 32.
2-6
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
2.3 Asynchronous Configuration Problems
o When the network process has the line state ON, it assumes
that it has complete control of the communications port of
the system. It will continue to run DECnet protocols in the
background. If you wish to use the communications port for
other purposes (such as a terminal emulator), you must first
turn the line state OFF with NCP. This will disengage the
network process and return the communications port to its
previous state.
o The network process uses the communications parameters stored
in the DECnet database, NOT the parameters that the port may
be programmed with by MS-DOS SETUP commands on the Rainbow
(or PC-DOS MODE commands on IBM PCs). Problems will occur
if, for example, you do not properly adjust the line speed
with NCP to match the remote system.
2-7
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
2.4 Ethernet Performance and Tuning
The Ethernet controllers supported by DECnet-DOS V1.1 use single
buffers for message reception. Since the personal computer's CPU is
fairly slow compared to the speed of the Ethernet, it is possible for
a message to be lost by a personal computer because it is busy getting
the last message off of the controller. When this happens, DECnet
will detect that a message has been lost (after a short time has
passed) and automatically retransmit the lost message. This loss of
messages and subsequent recovery can be observed in counters displayed
by NCP and NTU, in failures in Ethernet loop circuit commands in NTU,
and in short pauses during normal operations. These symptoms do NOT
indicate correctable problems. The loss of messages and subsequent
recovery is expected.
A number of network management parameters can be changed in an effort
to improve performance:
o In very large networks that include many routing nodes and/or
many LAT services, each personal computer may have to receive
a number of messages which are regularly broadcast by routing
nodes and LAT services. These messages are necessary for
normal operations. However, received data performance may be
improved by preventing the reception of these regular
messages. Following are the commands which turn off
reception of these messages and the effect of each command.
Only after all commands have been typed will the potential
performance improvement be realized.
_
1. LAT /n
_
The /n switch to LAT prevents LAT from being told the
name of each LAT service. If you do not wish to use LAT
services, just do not run LAT. If you DO wish to use LAT
_
services, use the /n switch when starting LAT and use the
LAT-HOST keyword with the NCP SET NODE command to inform
LAT which services should be available. (This restricts
your use of LAT services to those with service names of 6
_
characters or less.) The default is no /n switch, which
enables the reception of multicast messages.
2. NCP SET CIRCUIT SERVICE DISABLED [ENABLED]
This command prevents your personal computer from being
able to respond to loopback requests or MOP requests at
the circuit level. The default is ENABLED, which allows
your personal computer to receive multicast messages in
order to provide service functions.
2-8
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
3. NCP SET CIRCUIT MULTICAST DISABLED [ENABLED]
This command causes your personal computer to listen for
announcements concerning which node on the Ethernet is
the router only when the line is started and only every
ten minutes for 1 minute after that. The default is
ENABLED, which allows your personal computer to receive
multicast messages concerning routing.
o If logical links break, try setting the retry counter in your
personal computer higher by typing:
_______ ________ __________ ______ __
NCP>SET EXECUTOR RETRANSMIT FACTOR 10
o If performance seems bursty, try setting the delays before
retransmission lower by typing these commands on your remote
(non-MS-DOS) systems:
_______ ________ _____ ______ __
NCP>SET EXECUTOR DELAY FACTOR 32
_______ ________ _____ ______ _
NCP>SET EXECUTOR DELAY WEIGHT 3
o If performance seems bursty, you may also want to try
lowering the number of messages that a remote node can send
to your personal computer at a time. Type on your personal
computer:
_______ ________ _______ ____ _____ _
NCP>SET EXECUTOR RECEIVE PIPE QUOTA 1
o If performance seems bursty, you may also want to try raising
the number of messages that a remote node can send to your
personal computer at a time. Type on your personal computer:
_______ ________ _______ ____ _____ _
NCP>SET EXECUTOR RECEIVE PIPE QUOTA 8
2-9
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
2.5 Ethernet Configuration Problems
o During power OFF and perhaps power ON, Ethernet controllers
may introduce noise on the Ethernet.
o It may not be possible to format floppies on the IBM PC, the
IBM PC/XT, or the IBM PC AT while the Ethernet line is in the
ON state. The DMA of bytes to and from the Ethernet
controller may interfere with the floppy timing while
formatting. If this seems to be happening to you, use the
NCP command SET LINE STATE OFF before formatting and then SET
LINE STATE ON after formatting.
2.6 General Problems
o Following installation, DECPARM.DAT contains information
specific to the line you are using (either Asynchronous or
Ethernet). Each time the DECnet Network Process (DNP) is
started, it verifies that DECPARM.DAT contains the proper
line information. If you wish to switch between use of the
Ethernet line and use of the asynchronous line, you should
keep two copies of DECPARM.DAT: one for Ethernet (called
DECPARM.ETH, for example), and one for asynchronous (called
DECPARM.ASY, for example). Insure that AUTOEXEC.BAT does NOT
run the DECnet Network Process (DNP). After each boot, you
can rename the appropriate DECPARM file to DECPARM.DAT and
then run the matching DNP. If you attempt to use the wrong
network process for the current permanent database file
(DECPARM.DAT), the error message "wrong protocol type found
in DECPARM.DAT" will be displayed.
o The network takes control of clock interrupts as soon as the
scheduler component runs (SCHPC or SCHRB). The network also
takes control of com option interrupts when the line state is
ON. Other products which also take control of interrupts may
not be compatible with DECnet. In order to run such
incompatible software, you must either turn the DECnet line
OFF with NCP, or prevent the scheduler component from being
run. Note also that use of the DECnet virtual disks and
printer may not be possible during execution of incompatible
software products.
2-10
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
If you are using an asynchronous DDCMP connection, note that
Symphony from Lotus, as shipped, will cause the network
circuit to drop and therefore will not allow use of the
virtual disk and printer. However, using the INSTALL program
that comes with Symphony you can make the changes necessary
to force Symphony to ignore the communications port when it
runs. Run INSTALL to create a new driver set, or to change
an existing driver set. Delete the drivers for modem,
protocol, (and for the Rainbow, 7201 asynchronous support).
Note that if you modify an existing driver set, you must use
the method documented on (or about) page 41 of the
Introduction Manual which describes how to use the minus sign
to remove an option.
o The network process determines the system type that it is
running on by looking at ROM BIOS locations and/or calling
the Rainbow software interrupt 18 hex. Due to hardware
dependencies, the Rainbow and IBM PC processes are not
interchangeable. An error message will be issued and the
process will refuse to run on the wrong system.
o The transparent file access capabilities intercept the MS-DOS
system call interface through interrupt 21 hex. If you run
other programs that intercept interrupt 21, they may
interfere with the functioning of the transparent file access
operations.
o Be sure to understand that sockets are not bound to programs.
Once a socket is created, it will stay alive until it is
closed, even if the program that created it exits. A symptom
of too many open sockets is running out of buffer space. Use
NCP and the command SHOW ACTIVE LINKS to display open
sockets, and SET ACTIVE LINK STATE OFF to close open sockets.
o All utilities accept the node specification as either a node
name or node address. When node name alone is specified, all
utilities will check to see if default access control
information has been stored by NCP for that node and use that
access control information to make the connection. If the
node address is used, checking for default access control
information is BYPASSED.
2-11
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
o All features of DECnet-DOS cannot be supported on small
memory systems. If you find that the DECnet Installation
Procedure (DIP) warns you about having too little memory, if
you find that MS-DOS gives you an error message indicating
too little memory after running a utility, or if your
personal computer hangs after running a utility, try the
following:
- Study the appendix in the Installation Guide which lists
each utility, to determine whether it is memory resident
and its approximate size.
- Do not install any unnecessary third party software that
is memory resident.
- Do not install TTT. It is memory resident.
- Do not install TFA. It is memory resident.
- Do not install LAT. It is memory resident.
- Set the FILES parameter in CONFIG.SYS as low as possible.
64 bytes are used for each open file.
- Set the BUFFERS parameter in CONFIG.SYS as low as
possible. 528 bytes are used for each buffer.
- Use NCP to lower the number of logical links supported.
_
NCP DEFINE EXEC MAX LINK n
- Use NCP to lower the maximum number of buffers to
allocate.
_
NCP DEFINE EXEC MAX BUFFER n
On a 256K personal computer there is enough room to run NCP,
NFT, NTU, CTERM based SETHOST, NDU with one virtual device,
FAL, DTS, DTR, and MAIL if:
- FILES=8 in CONFIG.SYS.
- BUFFERS=2 in CONFIG.SYS.
- EXEC MAX LINKS 2 in NCP.
- EXEC MAX BUFFERS 12-14 in NCP.
Note that if DIP detects insufficient memory, it will automatically
adjust memory usage parameters in an attempt to fit all components
into memory.
2-12
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
2.6.1 Problems with Rainbow Only
o The Rainbow can suffer from crashes, hangs, memory errors,
and other problems if it contains bad memory chips. It may
be the case that your Rainbow can have bad memory which is
seldom used until DECnet is installed. (The resident parts
of DECnet cause more memory to be used.) As a result, it may
appear that the DECnet installation is causing these problems
when it is in fact the memory. If you are experiencing these
problems, have your local field service organization check
your Rainbow for bad memory.
o In order to avoid problems with the firmware, all
non-interrupt driven network processing is suspended while in
SETUP mode. Staying in SETUP mode for long periods of time
will most likely cause your network sessions to be lost.
o The network process uses the Rainbow MS-DOS V2.11 Extended
Communications BIOS User Defined Interrupt Service table to
redirect communications interrupts to it. Use of other
programs that use the BIOS function to change or reset the
_______ ______ _____
service routine address (see the Rainbow MS-DOS V2.05
____________ _____
Programmer's Guide for more information) will effectively
terminate DECnet communications if the process is active.
For example: running a poly-COM program will modify these
addresses. To recover, you must use NCP to set the line
state OFF and then back ON again.
2.6.2 Problems with IBM PCs Only
o The SETHOST utility uses interrupt 10H of the IBM BIOS while
running to control screen output, and takes over keyboard
interrupt 09H to handle keyboard input. Any other programs
that you may use to enhance the keyboard or display operation
may interfere with the operation of this utility.
2-13
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
2.7 NFT - Network File Transfer
o The algorithm for determining whether a file is ASCII or
image when copying from personal computer to remote without
switches is as follows: If the first 512 bytes contain a
CR/LF, the file must be ASCII. Otherwise, it must be image.
Note that some image files may appear to be ASCII using this
rule.
o The SET command for paths on remote ULTRIX systems does not
work.
o The use of MACY11 and LSA switches for remote DECsystem-10s
and DECsystem-20s does not work.
o If a directory command specifies multiple subdirectories and
some of them are protected, the error message fails to
display the volume and directory names.
o The command DIR REMOTE:: defaults the file specification to
*.*. This produces the correct results on all remote systems
except ULTRIX. On an ULTRIX system this only lists the files
that have a period in their names. To work around this
problem, use the command DIR REMOTE::*.
o The SHOW command displays any part of a password string which
follows an embedded space. This is not a serious problem
since most passwords do not have spaces in them.
o If a wildcarded copy from a remote VAX to the personal
computer specifies a wild file specification which matches a
directory specification on the VAX, the directory files are
copied to the personal computer. These files do not contain
any useful information and can be deleted.
o If a wildcarded copy from a remote VAX to the personal
computer requests access to a protected directory, NFT
displays a message saying that there was a problem with a
temporary file. This is the wrong message.
o If a COPY command which copies files from a remote ULTRIX
system to a personal computer defaults the output file
specification and the ULTRIX file specification contains
directories, then the resulting personal computer file will
be named incorrectly.
o If the value of MRS is set too large (> 1024) then NFT fails
in unpredictable ways.
2-14
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
2.8 Error Messages and Warnings
The following error messages and warnings are not listed in Appendix B
__________ ______ _____
(NFT Error Messages) of the DECnet-DOS User's Guide.
2.8.1 Error Messages
- Address already in use.
- Address family not supported by protocol family.
- Argument list too long.
- Argument too long.
- Attribute read error.
- Attribute write error.
- Bad address.
- Bad block on device.
- Bad file number.
- Bad terminator or bad value for switch:
- Bad version number.
- Broken pipe.
- Cannot close file.
- Cannot get JFN for file.
- Cannot open local file with DOS reserved names:
- Cannot PRINT list of files.
- Cannot PRINT local file.
- Connection refused.
- Connection reset by peer.
- Connection timed out.
- Destination address required.
- Device not available.
- Device not found.
- Device not ready.
- Device or file full.
- Disk full or other error in closing file.
- Disk full or other error in writing file.
- Disk usage exceeds quota.
- Error in data type.
- Error in file type extension.
- Failure to get transmit buffer.
- F11-ACP could not access file.
- F11-ACP could not create file.
- F11-ACP could not mark file for deletion.
- File activity precludes operation.
- File already open.
- File Exists.
- File extend failure.
- File is currently in an undefined state.
- Filename syntax error.
2-15
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
- File name too long.
- File not found.
- FSZ field invalid.
- Illegal record encountered.
- Insufficient network resources.
- Invalid DAP message type received.
- Invalid DAP message format received.
- Invalid file options.
- Invalid object name format.
- Invalid wildcard context value.
- Logical name error.
- LPT page limit exceeded.
- Message too long.
- Mount device busy.
- Network capacity exceeded.
- Network dropped connection on reset.
- Network operation failed at remote node.
- Network operation not supported.
- Network operation timed out.
- NFAR error, FFIRST with dir in progress.
- NFAR error, file not open.
- NFAR error, FNEXT with no dir in progress.
- NFAR error, illegal access.
- NFAR error, invalid function.
- NFAR error, invalid RATs.
- NFAR error, missing ::.
- NFAR error, missing quote.
- NFAR error, no \\\\ or \\*\\.
- NFAR error, no more room.
- NFAR error, record buffer too small.
- NFAR error, socket not found.
- No buffer space available.
- Node name cannot be longer than 6 characters.
- Node is unreachable.
- No more sockets available.
- No such device.
- Not supported by remote.
- Operation illegal or invalid for file organization.
- Operation in progress.
- Operation not supported on socket.
- Operation would block.
- Parity error on device.
- Path and file names not valid for SET, SHOW, or EXIT
commands.
- Permission denied.
- Protocol not available.
- Protocol not supported.
- Remote object is too busy.
- Result too large.
- Socket is already connected.
- Socket is not connected.
2-16
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
- Socket operation on nonsocket.
- Socket type not supported.
- Spool or submit command file error.
- Switches not valid for SET, SHOW, or EXIT commands.
- Task not available.
- Too many open files.
- Unexpected DAP message received.
- Unmatched quotes:
- Unrecognized local file specification, remote to remote
operations not supported.
- Unrecognized object.
- Unrecognized remote file specification:
- Unrecognized remote file specification, local to local
operations not supported.
- Unsupported DAP flag field received.
- VFC value must be less than 256.
2.8.2 Warnings
- Extra local file names will be ignored.
- Extra remote file names will be ignored.
- Warning: Destination file name list longer than source list.
2-17
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
2.9 SETHOST
2.9.1 CTERM ONLY
o Use of the @ command for batch input is not fully supported
by ULTRIX and RSX hosts.
o The VMS command SET TERM/INQ does not work properly when
embedded in LOGIN.COM and the @ command is used.
o VMS TDMS applications are not supported under CTERM
connections. VMS TDMS applications are supported under LAT
connections.
o A protocol-based virtual terminal service can be slower than
a direct dumb terminal connection. Some sequences will be
faster using CTERM because all character operations for a
complete line will be done locally in the Rainbow or IBM PC.
Some operations will be slower (such as editing with EDT)
because each character typed causes a number of CTERM
protocol messages to be exchanged.
o Writing saved session files does not check for disk error.
o While command line editing to VMS, if text is inserted which
fills a line, the image on the screen does not wrap to the
next line properly. The characters sent to the remote node
are correct.
o If backspace characters are output which would back the
cursor up before the beginning of the line, text which
follows the backspace characters appears on the next line.
Text should appear on the same line.
2-18
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
o For asynchronous configurations, characters are sometimes
lost when typing ahead.
o The following information applies to IBM PCs only:
- VT100 emulation on IBM PCs does not fully emulate a
VT100. Double height and double width text cannot be
displayed, 132 character width mode cannot be selected,
not all character attributes are available, and the local
printer is not supported.
- The first ALL-IN-1 screen leaves the cursor in the wrong
place. Typing carriage return properly positions the
cursor.
- Not all character attribute escape sequences work
properly. Both black and white and color have some
problems.
- After exiting from SETHOST on an IBM PC, some screen
attributes are not reset to their state before running
SETHOST, such as color and cursor format.
2.9.2 LAT ONLY
o Use of the @ command for batch input is not fully supported
by ULTRIX and RSX hosts.
o Use of the @ command for batch input is supported by VMS
hosts. However, it will not work properly if the SET
TERM/INQ command is embedded in LOGIN.COM and the @ command
is used.
o VMS TDMS applications are supported under LAT connections.
VMS TDMS applications are not supported under CTERM
connections.
2-19
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
o The following information applies to IBM PCs only:
- VT100 emulation on IBM PCs does not fully emulate a
VT100. Double height and double width text cannot be
displayed, 132 character width mode cannot be selected,
not all character attributes are available, and the local
printer is not supported.
- Not all character attribute escape sequences work
properly. Both black and white and color have some
problems.
- After exiting from SETHOST on an IBM PC, some screen
attributes are not reset to their state before running
SETHOST, such as color and cursor format.
o If backspace characters are output which would back the
cursor up before the beginning of the line, text which
follows the backspace characters appears on the next line.
Text should appear on the same line.
o Connections to RSX-11M-PLUS V3.0 can crash the system. This
problem is being solved by patches or future releases of RSX.
o Connections to RSX-11M-PLUS V3.0 can break. This problem is
being solved by patches or future releases of RSX.
o Connections to the Ethernet Terminal Server V2.1 (reverse
LAT) or earlier may break. This problem is solved by a
future release of the terminal server software.
o Connections to ULTRIX V1.2 (or earlier) systems can break.
This problem is solved by patches or a future release of the
ULTRIX software.
o If the NEW SESSION option is chosen after typing ^\<RET>
during a LAT session, SETHOST allows you to create a new
session. However, the existing LAT session is aborted.
(When a LAT session to a VMS host is aborted, your job
remains intact. The next time you log onto the VMS host, you
can reconnect to the same job.)
o When using <CTRL/S> and <CTRL/Q> to pause output, the
response may be slow. Pressing the <HOLD SCREEN> key (on the
Rainbow) or the <ALT/F1> key (on an IBM PC) is faster, but
the response is still not immediate.
2-20
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
o To send <CTRL/\> to the host system, be sure to repeat the
sequence twice. If you only do this once, SETHOST waits for
you to press the <RETURN> key.
o If you use /CTERM/SAVE, you can only get back to using LAT by
deleting the file SETHOST.DEF.
2.10 NDU - Network Device Utility
o When the NDU CLOSE command is issued for a remote virtual
disk file which resides on a personal computer running FAL,
FAL will report the "broken pipe" error message. This is
only a warning; no error has occurred.
o If a virtual disk file is created with one NDISK file
specification and then an attempt is made to delete the
virtual disk file using the command:
____ ____
DELETE NODE node NDISK file
with a different file specification which references the same
file (using logical names, for example), the delete function
will fail. Always delete the virtual disk using the same
file specification that it was created with if the delete is
done for a connected disk.
2.10.1 NPDRV - Virtual Printer Driver
o If the remote FAL makes an error, the Rainbow or IBM PC may
hang. This will very seldom occur.
o On IBM PCs use of the virtual printer by the background print
spooler may hang the system.
2-21
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
2.10.2 NDDRV - Virtual Disk Driver
o If the remote FAL makes an error, the Rainbow or IBM PC may
hang. This will very seldom occur.
2.11 NCP - Network Control Program
o Setting the state of the line to OFF in an asynchronous
configuration will shutdown network processing, but will NOT
hang up the phone, even if the circuit's modem parameter is
set to full. If you must hang up the phone under program
control, use the NCP command:
_______ ____ _____ ______
NCP>SET LINE STATE HANGUP
o The executor transmit and receive passwords and the remote
node access control strings may be quoted or unquoted.
Unquoted strings are forced to uppercase.
o Please be aware that some combinations of settings for buffer
sizes, buffer counts, and timers may cause performance
problems or network failures. Please change network
parameters only to solve specific problems. If new problems
occur as a result, change back to the default settings.
2-22
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
o If you plan to use the SET KNOWN NODES FROM REMOTE command,
be aware that in a large network, the resulting node database
can be so large that the search time during connections can
be very long. In a large network, consider only defining the
nodes you access frequently.
o When entering quoted strings as part of the command line
arguments, the quotes are removed. For example:
_______ ______ ____ _______
NCP>SET ACCESS USER "bence"
With the quotes removed, this results in:
_______ ______ ____ _____
NCP>SET ACCESS USER bence
The username bence is then forced to uppercase.
2-23
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
2.12 NTU - Network Test Utility
o The LOOP EXECUTOR command requires 3 free sockets for
successful execution. If only one (or no) socket is
available, a proper error message is returned. If exactly
two sockets are available, NTU reports: "time-out waiting
for connect". This does not indicate a failure of the
network.
o The LOOP CIRCUIT commands for Ethernet configurations may
fail to loop some messages. This does not indicate that
there is a problem which needs to be corrected. Personal
computers may lose messages at times. DECnet automatically
retransmits lost messages, but the circuit loopback
architecture does not.
o Access control strings may be quoted or unquoted. Unquoted
strings are forced to uppercase.
o LOOP CIRCUIT to the DECnet Router Server V1.0/V1.1 will fail.
This does not indicate an error. There is no loop circuit
server software in the asynchronous router server product.
2-24
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
2.13 TFA - Transparent File Access
o One can use TFA to type and copy files as follows:
TYPE \\f\node\\filespec
COPY local-file \\f\node\\remotefile
TYPE \\f\node\\remotefile >localfile
o TFA supports only one open file at a time.
2.14 TTT - Transparent Task-to-Task
o TTT supports up to 4 logical links at one time.
2.15 DTR/DTS
o DTR and DTS are tools used to test the network and measure
its performance. The documentation set does not include
documentation for DTR or DTS. However, the fourth floppy in
the distribution kit contains the file DTS.TXT which
describes the use of these tools.
o Interrupt tests to TOPS-20 systems do not work properly.
o DTS on a personal computer reports sequence errors during
echo tests, both to VAXes and to other personal computers.
2.16 MAIL
o MAIL.EXE can only SEND mail to remote nodes. It cannot
receive mail.
o If one attempts to send a non-ASCII text file as a mail
message, MAIL will not produce a useful error message, but
instead will behave erratically.
2-25
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
2.17 FAL (File Access Listener)
o FAL does incoming access checking only if the file DECACC.DAT
exists in the DECnet database path. Such a file is created
the first time the NCP SET ACCESS command is issued. If no
such file exists, or if you have not issued the SET ACCESS
command, the system's files are available to any and all
incoming access requests while FAL is running.
The DECACC.DAT file is deleted if the NCP command CLEAR KNOWN
ACCESS is issued. Note that if one clears all entries using
____
the NCP command CLEAR ACCESS USER user, the file will still
exist, but have no entries. In this case, FAL will do access
checking, but allow access to no users.
o Since MS-DOS is a single tasking operating system, FAL must
run to the exclusion of all other application programs.
o Some hosts may use as many as 4 logical links to perform a
single file access function. If you plan to run FAL, it is
suggested that you increase the number of logical links
supported. Type:
__________ ________ _______ _____ _
NCP>DEFINE EXECUTOR MAXIMUM LINKS 8
o Because MS-DOS path specifications contain the backslash
character and directory names and file names have the same
syntax, VMS cannot use path specifications without being
surrounded with double quotes. In addition, a number of
restrictions apply when using quoted file specifications in
VMS. To solve all these problems, FAL accepts VMS syntax for
file specifications:
$ DIR MSDOS::\TEST\*.C will fail
$ DIR MSDOS::"\TEST\*.C" will work
$ DIR MSDOS::[TEST]*.C will work
VMS does not understand that \foo is sometimes a file and
sometimes a directory. To avoid the problems that this
causes, always specify file names or use VMS syntax:
$ DIR MSDOS::"\" will fail
$ DIR MSDOS::"\*.*" will work
$ COPY *.FOO MSDOS::"\DIR" will fail
$ COPY *.FOO MSDOS::"\DIR\*.*" will work
$ COPY *.FOO MSDOS::[DIR]*.* will work
2-26
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
VMS does not properly separate the parts of a file
specification when it does wildcarding. As a result,
wildcard copies of files from a personal computer to VMS
using VMS DCL cannot be done using MS-DOS file syntax. Such
copies must be done using VMS file syntax:
$ COPY MSDOS::"\WORK\*.*" *.* will fail
$ COPY MSDOS::[WORK]*.* *.* will work
o FAL does NOT do file locking. If you will be using FAL for
simultaneous access to the same file, insure that all users
of the file open the file for reading ONLY. If two users
attempt to open the same file for simultaneous write,
unpredictable results may occur.
o If FAL is run under the SPAWNER, file access from VMS systems
using file lists may fail after the first file. Wildcard
file access is supported.
o When the NDU CLOSE command is issued for a remote virtual
disk file which resides on a personal computer running FAL,
FAL will report the "broken pipe" error message. This is
only a warning; no error has occurred.
o Trapping of hard device errors works for all IBM PCs. Hard
device errors that occur on a Rainbow will cause FAL to stop.
When FAL stops due to a device error, all its sockets are
still active. Use the NCP command "SET KNOWN LINKS STATE
OFF" to abort FAL's links and sockets before starting FAL
again.
2-27
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
2.18 DIP - DECnet-DOS Installation Procedure
1. The following information applies to Rainbows only:
- The files DNPETHRB.EXE and LAT.EXE are not a part of the
DECnet-Rainbow product, but are included on the floppies.
Do not copy these files to your Rainbow.
- If you choose to install DECnet files to floppies (such
that loading of NDDRV.SYS and NPDRV.SYS will be from a
floppy on system reboot), DIP will insert a dummy --
DEVICE=<x>:<path>DECDIP.SYS -- command line in CONFIG.SYS
because MS-DOS will fail on loading the first driver but
will succeed on loading subsequent drivers specified.
- Due to problems with MS-DOS and <CTRL/C> interrupt
handling, if a user enters a <CTRL/C> while in DIP and
chooses to "terminate" DIP, any saved answers will not be
written to a saved answer file. The only way to produce
a saved answer file is by running DIP to completion and
saving answers "normally".
- Numerous <CTRL/C>s may cause unpredictable results.
2. The display of disk usage after copying DECnet files is
incorrect when copy path and database paths are specified to
be on different devices.
3. If installing DECnet V1.1 and DECnet V1.1 has already been
installed at least once, database files do not have to be
deleted from the DECnet default database path (for example,
*.DAT).
4. If DIP is used to install DECnet, an existing DECPARM.DAT (if
found in the specified DECnet database path) will be deleted
automatically.
2-28
SOLVING PROBLEMS, RESTRICTIONS, AND HINTS
2.19 C Programming Library
o dnet_conn():
This function's first argument is a node specification
string, such as a node name or node address. If the string
is a node address, no default access control information will
be passed with the connect request. For example, the local
node's remote node database will not be searched to find
access control information that may be set up for this remote
node address.
o It is necessary to recompile/reassemble the V1.1 library
sources and produce a new library against which utilities can
be relinked. This will help to ensure that any
inconsistencies or incompatibilities that exist from V1.0
will go away.
o The C code in the programming library uses long variable
names. Be sure that your compiler can compile such sources.
o Functions required for DECnet network I/O are documented in
__________ ____________ _________ ______
the DECnet-DOS Programmer's Reference Manual. In addition to
these documented functions, many other undocumented 'support'
functions are included as part of the C programming interface
library found on the last kit floppy (DNETLIB.SRC).
2-29
CHAPTER 3
MODEM CONTROL
The information in this chapter is provided for people who want to
know how modem control is implemented. The information is intended
for people who understand modem operations.
3.1 Using Modem Control
To use modem control for DECnet on your personal computer, you should
make sure that cables and connections conform to the EIA RS-232-C and
CCITT V.28 and V.24 standards. (Refer to Section 3.3 of this guide
for information about the cables and interface leads to use with these
standards.)
The following assumptions have been made for this release of
DECnet-DOS:
o Connections that were established before turning the line
state ON will be maintained.
o Connections that still exist when turning the line state OFF
will be maintained (unless the data set is specifically
commanded to hangup).
You should also be aware of the following information:
o In the United Kingdom (UK), the R1 relay in modem number 2B
is held up for approximately 2 seconds in order to bridge the
gaps in the ringing signal. For proper operation in calls
that are automatically answered, the 2-second hold up
requires that the amount of time from DSR=ON through DTR=OFF
and back to DSR=ON be at least 5 seconds. This will avoid a
false second call seizure. (Refer to State 7 in Figure 3-1.)
3-1
MODEM CONTROL
o It is assumed that the terminal has two modes of operation:
- data leads only (modem control signals ignored)
- full modem control (modem control signals acknowledged)
The data leads only mode is used for local connections, such
as null modem applications. The proper mode signals are
simulated internally to allow the use of a single control
flow. You can choose between the two modes by using a set-up
parameter.
3.2 Modem States
Figure 3-1 shows the different states for the modem. (State 1 and
State 2 refer to power ON and internal self test functions, and are
omitted from this diagram for purposes of clarity.)
3-2
MODEM CONTROL
Power --> on from any state except off
| ||
______state 1_ OFFLINE Line state --> hangup or Line state -->
off
| | |
| DTR --> off |
| RTS --> off |
| TXD --> mark |
| | |
| | |
| ________________________
Disconnect DECnet from
hardware COM device
Line State=on ________________________
____________________
Connect DECnet to
hardware COM device
____________________
|
___ state 3_ IDLE
DTR --> on _________________________________
RTS --> on _____________ |
____________ | |
^ | |
| | |
| Modem Control=FULL Modem Control=NULL ?
| and DSR --> on ? (Data Leads Only)
| __________state 5_ __________state 4_
| Assume
| Start 30 sec DSR --> on
| and 1 sec CD --> on
| timers CTS --> on
| __________________ __________________
| | | |
| | | |
| | >1 sec and |
| | CTS --> on and |
| | CD --> on ? _______state 6_
| | | Data Exchange
| | | _______________
3-3
MODEM CONTROL
| | | |
| | ___________state 6_
| | Data Exchange
| | Transmit if CTS=on
| | Receive if CD =on
| | ___________________
| | |
| >30 sec or |
| DSR --> off ? |
| | DSR --> off or
| | CD --> off for >2 sec ?
| | |
| | |
| | |
| | |
| | |
| | |
| | _____________state 7_
| ---------> Disconnect
| DTR --> off
| RTS --> off
| TXD --> mark
| Start 5 sec timer
| _____________________
| |
| > 5 sec ?
|________________________________|
Figure 3-1: Modem States
The following sections explain the modem states that are detailed in
Figure 3-1.
3-4
MODEM CONTROL
3.2.1 General
The general states include:
o 1, OFF, or MARK - these relate to the negative voltage at the
interface pin.
o 0, ON, or SPACE - these relate to the positive voltage at the
interface pin.
3.2.2 State 1
This state is entered at power on.
3.2.3 State 2
This state is entered if the terminal is on-line.
3.2.4 State 3
This state exits unconditionally to State 4 if the data leads only
mode is selected. If the full modem control mode is selected, State 5
is entered (as soon as Data State Ready, DSR, has come on). The wait
for DSR is untimed. State 3 is the state an on line terminal is
normally in before connection has been established.
In State 3, the Data Terminal Ready (DTR) and Request to Send (RTS)
signals are turned on. In this state, the modem can switch itself
on-line only if DTR is ON. The RTS signal is needed by some modems to
prepare the transmit channel.
NOTE
In some cases (such as private wire), it is possible
for DSR to be ON before DTR is ON. This is possible
if there is a manual connection from the modem to the
line.
3-5
MODEM CONTROL
3.2.5 State 4
In this state, the actual signals from the modem are ignored and
forced internally ON (if the data leads only mode is selected). State
6 is then entered.
3.2.6 State 5
This state is entered only after Data Set Ready (DSR) has come ON.
This indicates that the modem is on-line. The modem can come on-line
either automatically or manually. It will come on-line automatically
if there is a call coming in through the automatic answer unit of the
modem. It will come on-line manually when you switch from voice to
data after you have established an incoming or an outgoing manual
call.
Once the modem is on-line, two timers are started. The timers are
called T1 and T2. The timers operate as follows:
o T1 protects against a non-data call. This is a PTT
requirement in Germany. If no data link has been established
within 30 seconds after the modem has gone on-line (State 6),
an automatic disconnect is initiated.
o T2 protects against data transfer within the first second
after the modem has gone on-line. This avoids garbage due to
transient effects in some older modems.
If Clear to Send (CTS) and Carrier Detect (CD) have both come ON, the
link is considered established.
3.2.7 State 6
This state is the normal data exchange state of the terminal when the
call is established.
3.2.8 State 7
This is the disconnect state. The disconnect is initiated by loss of
carrier (CD) for greater than 2 seconds, or by the loss of Data Set
Ready (DSR). The terminal waits 5 seconds, then a new connection is
anticipated by entering State 3. This sequence provides a proper
disconnection for all known modems.
3-6
MODEM CONTROL
Figure 3-2 illustrates the minimum implementation of the V.24 circuits
for full duplex modem control.
INTERNAL DTE ISO 2110 MALE V.24
SIGNAL NAME CONNECTOR PIN CIRCUIT
(TYPICAL) See State 7 NUMBER NUMBER
in Figure 2-1
PROT GND ----------------TT--------> 1 PROTECTIVE GROUND 101
TxD -------------|>-----------> 2 TRANSMITTED DATA 103
RxD -------------<|-----------> 3 RECEIVED DATA 104
RTS -------------|>-----------> 4 REQUEST TO SEND 105
CTS -------------<|-----------> 5 READY FOR SENDING 106
DSR -------------<|-----------> 6 DATA SET READY 107
SIG GND --------------------------> 7 SIGNAL GROUND 102
CD -------------<|-----------> 8 RECEIVED LINE 109
CARRIER DETECT
DTR -------------|>-----------> 20 DATA TERMINAL 108/2
READY
Figure 3-2: Minimum Implementation of V.24 Circuits for Full Duplex
Modem Control
3-7
MODEM CONTROL
3.3 Interface Requirements
The following tables specify the interface leads which are required to
use DECnet-DOS in asynchronous mode, either with a direct connection
or with a modem. (The DECnet software will not monitor the modem
leads when direct connection is specified. This allows for the
connection to a remote node using a null modem, a modem eliminator, or
null modem cable. These are cables and devices which may not provide
all the signal leads required for a modem connection.)
Following each table is a list of the part numbers for the DEC EIA
RS-232 communication cables which will provide these leads.
Table 3-1: Asynchronous Mode, Direct Connection
CCITT V.24 EIA RS-232-C
Pin No. Function Circuit No. Circuit No.
1 Protective Ground 101 AA
2 Transmit Data 103 BA
3 Receive Data 104 BB
7 Signal Ground 102 AB
Communication Cables:
BC22D 6 wire null modem cable (transmit and receive leads crossed
within cable, eliminating the need for a separate null modem
device.)
BC22E 16 wire modem cable
BC22F 25 wire modem cable
BCC14 16 wire modem cable (with thumb screw connectors)
BCC04 25 wire modem cable (with thumb screw connectors)
3-8
MODEM CONTROL
Table 3-2: Asynchronous Mode, Modem Connection
CCITT V.24 EIA RS-232-C
Pin No. Function Circuit No. Circuit No.
1 Protective Ground 101 AA
2 Transmit Data 103 BA
3 Receive Data 104 BB
4 Request to Send 105 CA
5 Clear to Send 106 CB
6 Data Set Ready 107 CC
7 Signal Ground 102 AB
8 Carrier Detect 109 CF
20 Data Terminal Ready 108/2 CD
Communication Cables:
BC22E 16 wire modem cable
BC22F 25 wire modem cable
BCC14 16 wire modem cable (with thumb screw connectors)
BCC04 25 wire modem cable (with thumb screw connectors)
3-9
MODEM CONTROL
3.4 Modem Option Selections
To use a modem with the asynchronous port, the modem must be
configured to match the line characteristics used by DECnet-DOS. For
many modems these will be the standard factory settings. Table 3-3
lists some of the user-selectable options you may find on your modem.
Table 3-3: User-selectable Modem Options
Setting for Use with
Option Description DECnet-DOS
Character Length No. of bits used to 10 bits -
encode a character. 8 data bits, 1 start
bit, and 1 stop bit.
Speed Indicate/Select Indicate mode: modem Indicate mode. (Pin
indicates modem 23, CCITT V.24 111,
speed on pin 12 is never asserted and
(CCITT V.24 112). pin 12, CCITT V.24
112, is not monitored
by DECnet-DOS.)
Receive Responds to Allows modem to Enabled (if you want
RDL respond to a remote to allow a remote
digital loopback modem test).
test request.
Other selectable modem options should be set according to the modem
user's guide for the particular modem application you are using.
(Other options include a public switched line, a leased line,
asynchronous or synchronous mode, etc.).
3-10
Downloaded From P-80 International Information Systems 304-744-2253