IBM Support

PJ41479: Applications which are using the WebSphere MQ client on z/TPF need a mechanism to wait for messages to arrive withoutrequiring

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • See Problem Summary.
    

Local fix

  • n/a
    

Problem summary

  • APAR NUMBER:  PJ41479
    PRODUCT:  z/TPF
    FUNCTIONAL AREA:  MQI CLIENT SUPPORT
    SHIPPED IN PUT:  11
    
    ABSTRACT:
    Applications which are using the WebSphere MQ client on z/TPF
    need a mechanism to wait for messages to arrive without
    requiring an ECB to be active.
    
    PACKAGE CONTENTS:
    Source Segments:
    (C) base/cntl/tpf_app_base.cntl
    (C) base/include/tpf/amqrfpha.h
    (C) base/include/tpf/cmqc.h
    (C) base/include/tpf/c_mqpr.h
    (N) base/rt/cget.mak
    (N) base/rt/cmqget.c
    (C) base/rt/cmqi03.c
    (C) base/rt/cqrreq.c
    
    Object Only Binaries:
    None.
    
    Configuration Independent Binaries:
    (C) base/lib/libCMQI.so
    (N) base/load/CGET.so
    (C) base/load/CMQ3.so
    (C) base/load/CMQI.so
    (N) base/obj/cmqget.o
    (C) base/obj/cmqi03.o
    (C) base/obj/cqrreq.o
    
    Support Files:
    base/lst/cmqget.lst
    base/lst/cmqi03.lst
    base/lst/cqrreq.lst
    base/lst/CGET.map
    base/lst/CMQ3.map
    base/lst/CMQI.map
    
    OTHER BINARIES TO BUILD: YES
    (C) <sys>/load/IPAT.so
    (C) <sys>/stdlib/libTPFSTUB.so
    (C) <sys>/stdload/TPFSTUB.so
    (C) <sys>/obj/ipat.o
    
    COMMENTS:
    Currently an ECB is required to remain in the z/TPF system if
    an application is using the WebSphere MQ Client on z/TPF to get
    messages from a remote queue manager if the MQGMO_WAIT option
    is specified and there are no messages on the queue. This can
    result in a large number of suspended ECBs remaining in the
    z/TPF system if there are many queues being serviced. A method
    is required that allows those ECBs to be exited and new ECBs
    created when a message arrives.
    

Problem conclusion

  • SOLUTION:
    The following functions have been added to z/TPF.
    - TPF_MQGET allows an application to request a message using
    the WebSphere MQ client to request a message from a remote
    queue manager and specify the application which should be
    activated when the message arrives.
    - TPF_MQGET_RESUME continues processing of a message that was
    requested by the TPF_MQGET function.
    In addition the __TPF_CLIENTONLY compiler option has been added
    which improves the performance of applications which are using
    only the MQ Client interface on z/TPF.
    
    COREQS: NO
    None.
    
    MIGRATION CONSIDERATIONS: YES
    Application programming interface (API) changes:
    TPF_MQGET and TPF_MQGET_RESUME have been added.
    
    BUILD COMMANDS AND INSTRUCTIONS: YES
    #maketpf commands for linux
    maketpf -f CMQ3 cmqi03.o
    maketpf -f CMQI cqrreq.o
    maketpf -f CGET cmqget.o
    maketpf -f TPFSTUB
    maketpf -f IPAT
    maketpf CMQ3 link
    maketpf CMQI link
    maketpf CGET link
    
    UPDATED INFORMATION UNITS: YES
    z/TPF C/C++ Language Support User's Guide
    
    See your IBM representative if you need additional information.
    
    DOWNLOAD INSTRUCTIONS:
    http://www.ibm.com/software/htp/tpf/pages/maint.htm
    
    APAR URL:
    http://www.ibm.com/software/htp/tpf/ztpfmaint/put11/PJ41479.htm
    

Temporary fix

Comments

APAR Information

  • APAR number

    PJ41479

  • Reported component name

    Z/TPF

  • Reported component ID

    5748T1501

  • Reported release

    110

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2013-08-29

  • Closed date

    2014-11-03

  • Last modified date

    2014-11-03

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

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

Publications Referenced
SK2T8062        

Fix information

  • Fixed component name

    Z/TPF

  • Fixed component ID

    5748T1501

Applicable component levels

  • R110 PSY

       UP



Document information

More support for: TPF
z/TPF

Software version: 110

Reference #: PJ41479

Modified date: 2014-11-03