Hitachi

JP1 Version 12 JP1/Performance Management Reference


jpctool alarm active

Organization of this page

Format

jpctool alarm active    -key service-key
                        -table alarm-table-name
                        -alarm alarm-name
                        [-wait number-of-seconds]

Function

The jpctool alarm active command enables a disabled alarm.

Alarms are enabled individually; they cannot be enabled by alarm table in batch mode.

Hosts that can execute the command

PFM - Manager

Execution permission

In Windows:

User with Administrators permissions

In UNIX:

User with root user permissions

Installation directory

In Windows:
installation-folder\tools\
In UNIX:
/opt/jp1pc/tools/

Arguments

-key service-key

Specifies the service key of the PFM - Agent or PFM - RM for which an alarm definition is to be enabled. A product name can also be specified when the product name display functionality is enabled. You can specify only the service key of PFM - Agent or PFM - RM here. For details about the service key of the PFM - Agent or PFM - RM, see the naming rules described in the appendix of the JP1/Performance Management Planning and Configuration Guide.

-table alarm-table-name

Specifies the name of the alarm table in which the alarm to be enabled is defined.

For alarm-table-name, specify a string of 1 to 64 bytes, consisting of double-byte characters, single-byte alphanumeric characters, single-byte spaces, and the following single-byte symbols:

% - ( ) _ . / @ [ ]

If the value contains a space, enclose the entire value in double quotation marks ("). If the value contains a defined symbol, specify an escape character if necessary.

Wildcard characters cannot be used.

-alarm alarm-name

Specifies the name of the alarm to be enabled.

If the specified alarm has already been enabled, this command terminates normally.

For alarm-name, specify a string of 1 to 20 bytes, consisting of double-byte characters, single-byte alphanumeric characters, single-byte spaces, and the following single-byte symbols:

% - ( ) _ . / @ [ ]

If the value contains a space, enclose the entire value in double quotation marks ("). If the value contains a defined symbol, specify an escape character if necessary.

Wildcard characters cannot be used.

-wait number-of-seconds

Specifies the maximum wait period (in seconds) applied when a command that cannot be executed with this command is running. When the setting to suspend execution of alarm commands (Alarm Command Wait Mode) is enabled in the startup information file (jpccomm.ini), if you want to specify a wait period (in seconds) separately from the wait period specified in the jpccomm.ini file, specify a value in the range from 1 to 3,600 for this option.

If you omit the option, this command runs with the wait period (in seconds) that is specified in the jpccomm.ini file.

For details on the commands that cannot be executed with this command, see Commands that cannot be executed with alarm commands. For details on the jpccomm.ini file and Alarm Command Wait Mode, see Startup information file (jpccomm.ini).

Notes

Return values

0

The command terminated normally.

1

An argument specification is invalid.

2

The user does not have execution permission for the command.

3

At least one of the Name Server, Master Manager, and View Server services is not running.

4

The startup stop command or another setup command was executed on the same machine.

5

The command was executed on a host that is not the PFM - Manager host. Alternatively, the agent for which alarms are to be enabled has not been set up.

Or else, an attempt was made to execute the command from the secondary PFM - Manager host when multiple monitoring is performed.

6

The specified alarm table or alarm is missing.

11

The user canceled the processing.

100

The Performance Management environment is invalid.

200

A memory shortage occurred.

210

A disk space shortage occurred.

211

A file or directory cannot be accessed.

222

A communication error occurred.

223

Communication processing resulted in a timeout.

255

An unexpected error occurred.

Usage example 1

This example enables the Disk Service Time alarm defined in the PFM - Agent for Platform (UNIX) monitoring template for PFM UNIX Solution Alarms 8.00.

jpctool alarm active -key UNIX -table "PFM UNIX Solution Alarms 8.00" -alarm "Disk Service Time"

Usage example 2

This example enables the alarm alarm1 that is defined in the alarmtable1 alarm table for PFM - Agent for Platform (UNIX):

jpctool alarm active -key UNIX -table alarmtable1 -alarm alarm1