What are the options for the nimalarm utility?

Products

• DX Unified Infrastructure Management (Nimsoft / UIM)
• CA Unified Infrastructure Management On-Premise (Nimsoft / UIM)
• CA Unified Infrastructure Management SaaS (Nimsoft / UIM)

Issue/Introduction

The nimalarm utility can be used to send UIM alarms via the command line. This can be used for getting alarms into UIM from systems that are not necessarily UIM-integrated.  For example, a batch file could be configured to call the nimalarm utility when it encounters an error during runtime.

The nimalarm utility is found in the UIM installation directory.  In a standard Windows installation it can be found in C:\Program Files (x86)\Nimsoft\bin

What do the various command line options do?

Environment

Release: DX UIM, Any version

Resolution

ALL options are optional. More detailed explanations below:

-l:

Sets the alarm severity.

-s:

Sets the subsystem ID.

-c:

Sets the suppression key.

-d:

Sets the internal debug level (ie. loglevel) of the utility.

-S:

Sets the source/hostname alarm fields.

-i:

Makes the utility print the nimid of the generated alarm.

-[1-5]:

Sets the custom fields 1 through 5.

-t,n:

Needs to be set together, decides the CI device ID.

-m:

The CI metric ID.

-a:

The alarm token, fills the udata->token field in the alarm PDS. Used for e.g. UMP for fetching internationalized alarm messages.

-V:

Sets values to be used in above mentioned internationalized alarm messages. See the properties files in the wasp/i18n directory for examples on how these are used.

Additional Information

Here are some usage examples:

Simplest usage is:

   nimalarm <message>

Complex usage:

nimalarm -l 5 -c test-xxxx-xx -S <server> -i "This is a TEST alarm"

Sets an alarm severity, sets a suppression key, sets an alarm source and returns the unique nimid of the alarm.