5.1 Introduction

5.2 Using oamsys

5.2.1 Launching oamsys

5.1 Introduction

This chapter describes how to use the oamsys utility to set up the OAM database, based upon parameter values specified in a system configuration file. (To learn how to create a system configuration file, refer to Chapter 3.)

5.2 Using oamsys

To perform system-wide configuration and startup of boards, use the oamsys utility. This utility:

• Stops any currently operating boards.

• Creates managed objects, and initializes the 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. For more information about system configuration files, see Chapter 3.

• Attempts to start (boot) all board managed objects.

To perform its tasks, the oamsys utility makes multiple calls to the oamcfg utility, described in Chapter 6.

To use oamsys, ctdaemon must be running. To learn how to start CT Access in this mode, refer to Chapter 2.

5.2.1 Launching oamsys

To launch oamsys, enter oamsys on the command line.

If you invoke oamsys without command line options, it searches for a file named oamsys.cfg in the current directory, and then the paths specified in the AGLOAD environment variable.

If you wish, you can specify a different filename (and path, if necessary) on the command line with the -f option:

oamsys -f c:\config\myfile.cfg

If you omit the path, oamsys searches for the file as described above. If you specify a filename without an extension, oamsys assumes the extension to be .cfg.

Note: oamsys reads system configuration files, not keyword files. Keyword files to be added to the OAM database must be specified within the system configuration file (see Chapter 3).

When invoked with a valid filename, oamsys does the following:

• Checks the syntax of your system configuration file, and that all required keywords are present.
  Note: oamsys checks syntax only on the system configuration file, and not on any keyword files referenced in the file. oamsys reports all syntax errors it finds.

• Checks for uniqueness of board name, number and bus/slot.

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

• Deletes all board configuration information currently stored in the OAM database (if there is any).

• Sets up the OAM database, and creates managed objects 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. For details on oamcfg, see Chapter 6.