PH45023: REASON CODE IIRSN_MTTSWPL NOT BEING RETURNED TO CALLER

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A CEXMAPI READASYN call returns an undocumented R15=00000010,
  REASON=04000000.  The problem is that the PC routine called by
  CEXMAPI is unable to get a lock to update the save area chain.
  The reason code should have been:
  IIRSN_MTTSWPL EQU 87 MTTH_SWPLOCK NOT OBTAINED
  .
  Omegamon XE for IMS v5.5 may see this error:
  KIPICA87E ERROR DURING READASYN OF IMS CONNECT HWSID=IMN1THWS,
  R15=00000010, REASON=04000000
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IMS Connect Extensions V3.1         *
  ****************************************************************
  * PROBLEM DESCRIPTION: Reason code IIRSN_MTTSWPL not being     *
  *                      returned to caller.                     *
  ****************************************************************
  A CEXMAPI READASYN call is returning with an undocumented
  R15=00000010, REASON=04000000.
  The problem is that the PC routine called by CEXMAPI is unable
  to get a lock to update the save area chain.
  The reason code should have been:
  IIRSN_MTTSWPL EQU 87 MTTH_SWPLOCK NOT OBTAINED
  

Problem conclusion

• CEXMAPI is corrected to:
  
  a. correctly return the failure reason code.
  
  b. create trace entries in the wrap around in-storage trace
     table.
  
  The user macro CEXAPEQU has some comment errors corrected.
  

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:

  UI80033

Modules/Macros

• CEXAPEQU CEXIICB  CEXMAPI
  

Fix information

• Fixed component name

  IMS CONNECT EXT

• Fixed component ID

  5655K4800

Applicable component levels

• R310 PSY UI80033

     UP22/04/09 P F204

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.