ULOPADAB - Adabas User Exit

ULOPADAB is a user-written routine called by Com-plete's Adabas interface routine, TLOPADAB, before processing an Adabas command from a Com-plete application program.

ULOPADAB, which allows the installation to examine and/or modify the contents of the Adabas parameters, is entered once for each Adabas command issued by a Com-plete program.

Note:
Com-plete user program functions are not available to ULOPADAB.

This document covers the following topics:


How to Use ULOPADAB

Upon entry to ULOPADAB, the Adabas parameter list is provided. Each parameter is documented in the Adabas Operations documentation.

The data provided by the parameter list can be examined and/or altered, as required, by ULOPADAB.

ULOPADAB Conventions

The following table summarizes the ULOPADAB linkage conventions.

Feature Convention
Attributes Reentrant.
Type Nucleus.
Size No restriction.
Registers at Entry
Register 1 Zero
Register 2 Address of the Com-plete COMREG
Register 3 Address of the Com-plete UPCB for the caller
Register 4 Address of the Com-plete THCB for the caller
Rgeister 5 Adresss of the Com-plete TIB for the caller
Register 6 Address of the caller's Adabas parameter list
Register 13 Address of an 18-word save area
Register 14 Address of the return point in TLOPADAB
Register 15 Address of the ULOPADAB entry point
Registers at Return All registers must be returned unchanged.
Parameters Refer to the Adabas Operations documentation.
Return Codes None.
Considerations
a Executes in supervisor state, and key of the user (thread).
b Cannot issue the Com-plete user function (MCALL).
c Called in the protect key in which the user is running.
d Adabas control block (ACB) and user block (UB) will be in the key of the user.
e Other areas pointed to by the Adabas parameter list may be in the user’s key or Com-plete’s key, depending on their locations.