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

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