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

Usage Notes
DISAble
tells CP not to call the entry points and external symbols associated with this
exit point until you enable it. (For more information about enabling exit points,
see Usage Note 4.) If omitted, DISABLE is the default.
ENable
tells CP to immediately start calling the entry points and external symbols
associated with this exit point.
EPName name
is the name (or names) of the entry point or external symbol that CP calls when
encountering this exit point number. Each name must be a 1- to 8-character
string. The first character must be alphabetic or one of the following special
characters: dollar sign ($), number sign (#), underscore (_), or at sign (@). The
rest of the string can be alphanumeric characters, the 4 special characters ($,
#, _, and @), or any combination thereof.
Note: The order that you specify the entry points and external symbols is the
order in which CP will call them.
1. Before you use the ASSOCIATE EXIT command, you should issue the
CPXLOAD command or configuration file statement to load the
customer-written CP routines for the exit point into CP’s system execution
space. These CP routines should contain the entry point names and external
symbols that you will specify on the ASSOCIATE EXIT command.
If you do not issue the CPXLOAD command or statement first or you issue the
ASSOCIATE EXIT command with an unknown entry point or external symbol,
CP just ignores any entry point name or external symbol that it does not
recognize and continues normal processing. If the unknown entry point or
external symbol is part of a list associated with an exit point, CP continues
processing the other members of the list. CP does not ignore an exit point
because it cannot find one entry point or external symbol in the list. CP only
ignores an exit point if it cannot find all the entry points and external symbols
in the list.
For more information about the CPXLOAD command, see page 101.
For more information about the CPXLOAD statement, see the z/VM: CP
Planning and Administration book.
2. To display whether there are any unknown entry points or external symbols
associated with an exit point, use the QUERY UNRESOLVED command (page
1062).
3. If you issue the ASSOCIATE EXIT command and do not specify the ENABLE
operand, CP will redefine the exit point with the information from your
ASSOCIATE EXIT command, but will not call any of the entry points or
external symbols associated with that exit point until you later enable it.
4. There are 2 ways to enable an exit point:
ASSOCIATE EXIT
v Enter another ASSOCIATE EXIT command and specify the ENABLE
operand, or
v Use the ENABLE EXITS command (page 431).
By default, exit points are disabled. Thus, in general, you should follow any
ASSOCIATE EXIT commands or statements with ENABLE EXITS commands
or statements.
5. CP calls the entry points and external symbols for an exit point in the order
that you specify them on the ASSOCIATE EXIT command, unless an entry
Chapter 2. CP Commands 19