Retrieve COBOL Error Handler (QlnRtvCobolErrorHandler) API

Required Parameter Group:

1	Current error-handling exit procedure pointer	Output	Anyptr
2	Error code	I/O	Char(*)

  Default Public Authority: *USE

  Service Program: QLNRMAIN

  Threadsafe: No

The Retrieve COBOL Error Handler (QlnRtvCobolErrorHandler) API allows you to retrieve the procedure pointer of the current COBOL error-handling procedure. You can call it from any ILE programming language; however, this API only retrieves the procedure pointer of the error handling program that is called when an error occurs in an ILE COBOL program.

Authorities and Locks

None.

Required Parameter Group

Current error-handling exit procedure pointer

OUTPUT; ANYPTR

Valid values are:

NULL	No current error-handling procedure found.
procedure-pointer	The procedure pointer of the error handler.

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

Message ID	Error Message Text
CPF3C90 E	Literal value cannot be changed.
LNR7074 E	Error code not valid.
LNR7075 E	Error addressing API parameters.

API introduced: V2R1.1

[ Back to top | High-level language APIs | APIs by category ]