PI13954: IMS CATALOG LOAD UTILITY FAILS U0034 WHEN JOB REGION SIZE IS 4M

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Running catalog load utility with a job region size of 4M fails
  with U0034. DFS3PCNC attempts to obtain more storage and fails.
  It then abends with U0034. Abend occurs at offset 1A0A label
  SUBMSG34.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS V13 users of the IMS Catalog         *
  *                 Populate utility (DFS3PU00 or DFS3UACB)      *
  *                 where the job's REGION size is not set to    *
  *                 0M may be affected.                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: The Populate job received abendU0034 in *
  *                      load module DFS3PCNC, csect DFS3PBLC    *
  *                      when the job's REGION size was set to   *
  *                      4M.                                     *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  Abend U0034 was issued by DFS3PBLC because a GETMAIN failed due
  to unavailable storage.  User's job contained REGION=4M.
  When it was increased to 5M or set to the maximum (0M), the
  Populate job completed successfully.
  
  While the Catalog code worked correctly, the documentation of
  IMS user abend 0034 did not have explanation for this GETMAIN
  failure.  This apar is being used to change the abend code
  from U0034 to U1002 (a generic Catalog abend code with various
  reason codes to provide detailed info on the cause of the
  error).  Reason code 4 will be used to indicate a Catalog
  GETMAIN failure due to lack of storage.
  

Problem conclusion

• GEN:
  KEYWORDS:
  
  *** END IMS KEYWORDS ***
  Catalog modules that issue abend U0034 for a GETMAIN failure
  have been updated to instead issue abend U1002 reason code 4.
  
  The modules are DFS3PBLC, DFS3CNTL, DFS3DBLC, DFS3DCNC,
  DFS3PCNC, DFS3PDBD, DFS3PLOC, DFS3PPSB, DFS3PSDC, DFS3REAC,
  DFS3SDBD, DFS3SPSB and DFS3SREF.
  
  The IMS Messages and Codes, Volume 3: IMS Abend Codes
  will be changed.
  
  For abend U1002, add the following under Explanation:
  
    Or there was a GETMAIN failure due to unavailable storage.
    Message DFS4477E will be issued under this condition.
  
  Add the following under Analysis, Table 1. Key descriptions
  for Register 15:
  
    X'04'   DFS3PU00   GETMAIN failed due to unavailable storage.
                       Check the REGION size, and consider setting
                       it to 0M.
  
  
  The IMS Systems Utilities Reference will be changed.
  
  In the chapters on IMS Catalog Populate utility (DFS3PU00) and
  ACB Generation and Catalog Populate utility (DFS3UACB),
  under Recommendation section, add the following paragraph:
  
    The storage requirement is highly dependent on the total
    number of ACBLIB members as they have to be kept in
    storage.  Consider increasing the job's region size to
    prevent a GETMAIN failure that will cause abend U1002
    reason code 4 to be issued.
  

Temporary fix

Comments

APAR Information

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

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

  UI18664

Modules/Macros

•    DFS3CNTL DFS3DBLC DFS3DCNC DFS3PBLC DFS3PCNC
  DFS3PDBD DFS3PLOC DFS3PPSB DFS3PSDC DFS3REAC DFS3SDBD DFS3SPSB
  DFS3SREF
  

Fix information

• Fixed component name

  IMS V13

• Fixed component ID

  5635A0400

Applicable component levels

• R300 PSY UI18664

     UP14/06/10 P F406

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.