                         3Com (R) Corporation
      EtherDisk (R) Diskette for the EtherLink III (R) Adapters
      Configuration and Diagnostic Program Instructions Summary



  Overview
  --------

  The configuration portion of the program allows you to change the
  configuration parameters for the adapter to fit the specific 
  environment in which the adapter is installed.

  The diagnostic portion of the Configuration and Diagnostic Program
  is designed to make sure that the adapter is installed correctly and
  functioning properly in your computer.  The Group 1 tests check the
  physical components, connectors, and circuitry of the adapter and
  require only that the adapter be installed in the computer.  The 
  Group 2 tests check the adapter's ability to transmit data on the 
  network and require that the adapter be connected to a loopback plug 
  or to a network.  The Group 3 tests check the adapter's ability to 
  correctly transmit and receive data over the network and require 
  that the adapter be connected to a network on which an echo server 
  has been set up.


  The computer containing the adapter to be configured or tested must be
  running DOS only.  

  NOTE:  If this computer is an operating server, notify all users of the
         server to save their work and log out from the network.  The
         Configuration and Diagnostic Program disrupts the normal operation
         of servers and workstations, so work that is not saved may be lost.

         Then shut down the server, and reboot with a DOS-only diskette.
         (This way no drivers or TSRs will be running when the program
          is started.)

  Starting the Configuration and Diagnostic Program
  --------------------------------------------------
   
   There are two ways to start the program:

   *  Automatically, from the INSTALL.EXE program, by selecting the options
      in the Configuration and Diagnostic submenu.

   *  Manually, from the root directory of the EtherDisk diskette, by typing
      the following command:

                 3C5X9CFG [command keyword] [parameter list]

      3C5X9CFG represents the 3Com Configuration and Diagnostic Program name.
      The brackets indicate that the command keyword and parameter list are
      optional.

      3C5X9CFG without any arguments invokes the program in full windows mode.
      This includes mouse support and context-sensitive help.  Press [F1] for
      help at any time.

      Command Line Keywords:
      ----------------------

      You can use the first two characters of any command or parameter
      as a shortcut.  For example, 3C5X9CFG HE RU means 3C5X9CFG HELP RUN.
    
      Also, the command keywords and parameters are not case-sensitive,
      so CONFIGURE, configure, and Configure, for example, will all work.
      

      CONFIGURE - Configures an adapter in one of three ways.
                  (1) automatically with /auto parameter 
                  (2) using a specified adapter configuration file 
                  (3) using command line configuration parameters

      ECHOSERVER - Enables a designated adapter to function within the echo
                   server.

      HELP - Displays general or command-specific help information.  To get
	     command-specific help, enter: 
                       
                          3C5X9CFG HELP [command keyword]

      LANGUAGE - Invokes the program in full windows mode using a specified
                 external resource file.  This option provides support for
                 multiple languages via a different resource file for each
                 language supported.

      LIST - Displays a list of installed adapters recognized by this program
             and their assigned adapter numbers.

      RUN - Executes the diagnostic tests (which can also be specified from a
            file) on a selected adapter and writes the results to the screen,
            a file, or a printer.


  Configuration
  -------------

  The adapter can be configured in one of the following four ways, which
  are described in greater detail below:

      *  Full Screen Windows Mode
      *  Command Line with Auto Configuration
      *  Command Line with Explicit Parameters
      *  Command Line with Configuration File

     Full screen windows mode
     ------------------------

     To configure the adapter using the full screen windowing, type 3C5X9CFG
     and [Enter].  Then select the Configure Adapter option in the Install 
     pull-down menu.

     Command line options 
     --------------------
  
     Defaults:  CONFIGURE has /AUTO and /ADAPTERNUM:1 as defaults.  So for 
     example, if only  "3c5x9cfg configure" is used, adapter number 1 will be
     auto configured.  

     ADAPTERNUM:N and /SLOT:S parameters can be used with any of the CONFIGURE 
     options that follow.  They are both intended for use whenever multiple 
     adapters are present in the computer and recognized by the Configuration
     and Diagnostic Program.

     /ADAPTERNUM:N specifies the adapter number to be configured for ISA
     computers.  Run the LIST command separately to determine the adapter
     number to use here.
     
     /SLOT:S specifies the physical slot number of the adapter to be configured
     in EISA and MCA computers.
       

     Command Line with Auto Configuration
     ------------------------------------

     Command syntax:  3C5X9CFG CONFIGURE  /AUTO 

     The /AUTO parameter configures the adapter automatically based on the
     software's best estimate using interpreted system information.
     This parameter sets the I/O Base Address, Interrupt, and Transceiver
     options. All other option settings are left unchanged. 

     NOTE:  The program will attempt to detect what Transceiver is being
     used, to set the Transceiver setting.  Therefore connect to the network
     first, then run /AUTO, and it will configure the Transceiver for you.
 
     
     Command Line with Explicit Parameters
     -------------------------------------

     Command syntax:  3C5X9CFG CONFIGURE  [ /INT:N  /IOBASE:N  /PORT:N 
                      /BSIZE:N  /BADDRESS:N   /MODEM:N  /XCVR:N  /TR:N  
                      /OPTIMIZE:N  /LINKBEAT:N  /CONFIGPORT:N ]

     Command line configuration parameters are used to configure the adapter
     using only the option settings you specify.  Some parameters are for 
     all adapters, some are for ISA only, and some are for EISA and MCA 
     only.  For example, /int:N is an ISA-only parameter, because with EISA 
     and MCA adapters, the computer vendor's configuration utility  or 
     option diskette handles the setting of the interrupt level.  In most
     cases, any combination of parameters can be used.  Therefore it is 
     possible to modify only a few settings if needed.

        /INT - Interrupt Level   (ISA only)
               Possible values - 3,5,7,9,10,11,12,15

        /IOBASE (or /PORT) - I/O Base Address   (ISA only)
               Possible values - EISA (to change to EISA mode) 
                                 or 200-3E0 in increments of 10

        /BSIZE - Boot PROM Size  (ISA only)
               Possible values - 8,16,32,disabled

        /BADDRESS - Boot PROM Address  (ISA only)
               Note:  For use only when /BSIZE is enabled

               Possible values - C2000-DE000, the range allowed 
               depends on the size selected with /BSIZE.  

        /MODEM - Modem Speed (Interrupt Disable Time)
               Possible values - 
                    Custom Disable Time Method:  25-1600, in increments of 25
                    Modem Speed Method:  None, 1200, 2400, 9600, 19200, 38400

               If no modem or other critical serial device is being used, then
               specify 1600 disable time for best performance.  If a modem is
               present, reduce the value until performance of both the modem
               and EtherLink III adapter are acceptable to you.  

        /TR (or /XCVR) - Transceiver  (ISA only)
               Possible values - TP, COAX, AUI, EXTERNAL (same as AUI)

        /OPTIMIZE - Network Driver Optimization  
               Possible values - DOS, Windows, OS/2, server

        /LINKBEAT - Link beat disable/enable  (pre-10BASE-T standard only)
               Possible values - disabled, enabled 

               NOTE:  Try this setting ONLY if pre-10BASE-T standard hubs
               are in use.

        /CONFIGPORT -  (ISA only)  Configport is a value the Configuration
               and Diagnostic Program uses internally, to search for ISA
               adapters.

               Possible values - 100-1E0, in increments of 10. 

               NOTE: Try this setting ONLY if a problem occurs in bringing up
               the program in an ISA computer.  (The 3Com internal default 
               configport of 110 may be incompatible with some ISA clone
               machines.)

               NOTE: If only this parameter is used, ie. "3c5x9cfg configure 
               /configport:1B0," and no other configuration parameters, the
               program will try the default configuration parameter, "/auto"
               to configure the adapter.


     Command Line with Configuration File
     ------------------------------------

     Command syntax:  3C5X9CFG CONFIGURE  /CONFIGFILE:filename 

     /CONFIGFILE:filename is used to configure an adapter with the settings
     specified in an ASCII configuration file that can be created and modified
     by any text editor.  The filename can be a fully qualified DOS filename 
     including a path.  A standard format for the file must be used, as follows:

        -  Variable names and values match the wording in the full-screen
            configure window in most cases.
        
        -  Begin each variable/value line with an "at" symbol (@), followed by
           a variable name, a colon (:), and the value.  

  		Example:  @I/O base address:300
        
        -  Blank lines and other white spaces are allowed between variable 
           lines.
       
        -  Start any comment lines with a semicolon (;).
       
        -  The variable names allowed are:
  		I/O base address
  		Interrupt request level
  		Boot PROM size
  		Boot PROM base address
  		Transceiver type
  		Network driver optimization
  		Maximum interrupt disable time
  		Link beat
       
        -  The values allowed are the same as those shown in the full-screen 
           configure window.  

  		Example 1:  @Network driver optimization:Windows or OS/2 Client
  		Example 2:  @Transceiver type:On-board Coax

  		The one exception to this rule is the Maximum Interrupt Disable Time
  		setting, which is used in place of Modem Speed.  The values are in
  		microseconds.  Possible values are 25-1600, in increments of 25.

  		Example:  @Maximum interrupt disable time:1600 microseconds


  Diagnostic
  ----------

  *  Full screen windows mode

     To run the diagnostic tests using the full screen windowing, type
     "3C5X9CFG" and ENTER.  Then select the Run Tests option in the Tests
     pull-down menu.

  *  Command line option - "Run"
    
     Command syntax:  3C5X9CFG RUN  [/TESTFILE:filename] [/RESULTS:[filename 
                      | PRN | PRNHP]] [/ADAPTERNUM:N | /SLOT:S]

     The RUN parameter executes the diagnostic tests on a selected adapter 
     and displays the results on the screen.  The defaults are adapter number 1
     and Group 1 tests.  The parameters below are all optional.
     
     /TESTFILE:filename specifies a test file that contains a specific test 
     setup description.
     
     /RESULTS:[filename or PRN or PRNHP] specifies an alternative location to 
     store the test results.  This location can be a DOS path and filename, 
     PRN printer port (same as LPT1), or PRNHP, which is an HP LaserJet printer
     connected to LPT1. 
     
     /ADAPTERNUM:N specifies the adapter number to be tested, in the case of
     multiple adapters installed in the computer and recognized by this 
     program.  Run the LIST command separately (see LIST below) to determine
     the adapter number to use.
     
     /SLOT:S specifies the physical slot number of the adapter to be tested
     when multiple adapters are installed in EISA and MCA computers.


  Other Command Line Options
  --------------------------

  *  HELP
   
     Command syntax:  3C5X9CFG HELP  [Command Keyword]

     HELP is an on-line summary of commands.  Without a command keyword,
     it gives a summary of the command keywords.  With a command keyword
     specified, it gives the parameter choices for that particular command.
     For example, "3C5X9CFG HELP CONFIGURE" gives details about the parameter
     options for the CONFIGURE command.
  
  *  LANGUAGE

     Command syntax:  3C5X9CFG LANGUAGE  /LANGFILE:filename

     LANGUAGE invokes the program in full windows mode using a specified 
     external resource file.  This option provides support for multiple
     languages via a different resource file for each language supported.

     /LANGFILE:filename is a required parameter with this command.
     The filename is the name of the resource file that is loaded by the
     program.  The filename can be a fully qualified DOS filename.

     NOTE: At this time, there are no alternate resource files included on
     the EtherDisk diskette.
 
  *  LIST
 
     Command syntax:  3C5X9CFG LIST

     LIST displays a list of currently installed adapters (and their assigned
     adapter numbers) that are recognized by this program. The adapter number 
     is then used as the N value for the /ADAPTERNUM:N parameter when multiple
     adapters are installed.  There are no parameters associated with the LIST 
     command keyword.

  *  ECHOSERVER

     Command syntax:  3C5X9CFG ECHOSERVER  [/ADAPTERNUM:N | /SLOT:S]
	 
     ECHOSERVER enables an adapter to function within an echo server. 
     /ADAPTERNUM:N specifies the adapter number to be configured in the echo
     server, in the case of multiple adapters.  /SLOT:S is available only on
     EISA or MCA computers, and refers to the physical slot in the echo server 
     where the adapter is located.


  Further Assistance
  ------------------

  If the adapter fails any of the diagnostic tests, see the TROUBLE.TXT file
  in the \DIAG directory on the EtherDisk diskette for troubleshooting
  procedures.

  The SUPPORT.TXT file in the \INFO subdirectory on the EtherDisk diskette
  provides information about obtaining product support for the adapter.  

  3Com, EtherDisk, and EtherLink are registered trademarks of 3Com Corporation.
  All other trademarks are the property of their respective owners.

(%VER  Configuration and Diagnostic Program Instructions Summary v2.1d)

