Hitachi

JP1 Version 12 JP1/Performance Management Reference


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

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