Creating a system configuration file for oamsys

Create a system configuration file describing all of the boards in your system. oamsys creates the records, and then directs NMS OAM to start the boards, configured as specified. The system configuration file is typically named oamsys.cfg. By default, oamsys looks for a file with this name when it starts up. Refer to the NMS OAM System User's Manual for specific information about the syntax and structure of this file.

Note: You can use the oamgen utility (included with the NMS OAM software) to create a sample system configuration file for your system. The system configuration file created by oamgen may not be appropriate for your configuration. You may need to make further modifications to the file before running oamsys to configure your boards based on the file. For more information about oamgen, refer to the NMS OAM System User's Manual.

The following table describes the CX 2000 board-specific settings to include in the system configuration file for each board:

Keyword

Description

Allowed values for CX 2000 products

[name]

Name of the board to be used to refer to the board in the software. The board name must be unique.

Any string, in square brackets [].

Product

Name of the board product.

CX 2000-16
CX 2000-32
CX_2000

Number

Board number you use in the application to refer to the board.

Any integer from 0 to 31. Each board's number must be unique.

Bus

PCI bus number. The bus:slot location for each board must be unique.

Values returned by pciscan.

Slot

PCI slot number. The bus:slot location for each board must be unique.

Values returned by pciscan.

File

Name of the board keyword file containing settings for the board.

You can specify more than one file after the File keyword:

File = mya.cfg myb.cfg myc.cfg

Alternatively, you can specify the File keyword more than once:

File = mya.cfg
File = myb.cfg
File = myc.cfg

Board keyword files are sent in the order listed. The value for a given keyword in each file overrides any value specified for the keyword in earlier files.


Sample system configuration file

The following system configuration file describes two CX 2000 boards: