Ref: 99980109
Title: SW/20-TCP-PKTGEN-NCS/AT Version 20100
Date: 9/28/88

Copyright 3Com Corporation, 1991.  All rights reserved.

Enclosed is a distribution diskette containing SW/20-TCP-PKTGEN-
NCS/AT Version 20100 (part number: 83-0170-03) for use with
MCPU20-based CS/1s that are booted from an NCS/AT.

This release memo describes the procedure for copying SW/20-TCP-
PKTGEN-NCS/AT 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-NCS/AT Version
20100.

.h1;Compatibility

SW/20-TCP-PKTGEN-NCS/AT 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, IB/2, and 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
           NCS/AT               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 operate with a 96-TPI disk drive.

.h1;Installation

                      ** NOTE **

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

Because SW/20-TCP-PKTGEN-NCS/AT Version 20100 is stored on a 96-
TPI, double-sided, high-density diskette, you must use the same
type of diskette if you are making a copy of the distribution
diskette.

Before your CS/1 can run SW/20-TCP-PKTGEN-NCS/AT Version 20100,
you must install the software on an NCS/AT that boots the CS/1.

If your system previously used SW/1-TCP-NCS/AT Version 20100,
you must install the software on an NCS/AT that boots the CS/1.

If your system previously used SW/1-TCP-NCS/AT Version 13000, it
is recommended that you make backup copies of the files in /usr/
NCS/GLOBALS.  This is because SW/20-TCO-PKTGEN-NCS/AT Version
20100 uses a new format for the files contained in this
directory.  When you run SW/20-TCP-PKTGEN-NCS/AT Version 20100,
these files are automatically updated.  But if for any reason you
want to return to using SW/1-TCP/NCS/AT Version 13000 later, the
updated files in this directory cannot be used.

Use the following procedure to create backup copies for the files
in /usr/NCS/GLOBALS:

1.  Follow the instructions in the NCS/AT Installation and
Operation Guide to log in to the NCS/AT.  A command prompt
appears on the screen after you have logged in.

2.  At the command prompt, enter utility mode by typing:

    ut

3.  Change the current directory to /usr/NCS by typing:

    cd /usr/NCS

4.  Create a new directory for the backup files.  In the
following examples, the name of the directory is OLDGLOBALS:

    cp GLOBALS/* OLDGLOBALS

5.  After the copy process is finished, a new prompt appears.
Type the following command to exit utility mode:

    exit

Follow these steps to copy SW/20-TCP-PKTGEN-NCS/AT Version 20100
from the distribution diskette to the NCS/AT disk:

1.  Follow the instructions in the NCS/AT Installation and
Operation Guide to log in to the NCS/AT.  A command prompt
appears on the screen after you have logged in.

2.  Insert the SW/20-TCP-PKTGEN-NCS/AT Version 20100 diskette in
the disk drive of the NCS/AT.

3.  At the command prompt, type the following command:

    utility floppyread

4.  The Floppyread utility copies the software from the SW/20-TCP-
PKTGEN-NCS/AT diskette to the NCS/AT disk.

As the files are copied to the disk, their names are
displayed.

If floppy read errors or disk write errors occor, remove and
replace the diskette; then repeat the procedure starting at
step 3.

If read or write errors continue to occur, or if other error
messages appear, contact an authorized 3Com service
representative for assistance.

5.  After the files have been successfully copied, the command
prompt appears.  Remove the distribution diskette from the
disk drive.

Before the CS/1 can be booted from the NCS/AT, it must be bound
to the NCS/AT by the BInd command.  Refer to the NCS/AT
Installation and Operation Guide for more information on the BInd
command.

                      ** NOTE **

When you use the BInd command, you must specify the bootfile
name to be "cs20tp.20100" so that the proper system software
is downloaded from the NCS/AT to the CS/1 when the CS/1
issues a boot request.

.h1;Testing Your Network

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

1.  Verify that the CS/1 is bound to the NCS/AT on which you have
just installed SW/20-TCP-PKTGEN-NCS/AT Version 20100.

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

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

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

    rotary !128=!64-!125

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

    setdefault (!128) ip=192.9.200.1

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

    connect 192.9.200.1

A welcome message is displayed on the screen.

7.  Press any key except the Break key on the terminal attached
to the second Communications Server.  The PKTGEN> prompt
appears on the screen.

8.  Begin transmission of test packets by typing the following
command on the terminal attached to the second
Communications Server.

    g

This command transmits test packets from the CS/1 running SW/
20-TCP-PKTGEN-NCS/AT 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-NCS/AT Version 20100.

Inspect the display on the terminal screen.  The characters
should line up in vertical columns, as shown in the example
in Figure 1.  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.

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

    g

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

11. Terminate the connection by entering the following command:

    dc

.h1;Features

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

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

2.  The format of test data blocks generated by SW/20-TCP-PKTGEN-
NCS/AT Version 20100 can be modified by changing the values
of the parameters in SW/20-TCP-PKTGEN-NCS/AT 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-NCS/AT 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-NCS/AT 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)

*   NCS/AT Installation and Operation Guide (2/88)
    (Part Number: 09-0092-02)

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