home *** CD-ROM | disk | FTP | other *** search
/ ftp.tcs3.com / ftp.tcs3.com.tar / ftp.tcs3.com / DRIVERS / Network / 3COM / 3C5x9 / 3c5x9x.exe / DIAG / INSTRUCT.TXT next >
Text File  |  1995-01-26  |  17KB  |  394 lines
  1.                          3Com (R) Corporation
  2.       EtherDisk (R) Diskette for the EtherLink III (R) Adapters
  3.       Configuration and Diagnostic Program Instructions Summary
  4.  
  5.  
  6.  
  7.   Overview
  8.   --------
  9.  
  10.   The configuration portion of the program allows you to change the
  11.   configuration parameters for the adapter to fit the specific 
  12.   environment in which the adapter is installed.
  13.  
  14.   The diagnostic portion of the Configuration and Diagnostic Program
  15.   is designed to make sure that the adapter is installed correctly and
  16.   functioning properly in your computer.  The Group 1 tests check the
  17.   physical components, connectors, and circuitry of the adapter and
  18.   require only that the adapter be installed in the computer.  The 
  19.   Group 2 tests check the adapter's ability to transmit data on the 
  20.   network and require that the adapter be connected to a loopback plug 
  21.   or to a network.  The Group 3 tests check the adapter's ability to 
  22.   correctly transmit and receive data over the network and require 
  23.   that the adapter be connected to a network on which an echo server 
  24.   has been set up.
  25.  
  26.  
  27.   The computer containing the adapter to be configured or tested must be
  28.   running DOS only.  
  29.  
  30.   NOTE:  If this computer is an operating server, notify all users of the
  31.          server to save their work and log out from the network.  The
  32.          Configuration and Diagnostic Program disrupts the normal operation
  33.          of servers and workstations, so work that is not saved may be lost.
  34.  
  35.          Then shut down the server, and reboot with a DOS-only diskette.
  36.          (This way no drivers or TSRs will be running when the program
  37.           is started.)
  38.  
  39.   Starting the Configuration and Diagnostic Program
  40.   --------------------------------------------------
  41.    
  42.    There are two ways to start the program:
  43.  
  44.    *  Automatically, from the INSTALL.EXE program, by selecting the options
  45.       in the Configuration and Diagnostic submenu.
  46.  
  47.    *  Manually, from the root directory of the EtherDisk diskette, by typing
  48.       the following command:
  49.  
  50.                  3C5X9CFG [command keyword] [parameter list]
  51.  
  52.       3C5X9CFG represents the 3Com Configuration and Diagnostic Program name.
  53.       The brackets indicate that the command keyword and parameter list are
  54.       optional.
  55.  
  56.       3C5X9CFG without any arguments invokes the program in full windows mode.
  57.       This includes mouse support and context-sensitive help.  Press [F1] for
  58.       help at any time.
  59.  
  60.       Command Line Keywords:
  61.       ----------------------
  62.  
  63.       You can use the first two characters of any command or parameter
  64.       as a shortcut.  For example, 3C5X9CFG HE RU means 3C5X9CFG HELP RUN.
  65.     
  66.       Also, the command keywords and parameters are not case-sensitive,
  67.       so CONFIGURE, configure, and Configure, for example, will all work.
  68.       
  69.  
  70.       CONFIGURE - Configures an adapter in one of three ways.
  71.                   (1) automatically with /auto parameter 
  72.                   (2) using a specified adapter configuration file 
  73.                   (3) using command line configuration parameters
  74.  
  75.       ECHOSERVER - Enables a designated adapter to function within the echo
  76.                    server.
  77.  
  78.       HELP - Displays general or command-specific help information.  To get
  79.          command-specific help, enter: 
  80.                        
  81.                           3C5X9CFG HELP [command keyword]
  82.  
  83.       LANGUAGE - Invokes the program in full windows mode using a specified
  84.                  external resource file.  This option provides support for
  85.                  multiple languages via a different resource file for each
  86.                  language supported.
  87.  
  88.       LIST - Displays a list of installed adapters recognized by this program
  89.              and their assigned adapter numbers.
  90.  
  91.       RUN - Executes the diagnostic tests (which can also be specified from a
  92.             file) on a selected adapter and writes the results to the screen,
  93.             a file, or a printer.
  94.  
  95.  
  96.   Configuration
  97.   -------------
  98.  
  99.   The adapter can be configured in one of the following four ways, which
  100.   are described in greater detail below:
  101.  
  102.       *  Full Screen Windows Mode
  103.       *  Command Line with Auto Configuration
  104.       *  Command Line with Explicit Parameters
  105.       *  Command Line with Configuration File
  106.  
  107.      Full screen windows mode
  108.      ------------------------
  109.  
  110.      To configure the adapter using the full screen windowing, type 3C5X9CFG
  111.      and [Enter].  Then select the Configure Adapter option in the Install 
  112.      pull-down menu.
  113.  
  114.      Command line options 
  115.      --------------------
  116.   
  117.      Defaults:  CONFIGURE has /AUTO and /ADAPTERNUM:1 as defaults.  So for 
  118.      example, if only  "3c5x9cfg configure" is used, adapter number 1 will be
  119.      auto configured.  
  120.  
  121.      ADAPTERNUM:N and /SLOT:S parameters can be used with any of the CONFIGURE 
  122.      options that follow.  They are both intended for use whenever multiple 
  123.      adapters are present in the computer and recognized by the Configuration
  124.      and Diagnostic Program.
  125.  
  126.      /ADAPTERNUM:N specifies the adapter number to be configured for ISA
  127.      computers.  Run the LIST command separately to determine the adapter
  128.      number to use here.
  129.      
  130.      /SLOT:S specifies the physical slot number of the adapter to be configured
  131.      in EISA and MCA computers.
  132.  
  133.      /PNPRST is an option to which can be used to bring a 3C509B out of the
  134.      Plug 'n Play wait for key state so the adapter can be reconfigured. The
  135.      symptom is the configuration and diagnostic program cannot find a 3C509B
  136.      ISA adapter in a computer.  The root cause is the computer BIOS writes
  137.      a byte to the parallel port status register.  This byte looks like the
  138.      first byte of the Plug 'n Play identification sequence.  The 509B will
  139.      then wait for the remaining bytes of the sequence, and will not respond
  140.      to normal inquiries.  The PNPRST option causes the configuration and
  141.      diagnostic program to issue several byte to the parallel port status
  142.      register, which returns the 509B to it's normal operating mode.
  143.        
  144.  
  145.      Command Line with Auto Configuration
  146.      ------------------------------------
  147.  
  148.      Command syntax:  3C5X9CFG CONFIGURE  /AUTO 
  149.  
  150.      The /AUTO parameter configures the adapter automatically based on the
  151.      software's best estimate using interpreted system information.
  152.      This parameter sets the I/O Base Address, Interrupt, and Transceiver
  153.      options. All other option settings are left unchanged. 
  154.  
  155.      NOTE:  The program will attempt to detect what Transceiver is being
  156.      used, to set the Transceiver setting.  Therefore connect to the network
  157.      first, then run /AUTO, and it will configure the Transceiver for you.
  158.  
  159.      
  160.      Command Line with Explicit Parameters
  161.      -------------------------------------
  162.  
  163.      Command syntax:  3C5X9CFG CONFIGURE  [ /INT:N  /IOBASE:N  /PORT:N 
  164.                       /BSIZE:N  /BADDRESS:N   /MODEM:N  /XCVR:N  /TR:N  
  165.                       /OPTIMIZE:N  /LINKBEAT:N  /CONFIGPORT:N  /PNP:N
  166.                       /SYNCREADY:N]
  167.  
  168.      Command line configuration parameters are used to configure the adapter
  169.      using only the option settings you specify.  Some parameters are for 
  170.      all adapters, some are for ISA only, and some are for EISA and MCA 
  171.      only.  For example, /int:N is an ISA-only parameter, because with EISA 
  172.      and MCA adapters, the computer vendor's configuration utility  or 
  173.      option diskette handles the setting of the interrupt level.  In most
  174.      cases, any combination of parameters can be used.  Therefore it is 
  175.      possible to modify only a few settings if needed.
  176.  
  177.         /INT - Interrupt Level   (ISA only)
  178.                Possible values - 3,5,7,9,10,11,12,15
  179.  
  180.         /IOBASE (or /PORT) - I/O Base Address   (ISA only)
  181.                Possible values - EISA (to change to EISA mode) 
  182.                                  or 200-3E0 in increments of 10
  183.  
  184.         /BSIZE - Boot PROM Size  (ISA only)
  185.                Possible values - 8,16,32,disabled
  186.  
  187.         /BADDRESS - Boot PROM Address  (ISA only)
  188.                Note:  For use only when /BSIZE is enabled
  189.  
  190.                Possible values - C2000-DE000, the range allowed 
  191.                depends on the size selected with /BSIZE.  
  192.  
  193.         /MODEM - Modem Speed (Interrupt Disable Time)
  194.                Possible values - 
  195.                     Custom Disable Time Method:  25-1600, in increments of 25
  196.                     Modem Speed Method:  None, 1200, 2400, 9600, 19200, 38400
  197.  
  198.                If no modem or other critical serial device is being used, then
  199.                specify 1600 disable time for best performance.  If a modem is
  200.                present, reduce the value until performance of both the modem
  201.                and EtherLink III adapter are acceptable to you.  
  202.  
  203.         /TR (or /XCVR) - Transceiver  (ISA only)
  204.                Possible values - TP, COAX, AUI, EXTERNAL (same as AUI)
  205.  
  206.         /OPTIMIZE - Network Driver Optimization  
  207.                Possible values - DOS, Windows, OS/2, server
  208.  
  209.         /LINKBEAT - Link beat disable/enable  (pre-10BASE-T standard only)
  210.                Possible values - disabled, enabled 
  211.  
  212.                NOTE:  Try this setting ONLY if pre-10BASE-T standard hubs
  213.                are in use.
  214.  
  215.         /CONFIGPORT -  (ISA only)  Configport is a value the Configuration
  216.                and Diagnostic Program uses internally, to search for ISA
  217.                adapters.
  218.  
  219.                Possible values - 100-1E0, in increments of 10. 
  220.  
  221.                NOTE: Try this setting ONLY if a problem occurs in bringing up
  222.                the program in an ISA computer.  (The 3Com internal default 
  223.                configport of 110 may be incompatible with some ISA clone
  224.                machines.)
  225.  
  226.                NOTE: If only this parameter is used, ie. "3c5x9cfg configure 
  227.                /configport:1B0," and no other configuration parameters, the
  228.                program will try the default configuration parameter, "/auto"
  229.                to configure the adapter.
  230.  
  231.         /PNP - (3C509B only) PNP controls the ability of the 3C509B to
  232.                respond to an ISA bus Plug 'n Play identification.
  233.  
  234.                Possible values - ENABLED or DISABLED
  235.  
  236.                ENABLED allows the adapter to respond to a Plug 'n Play
  237.                identification.  DISABLED does not allow the 509B to respond
  238.                to a Plug 'n Play identification.
  239.  
  240.         /SYNCREADY - (3C509B only) Forces the adapter to insert a wait state
  241.                on each I/O cycle.  Setting this option may allow the 509B to
  242.                work in computers with marginal ISA I/O bus timing.
  243.  
  244.                Possible values - ENABLED or DISABLED
  245.  
  246.                ENABLED adds a wait state to each I/O bus cycle.  DISABLED
  247.                allows the bus to run at full speed.
  248.  
  249.  
  250.      Command Line with Configuration File
  251.      ------------------------------------
  252.  
  253.      Command syntax:  3C5X9CFG CONFIGURE  /CONFIGFILE:filename 
  254.  
  255.      /CONFIGFILE:filename is used to configure an adapter with the settings
  256.      specified in an ASCII configuration file that can be created and modified
  257.      by any text editor.  The filename can be a fully qualified DOS filename 
  258.      including a path.  A standard format for the file must be used, as follows:
  259.  
  260.         -  Variable names and values match the wording in the full-screen
  261.             configure window in most cases.
  262.         
  263.         -  Begin each variable/value line with an "at" symbol (@), followed by
  264.            a variable name, a colon (:), and the value.  
  265.  
  266.           Example:  @I/O base address:300
  267.         
  268.         -  Blank lines and other white spaces are allowed between variable 
  269.            lines.
  270.        
  271.         -  Start any comment lines with a semicolon (;).
  272.        
  273.         -  The variable names allowed are:
  274.           I/O base address
  275.           Interrupt request level
  276.           Boot PROM size
  277.           Boot PROM base address
  278.           Transceiver type
  279.           Network driver optimization
  280.           Maximum interrupt disable time
  281.           Link beat
  282.        
  283.         -  The values allowed are the same as those shown in the full-screen 
  284.            configure window.  
  285.  
  286.           Example 1:  @Network driver optimization:Windows or OS/2 Client
  287.           Example 2:  @Transceiver type:On-board Coax
  288.  
  289.           The one exception to this rule is the Maximum Interrupt Disable Time
  290.           setting, which is used in place of Modem Speed.  The values are in
  291.           microseconds.  Possible values are 25-1600, in increments of 25.
  292.  
  293.           Example:  @Maximum interrupt disable time:1600 microseconds
  294.  
  295.  
  296.   Diagnostic
  297.   ----------
  298.  
  299.   *  Full screen windows mode
  300.  
  301.      To run the diagnostic tests using the full screen windowing, type
  302.      "3C5X9CFG" and ENTER.  Then select the Run Tests option in the Tests
  303.      pull-down menu.
  304.  
  305.   *  Command line option - "Run"
  306.     
  307.      Command syntax:  3C5X9CFG RUN  [/TESTFILE:filename] [/RESULTS:[filename 
  308.                       | PRN | PRNHP]] [/ADAPTERNUM:N | /SLOT:S]
  309.  
  310.      The RUN parameter executes the diagnostic tests on a selected adapter 
  311.      and displays the results on the screen.  The defaults are adapter number 1
  312.      and Group 1 tests.  The parameters below are all optional.
  313.      
  314.      /TESTFILE:filename specifies a test file that contains a specific test 
  315.      setup description.
  316.      
  317.      /RESULTS:[filename or PRN or PRNHP] specifies an alternative location to 
  318.      store the test results.  This location can be a DOS path and filename, 
  319.      PRN printer port (same as LPT1), or PRNHP, which is an HP LaserJet printer
  320.      connected to LPT1. 
  321.      
  322.      /ADAPTERNUM:N specifies the adapter number to be tested, in the case of
  323.      multiple adapters installed in the computer and recognized by this 
  324.      program.  Run the LIST command separately (see LIST below) to determine
  325.      the adapter number to use.
  326.      
  327.      /SLOT:S specifies the physical slot number of the adapter to be tested
  328.      when multiple adapters are installed in EISA and MCA computers.
  329.  
  330.  
  331.   Other Command Line Options
  332.   --------------------------
  333.  
  334.   *  HELP
  335.    
  336.      Command syntax:  3C5X9CFG HELP  [Command Keyword]
  337.  
  338.      HELP is an on-line summary of commands.  Without a command keyword,
  339.      it gives a summary of the command keywords.  With a command keyword
  340.      specified, it gives the parameter choices for that particular command.
  341.      For example, "3C5X9CFG HELP CONFIGURE" gives details about the parameter
  342.      options for the CONFIGURE command.
  343.   
  344.   *  LANGUAGE
  345.  
  346.      Command syntax:  3C5X9CFG LANGUAGE  /LANGFILE:filename
  347.  
  348.      LANGUAGE invokes the program in full windows mode using a specified 
  349.      external resource file.  This option provides support for multiple
  350.      languages via a different resource file for each language supported.
  351.  
  352.      /LANGFILE:filename is a required parameter with this command.
  353.      The filename is the name of the resource file that is loaded by the
  354.      program.  The filename can be a fully qualified DOS filename.
  355.  
  356.      NOTE: At this time, there are no alternate resource files included on
  357.      the EtherDisk diskette.
  358.  
  359.   *  LIST
  360.  
  361.      Command syntax:  3C5X9CFG LIST
  362.  
  363.      LIST displays a list of currently installed adapters (and their assigned
  364.      adapter numbers) that are recognized by this program. The adapter number 
  365.      is then used as the N value for the /ADAPTERNUM:N parameter when multiple
  366.      adapters are installed.  There are no parameters associated with the LIST 
  367.      command keyword.
  368.  
  369.   *  ECHOSERVER
  370.  
  371.      Command syntax:  3C5X9CFG ECHOSERVER  [/ADAPTERNUM:N | /SLOT:S]
  372.      
  373.      ECHOSERVER enables an adapter to function within an echo server. 
  374.      /ADAPTERNUM:N specifies the adapter number to be configured in the echo
  375.      server, in the case of multiple adapters.  /SLOT:S is available only on
  376.      EISA or MCA computers, and refers to the physical slot in the echo server 
  377.      where the adapter is located.
  378.  
  379.  
  380.   Further Assistance
  381.   ------------------
  382.  
  383.   If the adapter fails any of the diagnostic tests, see the TROUBLE.TXT file
  384.   in the \DIAG directory on the EtherDisk diskette for troubleshooting
  385.   procedures.
  386.  
  387.   The SUPPORT.TXT file in the \INFO subdirectory on the EtherDisk diskette
  388.   provides information about obtaining product support for the adapter.  
  389.  
  390.   3Com, EtherDisk, and EtherLink are registered trademarks of 3Com Corporation.
  391.   All other trademarks are the property of their respective owners.
  392.  
  393. (%VER  Configuration and Diagnostic Program Instructions Summary v4.2b)
  394.