UXEEX5 - Locate Exit

UXEEX5 is a user-written routine that enables users to allow an automatic recall of a library that has been migrated by Hierarchical Storage Manager. When UEDIT or UPDS issue a LOCATE macro, control is passed to UXEEX5, which can then interrogate the volser returned from the catalog and issue the recall SVC if required. An example of this exit is provided on the distribution source library.

This document covers the following topics:


How to Use UXEEX5

Upon entry, a set of parameters is received in the form of fullword addresses pointed to by register 1. Words 1 and 3 are unused. Word 2 contains the address of the data set name (DSN) and word 4 contains the address of the volser returned by the LOCATE macro.

UXEEX5 Conventions

The following table summarizes the UXEEX5 conventions.

Feature Convention
Attributes Reentrant if in a resident area.
Type Thread.
Size Restricted to the region area.
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 UXEEX5
Registers at Return All registers must remain unchanged.
Parameters
Word 1 Unused
Word 2 Address of the DSN
Word 3 Unused
Word 4 Address of a data area. Volser is at +6 in this data area.