jpctool monitor resume
- Organization of this page
Format
jpctool monitor resume {-group business-group-name | -host host-name [-force] | -id service-ID} [-lhost logical-host-name] [-noquery] [-wait number-of-seconds] [-verbose]
Function
The jpctool monitor resume command resumes the monitoring.
Hosts that can execute the command
PFM - Manager
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
-group business-group-name
Specifies the name of the business group of which the monitoring is to be resumed.
For business-group-name, specify a string of 1 to 255 bytes, consisting of double-byte characters, single-byte characters, and the symbols below. Alphabetic characters are case sensitive.
! " # $ % & ' ( ) + - . : ; < = > @ [ \ ] ^ _ ` { | } ~
If you specify a string that contains single-byte spaces, enclose the entire string in double quotation marks ("). If you specify a single-byte symbol, specify an escape character as necessary. You can also use wildcard characters to specify multiple business group names.
-host host-name
Specifies the name of the host of which the monitoring is to be resumed.
For host-name, specify a string of 1 to 32 bytes, consisting of single-byte alphanumeric characters with no space characters. You can use wildcard characters to specify multiple host names.
-force
Specify this option to remove the monitoring suspension setting information for a host that do not have agents (a host whose value of the * column of the Status item is displayed as # in the execution results of the jpctool monitor list command). For example, during the operation to change a host name, if the monitoring suspension setting information for the host with the old name remains, use this option to remove the information.
If you specify a wildcard character or an existing host name for the -host option, this option is ignored.
-id service-ID
Specifies the service ID of which the monitoring is to be started.
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.
-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 and no wildcard characters. If you omit this option, the command assumes that the physical host is specified.
-noquery
If this option is specified, the command does not output any query messages that interrupt command execution, making it unnecessary for the user to respond.
-wait number-of-seconds
Specifies the maximum wait time (in seconds) applied when a command that cannot be executed with this command is running. Specify a number in the range from 0 to 3,600 for this option.
If you omit this option, the command assumes that 300 seconds are specified. If you specify 0, the command execution is not suspended.
-verbose
If you specify this option, lists the hosts and agents for which the monitoring status is to be changed to the resume status.
Targets of each argument
Argument |
Target |
---|---|
-group |
Resumes the monitoring of the hosts that belong to the specified business group and the agents that are installed in the hosts. If the agents are PFM - RM, the monitoring of the remote agents is also resumed. |
-host |
Resumes the monitoring of the specified host and the agents that are installed in the host. If the agents are PFM - RM, the monitoring of the remote agents is also resumed. |
-id |
Resumes the monitoring of the specified agent. If the agent is PFM - RM, the monitoring of the remote agents is also resumed. |
Notes
-
If the monitoring suspension function option is disabled, this command cannot be used.
-
If the PFM - Manager service (Master Manager and View Server services) is not running, this command cannot be used.
-
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.
-
This command cannot be executed with the startup stop command or another setup command on the same machine. By specifying the -wait option, if a command that cannot be executed with this command is running, this command can wait for the command execution to complete for the specified period (in seconds).
-
Do not add or delete monitoring targets while this command is running. The latest information might not be displayed.
-
The monitoring of the hosts that have never been connected to PFM - Manager cannot be resumed by using the -group option. Specify the -host option and the -force option to resume the monitoring.
Return values
0 |
The command terminated normally. |
1 |
An argument specification is invalid. |
2 |
The user does not have execution permission for the command. |
5 |
The command was executed on a host that was not the PFM - Manager host. |
11 |
The user canceled the processing. |
12 |
The monitoring suspension function is disabled. |
16 |
This command waited to run because a startup or termination command or other setup command was being executed on the same machine, but a timeout occurred. |
17 |
This command was executed from the secondary PFM - Manager in a multiple-monitoring environment. |
18 |
The specified business group has not been registered. |
19 |
The specified host has not been registered. |
20 |
The specified service has not been registered. |
22 |
Failed to update PFM - Manager. |
23 |
Failed to update PFM - Agent and PFM - RM. |
100 |
The Performance Management environment is invalid. |
101 |
The service required for this operation does not start. |
102 |
The specified logical host name has not been set up. |
200 |
A memory shortage occurred. |
211 |
A file or directory cannot be accessed. |
222 |
A communication processing error occurred. |
223 |
A communication processing timeout error occurred. |
253 |
Access control by business group is disabled. |
255 |
An unexpected error occurred. |
Displayed information
The following table describes the information that is displayed by executing this command.
No |
Displayed information |
Description |
---|---|---|
1 |
List of targets |
The following information is displayed based on Table 3-90 Information displayed by the jpctool monitor command:
|
2 |
Query message |
A KAVE06181-Q message asking whether to continue the processing is output. If you enter Y, the processing continues. |
3 |
Progress display |
The progress for the following processing is displayed:
|
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 resumes the monitoring by specification of a business group when the monitoring was suspended by specification of a host.
This example assumes that the monitoring of HostA was suspended by specification of the host.
jpctool monitor resume -group Group1
The following shows an example of the command execution results.
[List of setting changes] Status Setting # Mon Log Mon Log Name - --- --- --- --- ------------------------------------------------------ G --- - --- - Group1 H Sus N Sus N HostA H Act Y Act Y HostB H Act Y Act Y HostC KAVE06181-Q Monitoring of the displayed host or agent will resume. Do you want to continue? (Y/N) Y KAVE06191-I Monitoring will resume. KAVE06183-I The settings information for the monitoring suspension function on the monitoring manager was successfully updated. [100%] KAVE06186-I The settings information for the monitoring suspension function on the monitoring agent was successfully updated. KAVE06192-I Monitoring was successfully resumed.
Usage example 2
This example resumes the monitoring by specification of a host when the monitoring was suspended by specification of the host.
This example assumes that the monitoring of HostA was suspended by specification of the host.
jpctool monitor resume -host HostA
The following shows an example of the command execution results.
[List of setting changes] Status Setting # Mon Log Mon Log Name - --- --- --- --- ------------------------------------------------------ H Sus N Sus N HostA KAVE06181-Q Monitoring of the displayed host or agent will resume. Do you want to continue? (Y/N) Y KAVE06191-I Monitoring will resume. KAVE06183-I The settings information for the monitoring suspension function on the monitoring manager was successfully updated. [100%] KAVE06186-I The settings information for the monitoring suspension function on the monitoring agent was successfully updated. KAVE06192-I Monitoring was successfully resumed.
Usage example 3
This example specifies the -verbose option under the same conditions as those of usage example 2.
jpctool monitor resume -host HostA -verbose
The following shows an example of the command execution results.
[List of setting changes] Status Setting # Mon Log Mon Log Name - --- --- --- --- ------------------------------------------------------ H Sus N Sus N HostA [List of status changes] Status Setting # Mon Log Mon Log Name - --- --- --- --- ------------------------------------------------------ H Sus N Sus N HostA A Sus N Act Y 1A1hostA[HostA] A Sus N Act Y 1A1hostA[All@HostA] R Sus N Act Y 1A1hostA[hostB@HostA] R Sus N Act Y 1A1hostA[hostC@HostA] A Sus N Act Y TA1HostA KAVE06181-Q Monitoring of the displayed host or agent will resume. Do you want to continue? (Y/N) Y KAVE06191-I Monitoring will resume. KAVE06183-I The settings information for the monitoring suspension function on the monitoring manager was successfully updated. [100%] KAVE06186-I The settings information for the monitoring suspension function on the monitoring agent was successfully updated. KAVE06192-I Monitoring was successfully resumed.
Usage example 4
This example resumes the monitoring by specification of an agent when the monitoring was suspended by specification of the agent.
This example assumes that the monitoring of TA1HostB was suspended by specification of the agent.
jpctool monitor resume -id TA1HostB
The following shows an example of the command execution results.
[List of setting changes] Status Setting # Mon Log Mon Log Name - --- --- --- --- ------------------------------------------------------ A Sus N Sus N TA1HostB KAVE06181-Q Monitoring of the displayed host or agent will resume. Do you want to continue? (Y/N) Y KAVE06191-I Monitoring will resume. KAVE06183-I The settings information for the monitoring suspension function on the monitoring manager was successfully updated. [100%] KAVE06186-I The settings information for the monitoring suspension function on the monitoring agent was successfully updated. KAVE06192-I Monitoring was successfully resumed.
Usage example 5
This example resumes the monitoring of the agents whose monitoring was suspended by specification of a host and an agent.
This example assumes that the monitoring of HostB was suspended by specification of the host and the monitoring of TA1HostB was suspended by specification of the agent.
First, resume the monitoring of HostB.
jpctool monitor resume -host HostB
The following shows an example of the command execution results.
[List of setting changes] Status Setting # Mon Log Mon Log Name - --- --- --- --- ------------------------------------------------------ H Sus N Sus N HostB KAVE06181-Q Monitoring of the displayed host or agent will resume. Do you want to continue? (Y/N) Y KAVE06191-I Monitoring will resume. KAVE06183-I The settings information for the monitoring suspension function on the monitoring manager was successfully updated. [100%] KAVE06186-I The settings information for the monitoring suspension function on the monitoring agent was successfully updated. KAVE06192-I Monitoring was successfully resumed.
The monitoring of HostB is now resumed. However, the monitoring of TA1HostB remains suspended because it was suspended by specification of the agent. Therefore, you must resume the monitoring of TA1HostB in the next step.
jpctool monitor resume -id TA1HostB
The following shows an example of the command execution results.
[List of setting changes] Status Setting # Mon Log Mon Log Name - --- --- --- --- ------------------------------------------------------ A Sus N Sus N TA1HostB KAVE06181-Q Monitoring of the displayed host or agent will resume. Do you want to continue? (Y/N) Y KAVE06191-I Monitoring will resume. KAVE06183-I The settings information for the monitoring suspension function on the monitoring manager was successfully updated. [100%] KAVE06186-I The settings information for the monitoring suspension function on the monitoring agent was successfully updated. KAVE06192-I Monitoring was successfully resumed.