C++ Exception Objects

All exception objects provide the following information:

The Class name can contain a trailing 'I', which implies it is an internally-contained class for the well known class. For example, CclFlowI is contained by CclFlow. If an internal class is reported the method reported might be an internal method, not an external one.

The Origin Point is a unique value which defines the exact point within the class library where the exception was generated. These are mainly useful for service.

The more important items of information are the Exception Code, Exception Text and Abend Code (ECI only). The following is a Summary of these Exception Codes and Text and whether they are relevant to ECI or EPI or both.
Table 1. Exception codes
Enumeration Text Description ECI EPI
Ccl::noError no error No error occurred Yes Yes
Ccl::bufferOverflow buffer overflow Attempted to increase a CclBuf object which isn't Extensible Yes  
Ccl::multipleInstance multiple instance Attempted to create more than one ECI object Yes  
Ccl::activeFlow flow is active Current Flow is still active, you cannot use this flow until it is inactive Yes  
Ccl::activeUOW UOW is active Current UOW is still active, you need to backout or commit. Yes  
Ccl::syncType sync error Incorrect synchronization type for method call. Yes Yes
Ccl::threadCreate thread create error Internal thread creation error Yes Yes
Ccl::threadWait thread wait error Internal thread wait error Yes  
Ccl::threadKill thread kill error Internal thread kill error Yes  
Ccl::dataLength data length invalid CommArea > 32768 Bytes or inbound 3270 data stream too large for Terminal Buffer size. Yes Yes
Ccl::noCICS no CICS® The Gateway is unavailable, or the server implementation is unavailable, or a logical unit of work was to be begun, but the CICS server specified is not available. No resources have been updated Yes Yes
Ccl::CICSDied CICS died A logical unit of work was to be begun or continued, but the CICS server was no longer available. If this is a link call with an active UOW, the changes are backed out. If this was a UOW Commit or Backout, the application cannot determine whether the changes have been committed or backed out, and must log this condition to aid future manual recovery. Yes  
Ccl::noReply no reply There was no outstanding reply Yes  
Ccl::transaction transaction abend ECI Program Abended Yes  
Ccl::systemError system error Unknown internal error occurred Yes Yes
Ccl::resource resource shortage The server implementation or the Gateway did not have enough resources to complete the request e.g. insufficient SNA sessions. Yes Yes
Ccl::maxUOWs exceeded max UOWs A new logical unit of work was being created, but the application already has as many outstanding logical units of work as the configuration will support. Yes  
Ccl::unknownServer unknown server The requested server could not be located Yes Yes
Ccl::security security error You did not supply a valid combination of user ID and password, though the server expects it. Yes Yes
Ccl::maxServers exceeded max servers You attempted to start requests to more servers than your configuration allows. Consult the documentation for your Gateway or server to see how to control the number of servers you can use. Yes Yes
Ccl::maxRequests exceeded max requests There were not enough communication resources to satisfy the request. Consult the documentation for your Gateway or server to see how to control communication resources Yes Yes
Ccl::rolledBack rolled back An attempt was made to commit a logical unit of work, but the server was unable to commit the changes, and backed them out instead Yes  
Ccl::parameter parameter error Incorrect parameter supplied Yes Yes
Ccl::invalidState invalid object state The Object is not in the correct state to start the method, e.g. terminal object still in server state and an attempt to send data is made. Yes Yes
Ccl::transId invalid transaction Null transid supplied or returned for a pseudo conversational transaction   Yes
Ccl::initEPI EPI not initialized EPI has failed to initialize correctly or EPI object is missing   Yes
Ccl::connect connection failed Unexpected error trying to add the terminal   Yes
Ccl::data stream 3270 data stream error Unsupported Data Stream   Yes
Ccl::invalidMap map/screen mismatch Map definition and Screen do not match   Yes
Ccl::cclClass CICS class error Unknown internal Class error occurred. Yes Yes
Ccl::startTranFailure Start Transaction Failure Transaction failed to start   Yes
Ccl::timeout Timeout Occurred Timeout occurred before response from Server Yes Yes
Ccl::noPassword Password is Null The object's password is null. Yes Yes
Ccl::noUserid Userid is Null The object's user ID is null Yes Yes
Ccl::nullNewPassword A NULL new password was supplied The provided password is null Yes Yes
Ccl::pemNotSupported PEM is not supported on the server The CICS Server does not support the Password Expiry Management facilities. The method cannot be used Yes Yes
Ccl::pemNotActive PEM is not active on the server Password Expiry Management is not active Yes Yes
Ccl::passwordExpired Password has expired The password has expired. No information has been returned Yes Yes
Ccl::passwordInvalid Password is invalid The password is invalid. Yes Yes
Ccl::passwordRejected New password was rejected Change password failed because the password does not conform to standards defined Yes Yes
Ccl::useridInvalid Userid unknown at server The user ID is unknown Yes Yes
Ccl:invalidTermid Termid is invalid The terminal ID is invalid   Yes
Ccl:invalidModelid Modelid is invalid Invalid Model/Device Type   Yes
Ccl:not3270 Not a 3270 device Not a 3270 device   Yes
Ccl:invalidCCSid Code page (CCSid value) is invalid Invalid CCSid   Yes
Ccl:serverBusy Server is too busy CICS server is busy   Yes
Ccl:signonNotPossible Sign-on Capable terminal is not possible The server does not allow the terminal to be installed as sign-on capable.   Yes

Information Information

Feedback


Timestamp icon Last updated: Tuesday, 19 November 2013


https://ut-ilnx-r4.hursley.ibm.com/tg_latest/help/topic/com.ibm.cics.tg.doc//proref/cclpapx00.html