jpctool alarm unapplied
- Organization of this page
Format
jpctool alarm unapplied [-wait number-of-seconds]
Function
The jpctool alarm unapplied command displays the alarm application status of monitoring agents. It displays services whose alarm application status is Waiting (waiting to be applied), Failed (failed to be applied), Uncertain (status unknown), Incompatible (not supported), and Inactive (stopped). The command does not display services for which application of alarm information has been successfully completed.
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
-wait number-of-seconds
Specifies the maximum wait period (in seconds) when a command that cannot be executed with this command is running. If the setting to suspend execution of alarm commands (Alarm Command Wait Mode) is enabled in the startup information file (jpccomm.ini) and 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).
Corrective action for each alarm application status
Alarm application status |
Explanation |
Corrective action |
---|---|---|
Waiting (waiting to be applied) |
Alarm information is in the process of being applied. |
Wait approximately 5 minutes and then re-execute the command jpctool alarm unapplied. |
Failed (failed to be applied) |
Application of the alarm information failed, or the application process timed out. |
Execute the command jpctool config alarmsync -target failed, and then re-execute the command jpctool alarm unapplied.# |
Uncertain (status unknown) |
The application status of the alarm information is unknown. |
Take corrective action according to the cause. For details, see the chapter that explains monitoring operations with alarms in the JP1/Performance Management User's Guide. |
Incompatible (not supported) |
Application of the alarm information failed, or the application process timed out, or this version of the service does not support application of alarm information using the command jpctool config alarmsync. |
Restart the Action Handler service that is displayed, and then re-execute the command jpctool alarm unapplied. |
Inactive (stopped) |
Alarm information cannot be applied because the service is currently stopped. |
Start the service. However, if there are no problems associated with the stopped service, no corrective action is required. |
If the alarm information is not applied to a service even after these corrective actions, verify that the following problems have not occurred:
-
The service is running in stand-alone mode.
-
The service is busy.
-
The host name of the connection target PFM - Manager is wrong.
-
In a multiple-monitoring environment, the primary and secondary settings are reversed.
Notes
-
Multiple instances of this command cannot be executed concurrently.
-
When performing multiple monitoring, you cannot execute this command from the secondary PFM - Manager host.
-
This command cannot be executed if the PFM - Manager service (Master Manager service) is not running.
-
This command cannot be executed on a standby node in a logical host environment.
-
If a service that has been deleted appears in the execution results, execute the command jpctool config alarmsync to apply the latest alarm information, and then re-execute the command jpctool alarm unapplied.
Return values
Return values from 80 to 83 depend on the alarm application status of the services, except for the status Inactive, which does not affect the return value.
0 |
The command terminated normally (no services are Incompatible, Failed, Waiting, or Uncertain). |
1 |
An argument specification is invalid. |
2 |
The user does not have execution permission for the command. |
3 |
The Master Manager service is not running. |
4 |
A startup or termination command, or other setup command, has been executed on the same machine. |
5 |
The command was executed on a host that was not the PFM - Manager host. Or, an attempt was made to execute the command from the secondary PFM - Manager host when multiple monitoring is performed. |
80 |
There is at least one service with an alarm application status of Uncertain, and no service with a status of Incompatible, Failed, or Waiting. |
81 |
There is at least one service with an alarm application status of Waiting, and no service with a status of Incompatible or Failed. |
82 |
There is at least one service with an alarm application status of Failed, and no service with a status of Incompatible. |
83 |
There is at least one action handler with an alarm application status of Incompatible. |
200 |
A memory shortage occurred. |
221 |
An attempt to acquire the alarm application status from the Master Manager service failed. |
222 |
An error occurred during communication processing. |
255 |
An unexpected error occurred. |
Information that is displayed
No. |
Information that is displayed |
Explanation |
---|---|---|
1 |
Host Name |
This column displays the name of the host running the service. If the service is a remote agent or group agent, the name of the host running the remote monitor is shown. |
2 |
ServiceID |
This column displays the service ID of the Agent Collector, remote agent, group agent, or action handler. The product name is not shown even if the product name display functionality is enabled. |
3 |
Service Name |
This column displays the name of the service. The product name is not shown even if the product name display functionality is enabled. |
4 |
Status |
This column displays the alarm application status of the service. |
Usage example
This example displays the alarm application status in Windows.
> jpctool alarm unapplied Host Name ServiceID Service Name Status --------- --------- ------------ ------ hostA 7A1inst01[All@hostA] Group Agent Waiting hostA 7A1inst01[t01@hostA] Remote Agent Failed hostB 7A1inst01[t02@hostB] Remote Agent Failed hostB PH1hostB Action Handler Inactive hostC TA1hostC Agent Collector Waiting KAVE06200-I Display processing of the alarm application state ended normally.