PK11142: OPERATORS CONSOLE TO SHOW THE MOST ACTIVE DESTINATION AND PERCENTS OF THE LONG/SHORT QUEUE BLOCKS THEY OCCUPY

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• An output to the operators console should show the most active
  destination and percents of long/short queue blocks they occupy.
  Also the last active destination should be displayed.
  The output should be able to be requested any time and should
  not be connected to any build ups of the queues and crossing
  thresholds.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users, that would like to have top nn        *
  *                 destinations using the long messages queue,  *
  *                 the short messages queue, the destinations   *
  *                 with most messages or last active            *
  *                 destinations displayed.                      *
  ****************************************************************
  * PROBLEM DESCRIPTION: Display for top nn destinations using   *
  *                      the long, the short, both messages      *
  *                      queues or last active destinations is   *
  *                      added.                                  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  WTO top nn destinations using the short messages queue,
  or the long messages queue, WTO top nn last active
  destinations, WTO top nn destinations with most messages.
  
  
        QCF  is enhenced to display the top NN destinations
  using the short messages queue,  the long messages queue,
  both short and long messages queues or last active
  destinations for non shared queue.
       QCF  is enhenced to display the top NN destinations
  using the messages queues or last active destinations
  for shared queue
  
  
   1.     Customers can trigger a WTO to  list  the top NN
  ( any number up to 99) destinations using next sample
  procedure.It executes DFSRRC00 with IQCXCTRL and  with
  parameter APARM. APARM sets  the  type of display and
  the number of the displayed destinations:
  
  
  
  **************************************************************
  *    S IQCCMDQU,PRM1=AAAA,PRM2=keyword=nn                    *
  *    &PRM1 sets IMSID - character, 4bytes                    *
  *    &PRM2 sets type of display -                            *
  *               TOPSM=nn / TOPLM=nn / TOPAM=nn / TOPLA=nn    *
  *                                                            *
  *  SAMPLES:S IQCCMDQU,PRM1=IMS1,PRM2=TOPAM=11                *
  *          S IQCCMDQU,PRM1=IMS1,PRM2=TOPLA=5                 *
  *  TOPSM=nn displays nn destinations with most short messages*
  *        queue records ( only for nonshared queues)          *
  *  TOPLM=nn displays nn destinations with most long  messages*
  *        queue records ( only for nonshared queues)          *
  *  TOPAM=nn displays nn destinations with most               *
  *        queue records ( for both queues types)              *
  *  TOPLA=nn displays nn destinations with most recent        *
  *        added records ( for both queues types)              *
  **************************************************************
  //IQCCMDQU EXEC PGM=DFSRRC00,REGION=1000K,TIME=1440,PARM=(BMP,
  //  IQCXCTRL,MRQPSB,,,W00040,,0,,,,15,15,&PRM1,,,,,'&PRM2')
  //STEPLIB  DD  DISP=SHR,DSN=qcfhlq.SIQCLOAD
  //         DD  DISP=SHR,DSN=imshlq.RESLIB
  //QCFPRINT DD  SYSOUT=*
  
  The presence of APARM triggers execution of function
  QUERY and WTOs for most active destinations
  
  
  2.Customers can trigger a WTO to  list  the top NN
  ( any number up to 99) destinations using  function QUERY
  and the regular batch  execution for QCF
  In order to support displaying the top NN destinations,
  new operands are  added to QUERY function step.
  
  -TOPLONGMSGWTO=nn (TOPLM=nn) to WTO top nn destinations
  using the long messages queue (non shared queues only)
  
  -TOPSHORTMSGWTO=nn (TOPSM=nn) to WTO top nn destinations
  using the short messages queue (non shared queues only)
  
  -TOPALLMSGWTO=nn (TOPAM=nn) to WTO top nn destinations
  with most messages
  
  -TOPLASTACTIVWTO=nn (TOPLA=nn) to WTO top nn last active
  destinations.
  
  FULL FORMAT OF QUERY STATEMENT
  
  FUNCTION QUERY TOPLM=12
  
  Any INCLUDE EXCLUDE statements that follow the FUNCTION statemen
  are ignored.
  
  3.Sample displays
  S IQCCMDQU,PRM1=IMS1,PRM2=TOPLA=9
  
   +IQC3522I Top         9         Last Active Destinations
   +IQC3523I Dest     QT            LastActive  LongB/ShrtB
   +IQC3524I AD201L5  LT   06/01/10-14:11:27:9   0.2%/ 0.0%
   +IQC3524I NDS01B   LT   06/01/10-14:11:27:9   0.2%/ 0.0%
   +IQC3524I RTERM07  LT   06/01/10-14:11:27:9   0.2%/ 0.0%
   +IQC3524I UTRL     LT   06/01/10-14:11:27:9   0.2%/ 0.0%
  
   +IQC3524I T3270L2  LT   06/01/10-14:11:27:9   0.2%/ 0.0%
   +IQC3524I AD201L4  LT   06/01/10-14:11:27:9   0.2%/ 0.0%
   +IQC3524I T2741    LT   06/01/10-14:11:27:9   0.2%/ 0.0%
   +IQC3524I S2741P1  LT   06/01/10-14:11:27:9   0.2%/ 0.0%
   +IQC3524I AD202F   LT   06/01/10-14:11:27:9   0.2%/ 0.0%
  
  S IQCCMDQU,PRM1=IMS1,PRM2=TOPLM=6
  
    +IQC3516I Top         6         Long  Queue Destinations
    +IQC3517I Dest     QT      LongBufs            LastActive
    +IQC3518I TSUED01  LT      36/ 3.1%   01/10/30-06:58:02:6
    +IQC3518I DESRZA70.A7CICHBT
    +IQC3518I -DFSASYNCAP      32/ 2.7%   01/10/31-02:29:40:6
    +IQC3518I CLIENT1-
    +IQC3518I -T3270LC OT      24/ 2.0%   01/11/02-10:19:04:1
    +IQC3518I T0910122 LT      24/ 2.0%   01/10/31-02:33:36:9
    +IQC3518I IMSNET.L62MVS1
    +IQC3518I -DFSASYNCAP      16/ 1.3%   00/05/20-12:57:54:3
    +IQC3518I VTAGB588 LT      16/ 1.3%   01/10/30-07:00:08:3
  

Problem conclusion

Temporary fix

Comments

• Install the APAR and use the sample procedure IQCCMDQU to
  createyour own procedure.
  

APAR Information

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

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

  UK10718

Modules/Macros

•    IQCCMDQU IQCCQSDC IQCDSECT IQCQMSG0 IQCQRY61
  IQCQUERY IQCXCTRL IQCXMSG0 IQCXREAD
  

Fix information

• Fixed component name

  IMS QUEUE CNTL

• Fixed component ID

  5697E9900

Applicable component levels

• R210 PSY UK10718

     UP06/01/13 P F601

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.