DFSMSdss: Accommodate ADREID0 EIREC14 expansion

Description

With APAR OA42238, the length of the EIREC14 structure in the ADREID0 macro is increased by 16 bytes. This expansion, which is related to DFSMSdss support for dump data sets compressed with zEDC services, may require changes for applications that invoke DFSMSdss using its application programming interface.

Table 1 provides more details about this migration action. Use this information to plan your changes to the system.

Table 1. Information about this migration action
Element or feature: DFSMSdss
When change was introduced: z/OS V2R1 and z/OS V1R13, both with APAR OA42238 applied.
Applies to migration from: z/OS V2R1 and z/OS V1R13, both without APAR OA42238 applied.
Timing: Before the first IPL of z/OS V2R2.
Is the migration action required? Yes, if you use the DFSMSdss application programming interface.
Target system hardware requirements: None.
Target system software requirements: None.
Other system (coexistence or fallback) requirements: None.
Restrictions: None.
System impacts: None.
Related IBM Health Checker for z/OS check: None.

Steps to take

Check for use of the Function Ending user interaction module exit option (EIOPTION14) in applications that exploit the DFSMSdss application programming interface. If EIOPTION14 is used, determine if the UIM copies the structure pointed to by EIRECPTR. In this exit the structure pointed to by EIRECPTR is named EIREC14. If the application copies the area of storage pointed to by EIRECPTR, then action may be required.

If the application copies the area of storage using EIRECLEN for the amount of data to copy, then the application must ensure the area that is the destination of the copy is large enough to accommodate the larger EIREC14 structure.

The length of the EIREC14 structure is not provided in the ADREID0 data area. Prior to the application of the PTFs for OA42238, determine the length of the EIREC14 structure with an equate of this form:
EQU EI14CPUT+L'EI14CPUT-EIREC14
After the application of the PTFs for OA42238, determine the length of the EIREC14 structure with an equate of this form:
EQU EI14ZCSV+L'EI14ZCSV+15-EIREC14

Reference information

For more information about the application programming interface and Eioption 14, see z/OS DFSMSdss Storage Administration .