Exit programs

An exit program is a program to which control is passed from a calling program. When you specify an exit program, the servers pass the following two parameters to the exit program before running your request:

• A 1-byte return code value.
• A structure containing information about your request. This structure is different for each of the exit points.

These two parameters allow the exit program to determine whether your request is allowed. If the exit program sets the return code to X'F0', the server rejects the request. If the return code is set to anything else, the server allows the request.

The same program can be used for multiple exit points. The program can determine what function is being called by looking at the data in the second parameter structure.

Use the Work with Registration Information (WRKREGINF) command to add your exit programs to the database exit points.

The database server has five different exit points defined:

QIBM_QZDA_INIT

called at server initiation

QIBM_QZDA_NDB1

called for native database requests

QIBM_QZDA_SQL1

called for SQL requests

QIBM_QZDA_SQL2

called for SQL requests

QIBM_QZDA_ROI1

called for retrieving object information requests and SQL catalog functions

Note: This exit point is called less often than in V5R1 and earlier Client Access ODBC drivers. If you have an exit program that uses this exit point, verify that it still works as intended.