# 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 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_2000_BRI
Number | Board number you use in the Natural Access application to refer to the board. | 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 your own 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 2000-BRI boards:

[First AG 2000-BRI]
Product = AG_2000_BRI
Number = 0
Bus = 0
Slot = 15
File = agpi2bri.cfg
[Second AG 2000-BRI]
Product = AG_2000_BRI
Number = 1
Bus = 0
Slot = 16
File = agpi2bri.cfg