jpcspm stop

Format

jpcspm stop      -key service-key
                [-lhost logical-host-name]
                [-inst instance-name]
                [-kill immediate]

To Page Top

Function

The jpcspm stop command stops services of Performance Management programs. It cannot stop the services of Performance Management programs at a remote host.

You can use the jpctool service list command to check the status of the Performance Management program services. jpcspm stop commands cannot be executed concurrently, nor can one be executed simultaneously with the jpcspm start command.

When the services to be stopped include PFM - Manager and the health check function is enabled on the PFM - Manager host on which you execute the command, the health check agent also stops as part of the PFM - Manager service. Note that you cannot specify agt0 as the service key.

To Page Top

Hosts that can execute the command

• PFM - Manager

• PFM - Agent

• PFM - RM

To Page Top

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

To Page Top

Installation directory

In Windows:

installation-folder\tools\

In UNIX:

/opt/jp1pc/tools/

To Page Top

Arguments

To Page Top

Notes

• You must specify the arguments in the order they appear in Format.

• If command execution returns the return value 103, monitoring of the process for stopping the service of a Performance Management program timed out. Wait a while, and then re-execute the jpcspm stop command. If this event occurs frequently, collect maintenance information and contact the system administrator. For details about how to collect maintenance information, see the chapter on troubleshooting in the JP1/Performance Management User's Guide.

• Once the jpcspm stop command is issued to stop PFM services, an attempt to stop the command (such as by pressing the Ctrl + C keys or with a signal) will not stop termination processing that has already been started by the command. If the jpcspm stop command is issued again to stop the service, the KAVE05034-E message might be displayed. Check the common message log for termination of the service and then re-execute the jpcspm stop command.

• 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.

• In the case of a host that supports the status management function, the Status Server service is not stopped unless all or stat is specified in service-key.

• If all is specified in service-key and the -lhost option is specified, the Status Server service will not be stopped.

• If the status management function is enabled, and the jpcspm stop command with all or stat specified in service-key is executed at the physical host, and at least one service that depends on the Status Server service is running at the logical host (version that supports the status management function), the command will display the KAVE06022-I message and return the return value 108.

• Do not execute this command concurrently with a start or stop command executed from cluster software or the service control manager. Because these commands contend with each other, the start or stop command might not be executed correctly.

• If you have enabled both automatic start and automatic stop of services in an environment powered by CentOS 7 or later versions, Linux 7 or later versions, Oracle Linux 7 or later versions, SUSE Linux 12 or later versions, start or stop the Performance Management program services by using the systemctl command. For details, see the notes on the jpcspm start command.

• The jpcspm stop command might terminate without outputting the following message related to the Remote Monitor Collector service, although the PFM - Agent or PFM - RM service is running when the jpcspm stop command is executed for PFM - Agent or PFM - RM:

  KAVE06008-I The service will now stop. (service=service-name, lhost=logical-host-name, inst=instance-name)

  In this case, the PFM - Agent or PFM - RM service is busy collecting performance data, so please wait for a while and then re-execute the command.

To Page Top

Return values

To Page Top

Usage example 1

This example stops all services of the Performance Management programs:

jpcspm stop -key all

To Page Top

Usage example 2

This example stops only the service of an instance named oracleA in the PFM - Agent for Oracle:

jpcspm stop -key Oracle -inst oracleA

To Page Top