gtpi1m14System Installation Support Reference

Dynamic Load Module External Function Call

User exit routine UCCEFCX is called by the dynamic load module (DLM) startup code before calling the entry point function (if the exit point named EFCX is active). User exit EFCX is called from an ISO-C environment. This exit point is in the CLMINT segment of the CIS0 library.

Multifunction user exit linkage is assembled into this exit point. This user exit is activated by the ZDBUG command (with the START parameter specified), which calls the UXITC macro with the IUX_VADB function set on.

General Conditions at Entry

The registers at entry are:

R8
Program base of the called program

R9
Address of the ECB.

R11-R15
See User Exit Routines - Common Entry Conditions.

System Conditions at Entry

System state
Problem (see Programming Considerations at Entry, item 1)

System mask
Unmasked (see Programming Considerations at Entry, item 1)

Protect key
Working storage or zero (0)

Address Space
EVM.

Programming Considerations at Entry

  1. Usually, the system state and system mask are as stated. However, there can be exceptions if system programs issued a MONTC macro to get to supervisor state and changed the system mask.
  2. You activate the TPF Assembler Debugger for VisualAge Client or TPF C Debugger for VisualAge Client code from this user exit by calling the UXMAC macro. Program load event detection code (the IUX_VADB UXMAC call) must be the last exit routine to be called in the exit. The debugger will not return to this user exit when it determines that the debugger must receive control. If you do not want the debugger to trace the program that will be entered, set the CE3_NO_DEBUG indicator in byte CE3DBCR (page 3 of the ECB) before the debugger is called. The debugger always sets this indicator off before activating the program.
  3. See User Exit Routines - Common Programming Considerations for other considerations.

Programming Considerations on Return

See User Exit Routines - Common Return Conditions.

General Conditions on Return

See User Exit Routines - Common Return Conditions.