PH15012: CURTASKS(MAX) TO WORK AS A FIELD IN A SUMMARY REPORT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• The customer would like to build a report with the higher
  CURTASKS value of all tasks from a CICS region in a time
  interval.
  He tried the following:
  COMMAND FROM  SYSIN   :
           CICSPA IN(SMFIN001),
                    APPLID(AOR58M12),
                    LINECNT(200),
                    FORMAT(':','/'),
                    PRECISION(4),
             SUMMARY(OUTPUT(SUMM0001),
                    SELECT2(PERFORMANCE(
                       INC(START(FROM(2019/07/03,05:00:00),
                                   TO(2019/07/03,06:00:00))))),
                    TOTALS(8),
                    INTERVAL(00:01:00),
                    FIELDS(START(DATE),
                           STOP(TIMET),
                           TASKCNT,
                           TOTCPU(TOT),
                           CURTASKS(MAX),   <========
                           ))
  And received the following error:
  CPA0310E  Summary Key error - Key sequence error detected at
            field CURTASKS from module CPASUMMF/CPASUMMF
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of CICS PA V5.4                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: The MAX summary function cannot be      *
  *                      specified for CMF count field CURTASKS  *
  *                      (DFHTASK A434).                         *
  ****************************************************************
  CICS CMF field CURTASKS (DFHTASK A434) is defined as character
  field CURTASKS (DFHTASK C434) in CICS PA.
  
  Being a character field allows it to be used as a summary key
  field. However, since this field represents the number of active
  user transactions when the task is started it provides
  little value as a summary key field to group transactions.
  
  CURTASKS would be of far more value as a count field to allow
  summary functions maximum (MAX) and minimum (MIN) to show the
  system load for specific summary intervals, APPLIDs, transaction
  codes, etc.
  

Problem conclusion

• This APAR restores CURTASKS field to its original type of count
  (DFHTASKS A434) in order to allow the specification of summary
  functions MAX and MIN.
  

Temporary fix

Comments

APAR Information

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

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

  UI64730 UI64731 UI64732 UI64733

Modules/Macros

• CPAC0532 CPACMDMF CPAFDXTR CPAHDLOD CPAPADRV CPARFEV  CPARFNEW
  CPAZ04
  

Fix information

• Fixed component name

  CICS PERF ANALY

• Fixed component ID

  5655Y2300

Applicable component levels

• R540 PSY UI64730

     UP19/08/17 P F908  

• R54C PSY UI64733

     UP19/08/17 P F908  

• R54E PSY UI64731

     UP19/08/17 P F908  

• R54K PSY UI64732

     UP19/08/17 P F908  

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.