Digital PDFs

AA-GV32A-TY

April 1986

70 pages

Original

0.8MB

Document:	DECnet-DOS V1.1 Mini-Reference Guide
Order Number:	AA-GV32A-TY
Revision:	0
Pages:	70
Original Filename:	AA-GV32A-TV_DECnet-DOS_V1.1_Mini-Reference_Guide_Apr86.pdf

OCR Text

DEC net-DOS
Mini-Reference Guide
Order No. AA-GV32A-TV
April 1986
This document contains quick reference information on the commands and
command syntax for DECnet-DOS utilities. The utilities and their commands
(or parameters and switches) are listed in alphabetical order by utility.
Supersession/Update Information:
Operating System and Version:

Software Version:

This is a new manual.
MS-DOS V2.11
PC DOS V2.10
PC DOSV3.10
DECnet-DOS V1 .1
DECnet-Rainbow V1.1

AA-GV32A-TV
First Printing, April 1986

The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this
document.
The software described in this document is furnished under a license and may only be used or copied in accordance with the
terms of such license.
No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital or its affiliated
companies.
Copyright © 1986 by Digital Equipment Corporation
The postage-prepaid Reader's Comments form on the last page of this document requests the user's critical evaluation to
assist us in preparing future documentation.

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

~D~DD~D
MASSBUS

PDP
P/OS
Professional
Rainbow
RSTS
RSX
RT
ULTRIX

ULTRIX-32
ULTRIX-32M
UNIBUS
VAX
VAXcluster
VMS
VT
Work Processor

MS™ and XENIX™ are trademarks of Microsoft Corporation.
IBM is a registered trademark of International Business Machines Corporation.
PC/XT and Personal Computer AT are trademarks of International Business Machines Corporation.
This manual was produced by Networks and Communications Publications.

FAL SWITCHES
The File Access Listener (FAL) provides a way for you to let other nodes access files on your node. The purpose of the FAL utility is to listen for
and receive remote access requests from the network. When FAl detects a request to copy a file from your node, it first checks the type of
access privilege contained in the request. If it has the proper privilege for access to your node, FAl sends the file data back to the requesting
node. You can control the way FAl operates by using switches.
Format
FAl [/switchl
Valid FAl switches are:
IASCII (fA)
IBINARY(fB)
IERROR(/E)
IlOG (/l)
To use these switches,"you must type them on the command line after the FAl command.
IASCII
When you use the IASCII switch, all files are transferred as ASCII files.
Format
IASCII

fBI NARY
When you use the fBI NARY switch, all files are transferred as binary (or image) files.

Format
fBINARY
fERROR
When you use the fERROR switch, FAL will report an error to the remote node if the requesting node is attempting to overwrite an existingfile.

Format
fERROR
fLOG
When you use the fLOG switch, FAL logs the type of access contained in every request it receives. The information is displayed on the
screen in front of you. If you do not want the information to appear at your terminal, you can redirect it to an output file.

Format
fLOG:filename

MAIL COMMANDS
The MAIL utility lets you send mail messages and text files to other nodes in the network. The MAIL commands are:
EXIT
HELP
MAIL
SEND
EXIT
The EXIT command allows you to leave the Mail utility.

Format
EXIT
HELP
HELP provides information about the MAIL commands and switches.

Format
HELP [topic]

Mail HELP topics and qualifiers include:
IEDIT
EXIT
INITFILE
MAIL

MAIL Examples
SEND
SEND Examples
ISUBJECT

MAIL and SEND
Both the MAIL command and the SEND command alloyv you to send mail messages and text files to other users in the network. These
commands may be used interchangeably.
Format
MAIL[lswitch] [filename]

Valid MAIL or SEND switches are:
IEDIT
ISUBJECT

MAIL PARAMETERS

When you first start the MAIL utility, you are prompted for information. The MAIL program uses this information each time you run the utility.
The information is stored in the initialization file (INIT file) called MAIL.DAT. The INIT file contains some or all of these mail parameters:
REPLYJDDRESS
DEFAULT_NODE
CARBON_COPY
EDITOR
PERSONAL-MESSAGE
REPLYJDDRESS
You must define the REPLYJDDRESS parameter when you first run the Mail utility. This is necessary for other users to have a way to
respond to your messages or to send you mail. The REPLYJDDRESS appears as part of the" Reply to" information string.
Format

REPLYJDDRESS = nodename::username

DEFAULT_NODE allows you to shorten the address for nodes that you address often. Once you have defined the DEFAULT_NODE
in the INIT file, you can send mail to any user on that node simply by specifying their user name.
Format

DEFAULT_NODE = nodename

CARBON_COPY is the address to which a copy of your mail message is sent. Each time you send a mail message, a copy of that message automatically goes to the CARBON_COPY address.
Format
CARBON_COPY = nodename::username
EDITOR
EDITOR specifies which editor the mail program will use when you want to edit mail messages. You must include the IEDIT switch with a
mail command if you want to edit a message or a text file before you send it.
Format
EDITOR = pathname
PERSONA~MESSAGE

The PERSONA~MESSAGE is a message that other users see whenever you send them mail. The message can contain your name
and phone number, or it can be any other descriptive text you wish to create.
Format
PERSONA~MESSAGE = descriptive text

NCP COMMANDS
The Network Control Program (NCP) is the DECnet management utility that accepts commands from your terminal to perform certain network
functions. The NCP commands let you identify your node to other nodes in the network, establish node names and default access control
information for other nodes, change network parameters, and monitor network activity and network error counters.
The NCP commands are:
CLEAR ACCESS
CLEAR EXECUTOR
CLEAR NODE
COpy KNOWN NODES
DEFINE CIRCUIT
DEFINE EXECUTOR
DEFINE LINE
EXIT
HELP
MONITOR LOGGING
QUIT
READ LOGGING
SET ACCESS
SET CIRCUIT
SET ECHO
SET EXECUTOR

SET LINE
SET LINK
SET KNOWN LINKS
SET NODE
SHOW ACCESS
SHOW CIRCUIT
SHOW EXECUTOR
SHOWLAT
SHOW LINE
SHOW LINKS
SHOW NODE
ZERO CIRCUIT
ZERO EXECUTOR
ZEROLAT
ZERO LINE

CLEAR ACCESS
The CLEAR ACCESS command removes access information for the designated user or for all users. The access information is stored
on a per user basis. It includes the password and access type. FAL uses this information to validate local file access.
Format
CLEAR ACCESS USER username
or
CLEAR KNOWN ACCESS
CLEAR EXECUTOR
The CLEAR EXECUTOR command removes specified executor node parameters from the local node's database.
Format
CLEAR EXECUTOR [RECEIVE PASSWORD ]
TRANSMIT PASSWORD

NOTE
These passwords are used for asynchronous DDCMP connections only.

CLEAR NODE
The CLEAR NODE command removes parameters stored on the local node for either the specified remote node or all remote nodes
known to the local node.
Format

CLEAR KNOWN NODES
or
CLEAR NODE node-id [ALL
]
USER
PASSWORD
ACCOUNT
LAT-HOST
COpy KNOWN NODES
The COPY KNOWN NODES command copies the node database to a file, leaving out any access information that may be contained in
the database.
Format

COpy KNOWN NODES TO file-id

DEFINE CIRCUIT
The DEFINE CIRCUIT command defines the characteristic for the circuit state (ON or OFF). The state you indicate will not take effect
until the next time you reboot your system.
Format

DEFINE CIRCUIT STATE [ON
OFF
DEFINE EXECUTOR

The DEFINE EXECUTOR command sets executor characteristics. These characteristics will not take effect until the next time you
reboot your system.
Format
DEFINE EXECUTOR

ADDRESS node-address
MAXIMUM BUFFERS number
MAXIMUM LINKS number
NAME node-name
SEGMENT BUFFER SIZE number

DEFINE LINE
The DEFINE LINE command defines the state of the line. It becomes effective with the next system reboot.

Format
DEFINE LINE STATE [ON ]
OFF
RECEIVE BUFFERS n
EXIT
The EXIT command allows you to exit from NCP and save parameter changes.

Format
EXIT
HELP
The HELP command displays information about NCP commands on your screen.

Format
HELP [command-verb [entity]]

MONITOR LOGGING
The MONITOR LOGGING command displays network events as they are being logged. You can stop the display of information logging
by pressing any key on the keyboard. You can also use (CTRUC I to stop the display and exit from NCP at the same time.

Format
MONITOR LOGGING [TO file-id]
QUIT
The QUIT command allows you to exit from NCP, and gives you the choice of saving or deleting any parameter changes you may have
made. If you have not made any changes, NCP simply exits. If you have made changes, NCP issues a prompt for you to verify whether or
not you want to save those changes.

Format
QUIT
READ LOGGING
The READ LOGGING command displays the contents of the event logging buffer. It may be redirected to a specified output file.

Format
READ LOGGING [TO fi/e-id)

SET ACCESS
The SET ACCESS command sets incoming access information for the designated user. The access information is stored on a per user
basis, and it includes the password and access type.
Format
SET ACCESS USER username
PASSWORD passwordl
[ access-type

There are four types of access. They are:
NONE - no access for this user. This is the default.
READ - provides read only access.
WRITE - provides write only access.
ALL - provides both read and write access.

SET CIRCUIT
The SET CIRCUIT command defines or modifies circuit information.
Format

SET CIRCUIT [circuit-id]

[

HELLO TIMER secondS]
OWNER fDECnet]
lMOP
SERVICE fDISABLED]
lENABLED
STATEfON 1
lOFFJ

SET ECHO
The SET ECHO command determines whether a redirected input file is displayed on your screen as the file is executed. The default is
OFF (no echo).
Format

SET ECHO fON
lOFF

SET EXECUTOR
The SET EXECUTOR command sets the executor node's parameters or characteristics.
Format
SET EXECUTOR

ADDRESS node-address
DELAY FACTOR number
DELAY WEIGHT number
IDENTIFICATION id-string
INACTIVITY TIMER seconds
INCOMING TIMER seconds
NAME node.-name
OUTGOING TIMER seconds
RECEIVE PASSWORD password
RECEIVE PIPE QUOTA number
RETRANSMIT FACTOR number
SEGMENT BUFFER SIZE bytes
STATE ON
TRANSMIT PASSWORD password
TRANSMIT PIPE QUOTA number

SET KNOWN (or ACTIVE) LINKS
The SET KNOWN (or ACTIVE) LINKS command breaks all link connections that are not set with the socket option, SO_KEEPALlVE,
and frees the associated sockets.
Format
SET [KNOWN LINKS] STATE OFF
ACTIVE LINKS
SET LINE
The SET LINE command defines or modifies line information.
Format
SET LINE [line-id]

DEVICE [COM_1]]
COM-2

(

MODEM [NULL]
FULL
SPEED baud-rate

STATE[g~J
NOTE

Information for DEVICE, MODEM, and line SPEED applies to asynchronous DDCMP configurations only.

SET LINK
The SET LINK command terminates logical link connections that are associated with a specific socket. The socket is also detached.
Format
SET LI NK socket STATE OFF
SET NODE
The SET NODE command assigns a node name plus access control information to a unique node address.
Format
SET [NODE node-address NAME node-name [acceSS-infO]]
[LAT-HOST]
KNOWN NODES FROM node-id
NODE node-id FROM node-id

SHOW CIRCUIT
The SHOW CIRCUIT command displays all the information you set with the SET CIRCUIT command, as well as certain system information. You can either display the information on your screen or redirect it to an output file at the local node.
Format

SHOW CIRCUIT [circuit-idJ [CHARACTERISTICS] [TO file-idJ
COUNTERS
STATUS
SUMMARY
SHOW EXECUTOR
The SHOW EXECUTOR command displays the executor node information. You can either display the information on your screen, or
redirect it to an output file at the local node.
Format

SHOW EXECUTOR [CHARACTERISTICS] [TO file-idJ
COUNTERS
STATUS
SUMMARY

SHOW KNOWN ACCESS
The SHOW KNOWN ACCESS command displays the contents of the incoming access database, which is stored in the file
DECACC.DAT. If a password is part of the database, it only appears on the screen as three dots (... ).
Format

SHOW KNOWN ACCESS [TO file-id]
SHOWLAT
The SHOW LAT command displays information about the LAT line you may be using. The information may be directed to a file. This
command only works if you have LAT installed on your node.
Format

SHOW LAT [COUNTERS] [TO file-id]

SHOW LINE
The SHOW LINE command displays line information. You can either display the information on your screen or redirect it to an output file
at the local node.
Format
SHOW LINE [Iine-id] [CHARACTERISTICS] [TO file-id]
COUNTERS
STATUS
SUMMARY
SHOW LINKS
The SHOW LINKS command displays summary type information for the specified logical links.
Format
SHOW (KNOWN LINKS) [TO fife-id]
ACTIVE LINKS

SHOW NODE
The SHOW NODE command displays remote node information. You can either display the information on your screen, or redirect it to
an output file at the local node.
Format
SHOW NODE node-id [STATUS ] [TO file-idj
SUMMARY
or
SHOW [KNOWN NODES ]
ACTIVE NODES
ADJACENT NODE
ZERO CIRCUIT
The ZERO CIRCUIT command zeroes the counters for the circuit.
Format
ZERO CIRCUIT [circuit-idj [COUNTERS]
ZERO EXECUTOR
The ZERO EXECUTOR command zeroes the counters associated with and maintained on the executor node.
Format
ZERO EXECUTOR [COUNTERS]

ZEROLAT
The ZERO LAT command zeroes the counters for the LAT line. This command only works if you have LAT installed on your node.
Format
ZERO LAT [COUNTERS]
ZERO LINE
The ZERO LINE command zeroes the counters for the line.
Format
ZERO LINE [line-idJ [COUNTERS]

NDUCOMMANDSFOR~RTUALD~KS

The Network Device Utility (NDU) allows you to access up to four virtual disk volumes at a time. Each remote volume is a file that is treated as if
it were a hard disk.
The following NDU commands allow you to control the use of remote files as virtual disk volumes.
CLOSE
The CLOSE command ends the connection between the specified drive and the virtual disk file on the remote node.

Format
CLOSE DRIVE drive
or
CLOSE NODE node-name NDISK file-name

CREATE
The CREATE command creates and formats a new remote data file, which is treated as a hard disk, and establishes a connection
between a volume name at your local node and the file.
Format
CREATE NODE node-name NDISK file-name

DRIVE drive
]
USER access-info

ACCESS[:~
[

ALLOCATION n
MAXn

DELETE
The DELETE command deletes an existing virtual disk file on a remote node.
Format
DELETE NODE node-name NDISK file-name [USER access-info]
or
DELETE DRIVE drive

HELP
The HELP command displays information about NDU commands and entities.
Format
HELP [Co"!mand-Verb]

entity
OPEN
The OPEN command establishes a connection between your local node and an existing virtual hard disk at a remote DECnet node.
Format
OPEN NODE node-name NDISK file-name [DRIVE drive
]
USER access-info

ACCESS[:~
SHOW
The SHOW command causes NDU to report on the status of all virtual disk(s) and printer.
Format
SHOW STATUS

NDU COMMANDS FOR VIRTUAL PRINTERS

The Network Device Utility (NDU) allows you to access one virtual printer at a time. The remote node which provides the virtual printer saves
any text you output to the printer device NPRN in a temporary file. When you stop using the virtual printer, the temporary file is queued for
printing at the default printer on the remote node.
The following NDU commands allow you to direct text to a remote node to be queued for printing at a later time.
CLOSE
The CLOSE command ends the connection between the device NPRN and the file on the remote node. The file is then queued to be
printed on the remote printer. After the file is printed, it is deleted.
Format

CLOSE PRINTER
CREATE and OPEN
The CREATE and OPEN commands function in the same way. Either command creates a new virtual printer file and makes it ready for
use. The printer file is created and then linked to the device NPRN.
Format

CREATE PRINTER NODE node-name [NPRINT file-name] [USER access-info]
OPEN PRINTER NODE node-name [NPRINT file-name] [USER access-info]

HELP
The HELP command displays information about NDU commands on your screen.
Format
HELP [Co"!mand-Verb]

entity
SHOW
The SHOW command causes NDU to report on the status of all virtual disk(s) and printer.
Format
SHOW STATUS

NFT COMMANDS
The Network File Transfer Utility (NFT) is a network program that allows you to access remote files. Using NFT, you can copy files between the
local node and remote nodes, delete local and remote files, display remote file contents, run batch files on remote nodes, and print files on
remote printers.
The following NFT commands allow you to perform operations on local and remote files.
APPEND
The APPEND command adds the contents of one or more input files to the end of an existing output file. You can append either ASCII or
binary files to or from remote nodes.
Depending on its position in a command, a file specification is either input (source) or output (destination).

Format
APPEND(/switch] input-file output-file
or
APPEND[lswitch]
File(s)? input-file
To?
output-file

Valid APPEND switches are:
IASCII
IDELETE
/IMAGE
INOLOG
IPRINT
ISUBMIT

COPY
The COPY command creates a new file or a new version of a file at the destination node. You can use the COpy command to copy files
from the local node to the remote node, and from the remote node to the local node.
Format
COPY[/switch] input-file [output-file]
or
COPY[/switch]
File(s)? input-file
To?
output-file

Valid switches to COpy to a remote node are:
IALLOCATION = nnn
IASCII
IBLOCK
ICC = xxx

IDELETE
IFIXED = nnn
/IMAGE
ILSA

IMACY11

IMRS = nnn
INOLOG
INOSPAN
IPRINT
ISUBMIT
!VARIABLE
!VFC = nnn

Valid switches to COPY from a remote node are:
IASCII
IBLOCK
/IMAGE
INOCONVERT
INOLOG

DELETE

The DELETE command deletes one or more specified local or remote files.
Format
DELETE[INOLOG] file-spec

or
DELETE[INOLOG]
File(s)? file-spec

DIRECTORY
The DIRECTORY command displays a list of local or remote file names, including the size (in blocks) and the time and date the file was
last modified or created.
Format
DIRECTORY[/switch] [file-spec]

Valid DIRECTORY switches are:
IBRIEF
IFULL

EXIT
The EXIT command exits from an NFT operation and returns control to the DOS operating system.
Format
EXIT
HELP
The HELP command displays information about NFT commands and switches on your screen.
Format
HELP [COmmand-Verb]
/switch
PRINT
The PRINT command queues a remote file to be printed on a remote printer. You must indicate the file to be printed. The file will be
printed on the system default printer.
Format
PRINT[/switch] file-spec

or
PRINT[/switch]
File(s)? file-spec
Valid PRINT switches are:
IDELETE
INOLOG
SET
The SET command allows you to set default access control information as well as disk and directory information for up to ten nodes.
There are no valid switches for the SET command.

Format
SET node-spec::[fi/e-spec]
or
SET
Node? node-spec::[fi/e-spec]
The node-spec in this case is a remote node name, followed by access control information (in quotation marks). For example:

BERG I L "BURTON password"

SHOW
The SHOW command displays the temporary default table of remote access information for the specified node. The password is not displayed on the screen. Instead, the character string password is displayed in its place.
There are no valid switches for the SHOW command.
Format
SHOW [node-name::)
SUBMIT
The SUBMIT command requests that the specified command file be run on the remote node. The specified remote node must support
command file submission and execution.
Format
SUBMIT[/NOLOG) remote-filespec
or
SUBMIT[/NOLOG)
File(s)? remote-filespec

TYPE
The TYPE command displays the contents of a local or remote file on your screen. You should use this command for ASCII files only.

Format
TYPE file-spec
or
TYPE
File(s)? file-spec

NTU COMMANDS
The Network Test Utility (NTU) allows you to display information about your node and how it is interacting with the network. You can use NTU
to pinpoint problems you may have in connecting your node to the network. Since problems can occur in any of the network components, the
NTU commands let you perform various tests which check the operation of each component. The tests check the operation of your local node,
the connection to the remote node, and the communication hardware between them.

The NTU commands are:
CLEAR ACCESS
CLEAR ACCOUNT
CLEAR COUNT
CLEAR DEFAULTS
CLEAR LENGTH
CLEAR PASSWORD
CLEAR USER
CLEAR WITH
EXIT
HELP
LOOP CIRCUIT (DDCMP)
LOOP CIRCUIT (ETHER)
LOOP EXECUTOR
LOOP LINE CONTROLLER
LOOP NODE
MIRROR
MONITOR LOGGING
READ LOGGING
SET ACCOUNT
SET CIRCUIT
SET COUNT

SET ECHO
SET LENGTH
SET LINE STATE
SET LINK
SET PASSWORD
SET USER
SET WITH
SHOW ACTIVE LINKS
SHOW ACTIVE NODES
SHOW ADJACENT NODE
SHOW CIRCUIT
SHOW DEFAULTS
SHOW EXECUTOR
SHOW KNOWN LINKS
SHOW KNOWN NODES
SHOW LINE
SHOW NODE
ZERO CIRCUIT
ZERO EXECUTOR
ZERO LINE

CLEAR ACCESS
The CLEAR ACCESS command removes the user-id, password, and accounting information that was stored by a previous SET or
LOOP command.
Format
CLEAR ACCESS
CLEAR ACCOUNT
The CLEAR ACCOUNT command clears the accounting information that was stored by a previous SET or LOOP command.
Format
CLEAR ACCOUNT
CLEAR COUNT
The CLEAR COUNT command resets the number that indicates how many times you want to repeat a specific test to its default value
of 1.
Format
CLEAR COUNT

CLEAR DEFAULTS
The CLEAR DEFAULTS command resets all the loop back parameters to their original values, which are: null for user-id, password, and
account; 1 for COUNT; 40 for LENGTH; and MIXED for TYPE.
Format
CLEAR DEFAULTS
CLEAR LENGTH
The CLEAR LENGTH command resets the number that indicates the message length to its default value of 40.
Format
CLEAR LENGTH
CLEAR PASSWORD
The CLEAR PASSWORD command removes the password that was stored by a previous SET or LOOP command.
Format
CLEAR PASSWORD

CLEAR USER
The CLEAR USER command removes the user-id that you initially stored with the SET or LOOP command.
Format
CLEAR USER
CLEAR WITH
The CLEAR WITH command resets the binary format indicated for the test message to its default value of MIXED. (See SET WITH for
more details.)
Format
CLEAR WITH
EXIT
The EXIT command lets you leave NTU. Whenever you issue this command, NTU attempts to restore the DECnet line to the ON state.
(You can also use [CTRUZ XRET ) to exit from NTU.)
Format
EXIT

HELP
The HELP command provides information about the NTU commands. Entering HELP alone results in a display of the available commands. You can further qualify the information you seek by specifying HELP followed by a command name (and optionally an entity).

Format
HELP [command_verb [entity)]
LOOP CIRCUIT (for Asynchronous DDCMP Configurations)
The LOOP CIRCUIT command invokes loop tests for the DECnet circuit. These tests verify that network communication is possible
between your local node and the adjacent node, or between your local node and a local or a remote modem.
For asynchronous DDCMP configurations, this command causes NTU to run a loopback test to a loopback plug, a modem, or an adjacent node. When you issue this command, NTU displays a menu for you to select the location of the loopback connector.

Format
LOOP CIRCUIT [COUNT n] [WITH ONES/ZEROES/MIXED] [LENGTH n]

LOOP CIRCUIT (for Ethernet Configurations)
The LOOP CIRCUIT command invokes loop tests for the DECnet circuit. These tests verify that network communication is possible
between your local node and a remote node.
For Ethernet configurations, this command causes NTU to run a loop back test to a specific Ethernet address or to a multicast Ethernet
address.
Format
LOOP CIRCUIT [WITH ONES/ZEROES/MIXED] [LENGTH n] [COUNT n]
or
LOOP CIRCUIT NODE node-id
[WITH ONES/ZEROES/MIXED] [LENGTH n] [COUNT n]
or
LOOP CIRCUIT PHYSICALADDRESS hh-hh-hh-hh-hh-hh
[WITH ONES/ZEROES/MIXED] [LENGTH n] [COUNT n]

LOOP EXECUTOR
The LOOP EXECUTOR command invokes the loop test for your local (executor) node. It verifies the operation of your local node by
checking the local network software. This test verifies that your local node software has been properly installed.
Format
LOOP EXECUTOR [COUNT n] [WITH MIXED/ONES/ZEROES] [LENGTH n]
LOOP LINE CONTROLLER
The LOOP LINE CONTROLLER command performs a loopback test within your local node, at the device level. This command can only
be used with Ethernet configurations, and requires the use of the DECNA loopback connector (part number 12-22196-01).
Format
LOOP LINE CONTROLLER

LOOP NODE
The LOOP NODE command invokes the loop test for the remote node. It verifies that your node can communicate with a specified
remote node. To perform this test, you need to include any network parameters that are necessary for accessing the loopback mirror on
the remote node. These parameters may include the node-id, the user-id, the password, and the account.
Format
LOOP NODE node-id

[

]
USER user-id
PASSWORD password
ACCOUNT account
COUNTn
WITH ONES/ZEROES/MIXED
LENGTHn

MIRROR
The MIRROR command allows a LOOP NODE test to be run from a remote system that supports the NCP loop node test (such as a
DECnet-DOS V1.1 system). The maximum size of a message that NCP will loop back is 512 bytes.
Format
MIRROR

MONITOR LOGGING
The MONITOR LOGG ING command displays network events as they are being logged. You can stop the display of information logging
by pressing any key on the keyboard. You can also use (CTRUC ) to stop the display and exit from NTU at the same time.

Format
MONITOR LOGGING [TO file-icl]
READ LOGGING
The READ LOGGING command causes the system to display information about network events that is contained in the event logging
buffer. These events are logged continuously. READ LOGGING lets you read the most current network information.
The information appears on the screen in front of you, or you can redirect the output to a specific file.

Format
READ LOGGING [TO file-icl]
SET ACCOUNT
The SET ACCOUNT command lets you specify the account to use for accessing the mirror on a remote node. You can use up to 39 characters to define the account.

Format
SET ACCOUNT account

SETCIRCUIT
The SET CIRCUIT command defines or modifies circuit information.
Format

secondS]

SET CIRCUIT [circuit-id]

(

HELLO TIMER
OWNER [DECnet]
MOP
SERVICE [DISABLED]
ENABLED
STATE[ON]
OFF

SET COUNT
The SET COUNT command lets you specify the number of times to repeat any of the NTU tests. The default value is 1, but you can
change this at any time using SET COUNT. You can assign any value that is in the range of 1 to 32,767.
Format
SETCOUNTn

SET ECHO
The SET ECHO command determines whether a redirected input file is displayed on your screen as the file is executed. The default is
OFF (no echo).
Format

SET ECHO [ON
OFF
SET LENGTH

The SET LENGTH command lets you specify the length of the test messages to be sent over the network. The default value is 40, but
you can change this at any time using SET LENGTH. You can assign any value from 1 up to 512.
Format
SET LENGTH n
SET LINE STATE
This command allows you to turn the state of the line to OFF or ON. The line is the communication path that connects your node to the
adjacent node.
Format

SET LINK
The SET LINK command terminates logical link connections that are associated with a specific socket. The socket is also detached.

Format
SET LINK socket STATE OFF
SET PASSWORD
The SET PASSWORD command lets you specify the password to use for accessing a mirror on the remote node. You can use up to 39
characters to define the password.

Format
SET PASSWORD password
SET USER
The SET USER command lets you specify the access control information necessary for accessing the mirror on the remote node. You
can set either the user's name or the user's node address with this command. (If you decide to provide the user's name, you must also
provide the appropriate password for that name.)

Format
SET USER user-id

SET WITH
The SET WITH command lets you specify the type of format to use for sending loopback messages. The format is always binary (ONES
and ZEROES), but you have a choice as to how the binary numbers are arranged. There are three ways to arrange the binary format:
All ONES (11111111)
All ZEROES (00000000)
Mixed ONES and ZEROES (01010101)
The default format is MIXED.

Format
SET WITH (ONES ]
ZEROES
MIXED
SHOW ACTIVE LINKS
The SHOW ACTIVE LINKS command displays summary type information for all active links between the executor node and the adjacent node (or other remote nodes with active logical links to your node).

Format
SHOW ACTIVE LINKS [TO fi/e-id]

SHOW ACTIVE NODES
The SHOW ACTIVE NODES command displays the executor node, the adjacent node, and a list of all the nodes that currently have
active links to your local node.

Format
SHOW ACTIVE NODES [TO file-id]
SHOW ADJACENT NODE
The SHOW ADJACENT NODE command displays information for the adjacent node.

Format
SHOW ADJACENT NODE [TO file-id]
SHOW CIRCUIT
The SHOW CIRCUIT command displays information about the specified circuit.

Format
SHOW CIRCUIT [circuit-id] [CHARACTERISTICS] [TO file-id]
COUNTERS
STATUS
SUMMARY

SHOW DEFAULTS
The SHOW DEFAULTS command displays all of the current default values set either by the system or with the SET or LOOP command.
SHOW DEFAULTS displays the values for the following:
Loop Count
Data Length
Data Type
User-id (if applicable)
Password (if applicable)
Account (if applicable)
Format
SHOW DEFAULTS

SHOW EXECUTOR
The SHOW EXECUTOR command displays information about the local node.

Format
SHOW EXECUTOR [CHARACTERISTICS] [TO file-id]
COUNTERS
STATUS
SUMMARY
SHOW KNOWN LINKS
The SHOW KNOWN LINKS command displays summary type information for all logical links known to the local node.

Format
SHOW KNOWN LINKS [TO file-id]
SHOW KNOWN NODES
The SHOW KNOWN NODES command displays a list of all nodes that are known to DECnet on your local node. You can set these
nodes by using NCP. You can perform NTU tests (those that require the use of node names) only to nodes that are known by your system.

Format
SHOW KNOWN NODES [TO file-id]

SHOW LINE
The SHOW LINE command displays information about the DECnet line (ASYNC-1 or ETHER-1) that you are using to communicate
over the network.
Format
SHOW LINE [line-id] [CHARACTERISTICS] [TO fi/e-id]
COUNTERS
STATUS
SUMMARY
SHOW NODE
The SHOW NODE command displays local information about a remote node, which you specify by its name or address. The node information appears on the screen in front of you.
Format
SHOW NODE node-id [STATUS ] [TO fi/e-id]
SUMMARY
ZERO CIRCUIT
The ZERO CIRCUIT command resets all the counters on the circuit to zero.
Format
ZERO CIRCUIT [circuit-id] [COUNTERS]

ZERO EXECUTOR
The ZERO EXECUTOR command resets all the counters for your local node to zero.

Format
ZERO EXECUTOR [COUNTERS]
ZERO LINE
The ZERO LINE command resets all the counters for your line to zero.

Format
ZERO LINE [line-id] [COUNTERS]

SETHOST PARAMETERS AND SWITCHES

The network virtual terminal utility (referred to as SETHOST) connects your system to a host node and allows your system to emulate (act like)
a terminal connected to the host node. Each time you connect or log on to a host, the connection is called a session.
There two techniques for connecting to a host node: LAT and CTERM. When SETHOST connects your node to another node, it checks to see
if you have a LAT driver installed. If so, SETHOST first attempts to connect your node to a LAT line. This is the default. If LAT is not available,
then SETHOST attempts to connect you using CTERM. You can select CTERM over LAT as the default by using the ICTERM switch.
The maximum number of concurrent sessions you can create depends on the number of network links you established with the NCP command, DEFINE EXECUTOR MAXIMUM LINKS. The number of sessions also depends on the number of links that are currently active.
SETHOST provides a command interface to create and modify different sessions. SETHOST also provides a menu interface which is displayed whenever a session is interrupted. This guide describes the switches used with the SETHOST command interface. For information
about the SETHOST menu, refer to the DECnet-DOS User's Guide.
The SETHOST command, its parameters, and various switches allow you to create, record, and modify your remote sessions. You can use
the parameters and the switches in the command line, or you can use them at the SETHOST prompt.
Format

SETHOST [node-spec or latservicename] [/switch]
NOTE

Any switches that can take arguments will accept q space, a colon (:), or an equal sign (=) as delimiters to separate the switch
from its argument.

IABORT
The IABORT switch lets you specify which session you want to abort. You can abort a single session or you can abort all the sessions. To
view the current sessions, use the ISHOW switch.

Format
IABORT=n
ALL
ICTERM
The ICTERM switch specifies that CTERM protocol be used for this connection. The default is to attempt to use LAT protocol first. If the
LAT attempt fails, the connection is made using CTERM. Only CTERM provides support for multiple sessions.

Format
ICTERM
IEDIT
The IEDIT switch controls the type of command line editing you can perform during your remote session. This switch only applies to
CTERM hosts or systems that support command line editing.

Format
IEDIT = edit-mode

The three editing modes are:
OVERSTRIKE
INSERT
NONE
IEXIT
The IEXIT switch lets you exit from SETHOST. You can enter the switch after you have typed the SETHOST command.
Format

IEXIT
IHElP
The IHElP switch displays the main help text screen for SETHOST.
Format

IHElP = topic
You can get help on the following topics:
@
node-spec
?
ISAVEDEFAUlT
IHElP
ISESSION
/TAKE IlOG
IEXIT
ISHOW
IEDIT IABORT
ICTERM
keyboard-layouts
context-switching
syntax
changing-default-line-editing-mode

LATSERVICENAME
The LATSERVICENAME parameter lets you specify the LAT service name to use for establishing a remote session.
Format
SETHOST latservicename
fLOG
The fLOG switch lets you record the terminal session in a log file. You can specify a file name for recording the session. If you do not
specify a name, the default file name is SESSION .LOG.
Format
fLOG:file-spec
NODE-SPEC
The NODE-SPEC parameter lets you specify the DECnet node name or DECnet node address to use for establishing a remote session.
Format
SET HOST node-spec

ISAVEDEFAULT
This switch lets you save the switch settings to be used as the default for all future sessions. The ISAVEDEFAULT switch only works with
the IEDIT and the ICTERM switches. If you use ISAVEDEFAULT and do not specify any switches to be saved, it has no effect.
When you use this switch, SETHOST places your specified defaults in a file called SETHOST.DEF in the DECnet directory. SETHOST
reads this file whenever you start the utility.

Format
ISAVEDEFAULT
ISESSION
The ISESSION switch specifies the session number to use for reconnection to a host. You can use the ISHOW switch to determine
which sessions are available. You can then use ISESSION to re-establish a connection to a particular session. This switch only applies
to CTERM hosts or systems that support multiple sessions.

Format
ISESSION=n

ISHOW

The ISHOW switch displays a list of the current sessions and the hosts that connect them to your node. This switch only applies to
CTERM hosts or systems that support multiple sessions.
Format
ISHOW

/TAKE
The /TAKE switch calis commands from a local file and sends them to the remote node's processor.
Format
/TAKE = file-spec
or

@fi/e-spec

DECnet-DOS
Mini-Reference Guide
AA-GV32A-TV

READER'S COMMENTS
What do you think of this manual? Your comments and suggestions
will help us to improve the quality and usefulness of our publications.

Please rate this manual:
Poor
1

Accuracy
Readability
Examples
Organization
Completeness

2
2
2
2
2

3
3
3
3
3

4
4
4
4
4

Excellent
5
5
5
5
5

Did you find errors in this manual? If so, please specify the error(s)
and page number(s).

General comments:

Suggestions for improvement:

Name
Title

Date _ _ __
Department _ _ _ _ _ __

Company
City

Street
State/Country

Zip Code

111111
BUSINESS REPLY LABEL
FIRST CLASS PERMIT NO. 33 MAYNARD MASS.
POSTAGE WILL BE PAID BY ADDRESSEE

SOFTWARE DOCUMENTATION
550 KING STREET
LITTLETON, MA01460-1289

NO POSTAGE
NECESSARY
IF MAILED
IN THE
UNITED STATES