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.