UDVSX0 - Usage Control of UDS/UDVS VSAM SERVICES

UDVSX0 is a user-written service routine that can be used to control and/or restrict the use of UDS/UDVS VSAM SERVICES.

When Com-plete is initially installed, no UDVSX0 module is available. This routine must be coded with the standard Com-plete exit requirements.

Note:
UDVSX0 is called for each VSAM SERVICES operation.

This document covers the following topics:

How to Use UDVSX0

At the time UDVSX0 is called, register 1 points to the IDCAMS control statement that will be executed. The control statement area has a contiguous length of 280 bytes. It will be presented to IDCAMS as 4 lines with 70 bytes each. A ZERO return code of 0 (zero) in register 15 will allow the operation. A non-zero return code in register 15 disallows the operation.

Note that the exit can modify the control statement area.

UDVSX0 Conventions

The following table summarizes the UDVSX0 linkage conventions.

Feature Convention
Attributes None required.
Type Online.
Size No restrictions.
Registers at Entry
Register 1 Points to the control statement area, contiguous, 4 lines at 70 bytes each
Register 13 Address of the 18-fullword z/OS-compatible save area
Register 14 Return address
Register 15 Entry point address
Registers at Return Registers must be unchanged except register 15, which contains the return code.
Return Codes
0 Allow operation
non-zero Disallow operation
Considerations Will be loaded by UDS/UDVS.