(Page 1 of 1 in this chapter) Version

Chapter 3

Configuring the Software

3.1 Introduction

: 3.1.1 Configuring the Software Under Windows NT
: 3.1.2 Configuring the Software Under Solaris x86

3.1 Introduction

This chapter describes the procedure for configuring the TX 3220 board under the following operating systems: Windows NT Solaris x86

3.2 Configuring the Software Under Windows NT

After installing the base/device driver software and TX 3220 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 (shown in step 1). The Configure/Install/Remove TX dialog box appears.

A list of currently installed TX Series CPs is displayed.
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 3220 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 CP or between multiple CPs. This value must be unique for every TX CP in the host personal computer.

Name for Display

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

Cpi Library Alias CP

Number assigned to current CP for use by applications which 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 3220. This is intended to prevent host applications from "hogging" 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. See Section 2.4.2 for more information on the MVIP-90 Bus Adapter.

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

Allows the administrator to govern how quickly the driver discards unread input. A value of 0 disables this parameter.

Seconds of inactivity until an alive check sequence is performed

Allows the administrator to govern 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

Allows the administrator to set the maximum number of open handles to this particular TX 3220 board.

For information on the Statistics tab, see Section 5.4.1, Viewing the Statistics for the TX 3220 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.

When every field has been defined, 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 3220 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.

Field	Description
`Serial #`	The serial number of the TX 3220 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 CP or between multiple CPs. This value must be unique for every TX CP in the host personal computer.
`Name for Display`	The text name that is used to identify the highlighted board in the Configure/Install/Remove TX dialog box (see step 2).
`Cpi Library Alias CP`	Number assigned to current CP for use by applications which 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. See Section 2.4.2 for more information on the MVIP-90 Bus Adapter.
`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`	Allows the administrator to govern how quickly the driver discards unread input. A value of 0 disables this parameter.
`Seconds of inactivity until an alive check sequence is performed`	Allows the administrator to govern 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`	Allows the administrator to set the maximum number of open handles to this particular TX 3220 board.

3.3 Configuring the Software Under Solaris x86

After installing the base/device driver software and TX 3220 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. Run the pciinst utility, located in the /usr/bin/ directory. The following message appears: You will now be asked to configure (add or modify) a txpci board. If you wish to add a board configuration, make sure the board is physically installed in the system. If you wish to remove a board configuration, you must have physically removed the board from the system. If not, quit now, shutdown the system, remove the board, and re-run this script when the machine restarts (to re-number the boards, if desired). Configure a txpci board or Quit now (c/q): If you want to abort the configuration process, type q, and press <enter>. The script will abort and you will be returned to the user prompt. To continue with the configuration process, type c and press <enter>. The output will look similar to the following example: There were two boards detected in the system: cpid(1) serial(0x1a5) hwtype(3220) cpid(2) serial(0x1a2) hwtype(3220) Enter a CPID (1 or greater) for the TX 3220 board ser# 0x1a5: The CPID is a number assigned to the current CP for use by applications which 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. Type a unique number (1 or greater) and press <enter>. The following prompt will appear: Do you want MVIP-90 compatibility enabled for board 1 (y/n): If the TX 3220 board has an MVIP Bus Adapter installed (see Section 2.4.2, Connecting to the MVIP-90 Bus), type y and press <enter> to continue. Otherwise, type n and press <enter>. Repeat steps three and four for each TX board in the system. When every TX board in the system has been assigned a unique CPID value, a new list of installed CPs appears: Here is the new system configuration: cpid(3) serial(0x1a5) hwtype(3220) cpid(4) serial(0x1a2) hwtype(3220) Do you want to keep this configuration (y/n/q): If you wish to discard the changes you have made, type n or q and press <enter>. The script will abort and you will have to run pciinst again to make any changes. If you are satisfied with the new changes, type y and press <enter>. The script will exit. You can configure additional features of the TX 3220 software by editing the txpci.conf file, located in the /platform/i86pc/kernel/drv/ directory. When you open txpci.conf with a text editor, the output should be similar to this: toffset = -360 maxsend = 32 readtime = 10 alivetime = 15 maxconn = 64 total-units = 2 interrupt-priorities = 5 # hardware type: 3220 serial-1=0x1a2 cpid-1=1 mvip-1=0 # hardware type: 3220 serial-2=0x1a5 cpid-2=0 mvip-2=0 ; The following table explains the txpci.conf fields and their respective ranges: Field Name Description toffset OS-specific information and should never be changed. maxsend Determines the number of outstanding messages that can be sent by the TX 32xx driver to the CP without a reply being sent back by the TX 3220 board. This is intended to prevent host applications from "hogging" memory by sending large bursts of messages. This value can range from 1 (MIN) to 256 (MAX). readtime Governs how quickly the driver discards unread input (in seconds). A value of 0 disables this parameter. alivetime Governs how often the TX 32xx driver sends an "Are you still alive?" message to the CP (in seconds). A value of 0 disables this parameter. maxconn Sets the maximum number of open handles to the TX 3220 board. This value can be 64, 128, 256, 512, 1024, or 2048. total-units The number of installed CPs in the current system. interrupt-priorities Identifies the priority level of the IRQ assigned to the TX 3220 board. This value should never be changed.

Field Name	Description
`toffset`	OS-specific information and should never be changed.
`maxsend`	Determines the number of outstanding messages that can be sent by the TX 32xx driver to the CP without a reply being sent back by the TX 3220 board. This is intended to prevent host applications from "hogging" memory by sending large bursts of messages. This value can range from 1 (MIN) to 256 (MAX).
`readtime`	Governs how quickly the driver discards unread input (in seconds). A value of 0 disables this parameter.
`alivetime`	Governs how often the TX 32xx driver sends an "Are you still alive?" message to the CP (in seconds). A value of 0 disables this parameter.
`maxconn`	Sets the maximum number of open handles to the TX 3220 board. This value can be 64, 128, 256, 512, 1024, or 2048.
`total-units`	The number of installed CPs in the current system.
`interrupt-priorities`	Identifies the priority level of the IRQ assigned to the TX 3220 board. This value should never be changed.

(Page 1 of 1 in this chapter) Version

tech_support@nmss.com