Configuring CMDGODI.LAN under Novell Netware and DOS

This page provides information about:

For parameters used to configure adapter mirroring for CMDGODI.LAN, see Mirroring under Novell NetWare

Parameters

The following are driver parameters which you can specify on the LOAD CMDGODI command line.

If the computer contains multiple Madge adapters, use this parameter to select the adapter to use by its IO port. If the computer contains multiple Madge adapters and this parameter (or the SLOT or BIA parameter) is not specified, you will be prompted to enter a value.

If the computer contains multiple Madge Smart adapters, use this parameter to select the adapter to use by its slot number. This is an alternative to the PORT or BIA parameters. The slot number is actually a Hardware Instance Number (HIN) which Novell use to uniquely identify an adapter within the system. The HIN may or may not correspond obviously to a physical slot number, depending on the adapter/computer combination.

If the computer contains multiple Madge Smart adapters, use this parameter to select the adapter to use by its burned-in address (BIA). This is an alternative to the PORT or SLOT parameters.

A burned-in address is expressed as a 12-digit hexadecimal value,

Example: BIA=0000F6690012.

Use this to specify the frame type (TOKEN-RING or TOKEN-RING_SNAP).  For details, see Specifying Frame Type below.

Use this parameter to specify a locally administered node address override for the adapter. This address will be a 12-digit hexadecimal number in the range 400000000000 to 7FFFFFFFFFFF. If you do not specify an override (and this is the normal case), the adapter's unique burned-in address is used.

To set the name of a logical board, use this parameter.

Use this parameter to override the default adapter transfer mode with 16-bit PIO, where supported by the particular adapter. In general, Madge recommends that you configure the adapter's transfer mode using Assist.

Override the current adapter setting for ring speed (where possible). In general, Madge recommends that you configure the adapter's ring speed using Assist.

Use this parameter to enable or disable abnormal ring status and adapter closed / re-opened reporting. You cannot disable critical condition messages (for example, adapter check).

The parameters to the WARN= option are:

The defaults for this parameter are:

Use this parameter to override the default watchdog timeout period (in seconds) for Smart adapters. If the adapter does not hear from the host within the timeout period, the adapter will remove itself from the ring. A value of zero turns off the watchdog timer.

Use this parameter to cause the adapter to go into sleep mode when the driver is unloaded. When the adapter receives a MAGIC PACKETtm it will turn the PC on. This functionality is only supported on adapters and PCs which support Wake-On-LAN.

If you use the WOL parameter, the adapter will signal wakeup on the WOL connector (fly lead attached to the motherboard) only. If you use the WOL_PME parameter, the adapter will additionally signal wakeup using the PCI bus PME signal.

For more information, see Remote PC Wake-Up (Wake-On-LAN).

Use this parameter to PERMANENTLY disable promiscuous mode on supported adapters.

This parameter should be used with care since once promiscuous mode is disabled it can never be re-enabled.

For more information, see Limiting Frame Reception - Disabling Promiscuous Mode.

Display details of adapters in the computer. You can use this parameter before or after CMDGODI.LAN is loaded onto any adapters. The display indicates adapters currently in use by CMDGODI.LAN.

Display the help screen.

The following parameters are used to configure adapter mirroring for CMDGODI.LAN versions which support this feature. Refer to Mirroring Adapters for more information.

Advanced Configuration

To specify the frame type, use the FRAME= parameter on the command line. Both TOKEN-RING and TOKEN-RING_SNAP frame types may be loaded simultaneously on the same adapter. The frame types required depends on the protocols you wish to use. For example, IPX uses TOKEN-RING frames but TCP/IP uses TOKEN-RING_SNAP frames. Example:

    LOAD CMDGODI PORT=1000 FRAME=TOKEN-RING

    LOAD CMDGODI PORT=1000

    FRAME=TOKEN-RING_SNAP

The BIND command is used to bind a logical instance of the driver to a protocol stack. The NAME= parameter can be used to override the default name (CMDGODI). Example:

    LOAD CMDGODI PORT=1000 NAME=adapter1

    LOAD CMDGODI PORT=2000 NAME=adapter2

    BIND IPX TO adapter1 NET=A12002

    BIND IPX TO adapter2 NET=A12003

If you need to use source routing, load Novell ROUTE.NLM. Source routing must be used if NetWare servers are to communicate with workstations across a source routing bridge or switch. In the following example CMDGODI.LAN is loaded onto two adapters with two frame types each and source routing is loaded for each logical board:

    LOAD CMDGODI PORT=1000 FRAME=TOKEN-RING NAME=adapter1

    LOAD ROUTE BOARD=1

    LOAD CMDGODI PORT=1000 FRAME=TOKEN-RING_SNAP NAME=adapter1_SNAP

    LOAD ROUTE BOARD=2

    LOAD CMDGODI PORT=2000 FRAME=TOKEN-RING NAME=adapter2

    LOAD ROUTE BOARD=3

    LOAD CMDGODI PORT=2000 FRAME=TOKEN-RING_SNAP NAME=adapter2_SNAP

    LOAD ROUTE BOARD=4

The maximum frame size which CMDGODI.LAN will support on a NetWare server is configured by placing the following line in STARTUP.NCF:

    SET MAXIMUM PHYSICAL RECEIVE PACKET SIZE=<max frame size>

Note that the actual maximum frame size used is limited by the maximum size supported at the configured ring speed. Setting this parameter to a number greater than is actually required wastes memory.

When the driver is running, the user can choose to shutdown or reset individual boards or adapters without having to unload the driver, using the following console commands:

This command removes an instance of a logical board which is currently loaded.

Since a logical board is a particular adapter/frame type combination, this command stops the adapter from using a particular frame type which was previously loaded.

This command removes all logical boards loaded on the specified adapter. The filename specified is CMDGODI.

This command performs a partial shutdown of the specified logical board. This temporarily suspends usage of the logical board, until a "RESET NETWORK INTERFACE" command is issued to reset the board.

This command resets the specified network adapter at the hardware level. The filename is CMDGODI.

This command resets the specified logical board. It can be used to restore operation of a logical board which was suspended using "SHUTDOWN NETWORK INTERFACE".

To determine the current configuration of adapters in the machine, type either "CONFIG" or "LOAD CMDGODI DISPLAY" from the console command line.

See Also: