# Running oamsys

After you create all necessary configuration files, you are ready to use the oamsys utility. To run oamsys, enter the following command from the command line:

oamsys options

where

Option | Description
-f filename | Specifies the file name (and path, if necessary) of a system configuration file to load. If you invoke oamsys without this option, it searches for a file named oamsys.cfg in the current directory, and then in the paths specified in the AGLOAD environment variable. If you specify a file name without an extension, oamsys assumes the extension to be .cfg.
-@ host | Loads the configuration file on the specified resource host. host is an IP address or machine name. If unspecified, the operations are performed on the host on which the utility was initialized.

oamsys reads system configuration files, not board keyword files. Board keyword files to be added to the NMS OAM database must be specified within the system configuration file. Refer to Creating a system configuration file for oamsys.

When you invoke oamsys with a valid file name, oamsys performs the following tasks:

- Checks the syntax of the system configuration file, and ensures that all required keywords are present. oamsys reports any syntax errors it finds.

Note: oamsys verifies the syntax of the system configuration file, but not of the board keyword files.

- Checks for uniqueness of board names, board numbers, bus numbers, and slot numbers within the system configuration file.

- Shuts down all boards referenced in the NMS OAM database.

- Deletes all board configuration information currently stored in the NMS OAM database.

- Sets up the NMS OAM database according to settings in the system configuration file and any referenced board keyword files.

- Attempts to start all boards according to the description in the database.

Natural Access Server (ctdaemon) must be running for oamsys to operate. For more information about Natural Access Server (ctdaemon), refer to the Natural Access Developer's Reference Manual.