IJ13165: AGGREGATION FAILS WITH INTERNAL ERROR WHEN GROUPING ON AN ATTRIBUTE THAT CONTAINS A SPECIAL VALUE

IBM CICSEX-5.5.0-FP00001
IBM CICSEX-5.5.0-FP00002
IBM CICSEX-5.5.0-FP00003
IBM CICSEX-5.5.0-FP00004
IBM CICSEX-5.5.0-FP00005
IBM CICSEX-5.5.0-FP00006
IBM CICSEX-5.5.0-FP00007

APAR status

• Closed as program error.

Error description

• Using CICS Explorer to aggregate data on a view which contains
  older definitions or resources that do not have a change agent
  value set, you receive the error:
  `Grouping on <resource_type> fails, not a JSON Object : null`
  This error indicates that the CMCI JVM server decoded a resource
  or definition record that was missing a value for an attribute
  where a valid value was required.
  

Local fix

Problem summary

• Before server side APAR PH06718, the server returned -1 to
  represent an N/A value which distorted the max/min/average
  aggregation functions. After installing the PTF for PH06718 the
  server returns a special value that is not a valid number.
  When aggregating on a column that contains a special value (e.g.
  when a remote program is installed, the use count is a special
  value and not a number) CICS Explorer shows message:
  An internal error occurred during: "Get Group: <RESOURCE_TYPE>".
  With a stack trace like this:
  java.lang.IllegalArgumentException: Can't filter on a range,
  special values, or not supported values
  at
  com.ibm.cics.core.model.AggregatedResourcesModel.createFilteredC
  ontext(AggregatedResourcesModel.java:54)
  at
  com.ibm.cics.core.model.AggregatedResourcesModel.<init>(Aggregat
  edResourcesModel.java:27)
  at com.ibm.cics.core.model.CPSM.getAggregation(CPSM.java:231)
  at
  com.ibm.cics.core.model.ResourcesModel.group(ResourcesModel.java
  :451)
  at
  com.ibm.cics.explorer.tables.ui.ResourcesViewJobs&#162;GetGroupJob.do
  Run(ResourcesViewJobs.java:151)
  at
  com.ibm.cics.explorer.tables.ui.ResourcesViewJobs&#162;ResourcesModel
  Job.run(ResourcesViewJobs.java:54)
  at org.eclipse.core.internal.jobs.Worker.run(Worker.java:60)
  The special value is not a valid value for that attribute and so
  an IllegalArgumentException is thrown whilst creating the
  filter.
  

Problem conclusion

• CICS Explorer is changed so that, when aggregating on a column
  that contains a special value the IllegalArgumentException is
  caught whilst creating the filter and the row is made not
  expandable.
  .
  The fix also similarly catches IllegalCICSAttributeException.
  This covers both the situation where we receive a non-valid CICS
  attribute value, and also a value that is a legal CICS attribute
  value, but doesn't fall within the type that we were expecting
  (so is an illegal argument).
  .
  This fix will be made available in Version 5.5.0.1 of the CICS
  Explorer.
  .
  For installation instructions please see:
  Ordering maintenance for IBM CICS Explorer and CICS Explorer
  plug-ins
  http://www.ibm.com/support/docview.wss?uid=swg21380083
  

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:

Modules/Macros

• EXPLORER
  

Fix information

• Fixed component name

  CICS EXPLORER V

• Fixed component ID

  5655Y0401

Applicable component levels

• R550 PSY

     UP