A fix is available
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 number
PM92768
Reported component name
WMQ Z/OS V7
Reported component ID
5655R3600
Reported release
018
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2013-07-11
Closed date
2013-09-16
Last modified date
2013-11-04
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
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.
[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
04 November 2013