|
Function To perform the following
functions: - Enables and disables an exit point. When an exit is disabled,
none of the routines specified are invoked.
- Alters the list of routines associated with an exit.
- Specifies whether selective trace records are created when this
exit is invoked.
Syntax
>>-$T--EXIT--+-nnn--+-------------+-------------------+--------->
| '- ---+-nnn-+-' |
| '-*---' |
| .-,----------------------------. |
| V | |
'-(------+-nnn-+--+-------------+---+--)-'
'-*---' '- ---+-nnn-+-'
'-*---'
>--+---------------------------------+-------------------------->
'-| Selection limiting keywords |-'
>--+---------------------------+-------------------------------><
'-| Modification keywords |-'
Modification keywords
|--+------------+--+-----------+--+------------+---------------->
'-,--DISABLE-' '-,--ENABLE-' '-,--REFRESH-'
>--+-----------------------------------------------+------------>
'-,--ROUtines--=--+---------------------------+-'
+-+----+--routine-----------+
| +-+--+ |
| '- --' |
| .-,---------------. |
| V | |
'-(----+----+--routine-+--)-'
+-+--+
'- --'
>--+----------------------------+--+----------------------+-----|
'-,--STATUS--=--+-DISABLED-+-' '-,--TRace--=--+-No--+-'
'-ENABLED--' '-Yes-'
Selection limiting keywords
|--+----------------------------------------+------------------->
'-,----/----STATUS--+-=--+--+-DISABLED-+-'
'-^=-' '-ENABLED--'
>--+----------------------------------+-------------------------|
'-,----/----TRace--+-=--+--+-No--+-'
'-^=-' '-Yes-'
Parameters - nnn
- The subscript that defines one or more exit points affected
by this command. The subscript can specify a numeric value or
a range of values. For information about specifying a range of values
for this subscript, see Command syntax conventions.
- REFRESH
- Refreshes the list of routine names associated with the exit through
address resolution processing. The address of the most recently loaded
routine with a matching name is associated with the exit. This process
also resolves entries that are NULL because load modules are deleted.
- ROUtines=(+/-routine)
- Specifies a list of routines to replace the existing one, that
is to add routines to the end of the list, to remove routines from
the beginning of the list, or both. The "+" indicates the routine
names to add to the end of the routine list. The "-" indicates routine
names to be removed from the beginning of the routine list. If there
is no "+" or "-" prefix for a routine name, then the previous prefix
is used. If the non-prefix routine name is the first element in the
specified list, then the list is a replacement of the existing one. Table 1 shows an example of specifying
the routine list (cumulative list).
Table 1. Example for ROUtines parameter
on $T EXIT(nnn)ROUTINES=specification |
Resulting routine list |
---|
A,B,C |
A,B,C |
+D |
A,B,C,D |
-B |
A,C,D |
+E,F,G |
A,C,D,E,F,G |
-C,D,+H,I |
A,E,F,G,H,I |
X,Y,Z,-X,+A |
Y,Z,A |
The added routine names are resolved to the address of
the most recently loaded routine with a matching name. The existing
routines in the list are not effected. As the example in Table 1, when +D is specified, the address
of the most recently loaded routine named D is associated with the
exit. However, the addresses associated with A, B, and C are not affected,
even if a $ADD LOADMOD was done for a new module with routine B in
it. For example, Table 2 shows
the resulting list of EXIT(5) after each command. Table 2. Example for ROUtines
and REFRESH parameters on $T EXIT(nnn)Command |
Resulting list |
---|
|
ROUTINES=(A,B,C) |
$DEL LOADMOD(BLOAD) |
ROUTINES=(A,B(NULL),C) |
$ADD LOADMOD(BLOAD) |
ROUTINES=(A,B(NULL),C) |
$T EXIT(5),ROUTINES=+D |
ROUTINES=(A,B(NULL),C,D) |
$T EXIT(5),REFRESH |
ROUTINES=(A,B,C,D) |
- STATUS={DISABLED|ENABLED}
- Specifies
the status of the JES2 exit point(s).
- DISABLED
- JES2 does not invoke any exit routines at this exit point.
- ENABLED
- JES2 invokes the exit routines at this exit point providing the
job being processed is eligible to use the exit.
- TRace={No|Yes}
- Specifies
whether the specified exit point(s) are to be traced.
Note: Trace
ID 13 must be activated for tracing to occur for any JES2 exit point.
Individual trace IDs can be activated either during initialization
on the TRACE(n) initialization statement, or using the $S TRACE(n)
command.
Authority Required This command requires system authority.
The description of the $T RDRnn command explains how to ensure that
the authority of the appropriate MVS™ system
command group is assigned.
This command requires control security
access authority. For a description of assigning command input authority,
see z/OS JES2 Initialization and Tuning Guide, SA32-0991.
Scope Single member. This command
will be in effect for this member only.
Depending on your installation's
setup, however, you might want this command to be applied to all members
of the MAS (to ensure a consistent environment across the MAS). If
so, you can use the MVS ROUTE *ALL command to issue this
command to all active members (if the JES2 command character is the
same on all members). See z/OS MVS System Commands, SA38-0666 for
more information on using the ROUTE *ALL command.
Messages The $HASP823 message
displays the current values of all the parameters on the EXIT(nnn)
initialization statement.
Examples 1 $t exit(5),status=enabled
$HASP823 EXIT(5)
$HASP823 EXIT(5) STATUS=ENABLED,ENVIRON=JES2,
$HASP823 ROUTINES=(DIAGX05,OURCMD,DIAGXITM),
$HASP823 SPLEVEL=CHECK,TRACE=YES,USECOUNT=0
2 $t exit(5),routine=-diagx05
$HASP823 EXIT(5)
$HASP823 EXIT(5) STATUS=ENABLED,ENVIRON=JES2,
$HASP823 ROUTINES=(OURCMD,DIAGXITM(NULL)),
$HASP823 SPLEVEL=CHECK,TRACE=YES,USECOUNT=0
3 $t exit(5),refresh
$HASP823 EXIT(5)
$HASP823 EXIT(5) STATUS=ENABLED,ENVIRON=JES2,
$HASP823 ROUTINES=(OURCMD,DIAGXITM),
$HASP823 SPLEVEL=CHECK,TRACE=YES,USECOUNT=0
|