acu_abend()

The acu_abend() function allows you to perform the ACUCOBOL-GT signal handling logic in selected programs when the runtime is initialized with the "--no-signal-handlers" option. If you run with "--no-signal-handlers", error conditions that raise signals are not detected automatically by the runtime. acu_abend() causes the runtime to output error messages and resets the state of the runtime. This function is designed for use in transaction processing environments that call the ACUCOBOL-GT runtime from a C main program.

Refer to the ACUCOBOL-GT User's Guide for more information on "--no-signal-handlers".

Usage

C programs that specify the "--no-signal-handlers" option in the call to acu_initv() may call the acu_abend() function from their own signal-handling code as follows:

void
 acu_abend( int signal_number )

where signal_number is the signal number or "-1" if no signal information is available.

Although you can call acu_abend() at any time, we recommend that you call it only if the application was executing COBOL code when the signal occurred; otherwise, the error messages reported by the runtime may be misleading. For example, you do not need to call acu_abend() if:

1. Your application calls acu_cobol() to execute a COBOL program.
2. The COBOL program exists.
3. After acu_cobol() returns, your application executes other non-COBOL processing.