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

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

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

  • 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



Rate this page:

(0 users)Average rating

Document information


More support for:

TPF
z/TPF

Software version:

110

Reference #:

PJ41479

Modified date:

2014-11-03

Translate my page

Machine Translation

Content navigation