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.
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.|
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.