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 {} {} 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 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 {} {} 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 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 . 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 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 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 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 5. Wait one minute for the netmap to be built. 6. Stop the transmitting station by pressing and enter the following command: t where is the number of packets to be transmitted. If you enter n instead of , 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 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.