jpcconf ha list

Organization of this page

Format
Function
Hosts that can execute the command
Execution permission
Installation directory
Arguments
Notes
Return values
Usage example

Format

jpcconf ha list    -key service-key
                  [-lhost logical-host-name]

To Page Top

Function

The jpcconf ha list command displays the settings for a Performance Management logical host environment.

This command can be executed only for a Performance Management product that supports logical host operation. PFM - Manager supports logical host operation. For details about logical host operation of a particular PFM - Agent or PFM - RM, see the chapter in the relevant PFM - Agent or PFM - RM manuals that describes cluster system operations.

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

`-key` `service-key`

Specifies the service key of the Performance Management program whose logical host environment settings are to be displayed. A product name can also be specified when the product name display functionality is enabled.

You can specify the following in service-key:

all: Specifies all Performance Management services set up on the specified logical host.
Manager or mgr: Specifies the PFM - Manager services (including the Action Handler service).
Service key of a PFM - Agent or PFM - RM service: Displays a particular PFM - Agent or PFM - RM service (including the Action Handler service). For details about the service key of the PFM - Agent or PFM - RM service, see the naming rules described in the appendix of the JP1/Performance Management Planning and Configuration Guide.

AH or act (service key of the Action Handler service) cannot be specified.

When one of the following values is specified for the service key, the logical host environment settings for the Performance Management program service are displayed:

Manager or mgr
Service key of the PFM - Agent service
Service key of the PFM - RM service

Specifying all in service-key displays the logical host environment settings for all Performance Management services set up on the specified logical host. Specifying the service key of a Performance Management service that does not support logical host operation results in an error.

`-lhost` `logical-host-name`

Specifies the host name of the logical host environment. You can omit this option.

Specifying a logical host name displays only the information about the specified logical host. If you omit this option, the command displays information about all logical hosts. If the specified logical host name has not been set up, an error results.

To Page Top

Notes

This command can display information about logical hosts even for standby nodes or when the shared disk cannot be accessed.
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.

To Page Top

Return values

`0`	The command terminated normally.
Other values	The command terminated abnormally.

To Page Top

Usage example

This example displays a list of logical hosts that have been set up:

jpcconf ha list -key all

The following is an output example:

[Figure]

To Page Top