7.1 Introduction

7.2 Launching oammon

7.2.1 Command Line Options

7.1 Introduction

This chapter provides detailed information about the OAM board monitoring utility, oammon. This utility allows you to perform the following operations:

• Monitor for board errors and other messages

• Capture these messages in a flat file

• Send an alert notification message to all OAM client applications

7.2 Launching oammon

To launch oammon, enter oammon on the command line, followed by zero or more command line options. Precede each option with a hyphen (-) or slash (/). If the option includes data, specify the data directly after the option on the command line. Valid options are described in Section 7.2.1.

If you invoke oammon without command line options, it displays:

Ready (press Esc or q to exit)...

oammon immediately begins monitoring, and displays any messages to stdout.

For oammon to report messages, ctdaemon must be running. (To learn how to start CT Access in this mode, refer to Chapter 4.) If oammon is started before ctdaemon, it displays:

Waiting for CT Access Server...

If oammon is running and ctdaemon starts, oammon then displays its Ready prompt and begins reporting messages.

7.2.1 Command Line Options

The following table describes the oammon command line options:

Option	Description
-f file	Log messages to file file, as well as stdout.
-s messagetext	Causes oammon to send a test alert notification message containing text messagetext to all applications currently monitoring for alert messages (for example, another instance of oammon that is monitoring). oammon then terminates. messagetext can be any string of characters. Applications receive an OAMEVN_ALERT event containing a pointer to an OAM_MSG structure containing the message text. For more information about alert notification, refer to the OAM Service Developer's Reference Manual.
-?	Causes oammon to display its help screen, and terminate.
-h	Causes oammon to display its help screen, and terminate.