GENWiki

Premier IT Outsourcing and Support Services within the UK

User Tools

Site Tools


archive:programming:dts
		   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.
/data/webs/external/dokuwiki/data/pages/archive/programming/dts.txt · Last modified: 2001/06/15 06:14 by 127.0.0.1

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki