Parameter Description for EXIT(nnn)

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 EXIT(nnn) statement
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.

Note: $$$$LOAD and $$$$DEL are reserved names. If you specify them, you will receive a $HASP003 RC=06 message indicating that the value contains invalid data.

Modification: $T EXIT(nnn) operator command.

STATUS=ENABLED|DISABLED
Specifies the initial status of the exit. If the exit is disabled, no exit routines can be invoked at this exit.
Whether or not the installation exit routines associated with an enabled exit are executed is dependent upon:
  • Whether the enabled status of the exit has been overridden by the $T EXIT(nnn) operator command.
  • Whether the job being processed is eligible to use the exit, as determined by your installation's setting of the job exit mask for that job. (See z/OS JES2 Installation Exits for information on how to use the job exit mask and z/OS JES2 Commands for information on how to use the $T EXIT(nnn) command.)

Modification: $T EXIT(nnn) operator command.

TRACE=Yes|No
Specifies whether the execution of this exit is to be traced. To trace an exit, you must also provide the following initialization statements:
  • TRACE(n) START=Yes
  • TRACEDEF ACTIVE=Yes

This parameter setting can be overridden by the $T EXIT(nnn) operator command. Exit tracing is also controlled by trace ID 13, the TRACE(n) and TRACEDEF initialization statements, and the $TRACE command. (See z/OS JES2 Initialization and Tuning Guide, the TRACE(n) and TRACEDEF initialization statements in this topic, and z/OS JES2 Commands for a description of the $TRACE command for further information concerning the tracing facility.)

Modification: $T EXIT(nnn) operator command.