gtpg2m5cGeneral Macros

UXCMC-User Exit Control

This general macro is used to dynamically activate or deactivate one or more of the dynamic user exit points in the control program. The UXCMC macro is also used to activate or deactivate one or more functions that reside in dynamic or nondynamic user exits. Optionally, when you use this macro, you can specify an address (override address) of a user exit routine that will receive control from the specified exit point.

Format




label
A symbolic name can be assigned to the macro statement.

WKREG=Rx
WKREG identifies a register to be used when UXCMC is called from the CP. The WKREG parameter should not be used by E-type programs. It is required when called from the CP. The WKREG must be R0, R2-R7. The original contents of the specified register are not saved.

Entry Requirements

Return Conditions


Contents of R15 Contents of R14 Meaning
0 0 Normal Return. The specified exit points have been activated or deactivated.
4 0 Incorrect action specified.
8 0 Too many exit points specified in the parameter list. The number exceeds the maximum defined in the DCTUCL DSECT (UCLCNT).
12 address of incorrect entry Incorrect index specified in the parameter list. The index is out of range.
16 address of incorrect entry An exit point index was specified in the parameter list for a nondynamic exit point and multiple function support is not being used.
20 address of duplicate entry A duplicate index value was specified in the parameter list.
24 address of incorrect entry An override address and activate action code were specified but the exit point was already active or multiple overrides were specified on ISO-C library exits.
28 address of incorrect entry The parameter list specifies an exit point for activation that has no user exit routine supplied for it. The routine must be coded and assembled in CP CSECT CCUEXT.
32 The address of the incorrect entry The parameter list specifies either CLE or CLX as exit points but the library ordinal number coded is greater than the maximum (1024).

Programming Considerations

Examples