PH08036: IMS CATALOG API OPEN FAILED WITH RETURN CODE 48 AND REASON CODE 6815744

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Using File Manager(FM) with a static PSB with GSAM PCB(s)
  results in message:
  FMNIA616 (10616) IMS catalog API OPEN failed with return code 48
            and reason code 68157440.
  GSAM is doing an API open to read the PSB/DBD members from the
  IMS directory, but we are not issuing a corresponding API close
  for the directory. When FM attempts to open the directory after
  GSAM initialization and gets an open failure.
  
  Prior to IMS catalog managed ACBs we would read the PSB/DBDLIB
  by doing an open for the DCB to read the GSAM control blocks
  from the PSB and DBD lib. Then we would close the DCB for the
  PSB/DBDLIB. This should work the same way for the IMS directory,
  i.e., open & close.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All IMS V15 Managed ACB users with GSAM databases.           *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * An application program issues an IMS catalog API OPEN and    *
  * fails with return code 48 and reason code 68157440           *
  * ('04100000'x) when attempting to open the IMS Catalog        *
  * directory. Or a IMS dependent region abends with ABENDU0657  *
  * reason 'C4C90005'x and message DFS823I when attempting to    *
  * open the IMS Catalog directory.                              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * INSTALL CORRECTIVE SERVICE FOR APAR/PTF                      *
  ****************************************************************
  An IMS Catalog API open call DFS3CATQ FUNCTION=OPEN issued by an
  application fails when attempting to read PSBs and/or DBDs from
  the IMS directory. The application attempts to open the IMS
  directory while an IMS dependent region also has the IMS
  directory open. The dependent region is accessing a GSAM
  database and module DFSZDI00 issues DFS3CATQ FUNCTION=OPEN for
  the directory without issuing a subsequent IMS Catalog API close
  call DFS3CATQ FUNCTION=CLOSE function. When a GSAM database is
  accessed the IMS Directory will remain open for the life of the
  dependent region and any applications that attempt to open the
  directory receive RC='30'x Dynamic allocation of IMS directory
  data set was not successful.
  
  Another symptom of this issue is ABENDU0657 with reason
  'C4C90005'x and message DFS823I. In this case, a dependent
  region uses a GSAM database under IMS Managed ACB environment
  and the region abends. At this point, the IMS directory data set
  is in OPEN status. Then an IMS Tools utility, PRF detected the
  abend and initiated a backout DFSBBO00 to backout the database
  updates. However, since the IMS directory data set was in OPEN
  status, a DFS3CATQ OPEN macro from GSAM initialization (
  DFSZDI00 ) failed with IKJ56246I DATA SET xxx.DFSCD000.DI100x
  NOT ALLOCATED, FILE IN USE and U0657 reason 'C4C90005'x and
  message DFS823I UNABLE TO OPEN CATALOG DIRECTORY.
  
  Additional Keywords: IMSCATALOG MACB AB0657 MSGDFS0657I DFS0657I
  MSGDFS823I
  

Problem conclusion

• DFSZDI00
  Code is added in module DFSZDI00 after label BL1501 to call new
  routine CLOSEDIR to close the IMS Directory. Routine CLOSEDIR
  determines the catalog High Level Qualifier (HLQ) and passes the
  HLQ as input to the Catalog API ( DFS3CATQ ). DFS3CATQ
  FUNCTION=CLOSE is issued to close the directory data set. If the
  CLOSE function fails message DFS4902W will be returned to the
  user and the dependent region will continue to process.
  
  Documentation Change
  
  Add the following message to IMS Version 15 Messages and Codes,
  Volume 1: DFS Messages (GC27-6789-00)
  
  DFS4902W UNABLE TO CLOSE THE CATALOG DIRECTORY
  
  Explanation
  An attempt is made to close the IMS directory data set during
  GSAM initialization.  This message is returned when the IMS
  directory data set is unable to close.
  
  System action
  The IMS dependent region continues to run with the IMS directory
  data set open.
  
  System programmer response
  Check for error messages, such as z/OS message IEC2xxI, that
  might indicate the cause of the problem. After the error is
  corrected, restart the dependent region.
  
  Module
  DFSZDI00
  

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:

  UI64831

Modules/Macros

• DFSZDI00
  

Fix information

• Fixed component name

  IMS V15

• Fixed component ID

  5635A0600

Applicable component levels

• R500 PSY UI64831

     UP19/08/21 P F908

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.