DTS/DTR TEST PROGRAMS
dts and dtr are the DECnet-DOS transmitter and receiver test
programs.
1. Types Of Tests
There are four basic tests provided by dts and dtr:
o Connect test
o Data test
o Disconnect test
o Interrupt test
Each test is divided into a set of subtests. The tests and subtests
are described in the following sections.
1.1 Connect Tests
Connect tests verify the ability of the network software to process
connect, connect accept, and connect reject requests with and without
optional user data. Connect tests that the user can perform are:
o Connect reject without user data
o Connect accept without user data
o Connect reject with 16 bytes of standard user data
1
o Connect accept with 16 bytes of standard user data
o Connect reject with received user data used as reject user
data
o Connect accept with received user data used as accept user
data
1.2 Data Tests
Data tests provide a full range of test capabilities from the very
simple data sink operation through data integrity checking. Data
tests the user can perform are:
o Sink test. dtr ignores all data received. No sequence or
content validation is performed.
o Sequence test. Data messages transmitted by dts to dtr
include a 4-byte sequence number. If a message is received
out of sequence, dtr aborts the logical link and the test.
o Pattern test. Data messages transmitted to dtr have both a
sequence number and a standard data pattern. If either the
sequence number or the received data does not match the
expected data, dtr aborts the logical link and the test.
o Echo test. Data messages received by dtr are transmitted
back to dts. There is sequence and data validity checking
done by dts but not by dtr.
1.3 Disconnect Tests
Disconnect tests are designed to determine whether dts can detect the
difference between disconnect and abort sequences generated by dtr as
well as receive the proper optional user data. Disconnect tests that
can be performed by the user are:
o Disconnect without data
o Abort without user data
o Disconnect with 16 bytes of standard user data
o Abort with 16 bytes of standard user data
o Disconnect with received connect user data used as disconnect
user data
2
o Abort with received connect user data used as abort user data
1.4 Interrupt Tests
Interrupt tests provide a full range of test capabilities from very
simple data sink operations through data integrity checking.
Interrupt tests that the user can perform are:
o Sink test. dtr ignores all interrupt data received. No
sequence or content validation is performed.
o Sequence test. Interrupt messages transmitted by dts to dtr
contain a 4-byte sequence number. If a message is received
out of sequence, dtr aborts the logical link and the test.
o Pattern test. Interrupt messages transmitted to dtr have
both a sequence number and a standard data pattern. If
either the sequence number or the data pattern is not
received with the expected data, dtr aborts the logical link
and the test.
o Echo test. Interrupt messages received by dtr are
transmitted back to dts. There is sequence and data
validity checking done by dts but not by dtr.
2. Operational Characteristics
dtr functions as a slave to dts and must be installed at the remote
node. dts initiates each test by issuing a connect request to dtr.
Parameter information pertinent to the type of test requested is
passed by dts to dtr in the optional data of the connect request. The
dts user interface enables the user to issue commands with options to
customize the test to be performed. Parameters are available to
regulate test duration, buffer level, and the type of data used.
The dts command syntax allows for two types of buffer level options:
squeue and rqueue. The squeue option is used by dts only and rqueue
is used by dtr only. The squeue parameter specifies the transmit
buffer level for dts. This level is the number of transmit requests
that dts attempts to keep outstanding to the network during the test.
In an echo test, the squeue parameter also specifies the receive
buffering level for dts. The rqueue parameter specifies the receive
buffer level for dtr.
3
3. Running dts/dtr
Be sure that the line is in the on state. Then enter the following
command:
% dts<RET>
The system will respond with the following message and prompt:
DTS Version n.n.n initiated on day month date hh:mm:ss year
DTS>
You can now begin to enter commands to dts (see command format in
Section 4.). When you wish to end testing, type exit in response to
the dts prompt. dts will print a termination message on your screen
when it exits and your DOS prompt will reappear.
4. dts Command Syntax
The basic syntax for dts commands is shown below (refer to the Preface
to review graphic conventions used in command descriptions). The
default values for a qualifier remain in effect until a different
value is specified. The specified value then becomes the new default
for all following tests until that value is changed.
SYNTAX
DTS>test[qualifiers][test-specific-qualifiers]
where
test Specifies the type of test, where test must be one
of the following:
connect Connect test
disconnect Disconnect test
data Data test
interrupt Interrupt test
qualifiers Specifies any number of the following optional
qualifiers. Once specified, these qualifiers
remain in effect for all applicable tests until
you change them or exit from dts. Each qualifier
must be preceded by a slash (/).
/nodename=node-id Identifies the node (by name or
address) on which dtr is to run
(default = "REMOTE"). dtr
4
must run on a remote node's
default nonprivileged account
because you cannot specify
access control information with
this qualifier.
/print or Tells dts whether or not to
/noprint print (log) test results.
(default)
/nostatistics or Tells dts whether or not to
/statistics print statistics on data and
(default) interrupt tests.
/display or Tells dts whether or not to
/nodisplay print the data and interrupt
(default) messages transmitted to dtr.
/speed=number Specifies the test line speed in
bits per second (default = 0).
dts uses this data for reporting
statistics.
test-specific- Specifies any number of test-specific qualifiers,
qualifiers as defined in the following sections.
Test-specific qualifiers apply to the current test
only.
5
4.1 Connect Test
SYNTAX
connect[qualifiers][test-specific-qualifiers]
where test-specific-qualifiers can be any of the following:
/type=subtest Specifies the type of test, where subtest can be:
accept Connect accept test (default)
reject Connect reject test
/return=type or Specifies the type of data returned by dtr, where
/noreturn type can be:
(default)
standard Standard user data
received Received user data
/noreturn causes no optional user data to be
returned.
EXAMPLE:
DTS>connect/nodename=pete/return=received
This command invokes a connect accept test (by default) with remote
node Pete. dtr is to return received user data as part of the
test.
6
4.2 Disconnect Test
SYNTAX
disconnect[qualifiers][test-specific-qualifiers]
where test-specific-qualifiers can be any of the following:
/type=subtest Specifies the type of test, where subtest can be:
synchronous Synchronous disconnect test
abort Disconnect abort test (default)
/return=type or Specifies the type of data returned by dtr, where
/noreturn type can be:
(default)
standard Standard user data
received Received user data
/noreturn causes no optional user data to be
returned.
EXAMPLE:
DTS>disconnect/nodename=paris/type=synchronous
This command invokes a synchronous disconnect test with remote node
Paris. dtr will not return any optional user data.
7
4.3 Data Test
SYNTAX
data[qualifiers][test-specific-qualifiers]
where test-specific-qualifiers can be any of the following:
/type=subtest Specifies the type of test, where subtest can be:
sink Sink test (default)
seq Sequence test
pat Pattern test
echo Echo test
/size=number Specifies data message length in bytes, where
number is a value in the range of n to 2048
(default = 128). n is 0 for sink and echo tests,
4 for a sequence test, and 5 for a pattern test.
/test-duration Specifies duration of the test in one of the
following formats:
/seconds=number (range: 1 to 60)
/minutes=number (range: 1 to 60)
/hours=number (range: 1 to 24)
The default is /seconds=15.
/flow=type or Specifies type of flow control (if any), where
/noflow type can be:
(default)
segment Segment flow control
message Message flow control
(default -- if /flow is specified)
If dtr is running on DECnet-DOS, it must use
the system default.
/rqueue=number Specifies number of pending receives for dtr to
maintain, where number is a value in the range 1
(default) to 16. If dtr is running on
DECnet-DOS, it must use the system default.
/squeue=number Specifies number of pending transmissions for dts
to maintain, where number is a value in the range
1 (default) to 16. If dts is running on
DECnet-DOS, it must use the system default.
/nak=number or Specifies the number of segments between NAKs. If
/nonak (default) dtr is running on DECnet-DOS, it must use the
system default.
8
/back=number or Specifies the number of segments before back
/noback pressuring. If dtr is running on DECnet-DOS,
(default) it must use the system default.
EXAMPLE:
DTS>data/size=512/seconds=30
DTS --I-- Test started at 11:23:30
DTS --I-- Test finished at 11:24:00
Test parameters:
Target node name "jones"
Test duration (sec) 30
Message size (bytes) 512
Summary statistics:
Total messages SENT 48
Total bytes SENT 24576
Messages per second 1.60
Bytes per second 819.20
Line thruput (baud) 6553
This command invokes the data test with the sink subtest (by
default). dts sends messages to dtr on node Jones (by default from
a previous command). The message size is 512 bytes and the
duration of the test is 30 seconds.
9
4.4 Interrupt Test
SYNTAX
interrupt[qualifiers][test-specific-qualifiers]
where test-specific-qualifiers can be any of the following:
/type=subtest Specifies the type of test, where subtest can be:
sink Sink test (default)
seq Sequence test
pat Pattern test
echo Echo test
/size=number Specifies data message length in bytes, where
number is a value in the range of n to 16
(default). n is 0 for sink and echo tests, 4 for
a sequence test, and 5 for a pattern test.
/test-duration Specifies duration of the test in one of the
following formats:
/seconds=number (range: 1 to 60)
/minutes=number (range: 1 to 60)
/hours=number (range: 1 to 24)
The default is /seconds=15.
/rqueue=number Specifies number of pending receives for dtr to
maintain, where number is a value in the range 1
(default) to 16. If dtr is running on
DECnet-DOS, it must use the system default.
/squeue=number Specifies number of pending transmissions for dts
to maintain, where number is a value in the range
1 (default) to 16. If dts is running on
DECnet-DOS, it must use the system default.
EXAMPLE:
DTS>interrupt/nodename=dallas/print/type=pat/test=30
DTS --I-- Test started at 17::44::10
DTS --I-- Test finished at 17::44::40
Test parameters:
Target node name "dallas"
Test duration (sec) 30
Message size (bytes) 16
10
Summary statistics:
Total messages SENT 2734
Total bytes SENT 43744
Messages per second 91.1
Bytes per second 1458
Line thruput (baud) 11665
This command invokes the interrupt test with the pattern subtest.
dts sends interrupt messages to dtr on node Dallas where test
information is to be printed. The default is used for message size
and the duration of the test is 30 seconds.