UXEEX4 - UEDIT LIBRARIAN/PANVALET Exit

#### Search Results

Search

# UXEEX4 - UEDIT LIBRARIAN/PANVALET Exit

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:

- How to Use UXEEX4

- UXEEX4 Conventions

## How to Use UXEEX4

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.

## UXEEX4 Conventions

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 |
Register 1 | Address of the parameter list
Register 13 | Address of an 18-fullword save area
Register 14 | Return address in the calling module
Register 15 | Entry address within UXEEX4
Registers | All registers must remain unchanged. at Return
Parameters |
Word 1 | Address of a return code halfword
Word 2 | Address of the UEPDCOM data area
Word 3 | Address of the 80-byte "++ADD", "++UPDATE", "-SEL", or "-ADD" control statement
Word 4 | Address of the EDCB data area
Word 5 | Address of the UEDTMGET data area (GETCHR information)
Return Codes |
0 | Execute the SAVE command.
4 | Abort the SAVE command.
Considerations |
a | Is given control for each SAVE command issued when saving to a LIBRARIAN or PANVALET library.
b | Will be loaded dynamically.

### On this page

- How to Use UXEEX4
- UXEEX4 Conventions