PI97358: CPSM CMAS WRITING EXCEPTION TRACE ENTRIES UNNECESSARILY FOR SOME SYSPARM TABLE QUERIES

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You look at the internal trace table for a CMAS or its AUX
  trace datasets, and you find many entries that look like this
  in the abbreviated trace:
  .
  TASK  MTD  PREV TRAN OBJ LEVL PT-ID   DEBUG UOW CMAS/USR ENVR
  12345 NEP2 NQRG CONA MAS EXCP      4 NODATA API <userid> LMAS
  12345 NEP2 NQRG CONA MAS EXCP      4 NODATA API <userid> LMAS
  12345 NEP2 NQRG CONA MAS EXCP      4 NODATA API <userid> LMAS
  12345 NEP2 NQRG CONA MAS EXCP      4 NODATA API <userid> LMAS
  12345 NEP2 NQRG CONA MAS EXCP      4 NODATA API <userid> LMAS
  .
  The expanded trace entries which format the MAL show the call
  to method NEP2 was for function EXTRACT. This may occur for
  various keyword queries against the CPSM SYSPARM table, which
  contains CPSM SIT parameters for the MASes in the CICSPlex.
  This query can come from the WUI, the CICS Explorer, or a
  user-written CPSM API program.
  .
  The exception trace entries do not indicate an error, and
  should not be written. If too many of these are written, it
  could negatively impact diagnostic data collection by filling
  up the trace table and AUX trace datasets.
  .
  .
  Additional Symptom(s) Search Keyword(s): KIXREVGJT
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V5R1M0, V5R2M0, V5R3M0 and   *
  *                 V5R4M0 Users                                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: When using the WUI, CICS explorer or    *
  *                      a CPSM API program to inquire the       *
  *                      CPSM SYSPARM table, there are lots      *
  *                      of exception traces on the CMAS and     *
  *                      MAS internal, and AUX trace data        *
  *                      sets.  The exception traces indicate    *
  *                      that a SIT parameter cannot be found    *
  *                      and NODATA is returned.                 *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes and MASes must be           *
  *                 restarted.  Note that the restarts do not    *
  *                 need to occur at the same time.              *
  ****************************************************************
  CPSM maintains a list of SIT parameters. When using CPSM
  function to query the SYSPARM table, the parameters in this list
  are used. However, some parameters are removed in the new
  version, and the CPSM parameter list should be updated
  accordingly, otherwise CICS will return exception and NODATA
  returned.
  
  The exception trace will be similar to either of the following:
  TASK  MTD  PREV TRAN OBJ LEVL PT-ID   DEBUG UOW CMAS/USR ENVR
  12345 NEP1 NQRG CONA MAS EXCP      4 NODATA API <userid> LMAS
  12345 NEP2 NQRG CONA MAS EXCP      4 NODATA API <userid> LMAS
  
  
  All affected SIT parameters are listed below, and some of them
  may not be applicable for certain releases:
    - EUDSASZE
    - JVMCCSIZE
    - JVMCCSTART
    - MAXOPENTCBS
    - MAXXPTCBS
    - HTTPSERVERHDR
    - HTTPUSRAGENTHDR
    - MINTLSLEVEL
    - NQRNL
    - SOTUNING
    - NISTSP800131A
  

Problem conclusion

• CPSM has been modified to update its copy of the SIT parameter
  list.
  

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:

  UI57185 UI57186 UI57190 UI57191 UI57192 UI57193 UI57194 UI57195

Modules/Macros

• CJCTNAGC CJDTNAGD CJETNAGE CJFTNAGF CJGTNAGG DFHPAGP  DFHPAIN
  DFHPAINT EYUTNAGE EYUTNAGF EYUTNAGG EYUTNAGH
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R000 PSY UI57192

     UP18/07/13 P F807

• R00M PSY UI57193

     UP18/07/13 P F807

• R100 PSY UI57194

     UP18/08/02 P F807

• R10M PSY UI57195

     UP18/07/13 P F807

• R800 PSY UI57185

     UP18/07/17 P F807

• R80M PSY UI57186

     UP18/07/17 P F807

• R900 PSY UI57190

     UP18/07/17 P F807

• R90M PSY UI57191

     UP18/07/17 P F807

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.