2.119 pdsvhostname (Display server's host name)

Organization of this section
(1) Function
(2) Executor
(3) Format
(4) Options
(5) Output format
(6) Rules
(7) Notes

(1) Function

The pdsvhostname command displays a specified server's host name in DAT format.

(2) Executor

HiRDB administrator

(3) Format

 pdsvhostname -s server-name [-b]

(4) Options

(a) -s server-name ~<identifier> ((1-8))

Specifies the name of the server whose host name is to be displayed.

Rules
  1. If the specified server name is not defined in HiRDB, the command outputs the KFPS05041-E message and terminates.
  2. If the specified server is not running (including when the unit is stopped), the command does not display a host name.
  3. The command accepts the name of a single server, front-end server, dictionary server, or back-end server.
(b) -b

Specifies that a title line is to be displayed.

When this option is omitted, the command displays the host name without a title line.

(5) Output format

Explanation
aa...a
Name of the host where the server specified in the -s option is currently running (up to 32 characters).
The command displays one of the following host names:
  • Host name specified in the -x or -c operand of the pdunit operand in the system definition.
  • Host name specified in the -x option if the system switchover facility is used without IP address inheritance and the host is running as the primary system, or the host name specified in the -c option if the system switchover facility is used without IP address inheritance and the host is running as the secondary system.
  • Name of the host whose server is running if the standby-less system switchover (effects distributed) facility is used and the specified server is currently running.
  • Name of the host that is running in the alternate portion if the standby-less system switchover (1:1) facility is used and the specified server is running in the alternate portion.

(6) Rules

  1. The pdsvhostname command can be executed only when HiRDB is running. If the command is executed while HiRDB is stopped, the command outputs the KFPS01853-W message and terminates.
  2. The pdsvhostname command must be executed at the server machine that contains the single server or where the system manager is located. If the command is executed from a server machine where the system manager is not located, the command outputs the KFPS05037-E message and terminates.
  3. For the rules for output in DAT format, see 1.5.3 Rules for output of command execution results in DAT format.

(7) Notes

  1. Depending on the execution timing, the pdsvhostname command may terminate normally even though HiRDB is inactive. This occurs in the following cases:
    • The system manager's shared memory is available.
    • When the server stopped, the unit did not detect the stop.
  2. The following are the pdsvhostname command's return codes:
    0: Normal termination.
    1: Specified server is inactive.
    4: HiRDB is inactive.
    8: Error termination (including memory shortage),# or the specified server was not found in HiRDB.
    #: Check the error message in the syslogfile or the standard error output, eliminate the cause of the error, and then re-execute the pdsvhostname command