UUTEX1 - UUTIL Security Exit

UUTEX1 is a user-written routine called by UUTIL before a function processor is called. The exit can be used to impose security restrictions on the use of certain UUTIL functions, over and above those already defined by Com-plete.

By default, certain functions of the UUTIL maintenance utility are only open to "Super Users". Control users can access "Super User" functions by either specifying the maintenance password when invoking UUTIL or, alternatively press PF10 on the UUTIL main menu. This prompts for the maintenance password and, when confirmed, will bring up an additional number of utilities usually restricted to the administrator.

This document covers the following topics:


How to Use UUTEX1

The first function of UUTEX1 (function code 0) allows the UUTEX1 user exit to override this password protection and allow a control user to automatically receive the full functionality when invoking UUTIL.

The second function of UUTEX1 (function code 4) allows the exit to control the use of the individual subfunctions of UUTIL shown on the right side of the UUT1 map.

UUTEX1 Conventions

Feature Convention
Registers at Return Registers 12 through 14 must be unchanged.
Parameters
Word 1 Address of a halfword function code:
0 Check if the maintenance password is required for control users to enter "super-user" status.
4 Check if UUTIL function should be allowed for the current user.
Word 2 Points to the two-character UUTIL function code.
Return Codes
For fct. 0 0 - Password required 4 - Password not required
For fct. 4 0 - Allow the request 4 - Disallow the request
Considerations
a Called by UUTIL.
b Linkage is dynamic, with COLOAD.