PK04198: SUPPORT TO DISPLAY THE TOP TEN DESTINATIONS USING THE MESSAGE QUEUES

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This QCF enhancement is to display the top 10 destinations
  using the message queues. Customers  would like to trigger
  a WTO that lists the top 10 destinations or source using
  the message queues.
  This is FITS REQ MR0914043036.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: NEW FUNCTION - DISPLAY TOP NN DESTINATIONS   *
  *                                                              *
  *                       QCF  is enhenced to display the top NN *
  *                 destinations using the messages queues.      *
  *                       Customers can trigger a WTO to  list   *
  *                 the top NN ( any number up to 99)            *
  *                 destinations that have the most messages     *
  *                 on the messages queue.                       *
  *                       These destinations can be listed at    *
  *                 cuustomer defined message queue              *
  *                 utilization percentage when  oveflow protec- *
  *                 tion starts  the user defined procedure      *
  *                 to browse /unload the queues.Control cards   *
  *                 for BROWSE with the new parameter have to    *
  *                 be generated in the default control card     *
  *                 members.                                     *
  ****************************************************************
  * PROBLEM DESCRIPTION: New parameter - TOPDSTWTO - is added to *
  *                      QCF function BROWSE.                    *
  *                      This parameter triggers QCF to issue    *
  *                      WTOs for selected number of destination *
  *                      with most messages on the queues.       *
  *                      Panels have been changed to allow       *
  *                      generation of the new parameter.        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  1.DISPLAY TOP NN DESTINATIONS:
  
     QCF  is enhenced to display the top NN destinations using
  message queues.
     Customers can trigger a WTO to  list  the top NN (any number
  up to 99)destinations that have the most messages on the
  message queue.
    These destinations can be listed at customer defined message
  queue utilization percentage when oveflow protection starts the
  user defined procedures to browse /unload the queues.Control
  cards for BROWSE with the new parameter have to be generated in
  the default control card members. Panels have been changed to
  allow generation of the new parameter.
        The destinations can be listed at any time without having
  to wait for some defined percentage level to be reached. A user
  defined procedure has to be started to execute function BROWSE
  with the new parameter.
  
       In order to support displaying the top NN destinations, a
  new operand - TOPDSTWTO (TD) is added to BROWSE function step.
  
  2.FULL FORMAT OF BROWSE STATEMENT:
  FUNCTION BROWSE QUEUETYPE=ALL,TOPDSTWTO=10,ACTION=READONLY
  
   TOPDSTWTO (TD)
   - Triggers WTO for top NN ( any  selected number up to 99 )
  destinations, that have been selected with the current BROWSE
  function.
   - First the selection is made, based on  BROWSE parameters,
  SELECT, INCLUDE and EXCLUDE statements (if any).
   -  Then the destinations are sorted by numbers of messages in
  descending order.
   -  WTOs are issued for top NN (whatever number is coded- up
  99) destinations.
   -  SELECT/INCLUDE/EXCLUDE can follow the BROWSE function.
  
  3.RECOMENDATIONS
  The recomended format to have the top destinations displayed
  via WTOs is:
  FUNCTION BROWSE QUEUETYPE=ALL,TOPDSTWTO=10,ACTION=READONLY
  END
  -If there are SELECT/INCLUDE/EXCLUDE control cards-the
  displayed top destinations would be for the current selection,
  not for all messages destinations.
  -To have the top  destinations for the queues displayed,
  SELECT/INCLUDE/EXCLUDE should not be coded.
  -QUEUETYPE=ALL - will select destinations from all queue types.
  -ACTION=READONLY - will request only the prefixes of the message
  minimizing the time for the response.
  
  4.SAMPLE BATCH JCL TO DISPLAY TOP NN DESTINATIONS
  //USRT003U JOB 'USER',MSGCLASS=H,MSGLEVEL=(1,1),CLASS=T,
  //         TIME=1440,REGION=6M
  //UNLOAD   EXEC BMPRCTAC,PSB=MRQPSB,MBR=IQCXCTRL,NBA=15,OBA=15,
  //         IMSID=SYS3
  //BMP.STEPLIB  DD  DISP=SHR,DSN=IMSTOOL.QCF21.IQC.SIQCLOAD
  //              DD   DISP=SHR,DSN=IMSBLD.I91RTS14.CRESLIB
  //BMP.SNAPDUMP DD   SYSOUT=H
  //BMP.SYSUDUMP DD   SYSOUT=H
  //BMP.QCFPRINT DD   SYSOUT=H
  //BMP.SYSPRINT DD   SYSOUT=H
  //BMP.QCFIN    DD   *
  FU BR QT=ALL,TOPDSTWTO=12
  END
  //
  
  5.SAMPLE WTOs
  +IQC5006I Top                12             Destinations
  +IQC5007I Destination      Q-Type   Primary   Secondary
  +IQC5007I  TSUED01           LT          18           0
  +IQC5007I  A7CICHBT
  +IQC5007I   -DFSASYNC         AP          16           0
  +IQC5007I  CLIENT1
  +IQC5007I  -T3270LC          OT           8           4
  +IQC5007I  T0910122          LT          12           0
  +IQC5007I  VTAGB588          LT           4           4
  
  6.MESSAGES
  IQC5006I Top                NN             Destinations
  Explanation: Header line with selected numebr of top destination
  displayed
  User Response:None
  
  
  IQC5007I Destination      Q-Type   Primary   Secondary
  Explanation: Destination name, queue type for the destination an
  counters of primary and secondary messages for this destination
  User response: None
  
  IQC4160E TOPDSTWTO (TD) is valid only with function BROWSE
  Explanation: Parameter TOPDSTWTO (TD) can be used only with
  function BROWSE.
  User Response:Remove TOPDSTWTO (TD) from current function
  statement and rerun the job.
  
  7.PANEL CHANGES (non-shared queues only)
  Panels IQCP72A and IQCP72B ( and the connected help panels) have
  changed to allow generation of the new parameter in the overflow
  protection members:
  

Problem conclusion

Temporary fix

Comments

• No Comments.
  

APAR Information

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

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

  UK02741

Modules/Macros

• IQCBMSG0 IQCBROWS IQCCQSDC IQCH72A1 IQCH72B
  IQCI72   IQCP7000 IQCP7100 IQCP7110 IQCP72A  IQCP72B  IQCP7200
  IQCP7210 IQCP7220 IQCP7230 IQCQMSG0 IQCQSNVS IQCQUERY IQCXMSG0
  IQCXREAD
  

Fix information

• Fixed component name

  IMS QUEUE CNTL

• Fixed component ID

  5697E9900

Applicable component levels

• R210 PSY UK02741

     UP05/04/26 P F504

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.