1.6.1 Checking the status of services by using a command
Use the jpctool service list command to check the status of services throughout the entire Performance Management system or to check the service operations on a specific host.
If you edit the pfmwebcon_host.conf file beforehand, you can also use this command to check the status of just the PFM - Web Console service that is installed on the host where the jpctool service list command is executed. To do so, edit the pfmwebcon_host.conf file in the same way as for synchronized starting and stopping of the PFM - Manager or PFM - Base and PFM - Web Console services. For details on how to edit the pfmwebcon_host.conf file, see 1.4.1 Synchronizing starting and stopping.
-
Log on to the host that has PFM - Manager, PFM - Agent, or PFM - RM installed.
-
Specify the service ID of the service for which you want to display service information, and execute the jpctool service list command.
For example, to check the status of all services on the local host, specify as follows:
jpctool service list -key all
Table 1‒2: Information that can be output by the jpctool service list command Output information
Description
Name of the host on which services are operating
Service ID
Service name
The process ID of the service.
-
When the status management function is enabled:
The process ID appears only when the Status is Active, Busy, S Active, S Busy, Starting, or Stopping.
-
When the status management function is disabled or your product version does not support the status management function:
The process ID appears only when the Status is Active.
The communication port number used by the service.
-
When the status management function is enabled:
The port number appears only when the Status is Active, Busy, S Active, or S Busy.
-
When the status management function is disabled or your product version does not support the status management function:
The port number appears only when the Status is Active.
The status of the service.
- When the status management function is enabled:
-
-
Status display in versions that support the status management function:
Active: The service is waiting for a request.
Inactive: The service is stopped.
Starting: The service is starting.
Busy: The service is processing a request.
S Active: The service is waiting for a request (stand-alone mode).
S Busy: The service is processing a request (stand-alone mode).
Stopping: The service is stopping.
-
Status display in versions that do not support the status management function:
Active*: The service is running.
Incomp*: The service is starting or stopping.
Inactive*: Either the system cannot establish a connection to the service or the service is stopped.
Comm Err*: The system is able to establish a connection to the service but there is no response.
Timeout*: The connection to the service has timed out.
Error*: An error other than a connection timeout has occurred. Refer to the common message log for details of the error. For details on PFM - Web Console service errors, see the trace log.
In the following situations, the above status display applies for services that support the status management function.
- The Status Server service is stopped.
- The Status Server has started but the status management function cannot recognize the status of the service#.
# You will need to restart the service for the status management function to recognize the service status correctly.
-
- When the status management function is disabled or your product version does not support the status management function:
-
Active: The service is running.
Incomp: The service is starting or stopping.
Inactive: Either the system cannot communicate with the service or the service is stopped.
Comm Err: The system is able to establish a connection to the service but there is no response.
Timeout: The connection to the service has timed out.
Error: An error other than a connection timeout has occurred. Refer to the common message log for details of the error. For details on PFM - Web Console service errors, see the trace log.
-