(Page 1 of 1 in this chapter) Version

Chapter 3

Configuring the Software

3.1 Introduction

3.2 Configuring the Software Under Windows NT

3.3 Configuring the Software Under UNIX

: 3.3.1 Adding a Board
: 3.3.2 Configuring a Board
: 3.3.3 Deleting a Board

3.1 Introduction

This chapter describes the procedure for configuring the TX 3220C board on the following operating systems: Windows NT UNIX

3.2 Configuring the Software Under Windows NT

After installing the base/device driver software and TX 3220C hardware, you may wish to change the software configuration. While in most cases there will be no need to change the default configuration, this section will explain how to change the default settings, if required.

Click the Start button, point to Settings, and click Control Panel.

Click NMS TX CPs. The Configure/Install/Remove TX dialog box displays a list of currently installed TX CPs.

Note: The Install TXn000 button allows you to install/configure ISA-based
TX 2000 and TX 3000 adapters. For detailed instructions on configuring the ISA-based TX boards, see the TX 2000/TX 3000 Installation Manual. The Help button also appears in this dialog box. If at any time you have questions about the configurable fields and their respective values, return to this window and click the Help button. The help dialog box appears.
Select the type of driver you would like help with and an index of help topics will appear.

Highlight the TX CP to be configured and click Configure Selected CP. The NMS PCI TX Configuration dialog box appears.

The General tab is automatically selected. The table shows the available options and a brief description of each one.

Field

Description

Serial #

The serial number of the TX 3220C board that is currently selected.

Model

The type of TX 32xx board currently installed (3210 or 3220).

Adapter

An adapter letter (A-P) assigned to the CP by the TX 32xx device driver. This letter is used for NMS internal software purposes, but may also appear in driver-produced messages in a Windows NT event log.

Device ID

Address assigned to the current CP for use in transferring messages between the host and the CP or between multiple CPs. This value must be unique for every TX CP in the host PC.

Name for Display

The text name that is associated with the board highlighted in the Configure/Install/Remove TX dialog box (see step 2).

Cpi Library Alias CP

Number assigned to current CP for use by applications that access CPs via the NMS CPI Library software API. This value must be unique within the set of all TX boards installed in the system. CP numbers that are already allocated to another board do not appear in this list. Selecting the Disabled option will disable the CPI Library API.

Caution:

The Cpi Library Alias CP field identifies the board number of the particular TX board you are configuring. All TX software uses this board number to identify which TX board to access. Leaving a value of 0 in this field will prevent the host software from accessing the TX board.

Click the TX Memory tab.

Maximum Outstanding Sends determines the number of outstanding messages which can be sent by the TX 32xx driver to the CP without a reply being sent back by the TX 3220C. This is intended to prevent host applications from monopolizing memory by sending large bursts of messages. This value can range from 1 (MIN) to 256 (MAX).

Click the TX Options tab.

The following fields are user-defined:

Field

Description

MVIP-90 Mode Enabled

Indicates whether or not the CP hardware has an MVIP-90 Bus Adapter installed. This is not used with the TX 3220C.

Number of 68360s with ss7 uCode

Currently ignored; reserved for future enhancements.

Number of 68360s in QUICC32 mode

Currently ignored; reserved for future enhancements.

Click the Host Options tab.

The following fields are user-defined:

Field

Description

Seconds until unread input is discarded

Determines how quickly the driver discards unread input. A value of 0 disables this parameter.

Seconds of inactivity until an alive check sequence is performed

Determines how often the TX 32xx driver sends an "Are you still alive?" message to the CP. A value of 0 disables this parameter.

Max. Connection Count

Sets the maximum number of open handles to this particular TX 3220C board.

When you have defined every field, click OK. This will close NMS PCI TX Configuration and return you to the Configure/Install/Remove TX dialog box. If you have other TX 3220C boards, highlight the next board to configure and click Configure Selected CP. When every board has been configured, click Exit.

You must restart your computer at this time in order to allow the configuration changes to take effect.

Note: For information on the Statistics tab, see Section 5.4.1, Viewing the Statistics for the TX 3220C Board (Windows NT). The Debug tab is used for developer purposes only. It is recommended that you do not make any changes to this dialog box.

Field	Description
Serial #	The serial number of the TX 3220C board that is currently selected.
Model	The type of TX 32xx board currently installed (3210 or 3220).
Adapter	An adapter letter (A-P) assigned to the CP by the TX 32xx device driver. This letter is used for NMS internal software purposes, but may also appear in driver-produced messages in a Windows NT event log.
Device ID	Address assigned to the current CP for use in transferring messages between the host and the CP or between multiple CPs. This value must be unique for every TX CP in the host PC.
Name for Display	The text name that is associated with the board highlighted in the Configure/Install/Remove TX dialog box (see step 2).
Cpi Library Alias CP	Number assigned to current CP for use by applications that access CPs via the NMS CPI Library software API. This value must be unique within the set of all TX boards installed in the system. CP numbers that are already allocated to another board do not appear in this list. Selecting the Disabled option will disable the CPI Library API.

Caution:	The Cpi Library Alias CP field identifies the board number of the particular TX board you are configuring. All TX software uses this board number to identify which TX board to access. Leaving a value of 0 in this field will prevent the host software from accessing the TX board.

Field	Description
MVIP-90 Mode Enabled	Indicates whether or not the CP hardware has an MVIP-90 Bus Adapter installed. This is not used with the TX 3220C.
Number of 68360s with ss7 uCode	Currently ignored; reserved for future enhancements.
Number of 68360s in QUICC32 mode	Currently ignored; reserved for future enhancements.

Field	Description
Seconds until unread input is discarded	Determines how quickly the driver discards unread input. A value of 0 disables this parameter.
Seconds of inactivity until an alive check sequence is performed	Determines how often the TX 32xx driver sends an "Are you still alive?" message to the CP. A value of 0 disables this parameter.
Max. Connection Count	Sets the maximum number of open handles to this particular TX 3220C board.

3.3 Configuring the Software Under UNIX

After installing the base/device driver software and TX 3220C hardware, you may wish to change the software configuration. While in most cases there will be no need to change the default configuration, this section will explain how to change the default settings, if required.

3.3.1 Adding a Board

Any TX 3220C boards in the system will be automatically configured when the TX Base software is installed. If you need to add additional TX 3220C boards, perform the following steps: Shutdown the system Physically add the TX 3220C board(s) Boot the system Using a text editor, open the cpcfg file, located in the /opt/nmstx/bin/ directory. The display will look similar to this: # Command BUS SLOT SPID # ------- --- ---- ---- # txcpcfg 0 0 1 To add a TX 3220C board to the configuration, you will have to know the BUS and SLOT values for the new TX 3220C board. To determine the BUS and SLOT values for the new TX 3220C board, navigate to the /opt/nmstx/bin directory and run the pcigetcfg utility. The display will look similar to this: # pcigetcfg NUMCNTLS = 2 HWTYPE0 = 3220 SERIAL0 = 0x55a9e CPID0 = -1 BUS0 = 2 SLOT0 = 5 Add a new line to the cpcfg file for the TX 3220C board to be added. Enter the BUS and SLOT values provided by the pcigetcfg utility. The CPID value must be unique for all the TX boards in your system. Save the file and run cpcfg to apply your new configuration settings.

3.3.2 Configuring a Board

To configure a TX 3220C board: Using a text editor, open the cpcfg file, located in the /opt/nmstx/bin/ directory. The display will look similar to this: # Command BUS SLOT SPID # ------- --- ---- ---- # txcpcfg 0 0 1 Enter the new values for the BUS, SLOT, or SPID fields of the TX 3220C board you want to configure. Note: The BUS and SLOT values must match the values provided by the pcigetcfg utility. The TX 3220C board will not function if the values do not match. The CPID value must be unique for all TX boards contained in your system. Save the file and run cpcfg to apply your new configuration settings.

3.3.3 Deleting a Board

To remove a TX 3220C board from the configuration: Using a text editor, open the cpcfg file, located in the /opt/nmstx/bin/ directory. The display will look similar to this: # Command BUS SLOT SPID # ------- --- ---- ---- # txcpcfg 0 0 1 Remove the line(s) containing the configuration information for the TX 3220C board(s) you wish to remove. Save the file and run cpcfg to apply your new configuration settings.

(Page 1 of 1 in this chapter) Version

tech_support@nmss.com