A fix is available
APAR status
Closed as new function.
Error description
NEW FUNCTION
Local fix
N/A
Problem summary
**************************************************************** * USERS AFFECTED: * * HDZ2250 USERS AND ABOVE WHO ARE USING THE * * DADSM EXIT IGGPRE00_EXIT * **************************************************************** * PROBLEM DESCRIPTION: * * NEW FUNCTION * **************************************************************** * RECOMMENDATION: * **************************************************************** SUMMARY: NEW FUNCTION
Problem conclusion
Temporary fix
Comments
NEW FUNCTION: IEXREASN = 24 (X'0018') and IEXREASN = 25 (X'0019') now will be used by IBM after this solution is installed into a system. Check your exit routine logic for the exit IGGPRE00_EXIT whether these reason codes are coded in the logic. If yes, please change to use the different reason codes. The new return conditions from the exit IGGPRE00_EXIT, which is documented in the manual z/OS DFSMS Installation Exits: When R15 (return code) = 0 and IEXREASN = 25 (x'0019') during extending on the same volume, End-of-Volume will not issue the ABENDX37. This will enable a forced EOV condition, which will make the data set extend to a new volume. When R15 (return code) = 4 and IEXREASN = 24 (x'0018') during extending to a new volume, SMS volume selection will reject all the volumes in the primary storage group(s), causing the out-of-space condition ABEND E37-08. If the primary storage group has the associated Extend storage group specified, SMS will attempt the extend request to a new volume in this Extend storage group. The exit is responsible for determining if the volume being extended to is in the primary or extend storage group. RC0 should be used when the volume is in the extend storage group. In the manual z/OS DFSMSdfp Storage Administration, under Extend Storage Group description,the following document will be added: You can use the exit IGGPRE00_EXIT to request SMS to switch to the extend storage group without attempting the extend request on any volumes in the primary storage group(s). When the exit encounters the volumes from the associated extend storage group, the exit is still able to decide whether to accept the extent. See the manual z/OS DFSMS Installation Exits for more details on the exit IGGPRE00_EXIT. Here are the updated documents in details: :SRL SC23686050 :TITLE zOS V2R5.0 DFSMSdfp Storage Administration :PGM z/OS DFSMS :REL V2R5 and Up :CHANGE Text follows In "Chapter 4. Defining storage groups", Section. Extend SG Name, add the following as the third note: You can use the exit IGGPRE00_EXIT to request SMS to switch to the extend storage group without attempting the extend request on any volumes in the primary storage group(s). When the exit encounters the volumes from the associated extend storage group, the exit is still able to decide whether to accept the extent. See the manual z/OS DFSMS Installation Exits for more details on the exit IGGPRE00_EXIT. :SRL SC23685050 :TITLE zOS V2R5.0 DFSMS Installation Exits :PGM z/OS DFSMS :REL V2R5 and Up :CHANGE Text follows In "Chapter 2. Data Management Installation/ Dynamic Exits", Section. Reject an Extend Request, add the following as the new paragraph under the current one: If you enable a forced end-of-volume condition during extending on the same volume, set IEXREASN to 25 and return code to zero. End-of-Volume will attempt the extend request on a new volume without issuing any ABENDX37. Section. IGGPRE00_EXIT dynamic exit, exit routine return codes, update the following: IGGPRE00_EXIT dynamic exit, exit routine return codes No return codes are defined for IGGPOST0. These return codes apply to IGGPRE00. Return Code Description 00 (x'00') Continue processing the DADSM request. Reason Code in IEXREASN Description 25 (x'0019') Enable a forced end-of-volume condition, which will make the data set extend to a new volume. This reason code is ignored in the system without the support. 04 (x'04') Reject the request for the current new volume. The request might be retried on another volume. Reason Code in IEXREASN Description 24 (x'0018') Request SMS volume selection to reject all the volumes in the primary storage group(s), causing the out-of-space condition ABENDE37-08. If the primary storage group has the associated Extend storage group specified, SMS will attempt the extend request to a new volume in this Extend storage group. The exit is responsible for determining if the volume being extended to is in the primary or extend storage group. RC0 should be used when the volume is in the extend storage group. This reason code is ignored in the system without the support. 08 (x'08) Unconditionally reject the DADSM request. :SRL SC23686350 :TITLE zOS V2R5.0 DFSMSdfp Diagnosis :PGM z/OS DFSMS :REL V2R5 and Up :CHANGE Text follows In "Chapter 8. DADSM/CVAF diagnostic aids", Table. 40 DADSM CREATE Diagnostic Information (Register 0), add the following new row after the current row for x'04' and x'15': x'04' | x'15' | x'00' | x'18' | DADSM CREATE exit routine associated with the IGGPRE00_EXIT preprocessing dynamic exit, such as IGGPRE00, reject the extend request on the current new volume and request SMS volume selection to reject all the volumes in the primary storage group(s). If there are volumes in the associated Extend storage group, retry on those volumes. :SRL SA38067550 :TITLE zOS V2R5.0 MVS System Messages Volume 8(IEF-IGD) :PGM z/OS MVS :REL V2R5 and Up :CHANGE Text follows In "Chapter 18. IGD messages", add the following new reason to the existing message IGD17269I: IGD17269I (n) VOLUMES WERE REJECTED BECAUSE (reason) The new reason: THEY WERE NOT EXTEND STORAGE GROUP VOLUMES
APAR Information
APAR number
OA64834
Reported component name
STORAGE MGMT SU
Reported component ID
5695DF101
Reported release
250
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2023-05-09
Closed date
2023-08-01
Last modified date
2023-11-07
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
OA64835 UJ93381 UJ93382
Modules/Macros
IGDVTSVS IGDVTSDA IGDVTSC2 IGDVTSSL IGDVTSV2 IGDVTSSN IGDVTSAV IEFSSSA
| SC23686050 | SC23685050 | SC23686350 | SA38067550 |
Fix information
Fixed component name
STORAGE MGMT SU
Fixed component ID
5695DF101
Applicable component levels
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":"SG19M"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"250"}]
Document Information
Modified date:
07 November 2023