$D PCE - Display status for JES2 processors

Function

To display status information (such as tracing status, ended counts or $ACTIVE counts) for one or more JES2 PCE types.

Parameters

(pce-type)

JES2 displays the status of processors in the specified processor-type(s). If this operand is omitted, then all PCE types are displayed.

The valid processor-types are:

Command Input

 Processors

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

EDS

Email services processor

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

MLLM

Line Manager

MISC

Miscellaneous processor

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 Processor

SPIN

Spin Output Processor

SPOOL

Spool Command Processor

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 topic about PCE List in z/OS JES2 Messages for a list of PCEs and a description of their functions.

ACTive=active

$ACTIVE count of all PCEs of this type. The $ACTIVE count is the number of devices of this type that are currently active or the number of jobs active on PCEs of this type.

Allocated=allocated

Number of defined PCEs that have been created.

COUNT=Allocated|Defined|Ended

Allocated

Number of defined PCEs that have been created.

Defined

Number of PCEs of this type defined to JES2.

Ended

Number of allocated PCEs that have ended.

Defined=defined

Number of PCEs of this type defined to JES2.

DESC

Displays a short description of the PCE type.

DETails=PCE(pcetype) | NAME=name | WAIT=waitparms | MOD=csect | SEQ=seq | TIME=yyyy.ddd,hh:mm:ss | SECONDS | MINUTES | HOURS | TRace=yes | {CURJOB | JOBid=jobnnnnn} | {ACTIVE=active} | {I/O=iii} | {ENDED=yes} | {EXIT=eee}

Displays detailed information about every PCE of the type.

pcetype

The processor type for a group of JES2 processors. This value is the NAME operand for an entry in the JES2 installation PCE table. For a complete list of the JES2 processor types, see the $T PCE command, or the "PCE list" at the end of this information for a list of PCEs, their names, and whether they are required, and a description of their function.

mod

Module CSECT name where PCE is $WAITing.

SEQ

Sequence number in mod where PCE is $WAITing.

TIME

Date and time when PCE $WAITed.

SECONDS>second | SECONDS<second

Time interval in second, more or less than which PCE has been waiting.

MINUTES>minute | MINUTES<minute

Time interval in minute, more or less than which PCE has been waiting.

HOURS>hour | HOURS<hour

Time interval in hour, more or less than which PCE has been waiting.

TRace=yes

Current trace status for the PCE.

CURJOB | JOBid

Current job id of job being processed (if any) by the PCE.

ACTIVE

$ACTIVE count for the PCE.

I/O

Number of $EXCPs outstanding for the PCE.

ENDED=yes

Present only if the PCE has ended.

EXIT=eee

Present only if the PCE is in logic that is part of an installation exit.

Ended=ended

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

LONG

Includes a description of the PCEs in the display.

Note: Because LONG automatically triggers a "long" display, you cannot add additional display-limiting parameters on this command; however, you can add selection-limiting parameters.

TRace={Mixed|No|P|Yes}

Displays the current trace status.

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.

Processing Considerations

If the processors within the specified type do not all have the same TRACE status, JES2 displays the status as ‘MIXED'. You must then use individual $DU commands to determine the status of each processor.

Scope

Single member. The response to this command will be a display of information about this member only. You might want to use this command to get information about all members in the MAS. To do 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 for more information on using the ROUTE *ALL command.

Messages

The $HASP653 message displays the current tracing status and PCE counts for the processor types specified.