jpcconf inst list
- Organization of this page
Format
jpcconf inst list -key service-key
[-lhost logical-host-name]
Function
The jpcconf inst list command displays the instance names that have been set up by a PFM - Agent or PFM - RM that can start multiple services on a single host.
Hosts that can execute the command
-
PFM - Agent
-
PFM - RM
Execution permission
- In Windows:
-
None
- In UNIX:
-
None
Installation directory
- In Windows:
installation-folder\tools\
- In UNIX:
/opt/jp1pc/tools/
Arguments
-key service-key
Specifies the service key of the PFM - Agent or PFM - RM service that set up the instance names you wish to display. A product name can also be specified when the product name display functionality is enabled. Only the service keys of PFM - Agents or PFM - RMs that have instance environments can be specified. 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.
-lhost logical-host-name
Specifies the host name of the logical host whose instance names are to be displayed.
For logical-host-name, specify a string of 1 to 32 bytes, consisting of alphanumeric characters with no space characters and no periods (.).
For logical-host-name, you cannot specify localhost, an IP address, or a host name beginning with a hyphen (-).
Notes
-
If the specified PFM - Agent or PFM - RM does not have an instance environment, nothing is output, even if this command is executed.
-
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. |
|
1 |
An argument specification is invalid. |
|
5 |
The specified service has not been installed. |
|
10 |
The command is executing in another session. |
|
100 |
The Performance Management environment is invalid. |
|
102 |
The specified logical host has not been set up. |
|
200 |
A memory shortage occurred. |
|
210 |
A disk space shortage occurred. |
|
211 |
A file or directory cannot be accessed. |
|
230 |
Execution of an internal command failed. |
|
255 |
An unexpected error occurred. |
Usage example1
This example displays the instance names of PFM - Agent for Oracle:
jpcconf inst list -key Oracle
If there are instances named SDA and SDC, the following is displayed:
![[Figure]](GRAPHICS/ZU202009.GIF)
Usage example 2
This example outputs the instance names of an instance of PFM - Agent for Oracle on a logical host (host name: jp1-ha1):
jpcconf inst list -key Oracle -lhost jp1-ha1