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
16.20
Published
September 2019
Language
English (United States)
Last Update
2019-10-12
dita:mapPath
uny1527114222311.ditamap
dita:ditavalPath
Audience_PDF_include.ditaval
dita:id
B035-2418
lifecycle
previous
Product Category
Teradata Tools and Utilities

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.