# Using oamsys

Use the oamsys utility to set up the NMS OAM database, based upon parameter values specified in a system configuration file. This utility:

- Stops any currently operating boards.

- Creates records for board components in the NMS OAM database based on a system configuration file you supply. Any existing board-specific data in the database is deleted and replaced with the contents of the system configuration file. Refer to Configuration file overview for more information.

- Configures non-board components. Refer to Configuring non-board objects for more information.

- Attempts to start all boards.

To perform its tasks, the oamsys utility makes multiple calls to the oamcfg utility. Refer to oamcfg overview for more information.

To use oamsys, ctdaemon must be running. To learn how to start Natural Access in this mode, refer to Starting the Natural Access Server.

To configure and start up boards on multiple systems, run oamsys once for each system, specifying the target system on the command line. oamsys can configure only one system at a time.

## Running oamsys

To launch oamsys, enter:

oamsys [options]

where options are:

Option | Use this option to...
--- | ---
-f filename | Specify 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 | Load the configuration file on resource host host. host is an IP address or machine name. If unspecified, the operation is 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.

When invoked with a valid file name, oamsys does the following:

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

Note: oamsys checks syntax only on the system configuration file and not on any keyword files referenced in the file.

- Checks for uniqueness of board name, number and bus/slot within the system configuration file.

- Shuts down all boards referenced in the NMS OAM database (if any).

- Deletes all board configuration information currently stored in the NMS OAM database (if any).

- Sets up the NMS OAM database according to the specifications in the system configuration file.

- Attempts to start all boards, as described in the database.

oamsys invokes oamcfg repeatedly to perform its actions. With each invocation, the command line is displayed. Refer to oamcfg overview for more information.