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.