z/OS JES2 Commands
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


$T EXIT(nnn) - Control JES2 installation exit points

z/OS JES2 Commands
SA32-0990-00

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

Read syntax diagramSkip visual syntax diagram
>>-$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 

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014