IO18136: GIMAPI RETURNS A VALUE OF 4 IN REG15, EVEN THOUGH THE RETURN AND CONDITION CODES IN THE PARM LIST ARE ZERO.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Our customer is using GIMAPI to query objects from an SMP/E CSI.
  After applying PTF UO01422 (SMP/E level 36.16), they're getting
  control returned with a value of 4 in reg15.  However the rc
  (return code), cc (condition code) and msgbuff (message buffer
  pointer) returned in the GIMAPI parm list are all zero.
  

Local fix

• Ignore the value in reg15.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the SMP/E CSI Application       *
  *                 Programming Interface (GIMAPI).              *
  ****************************************************************
  * PROBLEM DESCRIPTION: GIMAPI returns a value of 4 in REG15,   *
  *                      even when the return code and condition *
  *                      code in the parm list are zero.         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  GIMAPI mantains a lot of data in memory during processing.  At
  certain points in processing, it will delete information about a
  particular entry.  GIMAPI will attempt to locate the entry
  before attempting to delete it.  If the entry is not found the
  locate ends with a return code of 4 indicating that the deletion
  is not necessary.
  
  Modifications to GIMAPI processing by APAR IO14873 mistakenly
  saved the return code 4 generated by the locate.  The return
  code from the locate should be used solely as a signal that the
  deletion is not needed and it should not be maintained as a
  return code for the query request.
  

Problem conclusion

• Module GIMMPGTB was modified in SMP/E 3.6 to properly manage the
  return codes when manipulating data in memory.
  J00Y
  GIMJVLVL
  GIMLEVEL
  GIMMPGTB
  

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:

  UO01462

Modules/Macros

• GIMJVLVL GIMLEVEL GIMMPGTB
  

Fix information

• Fixed component name

  SMP/E

• Fixed component ID

  566894901

Applicable component levels

• RJ00 PSY UO01462

     UP13/02/20 P F302

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.