pdls [-d ha] (Display HiRDB system status)

Function

Displays the HiRDB system status when the system switching facility without IP address inheritance is used.

Format

pdls -d ha [{-u unit-identifier|-s server-name}] [-a]

Options

Specifies the identifier of the unit for which system status is to be displayed. When this option is omitted, the system status is displayed for all units.

If you specify the identifier of a unit to which the standby-less system switchover (effects distributed) facility is applicable, only the host and guest BESs in that unit are subject to this status display.

When the standby-less system switchover (effects distributed) facility is used, this option specifies the name of the server whose status is to be displayed. Specifying the server name of a unit to which the standby-less system switchover (effects distributed) facility is not applicable results in an error (KFPS05041-E message).

When the standby-less system switchover (effects distributed) facility is used, specifies that not only the execution status but also the detailed information (standby status, acceptable status, and running system start wait status) is to be displayed.

Rules
  1. If the standby-less system switchover (effects distributed) facility is not being used, the -a option is ignored, if specified.
  2. If the -a and -u options are both specified, detailed information about the host and guest BESs in the specified unit is displayed.
  3. If the -a and -s options are both specified, detailed information is displayed for each unit in the HA group of the specified server.
  4. When the -a option is omitted, information about the executing server is displayed.
  5. To check the servers that are in acceptable status, specify the -a option.
  6. The information to be displayed depends on the combination of the -a, -u, and -s options that are specified, as shown below:
    OptionActive serversInactive servers
    -a-u-sExecution statusStandby or acceptable statusRunning system start wait status
    SpecifiedSpecifiedSpecified[Figure][Figure][Figure][Figure]
    OmittedDDDD
    OmittedSpecifiedDDDD
    OmittedDDDD
    OmittedSpecifiedSpecified[Figure][Figure][Figure][Figure]
    OmittedDEEE
    OmittedSpecifiedDEED*
    OmittedDEED*
Legend:
D: Displayed
[Figure]: Not displayed
E: Results in an error
* Status of the inactive servers on all units in the HA group is displayed.

Notes

  1. Return code 0 for the pdls -d ha command indicates normal termination, and return code 8 indicates abnormal termination.
  2. If this command is specified when the system switching facility is not used or when the system switching facility is used but without IP address inheritance, a message is displayed and processing of the command terminates.

Output format

UNITID  INITIAL-HOST  [STATUS]  RESERVED-HOST  [STATUS]
aaaa     bb...b         [ccc]      dd...d           [eee]
 :        :             :         :              :

Explanation
aaaa
Unit identifier (4 characters)
bb...b
Host name of current system (up to 32 characters)
ccc
Status of host of current system (3 characters):
In the monitor mode:
ONL: Executing (online)
SBY: On standby (including stopped)
STP: Both systems are stopped
In the server mode:
ONL: Executing (online)
SBY: On standby*
STP: Stopped
dd...d
Host name of spare system (up to 32 characters)
If the corresponding unit is not subject to system switchover or is using the system switchover facility with inheritance of IP addresses, ******* is displayed.
eee
Host status of spare system (3 characters):
In the monitor mode:
ONL: Executing (online)
SBY: On standby (including stopped)
STP: Both systems are stopped
***: Not subject to system switchover or using the system switchover facility with inheritance of IP addresses
In the server mode:
ONL: Executing (online)
SBY: On standby
STP: Stopped
***: Not subject to system switchover or using the system switchover facility with inheritance of IP addresses
* When the standby-less system switchover (1:1) facility is used, the alternate BES is placed in SBY status when its preparations have been completed, not when the alternate BES unit has started.
Supplementary description of the output format:
  1. The following table shows the system statuses and display result:
    System statusDisplay result
    Monitor modeServer mode
    Primary systemSecondary systemPrimary systemSecondary systemPrimary systemSecondary system
    StoppedStoppedSTPSTPSTPSTP
    StoppedStandby*[Figure][Figure]STPSBY
    ActiveStoppedONLSBYONLSTP
    ActiveStandbyONLSBYONLSBY
    StoppedActiveSBYONLSTPONL
    StandbyActiveSBYONLSBYONL
    Standby*Stopped[Figure][Figure]SBYSTP
    Legend:
    [Figure]: Not applicable
    * Although the secondary system cannot be started by itself, if Hitachi HA Toolkit Extension is used and the running system is terminated normally while both systems are active, the secondary system does not stop automatically. As a result, only the secondary system remains active.
  2. If the names of the primary and secondary systems cannot fit on one line, the command displays the information about the secondary system's host on the next line. The following shows an example of this:

    UNITID  INITIAL-HOST [STATUS]  RESERVED-HOST [STATUS]
    aaaa    bb................................................bb      [ccc]
            dd................................................dd      [eee]

  3. Figure 2-4 shows the correspondence between the mode (monitor or server) and the information displayed by the pdls -d ha command.

    Figure 2-4 Correspondence between the mode (monitor or server) and the information displayed by the pdls -d ha command

    [Figure]

  4. When the standby-less system switchover (1:1) facility is used, the terms primary system, secondary system, executing unit, and standby unit mean the following:
    Primary system: Normal BES unit
    Secondary system: Alternate BES unit
    Executing: Unit that is executing processing (normal BES unit that has not been switched over or alternate BES unit that has been switched over)
    Standby: Standby unit (alternate BES unit that has not been switched over or normal BES unit that has been switched over)
Explanation
The values of aaaa through eee are the same as when the standby-less system switchover (effects distributed) facility is not used.
ff...f through iiii are sorted by the identifier of the unit that contains servers and are displayed for each server.
ff...f
Server name (up to 8 characters).
This is a server on the unit to which the standby-less system switchover (effects distributed) facility is applicable.
gggg
Identifier of the unit that contains the server (4 characters).
This is the identifier of the unit that contains server ff...f.
If the -u option is specified, this is the specified unit identifier.
If the -a option is specified but the -u option is omitted, this is the identifier of the unit whose status is to be displayed, among all units in the target HA group of server ff...f.
If the -a and -u options are both omitted, this is the identifier of the unit on which server ff...f is running.
If server ff...f is not running in any of the units of the HA group, **** is displayed.
hhh
Server's status (3 characters):
ONL
Executing (online)
SBY
Standby status for a host BES; acceptable status for a guest BES
If the -a option is omitted, this information is not displayed.
STP
If the -a, -u, and -s options are omitted, this value means that the server is not running on any unit in the HA group.
If the -a option is specified, this value means that the server is stopped on the unit gggg.
WIT
Running system start wait status
If the -a option is omitted, this information is not displayed.
iiii
Identifier of the definition target unit (4 characters).
This is the unit identifier specified in the pdstart -u system definition for server ff...f.
Example of display when the standby-less system switchover (effects distributed) facility is used:
The following shows a configuration example when the standby-less system switchover (effects distributed) facility is used:
[Figure]
When the pdls -d ha command is executed in this configuration, the following information is displayed:
  • When pdls -d ha is executed

SVID  UNIT  [STATUS]  INITIAL-UNIT
BES11 unt1  [ONL]     unt1
BES12 unt1  [ONL]     unt1
BES31 unt1  [ONL]     unt3
BES21 unt2  [ONL]     unt2
BES22 unt2  [ONL]     unt2
BES32 ****  [STP]     unt3

  • When pdls -d ha -a is executed

SVID  UNIT  [STATUS]  INITIAL-UNIT
BES11 unt1  [ONL]     unt1
BES12 unt1  [ONL]     unt1
BES21 unt1  [SBY]     unt2
BES22 unt1  [SBY]     unt2
BES31 unt1  [ONL]     unt3
BES32 unt1  [STP]     unt3
BES11 unt2  [SBY]     unt1
BES12 unt2  [SBY]     unt1
BES21 unt2  [ONL]     unt2
BES22 unt2  [ONL]     unt2
BES31 unt2  [SBY]     unt3
BES32 unt2  [STP]     unt3
BES11 unt3  [SBY]     unt1
BES12 unt3  [STP]     unt1
BES21 unt3  [SBY]     unt2
BES22 unt3  [SBY]     unt2
BES31 unt3  [SBY]     unt3
BES32 unt3  [STP]     unt3

  • When pdls -d ha -u unt1 is executed

SVID  UNIT  [STATUS]  INITIAL-UNIT
BES11 unt1  [ONL]     unt1
BES12 unt1  [ONL]     unt1
BES31 unt1  [ONL]     unt3

  • When pdls -d ha -u unt1 -a is executed

SVID  UNIT  [STATUS]  INITIAL-UNIT
BES11 unt1  [ONL]     unt1
BES12 unt1  [ONL]     unt1
BES21 unt1  [SBY]     unt2
BES22 unt1  [SBY]     unt2
BES31 unt1  [ONL]     unt3
BES32 unt1  [STP]     unt3

  • When pdls -d ha -s BES12 is executed

SVID  UNIT  [STATUS]  INITIAL-UNIT
BES12 unt1  [ONL]     unt1

  • When pdls -d ha -s BES12 -a is executed

SVID  UNIT  [STATUS]  INITIAL-UNIT
BES12 unt1  [ONL]     unt1
BES12 unt2  [SBY]     unt1
BES12 unt3  [STP]     unt1