Add Bindtime Exit (QbnAddBindtimeExit) API

The Add Bindtime Exit (QbnAddBindtimeExit) API may be used by a compiler preprocessor to define an exit program that is called when the created module is bound into a ILE program.

Authorities and Locks

None

Required Parameter Group

Qualified exit program name

INPUT; CHAR(20)

The qualified name of the exit program to be called when the created module is bound into an ILE program. The first 10 characters contain the program name, which is left-justified and padded with blanks. The second 10 characters contain the name of the library where the exit program is located and is left-justified and padded with blanks.

The library name can be specified with the following special value:

*LIBL

The library list.

The exit program is passed five parameters when called. The first two parameters are the exit program data and the exit program data length. The third parameter is a reserved CHAR(10). The fourth and fifth parameters are both reserved BINARY(4).

The exit program data being used in this API is defined by the user.

Exit program data

INPUT; CHAR(*)

This data is copied into the output source file member by the QbnEndPreProcessor API. When the exit program is called at ILE program creation time, a copy of the data is passed. The format of this data is specified by the supplier of the exit program. This data is ignored if the length of data to be passed to the length of exit program data parameter value is 0.

Length of exit program data

INPUT; BINARY(4)

The length of the data contained in the exit program data parameter.

Error code

I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.

Error Messages

[ Back to top | Program and CL Command APIs | APIs by category ]