$D TRace(nnn)

Function

To display the current status of JES2 trace IDs.

Syntax


>>-$D--TRace--+----------------------------------------+-------->
              +-nnn--+-------------+-------------------+   
              |      '- ---+-nnn-+-'                   |   
              |            '-*---'                     |   
              |    .-,----------------------------.    |   
              |    V                              |    |   
              '-(------+-nnn-+--+-------------+---+--)-'   
                       '-*---'  '- ---+-nnn-+-'            
                                      '-*---'              

>--+---------------------------------+-------------------------->
   '-| Selection limiting keywords |-'   

>--+-------------------------------+---------------------------><
   '-| Display limiting keywords |-'   

Display limiting keywords

|--+---------+--+------------+--+---------------+--------------->
   '-,--ASID-'  '-,--JOBNAME-'  '-,--JOB_NUMBER-'   

>--+----------+--+----------------+-----------------------------|
   '-,--START-'  '-,--TCB_ADDRESS-'   

Selection limiting keywords

|--+------------------------------+----------------------------->
   '-,--+---+--ASID--+-=--+--xxxx-'   
        '-/-'        '-^=-'           

>--+------------------------------------+----------------------->
   '-,--+---+--JOBNAME--+-=--+--nnnnnnn-'   
        '-/-'           '-^=-'              

>--+---------------------------------------+-------------------->
   '-,--+---+--JOB_NUMBER--+-=--+--nnnnnnn-'   
        '-/-'              '-^=-'              

>--+----------------------------------+------------------------->
   '-,--+---+--START--+-=--+--+-No--+-'   
        '-/-'         '-^=-'  '-Yes-'     

>--+-----------------------------------------+------------------|
   '-,--+---+--TCB_ADDRESS--+-=--+--xxxxxxxx-'   
        '-/-'               '-^=-'

Parameters

ASID= xxxx: Specifies the ASID used when filtering this JES2 trace point.
JOBNAME=nnnnnnn: Specifies the jobname used when filtering this JES2 trace point.
JOB_NUMBER=nnnnnnn: Specifies the job number used when filtering this JES2 trace point.
Note: If more than one of ASID=, JOBNAME=, and JOB_NUMBER= are specified for a specific trace ID, only one of the conditions must match the trace to be taken. In the JES2 address space, the values specified refer to the job that is being processed by JES2. For example, never specify the JES2 address space as ASID= because JES2 is never processing requests on the behalf of JES2. Outside the JES2 address space, these filters refer to the address space where the trace is being taken. For jobs being submitted through the internal reader, it is the job name, number, and ASID of the submitter of a job that are compared to the filters, not the values of the job being submitted. The same is true for FSS or SAPI devices. The filters refer to the SAPI or FSS address space, not the job that the FSS or SAPI application is processing.
START={No|Yes}: Specifies whether (Yes) or not (No) a specific trace ID or a range of IDs is activated.
TCB_ADDRESS=xxxxxxxx: Specifies the further limit tracing to the specified TCB. This is in addition to any filtering that is applied. This operand is ignored if ASID=. JOBNAME=, and JOB_NUMBER= are not specified. The TCB address must match even in the JES2 address space.
TRace(nnn): The $HASP667 message displays the current status of the specified trace ID(s).

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

The scope of some commands varies by parameter.

Some parameters on certain commands will display information about the entire MAS, while other parameters will display information about this member only.

For those commands that are single member scope, or have some parameters that are single member scope, you might want to use the parameters for that command to get information about all members of the MAS. If so, you can use the MVS ROUTE *ALL command to issue that 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 individual parameter descriptions list the resulting messages.

Example

 1   $D TRACE

  $d trace(4)
  $HASP667 TRACE(4)     START=NO

The $HASP667 message shows JES2 trace id status.