Skip to main content

TPF : Support : Maintenance TPF : Support : Maintenance

Skip to: Abstract | Comments | Solution | Related Segments | Migration | Download

APAR NUMBER:  PJ29214                           
PRODUCT:  TPF4  
FUNCTIONAL AREA:  MQS SUPPORT  
SHIPPED IN PUT:  18  
   

ABSTRACT:  
Enhance TPF MQSeries to display the number of SWBs that are currently  
in use by MQSeries and the number of aborted sweeps occurring for a  
specific queue.  
   
APAR CONTENTS:  
FEATURE   TYPE                STATUS    NAME                                
Base      CHeader             Changed   include/amquscrw.h  
Base      CPPHeader           Changed   include/c$mqmg.h  
Base      CHeader             Changed   include/c$mqs.h  
Base      CPP                 Changed   source/rt/base/cmqckp.cpp  
Base      CPP                 Changed   source/rt/base/cmqckq.cpp  
Base      CPP                 Changed   source/rt/base/cmqmgc.cpp  
Base      CPP                 Changed   source/rt/base/cmqmgr.cpp  
Base      CPP                 Changed   source/rt/base/cmqswp.cpp  
Base      CPP                 Changed   source/rt/base/cmqutl.cpp  
Base      CPP                 Changed   source/rt/base/cuscpf.cpp  
Base      CPP                 Changed   source/rt/base/cuscpr.cpp  
Base      CPP                 Changed   source/rt/base/cuscqm.cpp  
Base      CPP                 Changed   source/rt/base/cuscrw.cpp  
   
PREREQUISITE APARS:  To be applied in order listed.  
Base      CHeader             Changed   include/amquscrw.h  
 PJ25780(09)  PJ26156(10)  PJ26495(11)  PJ26498(11)  
 PJ27023(12)  
 PJ27351(13)  PJ27779(15)  PJ27830(15)  PJ28136(15)  PJ28339(16)  
 PJ28435(16)  PJ28758(17)  PJ29032(17)  PJ29062(17)  
Base      CPPHeader           Changed   include/c$mqmg.h  
 PJ25780(09)  PJ26156(10)  PJ27023(12)  PJ27050(12)  
 PJ27027(13)  
 PJ27278(13)  PJ27351(13)  PJ27572(14)  PJ28104(15)  PJ28136(15)  
 PJ28339(16)  PJ28506(17)  PJ28607(17)  PJ28758(17)  PJ29032(17)  
 PJ29062(17)  PJ29117(18)  PJ29132(18)  
Base      CHeader             Changed   include/c$mqs.h  
 PJ25780(09)  PJ26156(10)  PJ26498(11)  PJ27023(12)  
 PJ27050(12)  
 PJ27177(13)  PJ27027(13)  PJ27221(13)  PJ27190(13)  PJ27231(13)  
 PJ27375(13)  PJ27332(13)  PJ27355(13)  PJ27351(13)  PJ27555(14)  
 PJ27274(14)  PJ27572(14)  PJ27779(15)  PJ27830(15)  PJ27854(15)  
 PJ28066(15)  PJ28136(15)  PJ28169(16)  PJ27979(16)  PJ27858(16)  
 PJ28339(16)  PJ28435(16)  PJ28461(17)  PJ28607(17)  PJ28758(17)  
 PJ28954(17)  PJ28701(17)  PJ29032(17)  PJ29062(17)  PJ29031(18)  
 PJ29117(18)  PJ29132(18)  
Base      CPP                 Changed   source/rt/base/cmqckp.cpp  
 PJ27023(12)  PJ27384(13)  PJ27892(15)  PJ27925(15)  PJ28256(16)  
 PJ28695(17)  PJ29032(17)  PJ29062(17)  PJ29117(18)  
Base      CPP                 Changed   source/rt/base/cmqckq.cpp  
 PJ27023(12)  PJ27779(15)  PJ28066(15)  PJ29032(17)  PJ29065(17)  
 PJ29117(18)  
Base      CPP                 Changed   source/rt/base/cmqmgc.cpp  
 PJ25780(09)  PJ26156(10)  PJ27023(12)  PJ27050(12)  
 PJ27027(13)  
 PJ27190(13)  PJ27213(13)  PJ27375(13)  PJ27332(13)  PJ27351(13)  
 PJ27572(14)  PJ27779(15)  PJ28136(15)  PJ28339(16)  PJ28435(16)  
 PJ28506(17)  PJ28333(17)  PJ28607(17)  PJ28758(17)  PJ28866(17)  
 PJ28954(17)  PJ29032(17)  PJ29062(17)  PJ29117(18)  
Base      CPP                 Changed   source/rt/base/cmqmgr.cpp  
 PJ25780(09)  PJ26156(10)  PJ27023(12)  PJ27190(13)  PJ27231(13)  
 PJ27332(13)  PJ27355(13)  PJ27351(13)  PJ27274(14)  PJ27572(14)  
 PJ27764(14)  PJ28136(15)  PJ28170(15)  PJ27858(16)  PJ28435(16)  
 PJ28506(17)  PJ28423(17)  PJ28333(17)  PJ28758(17)  PJ28867(17)  
 PJ28701(17)  PJ29032(17)  PJ29062(17)  
Base      CPP                 Changed   source/rt/base/cmqswp.cpp  
 PJ27023(12)  PJ27050(12)  PJ27221(13)  PJ27351(13)  PJ27431(13)  
 PJ27696(14)  PJ27730(15)  PJ27779(15)  PJ27854(15)  PJ28221(16)  
 PJ28339(16)  PJ28682(17)  PJ28443(17)  PJ28758(17)  PJ29062(17)  
 PJ29238(18)  PJ29117(18)  PJ29132(18)  
Base      CPP                 Changed   source/rt/base/cmqutl.cpp  
 PJ25780(09)  PJ26156(10)  PJ26921(12)  PJ27007(12)  
 PJ27023(12)  
 PJ27177(13)  PJ27332(13)  PJ27351(13)  PJ27274(14)  PJ27572(14)  
 PJ27844(15)  PJ28136(15)  PJ27672(16)  PJ28435(16)  PJ28461(17)  
 PJ28758(17)  PJ29032(17)  PJ29062(17)  PJ29117(18)  
Base      CPP                 Changed   source/rt/base/cuscpf.cpp  
 PJ25780(09)  PJ26156(10)  PJ27023(12)  PJ27177(13)  PJ27375(13)  
 PJ27351(13)  PJ27274(14)  PJ27572(14)  PJ27779(15)  PJ28126(15)  
 PJ28136(15)  PJ28435(16)  PJ28758(17)  PJ28954(17)  PJ29032(17)  
Base      CPP                 Changed   source/rt/base/cuscpr.cpp  
 PJ28136(15)  PJ28435(16)  PJ28758(17)  PJ28954(17)  PJ29032(17)  
Base      CPP                 Changed   source/rt/base/cuscqm.cpp  
 PJ25780(09)  PJ26156(10)  PJ27023(12)  PJ27274(14)  PJ27779(15)  
 PJ28435(16)  PJ28758(17)  PJ29032(17)  PJ29062(17)  
Base      CPP                 Changed   source/rt/base/cuscrw.cpp  
 PJ25780(09)  PJ26156(10)  PJ26498(11)  PJ27023(12)  
 PJ27027(13)  
 PJ27351(13)  PJ27572(14)  PJ27779(15)  PJ27830(15)  PJ28136(15)  
 PJ28339(16)  PJ28435(16)  PJ28758(17)  PJ29032(17)  PJ29062(17)  
   

COMMENTS:  
Displaying the number of SWBs that are in use by TPF MQSeries will help  
customers manage and plan their system resources. The SWB count is  
provided for each queue and for the entire queue manager.   
   
The Aborted Sweep Count shows how many sweeps have been aborted for a  
particular queue. Aborted sweeps occur when the state of a message  
changes before the sweep is completed and it results in unnecessary  
pool usage. Displaying the number of aborted sweeps will help customers  
tune the MQSeries sweeper to avoid unnecessary depletion of long- term  
pools.  
   

SOLUTION:  
The SWBCount and AbortedSweepCount integer fields have been added to  
the MoreQDef structure in c$mqmg.h. An integer field named TotSWBCount  
was added to the MQT_T02 structure in c$mqs.h to keep track of the  
total number of SWBs being used by the queue manager.   
   
Code has been added to the MQ_FileAQueue routine in cmqckq.cpp to set  
the SWBCount after counting up the SWBs that are in use in the front  
and rear message lists of a particular queue.   
   
Code has also been added to the QM_Checkpoint routine in cmqckp.cpp to  
loop through each queue and add up the SWBCounts at checkpoint time.   
   
The QM_SweepQ function in cmqswp.cpp has been updated so that every  
time a sweep is aborted, the AbortedSweepCount will be incremented.   
   
   
This TPF MQSeries enhancement will allow the number of SWBs that are  
currently in use by MQSeries to be displayed on a queue by queue basis  
as well as by the queue manager. The following three ZMQSC messages  
have been added to display SWB counts:   
ZMQSC DISP QL-* SWBCOUNT   
ZMQSC DISP QL-QNAME STAT   
ZMQSC DISP QMGR   
   
This enhancement will also allow the number of aborted sweeps to be  
displayed on a queue by queue basis with the following ZMQSC messages:   
ZMQSC DISP QL-* ABORTSWP   
ZMQSC DISP QL-QNAME STAT   
   
The SWBCOUNT and ABORTSWP parameters have been added with this  
enhancement so that we can make use of the wildcard functionality on  
these two new counts.  
   
   
DEPENDENCIES  
   

SEGMENTS TO BE ASSEMBLED OR COMPILED:  
None.  
   

SEGMENTS TO BE LINK EDITED:  
cmqk40.exe (Shipped in Tar File)  
cmqs40.exe (Shipped in Tar File)  
cuiu40.exe (Shipped in Tar File)  
cusc40.exe (Shipped in Tar File)  
   
COREQS:  
None.  
   

MIGRATION CONSIDERATIONS:  
None.  
   
DOWNLOAD INSTRUCTIONS:  
http://www.ibm.com/software/htp/tpf/pages/maint
   
-- END APAR PJ29214 
       



Download file(s): Login once to access server, leave window open, then click on link(s) below. Source Listing Binary