Displaying Basic HyperSwap information

Use the DISPLAY HS command to display information about the Basic HyperSwap® function and the status of device pairs in the PPRC configuration. The issuing operator must have at least RACF® READ authority for the DISPLAY HS command or console INFO authority. See Table 1 and Table 1 for additional information. The DISPLAY HS command will fail if the Basic HyperSwap Management address space is not started.

Note: Basic HyperSwap (BHS) command handling is performed by the BHS Subsystem Interface (SSI) exit processing. Therefore, this command requires the BHS management address space to be active in order to recognize and process this command. If this command is issued when the BHS management address space is not active, then message IEE305I will be issued indicating that the command is not valid at this time.
 
D HS,{STATUS}
     {CONFIG[(DETAIL[,ALL]|EXCEPTION[,ALL])]Start of change[,NAME(session_name)]End of change}
STATUS
Displays the current status of the Basic HyperSwap function for all systems in the sysplex (for example, enabled, disabled, HyperSwap in progress).

Message IOSHM0303I is issued in response to the D HS,STATUS command and the output is routed to the issuing console. Start of changeSee z/OS MVS System Messages, Vol 9 (IGF-IWM) for more information about the IOSHM0303I message.End of change

CONFIG
A list of configurations (session names and session types) being maintained by Basic HyperSwap is displayed. When CONFIG is issued with either the DETAIL or EXCEPTION parameter, the current state of device pairs in the PPRC configuration (for example, Duplex, PPRC suspended, No Secondary Access) is displayed. Start of changeThe optional NAME parameter can be specified to display a specific configuration. If NAME is not specified, the information for the configuration currently preferred for HyperSwap is displayed.End of change
One of the following forms of the IOSHM0304I message is issued in response to this command:
  • The first Active Configurations form of the IOSHM0304I message is issued in response to the DISPLAY HS,CONFIG command only and displays both HyperSwap and MetroMirror configurations.
  • The HyperSwap Configuration form of the IOSHM0304I message is issued in response to the DISPLAY HS,CONFIG(option) or DISPLAY HS,CONFIG(option,ALL) command and only applies to a HyperSwap configuration.
  • Start of changeThe second Active Configurations form of the IOSHM0304I message is issued in response to the DISPLAY HS,CONFIG command with the NAME parameter.End of change
Start of changeSee z/OS MVS System Messages, Vol 9 (IGF-IWM) for more information about the IOSHM0304I message.End of change
DETAIL
Lists devices with any exception in the rightmost Status column.
EXCEPTION
Displays the exception reason followed by a list of devices.
ALL
Displays all devices.

When ALL is not specified (the default), 32 devices are displayed, followed by nnnn Devices not Displayed.

Start of changeNAME(session_name)End of change
Start of changeSpecifies the name of the HyperSwap configuration from which the device pairs are to be displayed. When NAME is not specified, the device pairs in the current HyperSwap viable configuration are displayed.End of change
Parent topic: DISPLAY command