# Creating a system configuration file for oamsys

Create a system configuration file describing all of the boards in your system. oamsys creates 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 2000C board-specific settings to include in the system configuration file for each board:

Keyword | Description | Allowed values for CX 2000C 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 2000C-48 CX 2000C-32 (for both CX 2000C-32 and CX 2000C-32-R)
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 2000C boards:

- Board number 0 is located at bus 0, slot 15. It is assigned a keyword file named cx-master.cfg.

- Board number 1 is located at bus 0, slot 16. It is assigned a keyword file named cx-slave.cfg.

- [CX-0]
  Product = CX 2000C-48
  Number = 0
  Bus = 0
  Slot = 15
  File = c:\nms\cx\cfg\cx-master.cfg
  [CX-1]
  Product = CX 2000C-32
  Number = 1
  Bus = 0
  Slot = 16
  File = c:\nms\cx\cfg\cx-slave.cfg