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

Obtain the fix for this APAR.

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 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.