$JDDETAILS

Function

To display resource, sampling, and wait statistics for the JES2 address space being monitored. This command should be used to determine if a resource problem is impacting JES2. The first part of the display contains statistics on the major JES2 resources. The second part displays JES2 CPU sampling statistics. High sample counts with a status other than ACTIVE or IDLE might indicate a problem. The final section is the MVS™ wait table. The main task should not enter long MVS WAITs after initialization. Typically, waits indicate some resource that was not immediately available to JES2.

The resource usage and CPU statistics are reset at the beginning of every hour. To view statistics for previous intervals use the $JD HISTORY command. Because the sampling is done without serialization, it is possible, in rare stations, that PCE and exit information in the wait table are inconsistent. It is also possible that the high and low utilization numbers might not reflect the highest and lowest actual utilization if the utilization spikes for a period of time shorter than the 1–second sampling interval .

The $JDDETAILS command allows subscripts.

Syntax


>>-$JD--DETAILS--+--------------------+------------------------><
                 '-(--+-RESOURCE-+--)-'   
                      +-MAIN-----+        
                      +-WAIT-----+        
                      +-ERROR----+        
                      '-STORAGE--'

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.

Processing Considerations

The following restrictions apply to all monitor commands. They:

Can only be issued through the MVS command interface (consoles or MGCRE) or JES2 automatic commands
Cannot be issued from the JES2 initialization data set, NJE/RJE, $M commands, or through a reader (INTRDR)
Can be the object of a $VS command
Are not limited by CONDEF CMDNUM=
Are not limited by CONDEF DISPMAX=
Support L= for directing the output but do not honor CONDEF RDIRAREA= or REDIRECT= parameters
Cannot use the JES2 command separator, semicolon (;), to separate monitor commands unless it is also the MVS command separator.

The $JDDETAILS command supports subscripts to limit the information that is being returned. If no subscript is provided, JES2 will display all the information. The valid subscripts are:

RESOURCE: Displays $HASP9104 with information on the current JES2 resource usage.
MAIN: Displays $HASP9105 with information on the current breakdown of CPU samples.
WAIT: Displays $HASP9106 which contains the table of MVS WAITs in the JES2 main task.
ERROR: Displays $HASP9107 with counts of errors JES2 has recently encountered.
STORAGE: Displays $HASP9108 with storage utilization statistics.

Scope

Single Member. The response to this command will be a display of information about this member only.

Messages

Examples

1
$JDDETAILS        
   $HASP9103 D DETAIL
   $HASP9104 JES2 RESOURCE USAGE SINCE 2002.149 23:00:00      
   RESOURCE    LIMIT    USAGE      LOW     HIGH  AVERAGE      
   -------- -------- -------- -------- -------- --------      
   BERT         1100       89       89       89       89      
   BSCB           42        0        0        0        0      
   BUFX          249        0        0        0        0      
   CKVR            2        0        0        0        0      
   CMBS          208        0        0        0        0      
   CMDS          200        0        0        0        0      
   ICES          101        0        0        0        0      
   JNUM         9999        6        6        6        6      
   JOES          200        2        2        2        2      
   JQES          500        6        6        6        6      
   LBUF          151        0        0        0        0      
   NHBS           23        0        0        0        0      
   SMFB           53        0        0        0        0      
   TGS           525       13       13       13       13      
   TTAB            3        0        0        0        0      
   VTMB           24        0        0        0        0      
   $HASP9105 JES2 SAMPLING STATISTICS SINCE 2002.149 23:00:00 
   TYPE               COUNT  PERCENT                          
   ----------------  ------  -------                          
   ACTIVE               134     0.22                          
   IDLE               58257    99.77                                    
   LOCAL LOCK             0     0.00                                    
   NON-DISPATCHABLE       0     0.00                                    
   PAGING                 0     0.00                                    
   OTHER WAITS            0     0.00                                    
   TOTAL SAMPLES      58391                                             
   $HASP9106 JES2 MAIN TASK MVS WAIT TABLE                              
   DATE     TIME     ADDRESS  MODULE   OFFSET WT-COUNT SM-COUNT PCE XIT 
   -------- -------- -------- -------- ------ -------- -------- --- --- 
   2002.149 22:34:06 011340B4 IGC018  +000B74        4       13  23 JCO
   2002.149 22:33:57 043B2BAE IGC0013I+001BAE        1        1  23 JCO 
   2002.149 22:33:57 0003D5F2 HASPCKPT+0065F2        1        2  23 JCO 
   2002.149 22:34:01 06C02108 HASPIRA +001108        2      142  23 JCO 
   2002.149 22:34:06 00FE2FF6 IEAVEWAT+0007DE        3        6 MLT JCO 
   2002.149 22:34:04 06C057C2 HASPIRDA+0027C2        1       24  23 JCO 
   2002.149 22:34:06 01182426 IEWFETCH+00152E        3        4  23 JCO 
   2002.149 22:34:06 0003FC00 HASPCKPT+008C00        1        6  23 JCO 
   2002.149 22:34:06 00066F7A HASPDYN +000F7A        1        1  23 JCO

The WT-COUNT in the above $HASP9106 response is the number of distinct times this MVS wait was encountered. The SM-COUNT is the number of times the sampling task sampled this wait. For the first wait, it has a wait count of 4 and a sample count of 13. It waited an average of 3 sample intervals at this wait. The sample interval is about 1/20 of a second; therefore, this MVS wait lasted on average 3/20 of a second each of the 4 times it was encountered.

In the MVS wait table, the PCE column can contain one of the following:

nnn – PCEID value for the PCE in control at the time of the MVS wait.
MLT – Multiple PCEs have MVS waited at this point.

In the MVS wait table, the XIT column can contain one of the following:

nnn – JES2 exit number at the time of the MVS wait.
JCO – MVS wait occurred in JES2 code only (never in an exit).
JNX – JES2 code and exit code both encountered this MVS wait.
MLT – The MVS wait occurred under multiple exits but never in non-exit JES2 code.