jpctool monitor status
- Organization of this page
Format
jpctool monitor status [-id service-ID] [-lhost logical-host-name]
Function
The jpctool monitor status command displays the monitoring statuses and settings for the command execution host.
Hosts that can execute the command
-
PFM - Manager
-
PFM - Agent
-
PFM - RM
Execution permission
- In Windows:
-
User with Administrators permissions (executed from the administrator console when Windows UAC functionality is enabled)
- In UNIX:
-
User with root user permissions (A user whose uid is 0.)
Installation directory
- In Windows:
-
installation-folder\tools\
- In UNIX:
-
/opt/jp1pc/tools/
Arguments
-id service-ID
Specifies the service ID for which monitoring suspension statuses and settings are to be displayed.
Specify the service ID (the second character is A) for the Agent Collector service or the Remote Monitor Collector service. You can also specify the health check agent. For service-ID, specify a string of 1 to 258 bytes. You can use wildcard characters to specify multiple service IDs. If you omit this option, the monitoring statuses and settings of the execution host and its agents are displayed.
-lhost logical-host-name
Specifies a logical host name if this command is to be executed by a host in the logical host environment, not in the physical host environment.
For logical-host-name, specify a string of 1 to 32 bytes, consisting of single-byte alphanumeric characters with no space characters. If you omit this option, the command assumes that the physical host is specified. Wildcard characters cannot be used.
Notes
-
If command execution is interrupted by pressing the Ctrl + C keys or by a signal, a predefined return value is not returned. Therefore, you should ignore the return value when the command was interrupted by the Ctrl + C keys or by a signal.
Return values
0 |
The command terminated normally. |
1 |
An argument specification is invalid. |
2 |
The user does not have execution permission for the command. |
20 |
The specified service has not been registered. |
100 |
The Performance Management environment is invalid. |
102 |
The specified logical host name has not been set up. |
200 |
A memory shortage occurred. |
211 |
A file or directory cannot be accessed. |
255 |
An unexpected error occurred. |
Displayed information
For details on the information displayed by executing this command, see Table 3-90 Information displayed by the jpctool monitor command.
Assumed environment
The usage examples below assume that this command is executed in the environment below.
In the figure, PFM - Agent indicates PFM - Agent for Platform and PFM - RM indicates PFM - RM for Oracle.
Usage example 1
This example displays the monitoring suspension statuses and settings for the command execution host HostA and its agents.
jpctool monitor status
The following shows an example of the command execution results.
Status Setting # Mon Log Mon Log Name - --- --- --- --- ------------------------------------------------------ H Act Y Act Y HostA A Act Y Act Y 1A1hostA[HostA] A Act Y Act Y 1A1hostA[All@HostA] R Act Y Act Y 1A1hostA[hostB@HostA] R Act Y Act Y 1A1hostA[hostC@HostA] A Act Y Act Y TA1HostA KAVE06180-I The monitoring suspension function was successfully set and the monitoring status was successfully displayed.
Usage example 2
This example displays the monitoring suspension statuses and settings for the command execution host HostB and its agents.
This example assumes that the monitoring of HostB was suspended by specification of the host.
jpctool monitor status
The following shows an example of the command execution results.
Status Setting # Mon Log Mon Log Name - --- --- --- --- ------------------------------------------------------ H Sus N Sus N HostB A Sus N Act Y TA1HostB KAVE06180-I The monitoring suspension function was successfully set and the monitoring status was successfully displayed.