PH57033: CNX0211I HTASK LIMITED TO 0 MESSAGE RETURNED INCORRECTLY IN CICS EXPLORER

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are using the CICS Explorer version 5.5.26, or newer, with
  a CMCI connection and attempt to retrieve HTASK (Task History)
  records for a region. You receive an error message similar to
  the following
  
  CNX0211I Context <context>. Resource HTASK. Limited to 0
  (sorted) records collected at <datetime>
  
  Your request has caused you to exceed the DEFAULTWARNCNT in the
  WUI server, as well as the MAXHISTRECS EYUPARM value from at
  least one MAS. Exceeding both these limits is resulting in a bad
  response from the CMCI.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM users.                       *
  ****************************************************************
  * PROBLEM DESCRIPTION: When displaying a table, for example    *
  *                      HTASKS, in the CICS explorer, if the    *
  *                      request hits MAXHISTRECS in 1 or more   *
  *                      MASes and DEFAULTWARNCNT in the WUI at  *
  *                      the same time then no records are       *
  *                      returned.                               *
  *                      CICS Explorer 5.5.26 or newer will      *
  *                      display:                                *
  *                      "CNX0211I Context <context>. Resource   *
  *                      HTASK. Limited to 0 (sorted) records    *
  *                      collected at <datetime>"                *
  ****************************************************************
  * RECOMMENDATION: Apply the PTF and recycle the WUI. Recycles  *
  *                 can be done in any order.                    *
  ****************************************************************
  When a CMCI request is made, for example by CICS Explorer, to a
  CICSPlex SM WUI server region, DFHWUEYU runs to process the
  request. If the WUI has been configured with a DEFAULTWARNCNT
  limit then a GET OBJECT() TEST is performed in DFHWUEYU to
  asses the size of the result set
  .
  DFHWUEYU, when evaluating the number of records to be returned,
  after a GET OBJECT() TEST in subroutine queryRecordCount,
  treats the WARNING/MAXRECORDS response as an error and sets
  the record count to zero.
  
  The CMCI resultsummary returned to the caller will indicate:
    api_function="GET TEST"
    api_response1="1037" api_response2="1369"
    api_response1_alt="WARNING" api_response2_alt="MAXRECORDS"
    recordcount="0"
  
  Records will be returned to CMCI callers who bypass the
  DEFAULTWARNCNT limit using the OVERRIDEWARNINGCOUNT parameter,
  but will be capped by the MAXRECORDS limit where appropriate.
  

Problem conclusion

• DFHWUEYU has been modified, in the queryRecordCount subroutine,
  to treat WARNING the same as OK and accumulate the number of
  records expected correctly.
  

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:

  PH58120 UI94599 UI94600

Modules/Macros

• DFHWUEYU
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R20M PSY UI94600

     UP23/11/28 P F311

• R30M PSY UI94599

     UP23/11/28 P F311

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.