ULINUSER - Com-plete Initialization Exit

ULINUSER is a user-written routine that is loaded during Com-plete initialization and termination processing.

This document covers the following topics:


How to Use ULINUSER

The ULINUSER routine can execute any SVC except the Com-plete SVC or the MCALL SVC. The routine is given the address of Com-plete's communications region in register 2, and the address of an 18-word register-save area in register 13. Note that registers must be saved and restored. It gets control in supervisor state, Com-plete's protect key and runs in the main task.

ULINUSER Conventions

The following table summarizes the ULINUSER linkage conventions.

Feature Convention
Attributes Need not be reentrant or reusable. Must run AMODE 31 until the parms are read and return to the nucleus in AMODE 31.
Type Nucleus.
Size No size limitation.
Registers at Entry
Register 1 at initialization call: points to a 4-byte constant 'INIT' at termination call: points to a 4-byte constant 'TERM'
Register 2 Points to Com-plete's communications region (see the COMREG member in the distributed source library).
Register 13 Points to an 18-word save area.
Registers at Return All registers must be saved and restored.
Parameters None.
Return Codes None.
Considerations Executes in supervisor state, key of Com-plete.