UUMAX1 - UMAP Initialization Exit

UUMAX1 is a user-written routine called by the UMAP utility program before the user receives the UMAP menu. This module allows the user to modify global defaults to UMAP and restrict UMAP execution by user ID.

This document covers the following topics:

How to Use UUMAX1

Upon entry to UUMAX1, a set of parameters is received in the form of fullword addresses in register 1.

UUMAX1 can issue any Com-plete function in the process of determining the security restrictions to be imposed upon a terminal user. Sample functions include:

  • COLOAD Load a table containing security information;

  • COLINK Invoke another user-written module;

  • GETCHR Obtain information about the terminal user;

  • WRTC Request additional information;

  • READ Obtain the requested additional information.

UUMAX1 Conventions

The following table summarizes the linkage conventions of UUMAX1.

Feature Convention
Attributes None required.
Type Thread.
Size Restricted to the UMAP 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 of UUMAX1
Registers at Return Registers 2 through 13 remain unchanged. Register 15 contains the return code.
Parameters
Word 1 Address of the eight-byte user ID.
Word 2 Address of the two-byte TID.
Word 3 Address of the 44-byte designated map library file name.
Word 4 Address of the six-byte volume serial number.
Word 5 Address of the eight-byte user exit communications area. This area is passed to all user exits and is neither modified nor checked by UMAP.
Word 6 Address of a two-byte area containing the default constant and variable field indicators.
Return Codes
0 Allow the request.
4 Disallow the request.
Considerations Will be loaded dynamically.