Use this system macro to generate the linkage to a user exit routine from a
user exit point (UEP) in the control program (CP).
Format
- XP=name
- This is the name of the user exit, as many as 4 characters. It must
satisfy the requirements described in the DCTUCL DSECT. To add an exit
point, its name must be added to the exit point list array (UEP) and
corresponding entries must be added to the exit point status array (ATT) and
to the exit point description array (DESC).
- ISOC
- Specifies whether the user exit point is being called from an ISO-C
environment.
- YES
- TPF ISO-C register conventions must be set up by the user. In
particular R13 should be the address of the ISO-C stack.
- NO
- R9 is restored upon return from the exit. NO is the default.
- CHECK=name
- This is the name of the user exit, as many as 4 characters, to be checked
to determine if the user exit is active.
- ACTIVE=label1
- This is a label to branch to if the specified user exit is active.
- NOTACTIVE=label2
- This is a label to branch to if the specified user exit is not
active.
- WKREG=Rx
- This is a register that CHECK parameter processing uses as a work register
when one is required.
Entry Requirements
None.
Return Conditions
None.
Programming Considerations
- This macro is only used in the control program (CP) and ISO-C startup
routines at defined user exit points. If called from ISO-C startup
routines, register R9 must be saved before to the call.
- Note:
- CHECK parameter processing can be used by E-type programs to check the
status of a user exit.
- I-stream considerations do not apply to the UXITC macro.
Examples
The following describes how to check the status of a user exit and call
it.
UXITC CHECK=SVC,NOTACTIVE=SKIPEXIT
UXITC XP=SVC
SKIPEXIT DS 0H