PK30143: CICS REPORTS QUEUELIMIT(0) AND QUEUELIMIT(NO) THE SAME ON A COLLECT STATISTICS CALL

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CICS treats QUEUELIMIT(0) and QUEUELIMIT(NO) when it reports the
  settings during COLLECT STATISTICS.  The distinction is made in
  the TCTSE control block, but CPSM reports this based on the
  information it receives from a COLLECT STATISTICS call.  CICS
  needs to differentiate 0 from NO.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS statistics unable to distinguish   *
  *                      between a QUEUELIMIT(NO) and a          *
  *                      QUEUELIMIT(0).                          *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When using CICSPlex SM to display the QUEUELIMIT parameter it is
  not possible to differentiate between a setting of NO or 0, both
  will be displayed as 0.
  The QUEUELIMIT parameter is on the CEDA definition for a
  CONNECTION and can be set to NO or a value between 0 and 9999.
  CICS Statistics has only one field (A14EALIM) which holds the
  QUEUELIMIT setting, but this field will be set to 0 for both
  a QUEUELIMIT of NO and 0.
  CICSPlex SM retrieves information about the QUEUELIMIT via
  COLLECT STATISTICS and field A14EALIM.
  
  Keyword: PK35450
  

Problem conclusion

• If the Queuelimit has been specified as 'No' then DFHBSSZ has
  been changed to set a value of -1 in CICS statistics field
  A14EALIM. The statistics programs DFHSTUP and DFH0STAT have
  been changed to interrogate the value of A14EALIM and if it is
  -1 to write 'No' to the statistics reports.
  
  The CICS Transaction Server for z/OS V3R1 Performance Guide
  (SC34-6452-03) has been changed in Appendix 1.1.13.1.1 Table 70
  for field A14EALIM
  Allocate queue limit A14EALIM   is the QUEUELIMIT parameter
                                  specified on the CONNECTION
                                  definition. If this value is
                                  reached then allocates are
                                  rejected. If a QUEUELIMIT of
                                  No has been set then this
                                  field will have a value of -1.
  
                                Reset characteristics: not reset
  
  The same manual has been changed in Appendix 1.1.13.1.2 Table 71
  The description for DFHSTUP name Allocate queue limit has been
  changed to read as follows:
  is the last value encountered for QUEUELIMIT parameter specified
  on the CONNECTION definition. When set, if this value is reached
  then allocates are rejected.
  

Temporary fix

• CICS AR400 AR401
  AR400 FIX AVAILABLE BY PTF ONLY
  ++ APAR (AK30143).
  ++ VER (C150) FMID(JCI6401).
  ++ MACUPD (DFH0STPR) DISTLIB(ADFHSAMP) SYSLIB(SDFHSAMP)
     /* MODULE: DFH0STPR --- TYPE: COBOL */.
  ./ CHANGE NAME=DFH0STPR,SEQFLD=738
        *************************************************
                                     ******@BA30143A  49344000
        * Check if the Connection Queue Limit is set to
                                    NO,    @BA30143A  49348000
        * ie DFHBSS will have set it to -1. If it is
                                 then      @BA30143A  49352000
        * write No out to the DFH0STAT field. Otherwise
                                           @BA30143A  49356000
        * write out the true value.        @BA30143A  49360000
        *************************************************
                                     ******@BA30143A  49364000
                 IF A14EALIM = -1 THEN                49368000
                     MOVE '    No'      TO PP115-120  49372000
                 ELSE                                 49376000
                    MOVE A14EALIM       TO PP111-120  49380000
                 END-IF                               49400000
  ./ ENDUP
  

Comments

APAR Information

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

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

  UK21304 UK21305

Modules/Macros

•    DFHBSSZ  DFHSTU14 DFHST14X DFH0STPR
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK21304

     UP07/01/19 P F701

• R401 PSY UK21305

     UP07/01/19 P F701

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.