jpcconf ha list
- Organization of this page
Format
jpcconf ha list -key service-key [-lhost logical-host-name]
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.
Hosts that can execute the command
-
PFM - Manager
-
PFM - Agent
-
PFM - RM
Execution permission
- In Windows:
-
User with Administrators permissions
- In UNIX:
-
User with root user permissions
Installation directory
- In Windows:
installation-folder\tools\
- In UNIX:
/opt/jp1pc/tools/
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.
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.
Return values
0 |
The command terminated normally. |
Other values |
The command terminated abnormally. |
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: