A fix is available
APAR status
Closed as new function.
Error description
NEW FUNCTION APAR
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: * * Users at HBB7790 and above that use * * HyperSwap. * **************************************************************** * PROBLEM DESCRIPTION: * * New Function APAR. * * Providing support for hardware reserves * * in a GDPS or z/OS HyperSwap * * environment. * * Also, providing support for sharing * * devices between SYSPLEXes in a z/OS * * HyperSwap environment. * **************************************************************** * RECOMMENDATION: * **************************************************************** New Function APAR. This APAR provides support to ensure active hardware reserves on primary PPRC devices are properly transferred to their recovery devices after a HyperSwap, helping to remove the need to convert hardware reserves to Global ENQs. This function is available with DS8000 9.1 firmware or higher. DS8K enablemnt requires an RPQ and a POKEABLE. This APAR also provides support for sharing devices between SYSPLEXes in a z/OS HyperSwap environment. The sharing is limited to devices in a single Metro Mirror HyperSwap configuration. This function can be activated with Copy Services Manager (CSM) 6.2.11.
Problem conclusion
Temporary fix
Comments
New Function APAR. This APAR provides support to ensure active hardware reserves on primary PPRC devices are properly transferred to their recovery devices after a HyperSwap, helping to remove the need to convert hardware reserves to Global ENQs. This function is available with DS8000 9.1 firmware. This APAR also provides support for sharing devices between SYSPLEXes in a z/OS HyperSwap environment. The sharing is limited to devices in a single Metro Mirror HyperSwap configuration. This functon can be activated with Copy Services Manager (CSM) 6.2.11. In z/OS MVS Data Areas Vol 3 (IEFALCXT-IRARENF1) (GA32-0937) z/OS MVS Data Areas Vol 2 (IAX-ISG) (GA32-0936 for HBB77A0, HBB77B0 and HBB77C0) The following updates to be made to 'IOCOM information' section: -Add to IOCOM programming interface information IOCHSRESERVE -Add to Modifiable part of IOCOM Offset Offset Type Len Name Description Dec Hex ... 65 (41) BITSTRING 1 IOCFLG4B Flag Byte 1... .... IOCHSRESERVE "X'80'" On, HyperSwap Managed hardware reserve support is active 66 (42) BITSTRING 2 -Add to IOCOM Cross Reference Name Offset Value(Hex Tag) IOCFLG4B 41 IOCHSRESERVE 41 80 In z/OS MVS System Messages, Volume 9 (IGF-IWM) (SA38-0676 for HBB7790, HBB77A0, HBB77B0 and HBB77C0) The following messages will be added: - IOSHM0437I | IOSHM0437I hh:mm:ss.nn HyperSwap phase - HyperSwap Soft Fence | starting | Explanation: z/OS HyperSwap is starting the Soft Fence by | HyperSwap phase | In the message text: | hh:mm:ss.nn | The actual time of the request. The time is represented | as hours 'hh'(00-23), minutes 'mm'(00-59), seconds 'ss' | (00-59), and hundredths of a second 'nn'(00-99). | System action: Processing continues. | Operator response: None. | System programmer response: None. | Module: IOSHMHST | Routing code: 2 | Descriptor code: 4 - IOSHM0438I | IOSHM0438I hh:mm:ss.nn HyperSwap phase - HyperSwap Soft Fence | completed | Explanation: z/OS HyperSwap has completed the Soft Fence by | HyperSwap phase | In the message text: | hh:mm:ss.nn | The actual time of the request. The time is represented | as hours 'hh'(00-23), minutes 'mm'(00-59), seconds 'ss' | (00-59), and hundredths of a second 'nn'(00-99). | System action: Processing continues. | Operator response: None. | System programmer response: None. | Module: IOSHMHST | Routing code: 2 | Descriptor code: 4 - IOSHM0439I | IOSHM0439I hh:mm:ss.nn HyperSwap phase - Remote Soft Fence | starting | Explanation: z/OS HyperSwap is starting the Remote Soft Fence | phase | In the message text: | hh:mm:ss.nn | The actual time of the request. The time is represented | as hours 'hh'(00-23), minutes 'mm'(00-59), seconds 'ss' | (00-59), and hundredths of a second 'nn'(00-99). | System action: Processing continues. | Operator response: None. | System programmer response: None. | Module: IOSHMHST | Routing code: 2 | Descriptor code: 4 - IOSHM0440I | IOSHM0440I hh:mm:ss.nn HyperSwap phase - Remote Soft Fence | completed | Explanation: z/OS HyperSwap has completed the Remote Soft | Fence phase | In the message text: | hh:mm:ss.nn | The actual time of the request. The time is represented | as hours 'hh'(00-23), minutes 'mm'(00-59), seconds 'ss' | (00-59), and hundredths of a second 'nn'(00-99). | System action: Processing continues. | Operator response: None. | System programmer response: None. | Module: IOSHMHST | Routing code: 2 | Descriptor code: 4 - IOSHM0441I | IOSHM0441I hh:mm:ss.nn HyperSwap phase - Quiesce I/O starting | Explanation: z/OS HyperSwap is starting the Quiesce I/O phase | In the message text: | hh:mm:ss.nn | The actual time of the request. The time is represented | as hours 'hh'(00-23), minutes 'mm'(00-59), seconds 'ss' | (00-59), and hundredths of a second 'nn'(00-99). | System action: Processing continues. | Operator response: None. | System programmer response: None. | Module: IOSHMHST | Routing code: 2 | Descriptor code: 4 - IOSHM0442I | IOSHM0442I hh:mm:ss.nn HyperSwap phase - Quiesce I/O | completed | Explanation: z/OS HyperSwap has completed the Quiesce I/O | phase | In the message text: | hh:mm:ss.nn | The actual time of the request. The time is represented | as hours 'hh'(00-23), minutes 'mm'(00-59), seconds 'ss' | (00-59), and hundredths of a second 'nn'(00-99). | System action: Processing continues. | Operator response: None. | System programmer response: None. | Module: IOSHMHST | Routing code: 2 | Descriptor code: 4 - IOSHM0443I | IOSHM0443I hh:mm:ss.nn HyperSwap processing issued an Unfence | Explanation: z/OS HyperSwap has completed the Unfence | operation | In the message text: | hh:mm:ss.nn | The actual time of the request. The time is represented | as hours 'hh'(00-23), minutes 'mm'(00-59), seconds 'ss' | (00-59), and hundredths of a second 'nn'(00-99). | System action: Processing continues. | Operator response: None. | System programmer response: None. | Module: IOSHMHST | Routing code: 2 | Descriptor code: 4 - IOSHM0444I | IOSHM0444I hh:mm:ss.nn HyperSwap phase - HyperSwap Soft | Fence to secondary devices starting | Explanation: z/OS HyperSwap is starting the Soft Fence to | secondary devices phase | In the message text: | hh:mm:ss.nn | The actual time of the request. The time is represented | as hours 'hh'(00-23), minutes 'mm'(00-59), seconds 'ss' | (00-59), and hundredths of a second 'nn'(00-99). | System action: Processing continues. | Operator response: None. | System programmer response: None. | Module: IOSHMHST | Routing code: 2 | Descriptor code: 4 - IOSHM0445I | IOSHM0445I hh:mm:ss.nn HyperSwap phase - HyperSwap Soft | Fence to secondary devices completed | Explanation: z/OS HyperSwap has completed the Soft Fence to | secondary devices phase | In the message text: | hh:mm:ss.nn | The actual time of the request. The time is represented | as hours 'hh'(00-23), minutes 'mm'(00-59), seconds 'ss' | (00-59), and hundredths of a second 'nn'(00-99). | System action: Processing continues. | Operator response: None. | System programmer response: None. | Module: IOSHMHST | Routing code: 2 | Descriptor code: 4 - IOSHM0520I | IOSHM0520I Reserve Mismatch detected, device pair = | sxxxx,syyyy | Explanation: A primary device is reserved without its | corresponding secondary device being reserved. | In the message text: | sxxxx | Primary device number (where 's' is the subchannel set | id) | syyyy | Secondary device number (where 's' is the subchannel set | id) | System action: HyperSwap is disabled | Operator response: None. | System programmer response: None. | Module: IOSHMAIT | Routing code: 2 | Descriptor code: 4 The following messages will be updated: - IOSHM0201I IOSHM0201I HyperSwap|MetroMirror configuration 'actionone' fails Reason: IOSHXSND processing fails Reason: Device configuration error ..... | Reason: HyperSwap Reserve support level is not | consistent across all systems Reason: 'actiontwo' on member 'memname' Reason code: 'failrsn' Devices: 'primdev-secdev' | Explanation: z/OS HyperSwap is not able to process the indicated request. ..... - IOSHM0303I IOSHM0303I HyperSwap status 'text' Explanation: Indicates the status of Basic HyperSwap. The 'text' is: Number of configurations: 'numofconfig' Replication Session: 'replsession_name' ..... HyperSwap disabled: By operator No configuration data ..... HyperSwap in progress Configuration data load in progress | One or more members have detected a reserve | mismatch ..... 'system_name' 'reason2' One of the following: Configuration load failed API function failed during swap processing | Member has detected a reserve mismatch ..... New Member configuration load failed: {Disable|Partition} Planned swap recovery: {Partition|Disable} Unplanned swap recovery: {Disable|Partition} FreezeAll: {No|Yes} Stop: {Yes|No} | Hardware Reserve Support: {Disabled|Enabled} ..... - IOSHM0420I IOSHM0420I HyperSwap not done because 'reason' ..... reason one of the following: ..... | a reserve mismatch has been detected | During a planned HyperSwap, a SYSPLEX member | has detected a reserve mismatch ..... KEYWORDS: HYPERSWP/K ×**** PE21/10/11 FIX IN ERROR. SEE APAR OA62168 FOR DESCRIPTION ×**** AE21/09/22 FIX IN ERROR. SEE APAR OA62168 FOR DESCRIPTION ×**** PE21/10/22 FIX IN ERROR. SEE APAR OA62168 FOR DESCRIPTION ×**** PE21/10/22 FIX IN ERROR. SEE APAR OA62168 FOR DESCRIPTION
APAR Information
APAR number
OA57049
Reported component name
IOS
Reported component ID
5752SC1C3
Reported release
790
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2019-03-01
Closed date
2021-04-01
Last modified date
2023-09-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UJ05211 UJ05212 UJ05213 UJ05218 UJ05220 UJ05221 UJ05222 UJ05223
Modules/Macros
IOSHMCF2 IOSHSAPI IOSHMAIT IOSHMIOS IOSDE63R IOSHSPCR IOSHMCMT IOSIOSEN IOSHMHST IOSVSSCH IOSVDSTF IOSHMEP2 IECDIOSB IOSHIMSG IOSVSSCQ IOSHMDSP IOSHSMTT IECVGENA IOSVFDSD IOSHMEDS IOSHMOPR IOSRRRSV IOSVSLFD IOSIOSJP IOSHMCM2 IOSHMCNS IOSHMEPT IOSHSSUB IOSHMHS2 IOSRDBOX IOSHMCFG IOSHMBLK IOSHVMTT IOSGEN IOSRDPSV IECDIOCM IOSHMGPE IOSHMCTL ISGGRSV IOSHFMTR IOSHMXUS IOSRFDEV IOSRSCH
| GA32093700 | GA32093600 | SA38067600 |
Fix information
Fixed component name
IOS
Fixed component ID
5752SC1C3
Applicable component levels
R7AJ PSY UJ05222
UP21/04/14 P F104
R7BJ PSY UJ05218
UP21/04/14 P F104
R7CJ PSY UJ05213
UP21/04/14 P F104
R790 PSY UJ05221
UP21/04/14 P F104
R79J PSY UJ05223
UP21/04/14 P F104
R7A0 PSY UJ05220
UP21/04/14 P F104
R7B0 PSY UJ05211
UP21/04/14 P F104
R7C0 PSY UJ05212
UP21/04/14 P F104
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SG19O","label":"IOS"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"790"}]
Document Information
Modified date:
02 September 2023