Rational Developer for System z
Enterprise COBOL for z/OS, Version 4.1, Programming Guide


Processing of PRTEXIT

The exit module is used in place of the SYSPRINT data set.

Table 1. PRTEXIT processing
Action by compiler Resulting action by exit module
Loads the exit module (mod3) during initialization  
Calls the exit module with an OPEN operation code (op code) Prepares its output destination for processing. Passes the status of the OPEN request to the compiler.
Calls the exit modules with a PUT op code when a line is to be printed, supplying the address and length of the record that is to be printed Passes the status of the PUT request to the compiler by a return code. The first byte of the record to be printed contains an ANSI printer control character.
Calls the exit module with a CLOSE op code when the end-of-data is presented Releases any resources that are related to its output destination

PRTEXIT parameters

The compiler uses a parameter list to communicate with the exit module. The parameter list consists of 10 fullwords that contain addresses, and register 1 contains the address of the parameter list. The return code, data length, and data buffer parameters are placed by the exit module for return to the compiler; and the other items are passed from the compiler to the exit module.

Table 2. PRTEXIT parameters
Offset Contains address of Description of item
00 User-exit type Halfword identifying which user exit is to perform the operation.

3=PRTEXIT

04 Operation code Halfword indicating the type of operation.

0=OPEN; 1=CLOSE; 3=PUT

08 Return code Fullword, placed by the exit module, indicating the success of the requested operation.

0=Operation was successful; 12=Operation failed

12 User-exit work area Four-fullword work area provided by the compiler, for use by the user-exit module
16 Data length Fullword specifying the length of the record being supplied by the PUT operation (the compiler sets this value to 133)
20 Data buffer or str3 Fullword containing the address of the data buffer where the compiler has placed the record to be printed by the PUT operation.

str3 applies only to OPEN. The first halfword (on a halfword boundary) contains the length of the string, followed by the string.

24 Not used (Used only by LIBEXIT)
28 Not used (Used only by LIBEXIT)
32 Not used (Used only by LIBEXIT)
36 Not used (Used only by LIBEXIT)

related references  
Processing of LIBEXIT


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)