6.7.3 Modifying an alarm definition

You can modify an alarm definition by exporting the alarm definition information to a file, editing the file, and then importing the file again.

In this procedure, use the following commands:

To export the alarm definition:

jpctool alarm export command
To import the alarm definition:

jpctool alarm import command

Note:: You cannot modify alarms that are defined in a monitoring template (the alarm tables that begin with PFM). If you want to edit them, you must first export the monitoring template, rename the alarm tables in the alarm definition file, and then import them.

Log on to the host where PFM - Manager is installed.
Execute the jpctool alarm list command to view the name of the alarm table whose definition you want to edit.

For example, execute the following command when you want to view the alarm table names defined in the PFM - Agent for Platform (UNIX):
```
jpctool alarm list -key UNIX
```
The output is shown below. In this example, you can see that the monitoring template and the alarm table alarmtable1 are defined.
```
Product ID:U
Alarm Table Name:
  alarmtable1
  PFM UNIX Solution Alarms 6.70
  PFM UNIX Solution Alarms 7.00
```
Execute the jpctool alarm list command to view the name of the alarm to edit the definition for.

For example, execute the following command when you want to view the alarm names defined in the alarm table named alarmtable1 of the PFM - Agent for Platform (UNIX):
```
jpctool alarm list -key UNIX -table alarmtable1
```
The output is shown below.
```
Product ID:U
DataModelVersion:4.0
Alarm Table Name:alarmtable1
Alarm Name: 
  Kernel CPU 01       [active]
  Kernel CPU 02       [active]
  User CPU 01         [active]
 
The Bound Agent:
  UA1hostA
  UA1hostB
```
For further details on the jpctool alarm list command, see the chapter that describes the command in the manual JP1/Performance Management Reference.
Execute the jpctool alarm export command.

For example, execute the following command when you want to export the definition information for all alarms defined in the alarm table alarmtable1 of PFM - Agent for Platform (UNIX):
```
jpctool alarm export -f /tmp/alarmtable1.cfg -key UNIX -table alarmtable1
```
For further details on the jpctool alarm export command, see the chapter that describes the command in the manual JP1/Performance Management Reference.
Open the /tmp/alarmtable1.cfg file with a text editor or other tool.
Edit the /tmp/alarmtable1.cfg file.

For details on how to edit individual definitions in the alarm definition file, see 6.7.1 Creating an alarm definition file.
Save the /tmp/alarmtable1.cfg file.
Execute the jpctool alarm import command.

For example, execute the following command when you want to import the definition information from the alarm definition file /tmp/alarmtable1.cfg:
```
jpctool alarm import -f /tmp/alarmtable1.cfg
```
For further details on the jpctool alarm import command, see the chapter that describes the command in the manual JP1/Performance Management Reference.

To Page Top