PM92768: WMQ V7 BATCH APPLICATION GETS ERROR MQRC_SOURCE_CCSID_ERROR (RC2111) ON MQSETMP WHEN DEFAULT CCSID MQCCSI_APPL IS USED .

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Batch application gets MQRC_SOURCE_CCSID_ERROR rc2111
  on MQSETMP API call when using default value MQCCSI_APPL
  for CCSID field VSCCSID in variable length string (MQCHARV)
  and VALUECCSID in message property options (MQSMPO).
  .
  The error occurs because the CCSID (APPL_CCSID) is not yet
  initialized in the BLOA . This is done by CSQBSRV when
  processing other MQ API call like MQOPEN.
  
  MQMSGPROP/K
  

Local fix

• Execute an MQOPEN before manipulating message properties
  or set CCSID in MQCHARV and MQSMPO prior to issuing
  the MQSETMP API call.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of WebSphere MQ Version 7          *
  *                 Release 0 Modification 1 and                 *
  *                 Release 1 Modification 0.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: Batch application issues API call       *
  *                      MQSETMP that fails with MQRC 2111       *
  *                      MQRC_SOURCE_CCSID_ERROR when CCSID      *
  *                      value MQCCSI_APPL (-3) is used for      *
  *                      property names or for string property   *
  *                      values.                                 *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Batch application that uses language environment (LE) but is not
  linked with MQ DLL stubs receives MQRC 2111
  MQRC_SOURCE_CCSID_ERROR after API call MQSETMP or MQINQMP or
  MQDLTMP.
  
  The reason for the error is that the application has not issued
  any other API call (except MQCONN) before calling MQCRTMH and
  MQSETMP and it has specified CCSID MQCCSI_APPL (-3) to the
  property names or to the string property values.
  

Problem conclusion

• For LE applications, the CCSID value MQCCSI_APPL is now resolved
  during call MQSETMP or MQINQMP or MQDLTMQP in CSQBPAPI.
  
  Non-LE applications continue to fail with MQRC 2111
  MQRC_SOURCE_CCSID_ERROR after MQSETMP/MQINQMP/MQDLTMP if CCSID
  value MQCCSI_APPL (-3) is used. Non-LE applications should code
  the actual CCSID value that is used to encode the property names
  or string values.
  
  The following are the changes to the MQ documentation in the
  Infocenter to describe behaviour for non-LE applications.
  
  =================== DOC changes to Messages and Codes ==========
  Update description of the API reason code 2111 to the MQ V710
  Infocenter topic "fm13050_" located on the following path:
  
  > WebSphere MQ
  >> Troubleshooting and support
  >>> Reason codes
  >>>> API completion and reason codes
  >>>>> API reason codes
  
  2111 (083F) (RC2111): MQRC_SOURCE_CCSID_ERROR
  
  Add the following paragraph at the end of the
  "Explanation" section:
  "
  This reason can occur on MQSETMP/MQINQMP/MQDLTMP calls
  when the application issuing these calls does not use
  Language Environment (LE) and defines CCSID value of
  MQCCSI_APPL (-3) in the MQCHARV fields for message
  property names and string property values.
  "
  
  Add the following paragraph at the end of the
  "Programmer response" section:
  "
  If this reason happens as result of a MQSETMP/MQINQMP/MQDLTMP
  call issued in a non-LE application program that has
  specified CCSID as MQCCSI_APPL (-3) then
  applications should be changed to specify  it
  the CCSID value used by the application to encode
  the property names or property string values.
  
  It is recommended that applications override the value of
  MQCCSI_APPL (-3) with the correct CCSID used as described in
  "Redefinition of MQCCSI_APPL <link  to fr22730_>"
  or to set the explicit CCSID value used to encode
  text strings in MQCHARV or similar structures.
  "
  =================== DOC changes to Messages and Codes =========
  Update description of the API reason code 2111 to the MQ V701
  Infocenter topic "fm13050_" located on the following path:
  
  > WebSphere MQ
  >> z/OS Messages and Codes
  >>> API completion and reason codes
  >>>> Reason codes
  >>>>> Reason code list
  
  2111 (083F) (RC2111): MQRC_SOURCE_CCSID_ERROR
  
  Add the following paragraph at the end of the
  "Explanation" section:
  "
  This reason can occur on MQSETMP/MQINQMP/MQDLTMP calls
  when the application issuing these calls does not use
  Language Environment (LE) and defines CCSID value of
  MQCCSI_APPL (-3) in the MQCHARV fields for message
  property names and string property values.
  "
  
  Add the following paragraph at the end of the
  "Programmer response" section:
  "
  If this reason happens as result of a MQSETMP/MQINQMP/MQDLTMP
  call issued in a non-LE application program that has
  specified CCSID as MQCCSI_APPL (-3) then
  applications should be changed to specify  it
  the CCSID value used by the application to encode
  the property names or property string values.
  
  It is recommended that applications override the value of
  MQCCSI_APPL (-3) with the correct CCSID used as described in
  "Redefinition of MQCCSI_APPL <link  to fr22730_>"
  or to set the explicit CCSID value used to encode
  text strings in MQCHARV or similar structures.
  "
  
  =================== DOC changes to Messages and Codes =========
  Update description of error message CSQB001E to the MQ V710
  Infocenter topic "zm10236_" located on the following path:
  
  > WebSphere MQ
  >> Reference
  >>> Messages and reason codes for z/OS
  >>>> Messages for WebSphere MQ for z/OS
  >>>>> Batch adapter messages (CSQB...)
  
  CSQB001E: Language environment programs running in
  z/OS batch or USS must use the DLL interface to WebSphere MQ
  
  Replace the paragraph on the "System action" section:
  "
  Processing continues. The Async Consume feature of
  WebSphere MQ is not supported when using the non-DLL stub
  interface to WebSphere MQ.
  "
  
  =================== DOC changes to Messages and Codes =========
  Update description of error message CSQB001E to the MQ V701
  Infocenter topic "zm10236_" located on the following path:
  
  > WebSphere MQ
  >> z/OS Messages and Codes
  >>> Messages
  >>>> Batch adapter messages (CSQB...)
  
  CSQB001E: Language environment programs running in
  z/OS batch or USS must use the DLL interface to WebSphere MQ
  
  Replace the paragraph on the "System action" section:
  "
  Processing continues. The Async Consume feature of
  WebSphere MQ is not supported when using the non-DLL stub
  interface to WebSphere MQ.
  "
  
  010Y
  100Y
  CSQBPAPI
  

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:

  UK97575 UK97576

Modules/Macros

• CSQBPAPI
  

Fix information

• Fixed component name

  WMQ Z/OS V7

• Fixed component ID

  5655R3600

Applicable component levels

• R010 PSY UK97575

     UP13/10/16 P F310

• R100 PSY UK97576

     UP13/10/16 P F310

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.