# Creating a system configuration file for oamsys

When you finish creating the board keyword files, create a system configuration file. The system configuration file lists the type and location of each of the boards and assigns a board keyword file to each board. oamsys uses this file to create records in the OAM database for each of the boards.

The following table describes the settings to include in the file for each board:

Keyword | Description
--- | ---
[name] | Name used to refer to the board in software. This name must be unique.
Product | Name of the board product (for example, CG_6000C_QUAD).
Number | Board number you use in the Natural Access application to refer to the board.
Bus | PCI bus number. The bus:slot location for each board must be unique.
Slot | PCI slot number. The bus:slot location for each board must be unique.
File | Name of the board keyword file containing settings for the board.

You can also specify keyword and value pairs directly in the system configuration file instead of in separate board keyword files. This method is often useful if the board configurations are identical except for one or two parameters (such as clocking information).

If you need to determine configuration information for the boards, use the pciscan utility. This utility identifies the NMS Communications PCI boards installed in the system, and returns each board's bus, slot, interrupt, and board type. For more information about pciscan, refer to the NMS OAM System User's Manual.

The system configuration file you create must be named oamsys.cfg. This is the file name oamsys looks for by default.

## Sample system configuration file

The following sample system configuration file describes a CG 6000C board and an AG 4000C board:

[My_CG_Board]
Product = CG_6000C_QUAD
Number = 0
Bus = 0
Slot = 15
File = c:\nms\cg\cfg\mycgbrd.cfg
Clocking.HBus.ClockMode = MASTER_A
Clocking.HBus.ClockSource = OSC
[My_4000_Board]
Product = AG_4000C_2T1
Number = 1
Bus = 0
Slot = 16
File = c:\nms\ag\cfg\my40brd.cfg
Clocking.HBus.ClockMode = SLAVE
Clocking.HBus.ClockSource = A_CLOCK

The CG 6000C board is assigned board number 0 and is located at bus 0, slot 15. It is assigned a keyword file named mycgbrd.cfg. It is set up as the primary H.100 bus clock master, using its on board oscillator as its timing reference.

The AG 4000C board is assigned board number 1 and is located at bus 0, slot 16. It is assigned a keyword file named my40brd.cfg. It is set up as a slave to the primary master (the CG 6000C board).