IBM Support

PH17289: WHEN AN IMS CATALOG API GET REQUEST RECEIVES A NONZERO RETCODE, FM/IMS PROVIDES INSUFFICIENT INFORMATION TO DIAGNOSE THE PROBLEM

A fix is available

Obtain the fix for this APAR.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • M/IMS issues message FMNIA631 "DBD not found" or FMNIA634 "PSB
not found"

when an IMS catalog API GET request receives a nonzero return
code.

FM/IMS should issue the following message instead:

"IMS catalog API GET of DBD dbname failed with return code rc
and reason code rsncd."

or

"IMS catalog API GET of PSB psbname failed with return code rc
and reason code rsncd."

Local fix

  • 



Problem summary


    

  • ****************************************************************
* USERS AFFECTED: Installations where the IMS management of    *
*                 ACBs is enabled.                             *
****************************************************************
* PROBLEM DESCRIPTION: When an IMS catalog API GET request     *
*                      receives a nonzero return code, FM/IMS  *
*                      provides insufficient information to    *
*                      diagnose the problem.                   *
****************************************************************
* RECOMMENDATION: Apply the provided PTF.                      *
****************************************************************
FM/IMS issues message FMNIA631 "DBD not found" or FMNIA634 "PSB
not found" when the GET request receives a nonzero return code.
These messages should only be issued when the user specifies a
DBD or a PSB that is not in the IMS catalog.

    



Problem conclusion


    

  • FM/IMS has been modified to issue these messages when an IMS
catalog API GET request fails and the failure isn't due to the
specified DBD or PSB not being in the IMS catalog:
"IMS catalog API GET of DBD dbname failed with return code
X'nnnnnnnn' and reason code X'nnnnnnnn'."
OR
"IMS catalog API GET of PSB psbname failed with return code
X'nnnnnnnn' and reason code X'nnnnnnnn'."

    



Temporary fix


    

  • 



Comments


    

  • 



APAR Information




    

  • APAR number
    PH17289
    • 

  • Reported component name
    FILE MANAGER Z/
    • 

  • Reported component ID
    5655Q4200
    • 

  • Reported release
    E14
    • 

  • Status
    CLOSED  PER
    • 

  • PE
    NoPE
    • 

  • HIPER
    NoHIPER
    • 

  • Special Attention
    NoSpecatt / Xsystem
    • 

  • Submitted date
    2019-09-25
    • 

  • Closed date
    2020-03-04
    • 

  • Last modified date
    2020-04-02
    • 





    

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

    • 

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

    • 



Modules/Macros


    

  • FMN1ASMX FMN1CAT  FMN1CPYR FMN1DLI  FMN1FBPD FMN1FEB1 FMN1FFOR
FMN1FIX1 FMN1FPR1 FMN1FTAD FMN1FTEX FMN1FUDB FMN1FUL  FMN1FUNS
FMN1FUSS FMN1FUTP FMN1FXSC FMN1IMSB FMN1LVL  FMN1MENU FMN1MJPN
FMN1MKOR FMN1PAB1 FMN1PAB2 FMN1PAB3 FMN1PAB4 FMN1PCLN FMN1PCOM
FMN1PED  FMN1PED1 FMN1PEDR FMN1PEDZ FMN1PHDZ FMN1PIVU FMN1PLU0
FMN1PNWS FMN1POPD FMN1POPI FMN1POPT FMN1PPU0 FMN1PSET FMN1PSSS
FMN1PSTP FMN1PTUT FMN1PUTL FMN1PV1  FMN1PX1  FMN1RBR9 FMN1RCLN
FMN1RCPX FMN1RCRS FMN1RCU3 FMN1RED9 FMN1RLR1 FMN1RLR2 FMN1RLR3
FMN1RTPL FMN1RTPX FMN1RTU3 FMN1RVPX FMN1RVU3 FMN1RVWS FMN1RXCD
FMN1RXNE FMN1RXR0 FMN1RXR1 FMN1RXTO FMN1ST00 FMN1SXT  FMNIA00
FMNIA03  FMNIA06  FMNIA09  FMNIA10  FMNIA15  FMNIA16  FMNIA17
FMNIA24  FMNIA27  FMNIA31  FMNIA34  FMNIA39  FMNIA40  FMNIA44
FMNIA45  FMNIA46  FMNIA47  FMNIA48  FMNIA49  FMNIA50  FMNIA51
FMNIA52  FMNIA53  FMNIA55  FMNIA56  FMNIA59  FMNIA60  FMNIA61
FMNIA64  FMNIA65  FMNIA66  FMNIA67  FMNIA68  FMNIB24  FMNIB29
FMNIB30  FMNIB31  FMNIB35  FMNIB36  FMNIB38  FMNIB42  FMNIB43
FMNIB44  FMNIB48  FMNIB49  FMNIB50  FMNIB51  FMNIB52  FMNIB54
FMNIB84  FMNIB86  FMNIB87  FMNIB90  FMNIC06  FMNIC07  FMNIC08
FMNIJ99  FMNMOD1

    



Fix information


    

  • Fixed component name
    FILE MANAGER Z/
    • 

  • Fixed component ID
    5655Q4200
    • 



Applicable component levels


    

  • RE14  PSY  UI68195
       UP20/03/11  P  F003
    • 



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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"E14","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSXJAV","label":"File Manager for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"E14","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
              

                          

          
 
        

      

    

      

        

          

            
Document Information


            

            


                        

            Modified date:
            

            11 March 2020
            

            
                      

        


        

        


      

    

  



    

  



  
    
      

      
Page Feedback