$P TRace

Function

To deactivate one or more specified trace identifiers.

Syntax


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

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

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

Display limiting keywords

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

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

Selection limiting keywords

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

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

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

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

Parameters

nnn|*: The subscript defining the trace ID(s) that are deactivated. The subscript may specify a specific trace identifier or a range of trace identifiers.
Trace Identifiers 1-47 have specific meanings that are described in z/OS JES2 Diagnosis, GA32-0993. Trace identifiers 48-255 are available for customer use.
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.
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.

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.

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 $HASP667 message displays the current status of the specified trace identifier.

Example

 1   $ptrace(1)

  $HASP667 TRACE(1)   START=NO

JES2 deactivates trace(1).