Ref: 99980107
Title: SW/20-TCP-PKTGEN Version 20100
Date: 9/28/88

Copyright 3Com Corporation, 1991.  All rights reserved.

Enclosed is a distribution diskette containing SW/20-TCP-
PKTGEN Version 20100 (part number: 83-0170-00) for use with your
MCPU20-based CS/1.

This release memo describes the procedures for copying SW/20-TCP-
PKTGEN Version 20100 and for testing the network with this packet
generating software.  It also lists the main features and known
problems in SW/20-TCP-PKTGEN Version 20100.

.h1;Compatibility

SW/20-TCP-PKTGEN Version 20100 operates with the following
products and software releases:

    CS/1 running SW/1-TCP Version 20000 or later
    CS/50 running SW/50-TCP Version 13010 or later
    CS/100 running SW/100-TCP Version 19000 or later
    CS/200 running SW/200-TCP Version 20100 or later
    NCS/150 running SW/150-NCS-TCP Version 11000 or later
    NCS/AT running SW/AT-NCS Version 11000 or later
    NCS/2 running SW/2-NCS Version 10000 or later
    Personal computer running SW/PCS-TCP Version 20000 or later
    IB/1 and IB/2 running SW/20 Version 11000 or later
    IB/3 running SW/20-IB Version 11000 or later

The following table illustrates the firmware and hardware
compatibility of SW/20-TCP-PKTGEN Version 20100:


            Firmware/Hardware Compatibility
-----------------------------------------------------------
 Product       Software                Firmware
                                MCPU20          EC/2

  CS/1     SW/20-TCP-PKTGEN     M3 MMON       M1 IECM 02A
                                00I or later  or later

If an Ethernet controller is used with the MCPU20-based CS/1, it
must be an EC/2 board with 512 kilobytes of RAM.  Also, an MCPU20
must operte with a 96-TPI disk drive.

.h1;Copying SW/20-TCP-PKTGEN

                      ** NOTE **

When following the instructions in this release memo, be sure
to press the Return key after typing each command.

Before you run SW/20-TCP-PKTGEN Version 20100 on the CS/1, you
should make a copy of the distribution diskette using the
following procedure:

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

2.  Press the Reset switch.

3.  Make a backup copy of the distribution diskette using the
following command:

    > co <n>

where n is the number of copies to be made.

4.  The following message appears on the screen:

    insert master and hit return key

Insert the SW/20-TCP-PKTGEN Version 20100 diskette in the
disk drive.  After you press the Return key, the following
messages appear on the screen if the read completes
successfully:

    reading ... OK
    insert copy 1 and hit return key

In the actual display, the number in the message may vary
according to the number of copies you have made.  If the
message "read error" appears instead fot he message "OK",
contact an authorized 3Com service representative for
assistance.

5.  Remove the SW/20-TCP-PKTGEN distribution diskette from the
disk drive.  Insert a blank, 96-TPI, double-sided, double-
density diskette in the disk drive, then press the Return
key.

6.  If an error message appears, remove and replace the diskette.
If errors continue to occur, contact an authorized 3Com
service representative for assistance.

If the copy completes successfully, the following messages
appear on the screen:

    formatting ... writing ... verifying ... OK
    copy completed

Remove the diskette from the disk drive, and label it "SW/20-
TCP-PKTGEN Version 20100".  Store the distribution diskette
in a safe place.  You can now use the newly made copy to
update your system.

.h1;Testing Your Network

Use the following procedure to test your network with SW/20-TCP-
PKTGEN Version 20100:

1.  Insert the newly made copy of SW/20-TCP-PKTGEN Version 20100
in the disk drive of the CS/1.

2.  Boot the CS/1 according to the procedure described in the CS/
1 Installation Guide.

3.  Connect a terminal to an SIO port on the CS/1.

4.  Set the privilege level to global network manager using the
SET PRIvilege command.

5.  Assign ports 64 through 125 on the CS/1 to a rotary.  For
example:

    rotary !128=!64-!125

6.  Assign an unused Internet address to the rotary defined in
step 5.  For example:

    setdefault (!128) ip=192.9.200.1

7.  From a terminal connected to a second Communications Server
on the network, make a connection to the address assigned in
step 6.  For example:

    connect 192.9.200.1

A welcome message is displayed on the screen.

8.  Press any key except the Break key.  The PKTGEN> prompt
appears on the screen.

9.  Begin transmission of test packets by entering the following
command and then pressing the Return key:

    g

This command transmits test packets from the CS/1 running SW/
20-TCP-PKTGEN Version 20100 via the second Communications
Server to the terminal from which the command was entered.
Each packet is represented on the screen by one line of data.
Data blocks, consisting of 22 lines of data and a header
line, are transmitted every two seconds.

If you wish to change this format, refer to the "Features"
section in this release memo for information on changing the
parameters in SW/20-TCP-PKTGEN Version 20100.

Inspect the display on the terminal screen.  The characters
should line up in vertical columns.  Irregular rows and
columns indicate lost characters.

Let the packet generator run for at least one hour.  Test
results are most reliable if the transmission is allowed to
continue for several hours.  3Com recommends running the
tests for 24 hours in order to measure the effect of any
daily transcient factors (e.g., electrical machinery starting
in the morning on a business day) and to get a reference base
of error rates for your installation.

10. To stop the tests, suspend transmission of test packets by
pressing the Break key.  Transmission of test packets may be
resumed by entering the command:

    g

11. After stopping the tests, return the terminal port to Command
mode by entering the ECMChar (usually <CTRL-^>).

12. Terminate the connection by entering the following command:

    dc

.h1;Features

SW/20-TCP-PKTGEN Version 20100 has the following features:

1.  CS/1 users can connect to virtual ports 64 through 125 to run
SW/20-TCP-PKTGEN Version 20100.

2.  The format of data blocks generated by SW/20-TCP-PKTGEN
Version 20100 can be modified by changing the values of
the parameters in SW/20-TCP-PKTGEN Version 20100.

To display these parameters, press "?" at the PKTGEN> prompt.

The following list provides a brief description of each of
the parameters in SW/20-TCP-PKTGEN Version 20100:

    a.  The "l" parameter determines the number of lines
        generated by each data block.

        For example, to transmit data blocks with 30 lines each,
        type the following at the PKTGEN> prompt:

        l 30

        The default value of this parameter is 22, and the
        possible values are 1 through 32767.

    b.  The "s" parameter determines the number of seconds
        between data block tranmissions.

        For example, to allow 5 seconds to elapse between data
        block tranmissions, type the following at the PKTGEN>
        prompt:

        s 5

        The default value of this parameter is 2, and the
        possible values are 1 through 32767.

    c.  The "h" parameter determines whether the data block is
        transmitted with or without a header.  The header is the
        first line of the data block and provides information
        regarding the date and server.

        For example, to transmit the data block without a header,
        type the following at the PKTGEN> prompt:

        h 0

        The default value of this parameter is 1, which transmits
        the data block with a header, and the possible values are
        1 or 0.

    d.  The "g" parameter determines the number of data blocks to
        be sent.

        For example, to send 50 data blocks, type the following
        at the PKTGEN> prompt:

        g 50

        The default value of this parameter is 0, which transmits
        data blocks until the user presses the Break key.  The
        possible values are 0 through 32767.

.h1;Known Problems

If users of SW/20-TCP-PKTGEN Version 20100 enter commands faster
than the terminal can echo them, these commands are lost.

.h1;Documentation

The following manuals provide related information:

*   CS/1 Installation Guide (10/87)
    (Part Number: 09-0117-00)

*   Getting Started Guide (2/87)
    (Part Number: 09-0043-01)

*   Connection Service User's Guide for XNS and TCP/IP
    Protocols (6/88)
    (Part Number: 09-0145-00)

*   Network Management Guide (9/87)
    (Part Number: 09-0067-02)

*   LAN Planning Guide (2/88)
    (Part Number: 09-0085-01)

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