PH06718: JAVA.LANG.ILLEGALSTATEEXCEPTION USING CMCI GRAPHQL API TO RETRIEVE RESOURCES WITH NO RESOURCE SIGNATURE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The CMCI GraphQL API is queried or used to aggregate resources.
  
  When one or more of the resources found was last modified
  before the introduction of resource signatures, the following
  exception occurs:
  
  java.lang.IllegalStateException: Attribute
  com.ibm.cics.drake.model.internal.CICSAttribute
  [propertyId=changeAgent, categoryId=resourcesignature,
  cicsName=CHANGEAGENT] has no value specified
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: java.lang.IllegalStateException when    *
  *                      using CICS Explorer or the CMCI         *
  *                      GraphQL API to aggregate results.       *
  ****************************************************************
  * RECOMMENDATION: CICSPlexSM V5R5M0 WUI server regions should  *
  *                 be restarted after applying this PTF.        *
  ****************************************************************
  CICS Explorer or the CMCI GraphQL API is used to aggregate a
  results set that contains resources last modified prior to the
  introduction of resource signatures.  This causes a
  java.lang.IllegalStateException.
  
  A further problem has been identified where N/A values in a
  numeric field are aggregated as if they are -1 values, thereby
  distorting max/min/average aggregation functions.
  
  There are also some attribute values for Local File which
  cannot be displayed correctly.
  

Problem conclusion

• The CMCI GraphQL API has been updated to return valid values
  when a CSD resource has no resource signature.  This allows the
  aggregation logic to process the resources successfully.
  
  Additionally some missing attribute values are added to Local
  File, particularly to support BDAM files.
  

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:

  UI61194

Modules/Macros

• DFJ@H531 DFJ@H532 DFJ@H533
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R200 PSY UI61194

     UP19/02/09 P F902

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.