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

DEFINE EXIT
►►
DEFine
Authorization
Purpose
Operands
EXit
exit
AT
entry + offset
Privilege Class: A
instruction
NORESolve
RESolve
Use DEFINE EXIT to dynamically define a new exit point in CP.
You can also dynamically define a new CP exit point during system initialization
using the DEFINE EXIT configuration file statement. For more information, see the
z/VM: CP Planning and Administration book.
exit
is the number of the exit point you are defining. This value must be a
hexadecimal number between X'0' and X'FFFF'. The recommended value is
between X'F000' and X'FFFF', because that range is reserved for customer use.
All other exit numbers are reserved for IBM, vendor, or general use.
AT entry + offset instruction
identifies the location of the exit point you are defining and the instruction that is
located at the exit point. The variable entry 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 alphabetic or numeric characters, the four special
characters ($, #, _, or @), or any combination. The variable offset must be a
1-to-4-character even hexadecimal number between X'0' and X'FFFE'. The
variable instruction must be a 2-, 4-, or 6-character hexadecimal number.
NORESolve
tells CP to resolve the entry points associated with this exit number the first
time they are called. This is the default.
RESolve
tells CP to resolve the entry points associated with this exit number when the
association is first established. Any existing associated entry points are resolved
immediately.
PARM
▼ parameter
PARM parameter
is a list of one or more parameters to be supplied to the exit. Five kinds of
tokens can be used to define a parameter:
1. Addresses: strings up to eight characters long, consisting of the
hexadecimal digits 0 through 9 and A through F.
DEFINE EXIT
2. General Registers: strings beginning with G or R, followed by a decimal
number between 0 and 15 or a hexadecimal digit, designating the contents
of a general register.
►◄
Chapter 2. CP Commands 165