IV98406: CICS BUNDLE FAILS TO INSTALL WITH MESSAGE DFHEC3108

IBM CICSEX-5.4.0-FP0002
IBM CICSEX-5.4.0-FP0003
IBM CICSEX-5.4.0-FP0004
IBM CICSEX-5.4.0-FP0005
IBM CICSEX-5.4.0-FP0006
IBM CICSEX-5.4.0-FP0007
IBM CICSEX-5.4.0-FP0008
IBM CICSEX-5.4.0-FP0009
IBM CICSEX-5.4.0-FP00010
IBM CICSEX-5.4.0-FP00011
IBM CICSEX-5.4.0-FP00012
IBM CICSEX-5.4.0-FP00013
IBM CICSEX-5.4.0-FP00014
IBM CICSEX-5.4.0-FP00015
IBM CICSEX-5.4.0-FP00016
IBM CICSEX-5.4.0-FP00017

APAR status

• Closed as program error.

Error description

• A CICS bundle is created to capture events in CICS. Specifically
  the event is capturing INVOKE SERVICE calls.
  When the bundle is exported and then installed into CICS the
  bundle installs but remains in a disabled state becasue of the
  following error:
  
  DFHEC3108 dd/mm/yyyy hh:mm:ss cccccccc Invalid keyword ()
  specified in event capture specification xxxxxxxxxxx in event
  binding yyyyyyyy.
  

Local fix

• Manually edit the evibind file to change the generated XML as
  follows:
  
  Change the following two lines
     <URI keyword="CHANNEL" filterOperator="OFF" filterValue=""/>
     <CHANNEL keyword="URI" filterOperator="OFF" filterValue=""/>
  
  to
     <URI keyword="URI" filterOperator="OFF" filterValue=""/>
     <CHANNEL keyword="CHANNEL" filterOperator="OFF"
  filterValue=""/>
  

Problem summary

• A CICS bundle is created to capture events in CICS, specifically
  the event is capturing INVOKE SERVICE calls.  When the bundle is
  exported and then installed into CICS, the bundle installs but
  remains in a disabled state.  The generated XML in the .evbind
  file produced by CICS Explorer is incorrect:
     <URI keyword="CHANNEL" .../>
     <CHANNEL keyword="URI" .../>
  Note that the keywords for URI and CHANNEL are the wrong way
  around.
  They should say
     <URI keyword="URI" .../>
     <CHANNEL keyword="CHANNEL" .../>
  

Problem conclusion

• The XML for the .evbind event binding file has been corrected so
  that the URI and CHANNEL elements and keywords are generated
  correctly.  The exported bundle can now be enabled once it has
  been installed into CICS.
  This fix will be made available in Version 5.4.0.2 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