PK72530: ADD DATABASE SUPPORT FOR EXTENDED ADDRESS VOLUMES ( EAV )

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Add IMS Database support for Extended Address Volumes ( EAV ).
  This is support for volumes greater than 64K.
  KEYWORDS: ZOS111T/K ZOS112T/K ZOS113T/K
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: ALL IMS V10 USERS OF FULL FUNCTION VSAM,     *
  *                 FAST PATH DATABASES AND DBRC RECON           *
  *                 DATASETS. THIS INCLUDES BOTH KSDS AND ESDS.  *
  ****************************************************************
  * PROBLEM DESCRIPTION: THIS ENHANCEMENT PROVIDES THE SUPPORT   *
  *                      FOR IMS VSAM DATASETS TO RESIDE IN THE  *
  *                      EAS (Extended Addressing Space)         *
  *                      PORTION OF AN EAV (Extended Address     *
  *                      Volume).                                *
  *                                                              *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  KEYWORD:
    TYPE24 LOG24 EAV EAV/K
  
  TO SATISFY GROWING DASD STORAGE REQUIREMENTS, Z/OS V1R10
  SUPPORTS EXTENDED ADDRESS VOLUMES (EAV). AN EAV IS DEFINED
  TO BE ANY VOLUME THAT HAS MORE THAN 65,520 CYLINDERS.
  ONLY 3390 MODEL A DEVICES CAN BE AN EAV.
  VOLUMES THAT ARE CONFIGURED WITH 65,520 CYLINDERS OR LESS
  ARE REFERRED TO AS NON-EAVS.
  AN EAV CONSISTS OF TWO AREAS OF MANAGED SPACE. THE FIRST
  65,520 CYLINDERS OF AN EAV IS CONSIDERED THE TRACK-MANAGED
  SPACE WHERE SPACE IS MANAGED IN TRACKS AND CYLINDERS.
  THE LAST CYLINDER IN THIS MANAGED SPACE IS AT CYLINDER
  65,519. THE SPACE ABOVE 65,520 CYLINDERS IS CONSIDERED
  THE CYLINDER-MANAGED SPACE ON THE VOLUME WHERE SPACE IS
  MANAGED IN MULTICYLINDER UNITS. ON AN EAV, THE MULTICYLINDER
  UNIT IS 21 CYLINDERS.  THE FIRST CYLINDER IN THIS MANAGED
  SPACE IS AT CYLINDER ADDRESS 65,520.
  IN ADDITION, THE SPACE ON AN EAV IS DIVIDED INTO TWO FORMS
  OF DISK ADDRESSING. THE EXTENDED ADDRESSING SPACE (EAS)
  ON AN EAV REFERS TO THE THE CYLINDERS WHOSE ADDRESSES
  ARE EQUAL TO OR GREATER THAN 65,536. THESE CYLINDER
  ADDRESSES ARE REPRESENTED BY 28-BIT CYLINDER NUMBERS.
  THE BASE ADDRESSING SPACE ON AN EAV REFER TO THE CYLINDERS
  WHOSE ADDRESSES ARE BELOW 65,536. THESE CYLINDER ADDRESSES
  ARE REPRESENTED BY 16-BIT CYLINDER NUMBERS OR BY 28-BIT
  CYLINDER NUMBERS WHOSE HIGH ORDER 12 BITS ARE ZERO.
  NOTE THAT DISK ADDRESSING WITHIN THE BASE ADDRESSING SPACE
  IS COMPATIBLE WITH DISK ADDRESSING ON NON-EAVS.
  IN Z/OS 1.10, IBM SUPPORTS VSAM DATA SETS ALLOCATED IN THE
  EXTENDED ADDRESSING SPACE (EAS) OF AN EAV. IMS SUPPORT FOR
  VSAM DATASETS ALLOCATED IN THE EXTENDED ADDRESSING SPACE OF
  AN EAV WILL BE PROVIDED THROUGH THE SERVICE PROCESS. THIS
  INCLUDES VSAM KSDS AND ESDS DATABASES AS WELL AS THE RECON
  DATASETS.
  
  MACROS CHANGED:
  
  DBFADSC:  ADDED ADSCF6EA FLAG TO ADSCFLG6. THIS INDICATES
            THAT THE ADS RESIDES ON AN EAV VOLUME.
  
  DBFESCD:  ADDED MODULE VECTOR ENTRY FOR DFSDEAV0
  
  DFSDMB:   ADDED BIT DMBPFEAV TO DMBPFLG3 TO INDICATE THE
            DATASET RESIDES ON AN EAV VOLUME
  
  DBFMER00: ADDED CHECK FOR THE ADS IN ERROR IF IT RESIDES
            ON AN EAV VOLUME. BIT IN THE ADSC (ADSCF6EA)
            INDICATES THE ADS IS ON AN EAV VOLUME.
  
  MODULES CHANGED:
  
  DBFMPOP0: ADDED CODE TO CALL DFSDEAV0 TO SEE IF THE ADS
            RESIDES ON AN EAV VOLUME. IF IT DOES, SETS BIT
            ADSCF6EA IN ADSCFLG6.
  
  DBFMADR0: ADDED MODULE VCON FOR DFSDEAV0
  
  DFSDVSM0: CODE ADDED TO SET A BIT IN THE LOG X'24' RECORD
            TO INDICATE THAT THE DATASET IN ERROR RESIDES IN
            THE EAS PORTION OF AN EAV VOLUME. BIT 'ERLGFEAV'
            IN ERLGFLG2 IS SET FOR AN EAV VOLUME.
            BIT DMBPFEAV IN DMBPFLG3 INDICATES AN EAV VOLUME.
  
  DFSDOC30: ADDED CODE TO CHECK FOR AN EAV VOLUME WHEN VSAM
            DATASETS ARE OPENED. MODULE DFSDEAV0 IS CALLED
            TO CHECK THE DEVICE TYPE. IF THE DATASET IS ON
            AN EAV, SETS BIT DMBPFEAV IN DMBPFLG3.
  
  DSPRSV00: CODE ADDED TO THE RESERVE PROCESSING OF THE RECON
            DATASETS. AN 'OBTAIN' MACRO IS ISSUED TO DO THE
            RESERVE I/O PROCESSING TO THE VTOC. IF THE DEVICE
            IS AN EAV, A NEW KEYWORD IS ADDED TO THE OBTAIN
            MACRO TO SUPPORT NEW FORMAT 8 AND 9 DSCBS ON
            EAV VOLUMES. THIS IS AVAILABLE WITH Z/OS 1.10
            ONLY. IF Z/OS 1.10 AND HIGHER, PARM 'EADSCB=OK'
            IS ADDED TO THE OBTAIN MACRO REQUEST.
  
  DFSKB009: CODE ADDED TO THE LOG X'24' PROCESSING.
            THE MODULES THAT GENERATE THE X'24' LOG RECORD SET
            A FLAG WHEN THE I/O ERROR OCCURS ON AN EAV VOLUME.
            THE NORMALIZED FORM IS IN FORMAT LLLCCCCH.
            THE LLLCCCC IS A 28BIT NUMBER IN A LINEAR FORM.
            BOTH FORMATS ARE PRINTED.THE NORMALIZED VALUE
            IS PRINTED WITH LABEL 'NORMALIZED EAV CCHHR'
  
  DFSLOG24: CODE ADDED TO THE LOG X'24' RECORD MAPPING.
            BIT 'ERLGFEAV' HAS BEEN ADDED TO INDICATE AN
            ERROR ON AN EAV VOLUME.
  
  DFSDEAV0: NEW OCO MODULE. CALLED BY NON-OCO PARTS TO CHECK
            FOR AN EAV VOLUME. IT IS COMPILED WITH Z/OS 1.10
            MACROS. A 'DEVTYPE' REQUEST IS ISSUED TO GET THE
            VOLUME INFORMATION FROM THE VTOC. BITS ARE CHECKED
            FOR AN EAV VOLUME. THEY ARE 'DVACYLMG+DVAEADSCB+
            DVAIXVLD'.
            A RETURN CODE BACK TO THE CALLER IS SET TO INDICATE
            WHETHER THE VOLUME IS ON AN EAV VOLUME OR NOT.
  

Problem conclusion

• KEYWORDS: EAV/K ZOS0201T/K ZOS0202T/K
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

  PK72529

• APAR is sysrouted TO one or more of the following:

  PK78388 UK43020

Modules/Macros

• DBFADSC  DBFESCD  DBFMADR0 DBFMER00 DBFMPOP0
  DFSDEAV0 DFSDMB   DFSDOC30 DFSDVSM0 DFSKB009 DFSLOG24 DSPRSV00
  HMK1010J
  

Fix information

• Fixed component name

  IMS V10

• Fixed component ID

  5635A0100

Applicable component levels

• R010 PSY UK43020

     UP09/01/16 P F901

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.