# Modifying the board keyword file

NMS OAM uses board keyword files to load and initialize all AG and CG boards in your system. To use NaturalFax, modify the board keyword files to:

- Explicitly allocate the DSPs on the board to perform fax functions.

- Specify the NaturalFax runtime software to be downloaded at board initialization.

Use the sample board keyword files provided with NaturalFax as models. Choose a board keyword file that corresponds to the hardware installed in your system.

For more information about... | Refer to...
--- | ---
Fax performance | Strategies for optimizing performance.
NMS OAM | The NMS OAM System User's Manual.
The keywords specified for each board | The board-specific installation and developer's manual.

The NMS OAM configuration files invoke the board keyword files. The NMS OAM configuration files are located in the following directories:

Operating system | Directory
Windows | \nms\ag\cfg \nms\oam\cfg
UNIX | /opt/nms/ag/cfg /opt/nms/oam/cfg

The following table lists some of the sample board keyword files for boards that support NaturalFax.

Note: These board keyword files are valid for CompactPCI, PCI, and PCIe (PCI Express) boards. When using the NMS OAM configuration file on a CompactPCI board, change the product name in the file to the board name (for example, AG_2000C).

Board | Board keyword file | Description
--- | --- | ---
AG 2000/200 AG 2000/400 | agpi2fax.cfg | mu-law fax transmit and receive configuration file
agpi2faxa.cfg | A-law fax transmit and receive configuration file
AG 2000-BRI | agpi2bri_fax.cfg | mu-law fax transmit and receive configuration file
agpi2bri_faxa.cfg | A-law fax transmit and receive configuration file
CG 6060 | cg6060faxa.cfg | A-law fax and IVR configuration file
CG 6565 | cg6565fax.cfg | mu-law fax and IVR configuration file

## Configuring AG boards

Complete the following steps to modify the board keyword file to run NaturalFax on AG boards:

Step | Action
1 | Verify that the DLMFiles keyword includes ag2fax.leo: DLMFiles[x] = ag2fax.leo
2 | Verify that the DSP.C5x[x].Image keyword includes the following files: For mu-law: DSP.C5x[x].Image = ag2fax.c54 For A-law: DSP.C5x[x].Image = ag2faxa.c54
3 | Save the changes to the board keyword file and exit the text editor.
4 | Run NMS OAM to configure and initialize the AG board(s) as specified in the oamsys.cfg file.
5 | Refer to the sample board keyword files for AG 2000 boards.

## Configuring CG boards

Complete the following steps to modify the board keyword file to run NaturalFax on CG boards:

Step | Action
1 | Verify that the DLMFiles[x] keyword includes the board keyword file. For CG 6565, CG 6565C, and CG 6565E boards: DLMFiles[x] = cg6565fax For CG 6060/C boards: DLMFiles[x] = cg6060fax
2 | Verify that the DSP.C5x[x].Files keyword identifies nmsfax as one of the data processing modules (DPMs) loaded on specific DSPs. The following example is for a CG 6x6x board: DSP.C5x[1..31].Files = nmsfax voice tone dtmf echo callp ptf mf
3 | Verify that the Resource[0].Definitions keyword identifies nmsfax as one of the data processing functions (DPFs) loaded on the DSPs. The following example is for a CG 6x6x board: Resource[0].Definitions = (nmsfax | (dtmf.det_all & ptf.det_2f & voice.rec_24 & (voice.play_24_100 | tone.gen)))
4 | Save the changes to the board keyword file and exit the text editor.
5 | Run NMS OAM to configure and initialize the CG board or boards as specified in the oamsys.cfg file.

For more information, refer to the Sample board keyword files.