Ref: 99980036
Title: Release Notes: TRTEST Ver 11000
Date: 6/30/87

Copyright 3Com Corporation, 1991.  All rights reserved.

Software Release

SW/1-TRTEST Version 11000

June 30, 1987

Part Number: 86-0115-00
.br;Revision 00


TO:          Token Ring Board Users

FROM:        Bridge Communications, Inc.

SUBJECT:     SW/1-TRTEST Version 11000

DATE:        June 30, 1987

Overview

SW/1-TRTEST is a diagnostic software program to be used on any
floppy-based Series/1 system equipped with a Token Ring
Controller/Multibus board.  The program performs an extensive
checkout of the TRC/M board and provides the heaviest traffic
flow over the Token Ring for the system under test.  It interacts
with the user via the console terminal.

This release memo describes all commands available in the
software and gives installation instructions.

SW/1-TRTEST Version 11000 Command Set

Each SW/1-TRTEST command consists of one or two characters, which
can be entered in uppercase or lowercase.  It is followed by
parameters separated by spaces, and terminated by a carriage
return.  Most of the command characters are mnemonic characters.
Numeric parameters are hexadecimal numbers.

In this section, parameters are noted between a pair of angle
brackets (<>).  If a parameter is enclosed in braces ({}), it is
an optional parameter.

The SW/1-TRTEST Version 11000 commands can be classified in four
major categories as follows:

1.  Commands to set data link or test process parameters

+ M {<min>} {<max>}

Sets the minimum and maximum lengths of packets to be
transmitted.  The lengths include Token Ring and
Logical Link Control headers and exclude CRC bytes.
If no parameters are specified, the current values are
displayed.

+ S

Sets the data link and test process parameters.  After
you have entered this command, the system will prompt
you for the debug options, which determine the types



of messages to be displayed.  Refer to the TRTEST
Debug Control section on page 7 of this release memo
for further information.

For the Mode parameter and the Broadcast Interval
parameter, the default values should be used.

+ Z

Clears the data link statistics.



2.  Commands to display parameters and current data link

+ CN

Clears the netmap table.

+ DM <addr> <len>

Displays memory starting at specific address (addr)
for the specified length (len).

+ DP

Displays the parameter settings.  For example, the
station address and the debug options are shown when
you enter this command.

+ DS

Displays the error, traffic, and system statistics.
For further information on statistics, refer to the
Statistics section on page 5.

+ N

Displays the netmap.

+ RX

Displays the current receive buffer descriptor.  The
buffer descriptor contains information such as the
address of the next receive buffer, and the length and
address of the current buffer.

+ TX

Displays the current transmit buffer descriptor.  The
buffer descriptor contains information about whether
the current buffer is used or empty, the pointer to
the buffer with which this descriptor is associated,
and the pointer to the next transmit buffer.

+ V

Displays the version string of the software.

3.  Command to initiate transmission on the network

+ T {<cnt>} {<addr>}

Transmits a number (cnt) of packets to the specified
address (addr).  The address must be divided into



three distinct words, each of which is represented by
one to four hexadecimal digits.  When you enter the
address, these words must be separated by a space.

If no parameters are specified, the count will be set
to infinity and the packets will be sent to the
stations that were previously specified.  If <cnt> is
set to 0, the count will also be set to infinity.
Each transmitted packet contains a level 1 header
followed by the data to be transmitted.  The size of
the packet varies from the minimum to the maximum size
specified with the M command.  To abort the
transmission, press <ESC>.



4.  Miscellaneous commands

+ H or ?

Displays a list of the available commands.

+ I

Enables the receiving mode to receive packets from the
other stations.  Press <ESC> to disable this mode.

Messages

The messages described in this section are not displayed as the
direct result of a certain command.  They indicate internal
events while the T or I commands are being executed.  To display
more internal information, use the debug options of the data link
software.

1.  Reception

+ #

Indicates that a test packet has been received from
the network.  This test packet contains a level 1 test
protocol header indicating the length of the data
transmitted.  Length and/or data may be checked and
stopped.

+ ?

Indicates that a packet has been received from the
network with unexpected packet type, whose level 1
test header is bad or nonexistent.

+ o

Indicates that a packet received from the network
cannot be delivered to the Token Ring by the driver
because the TR mailbox is full.  These packets are
discarded by the driver.

+ m

Indicates that the system is out of memory because all
buffers are currently used.

+ e

Indicates that an error such as CRC, framing, etc.,
has occurred.



+ V

Indicates that the packet received has bad length.

2.  Transmission

+ :

Indicates that the test program cannot obtain a
message block from the kernel to transmit a packet
(out of private memory).  The test program will keep
trying.

+ +

Indicates that the test program cannot obtain a buffer
from the kernel to transmit a packet (out of shared
memory).  The test program will keep trying.

+ !

Indicates that the data link agent will not transmit a
packet from the test program (control block list
full).  The test program will keep trying.

+ &

Indicates that a packet has been successfully given to
the data link agent for transmission.

+ t

Indicates that a transmit resource is exhausted.

Statistics

Both the Token Ring drivers and the Token Ring process maintain
counts and statistics of events related to the data link traffic.
Statistics may vary from one product to another but contain at
least the following information:

1.  Reception

+ Signal loss

+ Hard errors

+ Soft errors

+ Transmit beacon



+ Lobe wire fault

+ Auto removal

+ Remove MAC frame

+ Single station

+ Too long

+ Data miscompares

+ Successful reception

2.  Transmission

+ TCB out

+ Out of TXCBs

+ List error

+ Frame size error

+ Transmit threshold

+ False starts

+ Wrong priority

+ Bad frame

+ Wrong format

+ Bad commands

+ Successful transmission

3.  Miscellaneous statistics

+ Line errors

+ Burst errors

+ ARI/FCI errors

+ Abort errors

+ Lost frames

+ Receive congestion



+ Frame copy

+ Token errors

+ DMA bus errors

+ DMA parity errors

Refer to the TMS380 Adapter Chipset User's Guide (Part Number:
SPWU001) published by Texas Instruments for further information
on each error type.

Use the DS command to display the above information and the Z
command to clear it.

Running SW/1-TRTEST Version 11000

The attached stations are set up for simultaneous reception and
transmission.  A large amount of traffic is generated on the
network with this test, but the test can be run with regular
network traffic.

To run SW/1-TRTEST Version 11000, follow these steps:

1.  Connect a terminal to the console port of the CS/1.

2.  To boot all of the systems under test, enter the following
command on each of them: bt <CR>

3.  To start transmission, enter the T command on the systems
under test that are used as transmitting sources.  The
following is an example of this command: t 0 0 0 0 <CR> In
this command, the first parameter is 0.  Therefore, packets
will be transmitted until the command is aborted.  The
three 0's are words that constitute the address.  In this
example, the address is 000000000000.

4.  Enter the following commands on the other systems: i <CR>

5.  Wait one minute for the netmap to be built.

6.  Stop the transmitting station by pressing <ESC> and enter
the following command: t <cnt> where <cnt> is the number of
packets to be transmitted.  If you enter n instead of
<cnt>, packets will be transmitted to the stations that
appear in the netmap.

The first system under test should display a series of
ampersands (&); the rest of the systems under test should
display a series of pound signs (#).



7.  Press <ESC> to stop the transmission.

8.  To display the statistics results of the test, enter the
following command on each of the Token Ring systems under
test: ds

TRTEST Debug Message Control

SW/1-TRTEST uses a special version (debug version) of the Token
Ring data link process, which displays selected control messages
on the console.

The debug version of the data link process uses a memory word for
option selection, which determines the types of messages to be
displayed.  The following list shows the correspondence between
the memory word (in hexadecimal) and the types of messages:

8000    Messages concerning TMS-380 transmission.

4000    Messages concerning TMS-380 and the Token Ring board
initialization.

2000    Messages concerning the recycling of TXCBs and transmit
DBs.

1000    Messages concerning the TMS-380 reception.

0800    Messages concerning fatal problems before panic
subroutine is called.

To display more than one type of message, add the corresponding
numbers and set the memory word to the sum. For example, if you
want to generate messages concerning the TMS-380 transmission and
reception, add 1000 to 8000, then change the bits in the memory
word so that it represents the sum (9000).  If you want to
generate messages concerning the TMS-380 reception and messages
concerning fatal TMS-380 problems, store 1800 in the memory word.

If you have any questions, please contact an authorized Bridge
service representative for assistance.


