Oracle Audio Technologies Oracle Tuxedo - Manual (Page 95)

C l i e n t A p p l i c a t i o n C o n s i d e r a t i o n s
Oracle Tuxedo Mainframe Adapter for TCP - CICS User Guide 5-7
EXEC CICS LINK PROGRAM("PREREQ")
COMMAREA(&carea)
LENGTH(lmsg) RESP(resp) RESP2(resp2);
if(carea.CltHdr.ReturnCd || carea.CltHdr.ReqReturnCd)
process error;
else
successful call, returned data is in Request_data;
Note: C Programmers, do not include the NULL terminator on any strings. In the previous
example, the
memxxx calls were used instead of the strxxx calls. This example is typical
when using C and CICS together. For more information see your C for CICS
documentation.
Error Handling
You may encounter the following three types of errors while using TMA TCP for CICS:
z Gateway errors (communications problems)
z MVS or CICS errors
z Application errors
The following subsections explain how TMA TCP handles these different kinds of errors.
Gateway Errors
When local or remote gateway errors occur they are logged in the Oracle Tuxedo ULOG file on the
remote Oracle Tuxedo node and in the BEALOG file (a TD Queue defined during installation)
within the CICS region. All associated service requests fail and if the TMA gateways are able to
communicate with each other, error messages are communicated between them.
MVS or CICS Errors
For requests originating in the Oracle Tuxedo domain, if the remote target system does not make
it possible for TMA TCP for CICS to detect particular types of failure, the TMA TCP gateway
(the Oracle Tuxedo domain) blocking time-out parameter can be tuned to provide timely