$D TRACEDEF

Function

To display the current JES2 trace environment characteristics.

Syntax


>>-$D--TRACEDEF--+-----------+---------------------------------->
                 '-,--ACTIVE-'   

>--+------------------------------------+--+----------+--------->
   '-,--LOG--+------------------------+-'  '-,--PAGES-'   
             |       .-,---------.    |                   
             |       V           |    |                   
             '-=--(----+-CLASS-+-+--)-'                   
                       +-SIZE--+                          
                       '-START-'                          

>--+-----------------------------------------+------------------>
   '-,--STATS--+---------------------------+-'   
               |       .-,------------.    |     
               |       V              |    |     
               '-=--(----+-DISCARDS-+-+--)-'     
                         +-IDS------+            
                         '-TOTDISC--'            

>--+------------+--+-----------+--+------------+---------------><
   '-,--TABFREE-'  '-,--TABLES-'  '-,--TABWARN-'

Parameters

ACTIVE

Specifies whether (Yes) or not (No) the TRACE facility is started.

LOG[=CLASS|SIZE|START]

Specifies the trace table logging environment.

CLASS: Specifies the output class (A-Z, 0-9) of the trace log data set.
SIZE: Specifies the maximum size (100-2147483647) (in bytes) that the trace log data set may attain before it is queued for printing.
START: Specifies whether (Yes) or not (No) the trace log information is formatted and periodically added to the trace log data set.

PAGES

Specifies the number (9-1250) of 4K-pages available to each trace table.

STATS[=DISCARDS|IDS|TOTDISC]

Displays statistics about the tracing facility.

DISCARDS: Discards since last successful trace.
IDS: The active trace IDs.
TOTDISC: Total discards since tracing was started.

TABFREE

The number of unused trace tables.

TABLES

Specifies the number (0-2500) of trace tables that JES2 creates at initialization.

TABWARN

Specifies the percentage (0-100) of trace table use at which the operator will be alerted.

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 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, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

The individual parameter descriptions list the resulting messages.

Example

 1   $D TRACEDEF

  $d tracedef
  $HASP698 TRACEDEF
  $HASP698 TRACEDEF  ACTIVE=NO,TABLES=3,PAGES=9,TABWARN=80,
  $HASP698           TABFREE=3,LOG=(CLASS=A,START=NO,SIZE=500),
  $HASP698           STATS=(TOTDISC=0,DISCARDS=0,IDS=(NONE))

The $HASP698 message shows JES2 trace characteristics.