IT16629: MQCXP.SecurityParms returned by exit must remain usable by MQ until MQXR_TERM

APAR status

• Closed as documentation error.

Error description

• If the security exit does not leave the MQCXP.SecurityParms
  pointer it gave to MQ addressable and with valid contents until
  the moment it is called with MQXR_TERM, then unpredictable
  results may occur.
  
  For example:
  AMQ9557: Queue Manager User ID initialization failed for 'xyz'.
   EXPLANATION:
   The call to initialize the User ID 'xyz' failed with CompCode 2
   and Reason 2595.
  
  Such a problem can happen if the user code invalidates the
  storage at a pointer via MQCXP.SecurityParms or reuses it for
  some other purpose.
  
  The MQ product documentation did not explicitly state that the
  user is expected to leave the contents of that memory stable,
  until the time when it is called wtih MQXR_TERM.
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Users who write security exits for use with MQ.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  The writer of the exit must ensure that, if they pass a MQCSP
  data block to MQ via the MQCXP.SecurityParms, that this memory
  area remains good until MQ calls the final call to the exit,
  with MQXR_TERM.
  
  The MQ documentation was not clear on this point, and a user
  found a problem when they freed the block too early.
  
  http://www.ibm.com/support/knowledgecenter/SSFKSJ_9.0.0/com.ibm.
  mq.con.doc/q016800_.htm
  

Problem conclusion

• The MQ documentation is clarified on this point.
  At this page
  http://www.ibm.com/support/knowledgecenter/SSFKSJ_9.0.0/com.ibm.
  mq.con.doc/q016800_.htm
  The text will be changed to reflect that the exit MUST wait
  until MQXR_TERM before invalidating or freeing the memory.
  

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:

Fix information

Applicable component levels