Hitachi

JP1 Version 12 JP1/Performance Management Reference


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

Table 3‒91: Targets of each argument (jpctool monitor resume command)

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

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.

Table 3‒92: Information displayed by the jpctool monitor resume 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:

[List of setting changes]

Displays the hosts and agents for which the monitoring suspension setting is to be changed to the resume status.

[List of status changes]

Displays the hosts and agents for which the monitoring status is to be changed to the resume status. This information is displayed only when the -verbose option is specified.

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:

  • Change of PFM - Manager settings

  • Change of the monitoring status on PFM - Agent or PFM - RM

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.

[Figure]

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.