PI12488: Support for 64 bit MQ applications written in C

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New function support
  .
  Additional symptoms/keywords:
  This APAR also made changes similar to PM55581 and PM89237 for
  CSQBLB26, CSQBLB36, and CSQBLB56.  The problem there was an
  ABEND0C4 0C4.  For example, in CSQBLB56, the program check
  occurred because REG6=00000000.  It was loaded from a variable
  called thunked that was zeroes because a prior STORAGE OBTAIN
  for SP1 KEY8 private storage had failed.  The fix will handle
  the obtain failure rather than allowing the S0C4.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of WebSphere MQ for z/OS Version 7 *
  *                 Release 1 Modification 0.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: MQ applications written in C cannot be  *
  *                      compiled as 64 bit applications using   *
  *                      the LP64 compiler option.               *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When compiling an MQ application that includes header file
  cmqc.h, the compile fails if the LP64 compiler option is
  specified.
  The listing contains the following error:
  "WebSphere MQ for z/OS does not support the LP64 compilation
  option"
  

Problem conclusion

Temporary fix

Comments

• Support for 64 bit MQ applications written in C has been added,
  enabling MQ applications to be compiled using the LP64 compiler
  option, and successfully used with an MQ queue manager.
  
  A new subtopic is added to the infocenter:
  Developing applications
  - Building a WebSphere MQ application
   - Building your application on z/OS
    - Preparing your program to run (fg16770_)
     - Building 64bit C applications.
  
  In z/OS 64bit C applications are built using the LP64 compiler
  and binder options.  The WebSphere MQ for z/OS cmqc.h header
  file recognizes when this option is provided to the compiler
  and generates MQ types and structures appropriate for 64bit
  operation.  C code built with this option must be built to use
  dynamic-link libraries (DLLs) appropriate for the coordination
  semantic required.
  The specific DLL is indicated by binding the compiled code with
  the appropriate side-deck defined in the following table:
  
  COORDINATION                                         | side-deck
  single phase commit MQI                              | CSQBMQ2X
  2 phase commit with RRS coordination via RRS verbs   | CSQBRR2X
  2 phase commit with RRS coordination using MQI verbx | CSQBRI2X
  
  To build a single phase commit MQ program as a batch job, use
  the EDCQCB JCL procedure supplied with 'z/OS XL C/C++' as
  follows:
  
  //PROCS   JCLLIB ORDER=CBC.SCCNPRC
  //CLG  EXEC EDCQCB,
  //  INFILE='thlqual.SCSQC37S(CSQ4BCG1)',          < MQ SAMPLES
  //  CPARM='RENT,SSCOM,DLL,LP64,LIST,NOMAR,NOSEQ', < COMPILER OPT
  //  LIBPRFX='CEE',                      < PREFIX FOR LIBRARY DSN
  //  LNGPRFX='CBC',                     < PREFIX FOR LANGUAGE DSN
  //  BPARM='MAP,XREF,RENT,DYNAM=DLL', < LINK EDIT OPTIONS
  //  OUTFILE='userid.LOAD(CSQ4BCG1),DISP=SHR'
  //COMPILE.SYSLIB DD
  //               DD
  //               DD DISP=SHR,DSN=thlqual.SCSQC370
  //BIND.SCSQDEFS DD DISP=SHR,DSN=thlqual.SCSQDEFS
  //BIND.SYSIN  DD *
    INCLUDE SCSQDEFS(CSQBMQ2X)
    NAME CSQ4BCG1
  
  To build an RRS coordinated program in z/OS Unix System Services
  compile and link as follows:
  '
  cc  -o mqsamp -W c,LP64,DLL -W l,DYNAM=DLL,LP64
      -I"//'thlqual.SCSQC370'" "//'thlqual.SCSQDEFS(CSQBRR2X)'"
      mqsamp.c
  '
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UI18714

Modules/Macros

• CMQC     CSQBLB16 CSQBLB26 CSQBLB36 CSQBLB46 CSQBLB56 CSQ4BCJ1
  

Fix information

• Fixed component name

  WMQ Z/OS V7

• Fixed component ID

  5655R3600

Applicable component levels

• R100 PSY UI18714

     UP14/06/12 P F406

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.