Retrieve COBOL Error Handler (QLRRTVCE) API


  Required Parameter Group:

1 Current or pending error-handling exit program name Output Char(20)
2 Scope of error-handling exit program Input Char(1)
3 Error code I/O Char(*)

  Default Public Authority: *USE

  Threadsafe: No

The Retrieve COBOL Error Handler (QLRRTVCE) API allows you to retrieve the name of the current or pending COBOL error-handling program. You can call it from any programming language; however, this API only retrieves the name of the error handling program that is called when an error occurs in a COBOL/400® program.


Authorities and Locks

None.


Required Parameter Group

Current or pending error-handling exit program name
OUTPUT; CHAR(20)

The qualified name of the error-handling program for the current or pending COBOL run unit.

The 20 characters of this parameter are:

1-10 The name of the program object.
Valid values are:

*NONE No user-defined COBOL error handler has been set.
program-name The name of the error-handling program.
11-20 The library where the program object existed.
The valid value is:

library-name The library where the program object existed.

Scope of error-handling exit program
INPUT; CHAR(1)

The program can apply to a current or pending run unit.

Valid values are:

C Current COBOL run unit
P Pending COBOL run unit

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.
LBE7040 E Format of error code parameter is not correct.
LBE7051 E Scope parameter not valid.
LBE7052 E Run unit specified for error handler does not exist.
LBE7055 E Severe error while addressing parameter list. The API did not complete.

API introduced: V3R6

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