Note:
A familiarity with the functional design of the UEDIT utility program
is necessary for a full understanding of this section.
UXEEX4 is a user-written routine that allows you to enforce installation standards for the LIBRARIAN "-SEL" and "-ADD" statements and the PANVALET "++ADD" and "++UPDATE" statements. When the UEDIT SAVE operation is executed, control is passed to UXEEX4 for each of these statements existing in a member. This routine can be included:
As an operating system or Com-plete-resident program;
On a library in the COMPLIB chain.
If it is present as a resident program, UXEEX4 must be reentrant. An example of this exit is provided on the distributed source library COM.SOURCE.
This document covers the following topics:
Upon entry to UXEEX4, a set of parameters is received in the form of fullword addresses pointed to by register 1. Word 1 contains the address of a halfword return code area where the status of the request is placed. Word 2 contains the address of the UEPDCOM data area. Word 3 contains the address of an 80-byte "++ADD", "++UPDATE", "-ADD", or "-SEL" statement that can be examined and modified. Word 4 contains the address of the Edit Control Block (CMEDCB) data area. Word 5 contains the address of a storage area containing GETCHR information.
Upon return from UXEEX4, the return code halfword is examined and processed as follows:
| 0 | The SAVE operation continues. |
| 4 | The SAVE operation is aborted, and an error message is output on the UEDIT menu display. |
The following table summarizes the UXEEX4 linkage conventions.
| Feature | Convention | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Attributes | Reentrant if in a resident area. | ||||||||||
| Type | Thread. | ||||||||||
| Size | Restricted to the UEBP thread region. | ||||||||||
| Registers at Entry |
|
||||||||||
| Registers | All registers must remain unchanged. at Return | ||||||||||
| Parameters |
|
||||||||||
| Return Codes |
|
||||||||||
| Considerations |
|