home *** CD-ROM | disk | FTP | other *** search
/ ftp.tcs3.com / ftp.tcs3.com.tar / ftp.tcs3.com / DRIVERS / Network / 3COM / 3c90x / Ver5.01 / 3c90xx2.exe / HELP / DOSDIAG.TXT < prev    next >
Text File  |  1999-06-01  |  13KB  |  337 lines
  1.                          3Com (R) Corporation
  2.                     3C90x EtherLink PCI NIC Family
  3.           3Com NIC Configuration and Diagnostic Program for DOS
  4.  
  5.  
  6. Overview
  7. --------
  8. The configuration portion of the 3Com NIC Configuration and Diagnostics
  9. program for DOS allows you to change the configuration parameters 
  10. for the NIC to fit the specific environment in which the NIC is 
  11. installed.
  12.  
  13. The diagnostics portion of the program is designed to make sure that 
  14. the NIC is installed correctly and functioning properly in the PC.
  15. It consists of the following tests:
  16.  
  17.    The Group 1 tests check the physical components, connectors, and 
  18.    circuitry of the NIC and require only that the NIC be installed in 
  19.    the PC.
  20.  
  21.    The Group 2 tests check the ability of the NIC to transmit data on the
  22.    network; these require that the NIC be connected to a loopback plug 
  23.    or to a network (for 3C900-COMBO or 3C900-TPC NICs).  
  24.  
  25.    The Group 3 tests check the ability of the NIC to correctly transmit and 
  26.    receive data over the network; these require that the NIC be connected 
  27.    to a network on which an echo server has been set up.
  28.  
  29. The PC that contains the NIC to be configured or tested must be running 
  30. DOS only (reboot with a DOS-only diskette) and must have at least 505KB 
  31. of free memory.
  32.  
  33. NOTE:  If the PC is an operating server, notify all users of the
  34.        server to save their work and to log out from the network before
  35.        running the Configuration and Diagnostics program. The program 
  36.        disrupts the normal operation of servers and workstations, 
  37.        and work that is not saved may be lost.
  38.  
  39.  
  40. Starting the 3Com NIC Configuration and Diagnostics Program for DOS
  41. ------------------------------------------------------------------
  42.  
  43. There are two ways to start the program:
  44.  
  45. 1.  Automatically (from INSTALL.EXE) by selecting 
  46.     Configuration and Diagnostics Program on the main menu.
  47.  
  48. 2.  Manually, from the root directory of the EtherCD or EtherDisk diskette 2, 
  49.     by typing the following command:
  50.  
  51.     3C90XCFG [command keyword] [parameter list]
  52.  
  53.     3C90XCFG represents the 3Com NIC Configuration and Diagnostics program
  54.     name.
  55.     The brackets indicate that the command keyword and parameter list are
  56.     optional.
  57.  
  58.     3C90XCFG without any arguments invokes the program in full Windows
  59.     mode. This includes mouse support and context-sensitive help.  
  60.     Press [F1] for help at any time.
  61.  
  62.  
  63.     Command Line Keywords
  64.     ---------------------
  65.     You can use the first two characters of any command or parameter as a 
  66.     shortcut. For example, 3C90XCFG HE RU means 3C90XCFG HELP RUN.
  67.  
  68.     The command keywords and parameters are not case-sensitive (for
  69.     example, CONFIGURE, configure, and Configure, will all work).
  70.  
  71.  
  72.     CONFIGURE
  73.         Configures a NIC in one of three ways:
  74.         1.  Automatically with the /auto parameter
  75.         2.  Using a specified NIC configuration file
  76.         3.  Using command line configuration parameters
  77.  
  78.     ECHOSERVER
  79.         Enables a designated NIC to function as an echo
  80.         server.
  81.  
  82.     HELP 
  83.         Displays general or command-specific help information.  
  84.         To get command-specific help, type:
  85.  
  86.         3C90XCFG HELP [command keyword]
  87.  
  88.     LANGUAGE 
  89.         Invokes the program in full Windows mode using a 
  90.         specified external resource file. This option provides
  91.         support for multiple languages through a different resource
  92.         file for each language supported.
  93.        
  94.     LIST 
  95.         Displays a list of installed NICs and their recognized 
  96.         NIC numbers.
  97.        
  98.     RUN 
  99.         Executes the diagnostic tests (which can also be specified
  100.         from a file) on a selected NIC and writes the results 
  101.         to the screen, a file, or a printer.
  102.  
  103.  
  104. Configuration
  105. -------------
  106. The NIC can be configured in either full-screen Windows mode or 
  107. command line mode.
  108.  
  109.  
  110.     Full Screen Windows Mode
  111.     ------------------------
  112.     To configure the NIC using full-screen windowing, type:
  113.     
  114.     3C90XCFG [Enter] 
  115.     
  116.     Then select the Configure NIC option from the Install menu.
  117.  
  118.  
  119.     Command Line Mode
  120.     -----------------
  121.         Command Line Mode Defaults
  122.         --------------------------
  123.         Defaults: CONFIGURE has /AUTO and /ADAPTERNUM:1 as defaults.  
  124.         So, for example, if only 3C90XCFG CONFIGURE is used, NIC 
  125.         number 1 is automatically configured.
  126.  
  127.         ADAPTERNUM:N and /SLOT:S parameters can be used with any of the 
  128.         CONFIGURE options that follow. They are both intended for use 
  129.         whenever multiple NICs are present in the PC and 
  130.         recognized by the Configuration and Diagnostics program.
  131.  
  132.         /ADAPTERNUM:N specifies the number of the NIC to be configured for 
  133.         PCI computers. Run the LIST command separately to determine the 
  134.         NIC number to use here.
  135.  
  136.     There are three different ways to configure the NIC using 
  137.     command-line mode: 
  138.     
  139.     1.  Command line with auto configuration
  140.  
  141.     2.  Command line with explicit parameters
  142.  
  143.     3.  Command line with configuration file
  144.      
  145.      
  146.         Command Line with Auto Configuration
  147.         ------------------------------------
  148.         Command syntax:  3C90XCFG CONFIGURE  /AUTO
  149.  
  150.         The /AUTO parameter configures the NIC media type 
  151.         automatically. All other options settings are left unchanged.
  152.  
  153.         NOTE:  The program attempts to detect what media type is being 
  154.                used. Therefore, connect to the network first and then run        
  155.                3C90CFG CONFIGURE /AUTO. The program configures the 
  156.                media type for you.
  157.  
  158.  
  159.         Command Line with Explicit Parameters
  160.         -------------------------------------
  161.         Command syntax:  3C90XCFG CONFIGURE  [ /BSTATE:N  /XCVR:N  /TR:N
  162.                          /FULLDUPLEX:N /OPTIMIZE:N  /LINKBEAT:N ]
  163.  
  164.         Command line configuration parameters are used to configure the 
  165.         NIC using only the option settings you specify. Some 
  166.         parameters are for all NICs; some are for PCI only. For 
  167.         example, /BSTATE:N is a PCI-only parameter. In most cases, any 
  168.         combination of parameters can be used. Therefore, it is possible
  169.         to modify only a few settings if needed.
  170.  
  171.         /BSTATE           
  172.             Boot PROM state  
  173.             Possible values - disabled, enabled
  174.  
  175.         /TR (or /XCVR)
  176.             Transceiver  
  177.             Possible values - Auto, 100BASE-TX, 10BASE-T, COAX, AUI,
  178.                               100BASE-T4, 10BASE-FL, and 100BASE-FX
  179.  
  180.         /OPTIMIZE 
  181.             Network Driver Optimization
  182.             Possible values - NORMAL, NETWORK, CPU
  183.  
  184.         /LINKBEAT
  185.             Link Beat disable/enable (pre-10BASE-T standard only)
  186.             Possible values - disabled, enabled
  187.             
  188.             NOTE:  Try this setting ONLY if pre-10BASE-T standard hubs
  189.                    are in use.
  190.  
  191.         /FULLDUPLEX
  192.             Full Duplex disable/enable 
  193.             Possible values - disabled, enabled
  194.  
  195.             NOTE:  Enable this setting ONLY if the NIC is
  196.                    connected to a 100BASE-T or 10BASE-T repeater
  197.                    that supports full duplex. Otherwise, it will bring 
  198.                    down the network.
  199.  
  200.  
  201.         Command Line with Configuration File
  202.         ------------------------------------
  203.         Command syntax:  3C90XCFG CONFIGURE  /CONFIGFILE:filename
  204.  
  205.         /CONFIGFILE:filename is used to configure a NIC with the
  206.         settings specified in an ASCII configuration file that can be 
  207.         created and modified by any text editor. The filename can be
  208.         a fully qualified DOS filename including a path. A standard
  209.         format for the file must be used, as follows:
  210.        
  211.         -   Variable names and values match the wording in the
  212.             full-screen Configure window in most cases.
  213.  
  214.         -   Begin each variable/value line with an "at" symbol (@), 
  215.             followed by a variable name, a colon (:), and the value.
  216.  
  217.             Example:  @Media type: 100BASE-TX
  218.  
  219.         -   Blank lines and other white spaces are allowed between 
  220.             variable lines.
  221.  
  222.         -   Start any comment lines with a semicolon (;).
  223.  
  224.         -   The variable names allowed are:
  225.             Boot PROM state
  226.             Media type
  227.             Network driver optimization
  228.             Full duplex
  229.             Link beat
  230.  
  231.         -   The values allowed are the same as those shown in the 
  232.             full-screen Configure window.
  233.         
  234.             Example 1:  @Network driver optimization:Normal
  235.             Example 2:  @Media type:On-board Coax
  236.  
  237.  
  238. Diagnostics
  239. -----------
  240.  
  241.     Full-Screen Windows Mode
  242.     ------------------------
  243.     To run the diagnostic tests using full-screen windowing, type:
  244.     
  245.     3C90XCFG [ENTER] 
  246.     
  247.     Then select the Run Tests option from the Tests menu.
  248.  
  249.     
  250.     Command Line Option - RUN
  251.     -------------------------
  252.  
  253.     Command syntax:  3C90XCFG RUN  [/TESTFILE:filename] [/RESULTS:[filename
  254.                      | PRN | PRNHP]] [/ADAPTERNUM:N]
  255.  
  256.     The RUN parameter executes the diagnostic tests on a selected NIC
  257.     and displays the results on the screen. The defaults are NIC
  258.     number 1 and Group 1 tests. The parameters below are all optional.
  259.  
  260.     /TESTFILE:filename 
  261.          Specifies a test file that contains a specific test setup
  262.          description.
  263.  
  264.     /RESULTS:[filename or PRN or PRNHP] 
  265.          Specifies an alternative location to store the test results.
  266.          This location can be a DOS path and filename, PRN printer port
  267.          (same as LPT1), or PRNHP, which is an HP LaserJet printer
  268.          connected to LPT1.
  269.  
  270.     /ADAPTERNUM:N 
  271.          Specifies the NIC number to be tested, in the case of
  272.          multiple NICs installed in the PC and recognized by 
  273.          this program. Run the LIST command separately (see LIST below)
  274.          to determine the NIC number to use.
  275.  
  276.  
  277. Other Command Line Options
  278. --------------------------
  279.  
  280. HELP
  281.     Command syntax:  3C90XCFG HELP  [Command Keyword]
  282.  
  283.     HELP is an on-line summary of commands. Without a command keyword
  284.     specified, it gives a summary of the command keywords. With a command 
  285.     keyword specified, it gives the parameter choices for that particular 
  286.     command. For example, 3C90XCFG HELP CONFIGURE gives details about the 
  287.     parameter options for the CONFIGURE command.
  288.  
  289. LANGUAGE
  290.     Command syntax:  3C90XCFG LANGUAGE  /LANGFILE:filename
  291.  
  292.     LANGUAGE invokes the program in full Windows mode using a specified
  293.     external resource file. This option provides support for multiple
  294.     languages through a different resource file for each language supported.
  295.  
  296.     /LANGFILE:filename is a required parameter with this command.
  297.     The filename is the name of the resource file that is loaded by the
  298.     program. The filename can be a fully qualified DOS filename.
  299.  
  300.     NOTE: At this time, there are no alternative resource files included 
  301.           on the EtherCD or EtherDisk diskette.
  302.  
  303. LIST
  304.     Command syntax:  3C90XCFG LIST
  305.  
  306.     LIST displays a list of currently installed NICs (and their 
  307.     assigned NIC numbers) that are recognized by this program. The 
  308.     NIC number is then used as the N value for the /ADAPTERNUM:N 
  309.     parameter when multiple NICs are installed.  There are no 
  310.     parameters associated with the LIST command keyword.
  311.  
  312. ECHOSERVER
  313.     Command syntax:  3C90XCFG ECHOSERVER  [/ADAPTERNUM:N]
  314.  
  315.     ECHOSERVER enables a NIC to function within an echo server.
  316.     /ADAPTERNUM:N specifies the NIC to be configured in the 
  317.     echo server, in the case of multiple NICs. 
  318.  
  319.  
  320. Further Assistance
  321. ------------------
  322. If the NIC fails any of the diagnostic tests, see the TROUBLE.TXT file
  323. in the \HELP directory on the EtherCD (or EtherDisk diskette 2) for 
  324. troubleshooting procedures.
  325.  
  326. The SUPPORT.TXT file in the \HELP directory on the EtherCD (or EtherDisk 
  327. diskette 2) provides information about obtaining product support for 
  328. the NIC.
  329.  
  330.  
  331. 3Com, EtherDisk, and EtherLink are registered trademarks of 3Com
  332. Corporation. All other trademarks are the property of their respective 
  333. owners.
  334.  
  335.  
  336. (%VER DOSDIAG.TXT - Configuration and Diagnostic Program Instructions v5.1.0)
  337.