17.10 - DBCHPEC - Call-Level Interface Version 2

Teradata® Call-Level Interface Version 2 Reference for Workstation-Attached Systems

Product
Call-Level Interface Version 2
Release Number
17.10
Release Date
October 2021
Content Type
Programming Reference
Publication ID
B035-2418-061K
Language
English (United States)

DBCHPEC sets the global CLI attention flag to indicate that the application has responded to a BREAK interrupt.

DBCHPEC also wakes the process from a wait state (for example, if it is in DBCHWAT or a waiting DBCHCL function).

Using a control-C break/abort and if a break handler is posted (for example, through a signal C call), the application should not post the abort call within the signal handler routine; if DBCHCL is called from the signal handler, erroneous results could occur. To properly handle the break/abort, the application should wait for any pending DBCHCL operation to complete by returning the EM_BREAK return code and then post the Abort function.

Parameters

DBCHPEC (ReturnCode, UserECB)

where the following is true:

The parameter... Is the...
ReturnCode four-byte address of an area allocated by the application program for storage of a four-byte signed integer.
UserECB four-byte address of the area allocated by the application program for use as UserECB.

Usage Notes

After control returns from DBCHPEC, the integer contains a code whose value represents success or failure. A return code of zero indicates success; a non-zero return code indicates failure, and the value specifies the reason for the failure.