$T PCE

Function

To start or stop tracing for all JES2 processors of a given type, including non-device oriented JES2 processors.

Syntax


>>-$T--PCE--+-'--pce--'----------------------------------+------>
            '-(----+-pce-------+--+---------------+----)-'   
                   +-'--pce--'-+  +- ---pce-------+          
                   '-*---------'  +- ---'--pce--'-+          
                                  '- -*-----------'          

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

>--+---------------------------+-------------------------------><
   '-| Modification keywords |-'   

Modification keywords

|--+----------------------+-------------------------------------|
   '-,--TRace--=--+-No--+-'   
                  +-Yes-+     
                  '-P---'     

Selection limiting keywords

|--+----------------------------------+------------------------->
   '-,--+---+--ACTive--+-=--+--active-'   
        '-/-'          +-¬=-+             
                       +->--+             
                       '-<--'             

>--+----------------------------------------+------------------->
   '-,--+---+--Allocated--+-=--+--allocated-'   
        '-/-'             +-¬=-+                
                          +->--+                
                          '-<--'                

>--+------------------------------------+----------------------->
   '-,--+---+--Defined--+-=--+--defined-'   
        '-/-'           +-¬=-+              
                        +->--+              
                        '-<--'              

>--+--------------------------------+--------------------------->
   '-,--+---+--Ended--+-=--+--ended-'   
        '-/-'         +-¬=-+            
                      +->--+            
                      '-<--'            

>--+----------------------------------+-------------------------|
   '-,----/----TRace--+-=--+--+-No--+-'   
                      '-¬=-'  '-Yes-'

Parameters

pce

The processors for which tracing is activated or deactivated. The following processor-type values may be specified.

Command Input: Processor(s)
ALICE: Acquire lock and initiate cleanup executor
ASYNC: ASYNC I/O Processor
BERTLOCK: BERT Lock Post Processor
CKPT: Checkpoint Processor
CNVT: JCL Converter
COMM: Command Processor
DAWN: Distributed Available Work Notification
ENF: ENF Listen Processor
EOM: End of memory processor
EVTL: Event Trace Log
EXEC: Execution Services
FCLEANUP: FSS Cleanup at EOM
HOPE: Output Processor
IRCLEAN: Internal Reader Cleanup
JCMD: MAS Command Processor
JQRP: JQE Request Processor
MCON: Remote Console Processor
MISC: Miscellaneous processor
MLLM: Line Manager
NET.JR: NJE Job Receiver
NET.JT: NJE Job Transmitter
NET.SR: NJE SYSOUT Receiver
NET.ST: NJE SYSOUT Transmitter
NET.RR: Job Route Receiver
NET.RT: Job Route Transmitter
NPM: Network Path Manager
NRM: Network Resource Monitor
OFF.JR: Offload Job Receiver
OFF.JT: Offload Job Transmitter
OFF.SR: Offload SYSOUT Receiver
OFF.ST: Offload SYSOUT Transmitter
PRT: Printer
PRTYO: Output Priority Aging
PRTY: Job Priority Aging
PSO: Process SYSOUT Processor
PUN: Punch
PURGE: Purge Processor
RDR: Reader
RESOURCE: Resource Monitor
RESTART: ARM Support Processor
RMT.RDR: RJE Reader
RMT.PRT: RJE Printer
RMT.PUN: RJE Punch
SJFSERV: SWB Modify Processor
SNF: Spool Garbage Collector
SOM: Spool Offload I/O Manager
SPI: SYSOUT API
SPIN: Spin Processor
SPOOL: Spool Command Manager
STAC: SSI Status/Cancel Services
TIME: Elapsed Time Monitor
TIMER: STIMER/TTIMER Processor
WARM: Warm Start Processor
XCF: JESXCF Interface
XCFCMND: JESXCF Request Processor

See "PCE List" in z/OS JES2 Messages for a list of PCEs and a description of their functions.

ACTive=active

The $ACTIVE count.

Allocated=allocated

Number of defined PCEs that have been created.

Defined=defined

Number of PCEs of this type defined to JES2.

Ended=ended

Number of allocated PCEs that have ABENDed and are now ended.

TRace={No|Yes}

Specifies whether tracing is to be activated or deactivated for these processors.

Yes

Tracing is activated if trace IDs 11 and 12 are currently enabled. This command causes tracing of program linkage ($SAVE and $RETURN macros) performed under control of the specified group of processors.

Note:

Trace IDs 11 and 12 may be enabled either at initialization on the TRACE(n) statement or using the $S TRACE(n) command.
Not all processors that are eligible for tracing use the $SAVE and $RETURN macros (for example, the STIMER/TTIMER processor).

No

Tracing is disabled.

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.

Processing Considerations

For some device processors, tracing may have been set individually using other commands (for example, $TRDR1,TR=Y). This command sets tracing for ALL processors of the given type. Subsequent $T commands for individual devices can be issued to change the setting for just selected processors.

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 $HASP653 message displays the current processor tracing status and the PCE counts for the processor type specified.

Examples

 1   $t pce(evtl),trace=yes

  $HASP653 PCE(EVTL)     COUNT=(1,1,0),ACTIVE=0,TRACE=YES

JES2 activates tracing for the event trace log processors.

 2 $TPCE(CKPT),TRACE=YES
$HASP653 PCE(CKPT)      COUNT=(1,1,0),ACTIVE=0,TRACE=YES

Activate tracing for checkpoint type PCEs.

 3 $TPCE(NET*),TRACE=YES
$HASP653 PCE(NET.JT)    COUNT=(30,30,0),ACTIVE=0,TRACE=YES
$HASP653 PCE(NET.JR)    COUNT=(10,10,0),ACTIVE=0,TRACE=YES
$HASP653 PCE(NET.ST)    COUNT=(30,30,0),ACTIVE=0,TRACE=YES
$HASP653 PCE(NET.SR)    COUNT=(40,40,0),ACTIVE=0,TRACE=YES
$HASP653 PCE(NET.RR)    COUNT=(1,1,0),ACTIVE=0,TRACE=YES
$HASP653 PCE(NET.RT)    COUNT=(1,1,0),ACTIVE=0,TRACE=YES

Activate tracing for all PCE types that start with NET.

 4 $TPCE(*),ACTIVE>0,TRACE=YES
$HASP653 PCE(PRT)       COUNT=(11,11,0),ACTIVE=1,TRACE=YES

Activate tracing for all PCE types that have an active count of 1 or more.