z/VM: CP Commands and Utilities Reference - z/VM - IBM

ASSOCIATE EXIT
20 z/VM: CP Commands and Utilities Reference
point overrides this action. Any entry point can tell CP to change the normal
processing flow by skipping one or all subsequent entry points or external
symbols.
6. To display status and usage statistics information about a specific exit point,
use the QUERY EXITS command (page 791).
Note: While processing the ASSOCIATE EXIT command (or statement), CP
creates a CP exit block for the specified exit point. For a static exit
point, CP does not create CP exit control blocks until you associate one
or more entry points or external symbols with that exit point. If you try to
issue a QUERY EXITS command against such an exit point, CP issues
message HCP2752E as the response to your QUERY EXITS command.
For a dynamic exit point, QUERY EXITS responds with the definition of
the exit, even if there are no entry points associated with it.
7. To display the real address of the CP exit block for a specific exit point, use
the LOCATE XITBK command (page 565). Again, if you have not associated
one or more entry points or external symbols with the specified exit point, there
is no CP exit block for CP to locate and display. Instead, CP issues error
message HCP2752E.
8. To display the real address of the CP indirect call locator block for a specific
exit point, use the LOCATE ICLBK command (page 539).
9. To change the definition of an existing dynamic exit point, or to remove the exit
point from the system, use the MODIFY EXIT command (page 618).
10. To stop CP from calling the entry points and external symbols associated with
one or more exit points after defining those exit points, use the DISABLE
EXITS command (page 269).
11. To remove the customer-written CP routines from CP’s system execution
space:
a. Use the DISASSOCIATE command (page 274) to revoke all entry point and
external symbol assignments made with the ASSOCIATE EXIT command
or configuration file statement
b. Use the CPXUNLOAD command (page 107) to unload the customer-written
CP routines.
12. Using the ASSOCIATE EXITS command or configuration file statement, you
can add to the list of entry points and external symbols for an exit point, or you
can replace the list. For example, if you associate entry points ZZZA1 and
ZZZA2 with an exit point:
associate exit 1 epname zzza1 zzza2
Ready;
and then you associate additional entry points YYYB1 and YYYC2:
associate exit 1 preceding epname yyyb1 yyyc2
Ready;
the final list of entry points would be:
YYYB1 YYYC2 ZZZA1 ZZZA2
13. To remove one or more entry points or external symbols from the list
associated with an exit point, issue the ASSOCIATE EXIT command with the
REPLACE operand and specify only those entry points and external symbols
that you want CP to call.
14. If the exit point is disabled when you issue the ASSOCIATE EXIT command,
CP immediately updates the list of entry points and external symbols with your
changes. If the exit point is enabled, CP checks to see if the specified exit