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