 |
Function To display the characteristics
of JES2 exit points.
Syntax
>>-$D--EXIT--+----------------------------------------+--------->
+-nnn--+-------------+-------------------+
| '- ---+-nnn-+-' |
| '-*---' |
| .-,----------------------------. |
| V | |
'-(------+-nnn-+--+-------------+---+--)-'
'-*---' '- ---+-nnn-+-'
'-*---'
>--+---------------------------------+-------------------------->
'-| Selection limiting keywords |-'
>--+-------------------------------+---------------------------><
'-| Display limiting keywords |-'
Display limiting keywords
|--+------------+--+-------------+------------------------------>
'-,--ENViron-' '-,--ROUtines-'
>--+---------------------------------------------------------------------------------------+-->
'-,--ROUtine--+-nnn--+-------------+-------------------+--+---------------------------+-'
| '- ---+-nnn-+-' | | .-,------------. |
| '-*---' | | V | |
| .-,----------------------------. | '-=--( ---+-NAME-----+-+--)-'
| V | | +-USECOUNT-+
'-(------+-nnn-+--+-------------+---+--)-' +-ADDRESS--+
'-*---' '- ---+-nnn-+-' '-LOADMOD--'
'-*---'
>--+---------+--+------------+--+-----------+--+----------+----->
'-,--LONG-' '-,--SPLEVEL-' '-,--STATUS-' '-,--TRace-'
>--+-------------+----------------------------------------------|
'-,--USEcount-'
Selection limiting keywords
|--+----------------------------------------+------------------->
'-,--+---+--ENViron--+-=--+--+-FSS-----+-'
'-/-' '-^=-' +-JES2----+
+-MIXED---+
+-SUBTASK-+
'-USER----'
>--+---------------------------------------------------------------------------------------------------------------+-->
| .-,----------------------------. |
| V | |
'-,--+---+--ROUtine--+-nnn--+-------------+-------------------+--+-=--+--( ---+-NAME--+-=--+--name-------+-+--)-'
'-/-' | '- ---+-nnn-+-' | '-^=-' | '-^=-' |
| '-*---' | +-USECOUNT--+-=--+--count--+
| .-,----------------------------. | | '-^=-' |
| V | | +-ADDRESS--+-=--+--address-+
'-(------+-nnn-+--+-------------+---+--)-' | '-^=-' |
'-*---' '- ---+-nnn-+-' '-LOADMOD--+-=--+--loadmod-'
'-*---' '-^=-'
>--+----------------------------------------+------------------->
'-,--+---+--SPLEVEL--+-=--+--+-CHECK---+-'
'-/-' '-^=-' '-NOCHECK-'
>--+------------------------------------------------+----------->
'-,--+---+--STATUS--+-=--+--+-DISABLED---------+-'
'-/-' '-^=-' +-DISABLED/ENTERED-+
'-ENABLED----------'
>--+----------------------------------+-------------------------|
'-,--+---+--TRace--+-=--+--+-No--+-'
'-/-' '-^=-' '-Yes-'
Parameters - EXIT(nnn|*)
- The $HASP823 message
displays the current characteristics of the specified JES2 exit points.
- ENViron[=FSS|JES2|MIXED|SUBTASK|USER]
- Displays
the environment in which the exit gains control. You can specify the
ENVIRON parameter without an environment keyword, or you can specify
an environment if you are requesting information about all modules
in that environment only (for example, ENV=USER).
Valid keyword
values for the D MODULE ENV= parameter and their meanings are: - Value
- Meaning
- FSS
- Displays only those exits that are entered in the FSS address
space environment.
- JES2
- Displays only those exits that are entered in the JES2 address
space main task environment.
- MIXED
- Displays only those exits that are entered in the same environment.
Having a module with routines defined for different environments is
rare in IBM® modules, and is not recommended in installation-defined
modules.
- SUBTASK
- Displays only those exits that are entered in the JES2 address
space subtask environment.
- USER
- Displays only those exits that are entered in the multi-address-space
user environment.
- LONG
- Specifies whether or not an abbreviated list of characteristic
is provided. An abbreviated display of characteristics is provided
unless LONG is requested. The abbreviated list includes only the
following characteristics:
- STATUS
- ENVIRON
- ROUTINES
- SPLEVEL
- TRACE
- USECOUNT
When LONG is specified, if there are routines
associated with the selected exit or exits, the ROUTINE(nnn) keyword
is displayed while the ROUTINES keyword is not displayed. If there
are no routines associated with the selected exit or exits, neither
of these keywords will be displayed when LONG is specified.
- ROUtines
- Displays the names of the routines associated with the selected
exit or exits.
- ROUtine(nnn)
- Displays
detailed information about a particular routine associated with the
exit. This keyword is displayed if specified on the command or if
LONG is specified. Detailed information includes the following values:
- NAME
- Routine name
- USECOUNT
- Current use count
- ADDRESS
- Address of routine
- LOADMOD
- Name of loadmod that contains routine
- SPLEVEL[=CHECK|NOCHECK]
- Display
only those exits that are entered in the SPLEVEL= parameter on the
$MODULE macro. Optionally, you can display only those modules that
have assigned a specific value to the $MODULE SPLEVEL= parameter by
coding one of the following keywords:
- Value
- Meaning
- CHECK
- Display only those modules that specified CHECK on the $MODULE
SPLEVEL= parameter.
- NOCHECK
- Display only those modules that specified NOCHECK on the $MODULE
SPLEVEL= parameter.
- STATUS={DISABLED|DISABLED/ENTERED|ENABLED}
- Display
the current state of the exit in:
- DISABLED
- The exit is not to be entered.
- DISABLED/ENTERED
- The exit received control even though it is in a disabled state.
- ENABLED
- The exit is to be entered at the appropriate point in processing.
- TRace[=No|Yes]
- Specifies
whether the execution of this exit is to be traced (Yes) or not (No).
- USECOUNT
- Displays
a count of processes using the exit at this time.
Authority Required This command requires display 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 read security access authority. For a description of assigning command
input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.
Scope Single member. The command
will be in effect for this member only. There is no need to have this
command issued to all members of the MAS.
Messages The $HASP823 messages displays
the characteristics of JES2 exit points.
Examples 1 $d exit(5)
$HASP823 EXIT(5) STATUS=ENABLED,ENVIRON=JES2,
$HASP823 ROUTINES=(OURCMD,QUEBRK),SPLEVEL=CHECK,
$HASP823 TRACE=YES,USECOUNT=0
JES2
displays the current status of $EXIT 5. The exit is enabled, and
routines OURCMD and QUEBRK will get control whenever exit 5 is entered.
2 $d exit(*),status=enabled,routines
$HASP823 EXIT(5) ROUTINES=(OURCMD,QUEBRK)
$HASP823 EXIT(24) ROUTINES=(FIXMAP)
$HASP823 EXIT(26) ROUTINES=(FREEMAP)
JES2
displays all enabled $EXITs, and the routines associated with each.
3 $d exit(5),long
$HASP823 EXIT(5)
$HASP823 EXIT(5) STATUS=ENABLED,ENVIRON=JES2,
$HASP823 ROUTINE(1)=(NAME=OURCMD,USECOUNT=0,
$HASP823 ADDRESS=0A18F4A0,LOADMOD=HASTX5),
$HASP823 ROUTINE(2)=(NAME=DIAGXITM,USECOUNT=0,
$HASP823 ADDRESS=09F302C0,LOADMOD=HASTDIAG),
$HASP823 SPLEVEL=CHECK,TRACE=YES,USECOUNT=0
4 $d exit(*),ROUTINE(*)=(loadmod=HASTDIAG)
$HASP823 EXIT(1)
$HASP823 EXIT(1) ROUTINE(1)=(NAME=DIAGX01,USECOUNT=0,
$HASP823 ADDRESS=09F429F0,LOADMOD=HASTDIAG),
$HASP823 ROUTINE(2)=(NAME=DIAGXITM,USECOUNT=0,
$HASP823 ADDRESS=09F302C0,LOADMOD=HASTDIAG)
$HASP823 EXIT(2)
$HASP823 EXIT(2) ROUTINE(1)=(NAME=DIAGX02,USECOUNT=0,
$HASP823 ADDRESS=09F35520,LOADMOD=HASTDIAG),
$HASP823 ROUTINE(2)=(NAME=DIAGXITM,USECOUNT=0,
$HASP823 ADDRESS=09F302C0,LOADMOD=HASTDIAG)
$HASP823 EXIT(3)
$HASP823 EXIT(3) ROUTINE(1)=(NAME=DIAGX03,USECOUNT=0,
$HASP823 ADDRESS=09F35AA8,LOADMOD=HASTDIAG),
$HASP823 ROUTINE(2)=(NAME=DIAGXITM,USECOUNT=0,
$HASP823 ADDRESS=09F302C0,LOADMOD=HASTDIAG)
$HASP823 EXIT(4)
$HASP823 EXIT(4) ROUTINE(2)=(NAME=DIAGXITM,USECOUNT=0,
$HASP823 ADDRESS=09F302C0,LOADMOD=HASTDIAG)
$HASP823 EXIT(5)
$HASP823 EXIT(5) ROUTINE(2)=(NAME=DIAGXITM,USECOUNT=0,
$HASP823 ADDRESS=09F302C0,LOADMOD=HASTDIAG)
|
z/OS JES2 Commands
Copyright IBM Corporation 1990, 2014