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


Processing of ADEXIT

Use of the ADEXIT module requires the compiler option ADATA to produce SYSADATA output, and the DD statement SYSADATA.

Table 1. ADEXIT processing
Action by compiler Resulting action by exit module
Loads the exit module (mod4) 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 the compiler has written a SYSADATA record, supplying the address and length of the SYSADATA record Passes the status of the PUT request to the compiler by a return code
Calls the exit module with a CLOSE op code when the end-of-data is presented Releases any resources

ADEXIT 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. ADEXIT parameters
Offset Contains address of Description of item
00 User-exit type Halfword identifying which user exit is to perform the operation.

4=ADEXIT

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
20 Data buffer or str4 Fullword containing the address of the data buffer where the compiler has placed the record to be printed by the PUT operation.

str4 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)