jpcconf mgrhost display
- Organization of this page
Format
jpcconf mgrhost display [-lhost logical-host-name]
Function
The jpcconf mgrhost display command displays all host names of PFM - Manager hosts for the connection destinations (Name Server services).
To display the PFM - Manager host for the connection destination in a logical host environment, you must specify the -lhost option.
When two PFM - Manager hosts for the connection destination have been registered, the host names are displayed in order of primary host name and secondary host name.
Hosts that can execute the command
-
PFM - Manager
-
PFM - Agent
-
PFM - RM
Execution permission
To only display the host name of the PFM - Manager host for the connection destination (Name Server service), execution permission is not required.
Only the following users can set or change (with an argument specified) the PFM - Manager host:
- In Windows:
-
User with Administrators permissions (executed from the administrator console when Windows UAC functionality is enabled)
- In UNIX:
-
User with root user permissions
Installation directory
- In Windows:
-
installation-folder\tools\
- In UNIX:
-
/opt/jp1pc/tools/
Arguments
-lhost logical-host-name
Specifies the host name in the logical host environment for which the PFM - Manager for the connection destination host is to be displayed, set, or changed.
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 this command's 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. (When only one PFM - Manager host for the connection destination is registered) |
1 |
An argument specification is invalid. |
2 |
The user does not have execution permission for the command. |
10 |
The command is executing in another session. |
100 |
The Performance Management environment is invalid. |
102 |
The specified logical host name has not been set up. |
200 |
A memory shortage occurred. |
210 |
A disk space shortage occurred. |
211 |
A file or directory cannot be accessed. |
254 |
The command terminated normally. (When two PFM - Manager hosts for the connection destinations are registered) |
255 |
An unexpected error occurred. |
Usage example 1
This example displays the PFM - Manager host for the connection destination:
jpcconf mgrhost display
Usage example 2
This example displays the PFM - Manager host for the connection destination specified in the logical host (host name: jp1-ha1):
jpcconf mgrhost display -lhost jp1-ha1