search cancel

CA Gen 8.6 ECI v2 Middleware troubleshooting

book

Article ID: 188849

calendar_today

Updated On:

Products

Gen

Issue/Introduction

With the new support in CA Gen 8.6 of ECI v2 for C clients (GUI, COM Proxy, and C Proxy), this article was written to cover troubleshooting advice and common errors for using ECI with Gen.
It can be used when implementing Gen C clients connected to Gen CICS servers via ECI v1 or V2.

Environment

CA Gen 8.6 C clients (GUI, COM Proxy, and C Proxy)
ECI v1 or V2

Resolution

1. Where to look when problems arise:

Communications configuration:
  • Values set in commcfg.ini  (if creating a Gen Support case is ultimately required they can advise on setting debug options in this file)
  • Security type used (Enhanced, Standard, None)
  • Values before/after user exit
  • What type of ECI flow (v1, v2 COMMAREA, v2 CONTAINER)
CICS Log:
  • Security errors
  • Communication errors
  • CICS Command errors (Get/Put Container)
Windows Event Viewer:
  • CTG errors
  • Application errors
CTG Online Documentation
https://www.ibm.com/support/knowledgecenter/SSZHFX_9.2.0/welcome.html


2. Common Errors and possible root causes:

ECI_ERR_SYSTEM_ERROR
  • CTG not started – ECI v1
CTG_ERR_CONNECTFAILED
  • CTG not started – ECI v2
  • PortNumber not correct
ECI_ERR_NO_CICS
  • CICS not running
ECI_ERR_UNKNOWN_SERVER
  • ECI System Name not known to CTG
  • Attempt to send ECI v1 flow on IPIC network protocol
ECI_ERR_INVALID_CALL_TYPE
  • ECI System Name not known to CTG – Container
  • Attempt to send Container on non-IPIC network protocol
CTG_ERR_BADHOST
  • HostName not correct

Additional Information

See related KB article: CA Gen 8.6 ECI v2 Support
Related documentation:
CA GEN 8.6 > Release Notes > New Features > ECI V2 Support for CA Gen C Clients
CA GEN 8.6 > Glossary of Gen Terms > Distributed Processing Terminology > ECI Terminology
CA GEN 8.6 > Distributed Processing > Working With Distributed Processing > Overriding Communications Support at Execution Time 
NOTE commcfg.ini syntax for ECI v1 versus v2
v1: <TRANCODE> ECI {ECI System Name}
v2: <TRANCODE> ECI <StorageType> {HostName} {PortNumber} {ECI System Name}