Creating a system configuration file for oamsys

When your board keyword files are complete, 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 on 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 AG board-specific settings to include in the system configuration file for each AG board:

Keyword

Description

Allowed values for AG boards

[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.

AG_2000C

Number

Board number you use in the Natural Access 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.

Several board keyword files are installed with the AG software, one for each country or region.

For information about creating a custom board keyword file, refer to Changing configuration parameter settings.

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 applied in the order in which they are 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 AG 2000C boards, both to be configured for the United States:

[First AG 2000C]
Product = AG_2000C
Number  = 0
Bus     = 0
Slot    = 15
File    = agpi2000c.cfg

[Second AG 2000C]
Product = AG_2000C
Number  = 1
Bus     = 0
Slot    = 16
File    = agpi2000c.cfg