Administrative API Reference

sqleisig - Install Signal Handler

Installs the default interrupt (usually Control-C and/or Control-Break) signal handler. When this default handler detects an interrupt signal, it resets the signal and calls sqleintr - Interrupt.

Authorization

None

Required Connection

None

Version

sqlenv.h

C API Syntax

/* File: sqlenv.h */ /* API: Install Signal Handler */ /* ... */ SQL_API_RC SQL_API_FN sqleisig ( struct sqlca * pSqlca); /* ... */

Generic API Syntax

/* File: sqlenv.h */ /* API: Install Signal Handler */ /* ... */ SQL_API_RC SQL_API_FN sqlgisig ( struct sqlca * pSqlca); /* ... */

API Parameters

pSqlca

Output. A pointer to the sqlca structure. For more information about this structure, see SQLCA.

REXX API Syntax

INSTALL SIGNAL HANDLER

Sample Programs

C

\sqllib\samples\c\dbcmt.c

COBOL

\sqllib\samples\cobol\ish.cbl

REXX

\sqllib\samples\rexx\dbcmt.cmd

Usage Notes

If an application has no signal handler, and an interrupt is received, the application is terminated. This API provides simple signal handling, and can be used if an application does not have extensive interrupt handling requirements.

The API must be called for the interrupt signal handler to function properly.

If an application requires a more elaborate interrupt handling scheme, a signal handling routine that can also call sqleintr - Interrupt can be developed. Use either the operating system call or the language-specific library signal function. sqleintr - Interrupt should be the only database manager operation performed by a customized signal handler. Follow all operating system programming techniques and practices to ensure that the previously installed signal handlers work properly.

See Also

sqleintr - Interrupt.