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

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

• -u unit-identifier <identifier> ((4 characters))

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.

• -s server-name <identifier> ((1-8))

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).

• -a

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:
   

   Option			Active servers			Inactive servers
   -a	-u	-s	Execution status	Standby or acceptable status	Running system start wait status
   Specified	Specified	Specified
   		Omitted	D	D	D	D
   	Omitted	Specified	D	D	D	D
   		Omitted	D	D	D	D
   Omitted	Specified	Specified
   		Omitted	D	E	E	E
   	Omitted	Specified	D	E	E	D*
   		Omitted	D	E	E	D*

Legend:

D: Displayed

: Not displayed

E: Results in an error

^* Status of the inactive servers on all units in the HA group is displayed.

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.

• When the standby-less system switchover (effects distributed) facility is not used

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 status		Display result
   		Monitor mode		Server mode
   Primary system	Secondary system	Primary system	Secondary system	Primary system	Secondary system
   Stopped	Stopped	STP	STP	STP	STP
   Stopped	Standby*			STP	SBY
   Active	Stopped	ONL	SBY	ONL	STP
   Active	Standby	ONL	SBY	ONL	SBY
   Stopped	Active	SBY	ONL	STP	ONL
   Standby	Active	SBY	ONL	SBY	ONL
   Standby*	Stopped			SBY	STP

   Legend:

   : 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-3 shows the correspondence between the mode (monitor or server) and the information displayed by the pdls -d ha command.
   

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

   

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)
   

• When the standby-less system switchover (effects distributed) facility is used
  

  UNITID INITIAL-HOST [STATUS] RESERVED-HOST [STATUS] aaaa bb...bb [ccc] dd...dd [eee] : : : : : SVID UNIT [STATUS] INITIAL-UNIT ff...f gggg [hhh] iiii : : : :

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:

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