$JDHISTORY

Function

To display the history of resource usage and CPU statistics over time. At the beginning of every hour, JES2 saves the current statistics and resets the count. Use this command to review the saved statistics. The monitor obtains and displays up to 72 hours of samples, based on how long the monitor address space has been running. This command allows subscripts for resources.

The monitor displays information by sampling fields in the JES2 address space. Because JES2 samples without serialization, it is possible that the high and low utilization numbers might not reflect the highest and lowest actual utilization if the utilization spikes for period of time shorter than the 1–second sampling period.

Note: If the monitor address space has been active over 72 hours, a single display from the $JDHISTORY command will results in over to 1270 lines of data.

Syntax


                    .-,---------.                            
                    V           |                            
>>-$JD--HISTORY--(----+-------+-+--)--+------------------+-----><
                      +-MAIN--+       '-+-HOURS=-+-hours-'   
                      +-BERT--+         '-H=-----'           
                      +-BSCB--+                              
                      +-BUFX--+                              
                      +-CKVR--+                              
                      +-CMBS--+                              
                      +-CMDS--+                              
                      +-ERROR-+                              
                      +-ICES--+                              
                      +-JNUM--+                              
                      +-JOES--+                              
                      +-JQES--+                              
                      +-LBUF--+                              
                      +-NHBS--+                              
                      +-SMFB--+                              
                      +-TGS---+                              
                      +-TTAB--+                              
                      '-VTMB--'

Authority Required

The $JDHISTORY command supports subscripts to limit the information returned. If no subscript is provided, then all information is displayed. The valid subscripts are:

MAIN: Main task sampling percent history.
BERT: JES2 BERT usage history.
BSCB: JES2 BSC buffer usage history.
BUFX: JES2 Extended buffer usage history.
CKVR: JES2 CKPT versions usage history.
CMBS: JES2 CMB usage history.
CMDS: JES2 CMD usage history.
ERROR: JES2 error history.
ICES: JES2 ICE usage history.
JNUM: JES2 Job number usage history.
JOES: JES2 JOE usage history.
JQES: JES2 JQE usage history.
LBUF: JES2 logical buffer usage history.
NHBS: JES2 NJE header buffer usage history.
SMFB: JES2 SMF buffer usage history.
TGS: JES2 track group usage history.
TTAB: JES2 trace table usage history.
VTMB: JES2 VTAM® buffer usage history.

Parameters

HOURS=|H=: Indicates how many history entries are to be displayed. If not specified, the default is 72 hours, or however many hours the monitor has been active.
HOURS= can increase or decrease the number of intervals displayed. The monitor maintains history for the life of the monitor address space.

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.

Scope

Single member. This response to this command displays information about this member only.

Messages

Examples

 1 
$JD HISTORY
$HASP9130 D HISTORY                                         
   $HASP9131 JES2 BERT USAGE HISTORY                              
   DATE     TIME        LIMIT    USAGE      LOW     HIGH  AVERAGE 
   -------- -------- -------- -------- -------- -------- -------- 
   2002.149 23:00:00     1100       89       89       89       89 
   2002.149 22:33:57     1100       89       83       90       89 
   $HASP9131 JES2 BSCB USAGE HISTORY                              
   DATE     TIME        LIMIT    USAGE      LOW     HIGH  AVERAGE 
   -------- -------- -------- -------- -------- -------- -------- 
   2002.149 23:00:00       42        0        0        0        0 
   2002.149 22:33:57       42        0        0        0        0 
   $HASP9131 JES2 BUFX USAGE HISTORY                              
   DATE     TIME        LIMIT    USAGE      LOW     HIGH  AVERAGE 
   -------- -------- -------- -------- -------- -------- -------- 
   2002.149 23:00:00      249        0        0        0        0 
   2002.149 22:33:57      249        0        0        7        0 
   $HASP9131 JES2 CKVR USAGE HISTORY                              
   DATE     TIME        LIMIT    USAGE      LOW     HIGH  AVERAGE 
   -------- -------- -------- -------- -------- -------- -------- 
   2002.149 23:00:00        2        0        0        0        0 
   2002.149 22:33:57        2        0        0        0        0 
   $HASP9131 JES2 CMBS USAGE HISTORY                              
   DATE     TIME        LIMIT    USAGE      LOW     HIGH  AVERAGE 
   -------- -------- -------- -------- -------- -------- -------- 
   2002.149 23:00:00      208        0        0        0        0
   2002.149 22:33:57      208        0        0        0        0
   $HASP9131 JES2 CMDS USAGE HISTORY                             
   DATE     TIME        LIMIT    USAGE      LOW     HIGH  AVERAGE
   -------- -------- -------- -------- -------- -------- --------
   2002.149 23:00:00      200        0        0        0        0
   2002.149 22:33:57      200        0        0        0        0
   $HASP9131 JES2 ICES USAGE HISTORY                             
   DATE     TIME        LIMIT    USAGE      LOW     HIGH  AVERAGE
   -------- -------- -------- -------- -------- -------- --------
   2002.149 23:00:00      101        0        0        0        0
   2002.149 22:33:57      101        0        0        0        0
   $HASP9131 JES2 JNUM USAGE HISTORY                             
   DATE     TIME        LIMIT    USAGE      LOW     HIGH  AVERAGE
   -------- -------- -------- -------- -------- -------- --------
   2002.149 23:00:00     9999        6        6        6        6
   2002.149 22:33:57     9999        6        0        6        6
   $HASP9131 JES2 JOES USAGE HISTORY                             
   DATE     TIME        LIMIT    USAGE      LOW     HIGH  AVERAGE
   -------- -------- -------- -------- -------- -------- --------
   2002.149 23:00:00      200        2        2        2        2
   2002.149 22:33:57      200        2        0        2        2
   $HASP9131 JES2 JQES USAGE HISTORY                             
   DATE     TIME        LIMIT    USAGE      LOW     HIGH  AVERAGE
   -------- -------- -------- -------- -------- -------- -------- 
   2002.149 23:00:00      500        6        6        6        6 
   2002.149 22:33:57      500        6        0        6        6 
   $HASP9131 JES2 LBUF USAGE HISTORY                              
   DATE     TIME        LIMIT    USAGE      LOW     HIGH  AVERAGE 
   -------- -------- -------- -------- -------- -------- -------- 
   2002.149 23:00:00      151        0        0        0        0 
   2002.149 22:33:57      151        0        0        0        0 
   $HASP9131 JES2 NHBS USAGE HISTORY                              
   DATE     TIME        LIMIT    USAGE      LOW     HIGH  AVERAGE 
   -------- -------- -------- -------- -------- -------- -------- 
   2002.149 23:00:00       23        0        0        0        0 
   2002.149 22:33:57       23        0        0        0        0 
   $HASP9131 JES2 SMFB USAGE HISTORY                              
   DATE     TIME        LIMIT    USAGE      LOW     HIGH  AVERAGE 
   -------- -------- -------- -------- -------- -------- -------- 
   2002.149 23:00:00       53        0        0        0        0 
   2002.149 22:33:57       53        0        0        0        0 
   $HASP9131 JES2 TGS  USAGE HISTORY                              
   DATE     TIME        LIMIT    USAGE      LOW     HIGH  AVERAGE 
   -------- -------- -------- -------- -------- -------- -------- 
   2002.149 23:00:00      525       13       13       13       13 
   2002.149 22:33:57      525       13        9       13       13 
   $HASP9131 JES2 TTAB USAGE HISTORY                              
   DATE     TIME        LIMIT    USAGE      LOW     HIGH  AVERAGE      
   -------- -------- -------- -------- -------- -------- --------      
   2002.149 23:00:00        3        0        0        0        0      
   2002.149 22:33:57        3        0        0        0        0      
   $HASP9131 JES2 VTMB USAGE HISTORY                                   
   DATE     TIME        LIMIT    USAGE      LOW     HIGH  AVERAGE      
   -------- -------- -------- -------- -------- -------- --------      
   2002.149 23:00:00       24        0        0        0        0      
   2002.149 22:33:57       24        0        0        0        0      
   $HASP9132 MAIN TASK SAMPLING PERCENT HISTORY                        
   DATE     TIME       COUNT ACTIVE   IDLE   WAIT L-LOCK N-DISP PAGING 
   -------- --------  ------ ------ ------ ------ ------ ------ ------ 
   2002.149 23:00:00   58811   0.23  99.76   0.00   0.00   0.00   0.00 
   2002.149 22:33:57   30791   0.29  99.07   0.61   0.00   0.00   0.00

In the $HASP9132 message above, status is one of:

ACTIVE– Subtask is active and processing normally.
INITIALIZING– Subtask is still completing its initialization processing (or is reinitializing after a failure.)
TERMINATING– Subtask is in the process of shutting down.
TERMINATED– Subtask has shut down.

Alerts are based on the individual subtask and the functions they perform. Alerts include:

AWAITING JES2– The JES2 address space is not active; therefore, the subtask is not performing its normal function.
RECOVERING– The subtask has ABENDed and is in the process of recovering.

The module information display includes the name of the module, where it is located in the monitor address space, the length of the module (in hex), the date and time the module was assembled, and information on what maintenance was applied to the module.