Use the DISPLAY HIS command to display the results of the latest HIS Profiler run initiated by an F hisproc,BEGIN command. Hardware event data collection is performed by hardware instrumentation services (HIS), which collects hardware event data for processors in SMF records type 113 and some of the z/OS UNIX System Services output files.
The DISPLAY HIS command is also used to display statistics
on the exploiters of the HISSERV service. The HISSERV service allows
authorized programs to collect hardware instrumentation data. The
amount of time each exploiter takes to collect the data is recorded
by the service, and displayed here to aid in problem determination
should a performance degradation occur.
Note that the results displayed by the D HIS command
in system message HIS015I message will only be as current as the last
time you initiated a hardware event data collection run with the F hisproc,BEGIN command. The displaying of statistical information, as well as
any service parameters, are displayed as long as the HISSERV service
is active.
|
- HIS
- The system displays HIS information in message HIS015I. For more information about HIS015I, see z/OS MVS System Messages, Vol 6 (GOS-IEA).
- L=a|name|name-a
- This operand specifies the display area (a), console name (name),
or both (name-a) where the output is to be displayed.
If you omit this operand, the display is presented in the first available display area or the message area of the console through which you enter command.
You can start a run of hardware event data collection using the MODIFY hisproc,BEGIN command. See Starting, configuring, and stopping hardware event data collection.
Examples
Example 1: If you issue the D HIS command to display the results of the latest hardware event data collection run while the collection is still in progress, the data displayed might be incomplete. The following example shows output from a D HIS command issued while data collection is still running. SYSHIS20071108.184129 is the file name prefix for all the output files for the data collection run. The PATH= /user is the USS directory where all the output files are created. The COMPLETION STATUS indicates if the instrumentation run was successful or not. LOST SAMPLES shows the total count of lost samples on all the processors if sampling is active.
The HIS profiler (the collection started by F hisproc,BEGIN)
is the only HISSERV exploiter. It queries for counters data every
15 minutes, and takes almost .2 seconds to process each sampling data
event callback.
HIS015I 18.41.33 DISPLAY HIS 201
HIS 0023 ACTIVE
COMMAND: MODIFY HIS,B,TT=’Sampling’,BUF=25,PATH=’/user’,MJOB=(OMVS,J*,GRS)
START TIME: 2007/11/08 18:41:29
END TIME: ----/--/-- --:--:--
COMPLETION STATUS: --------
FILE PREFIX: SYSHIS20071108.184129
LOST SAMPLES: 0
COUNTER VERSION NUMBER 1: 1 COUNTER VERSION NUMBER 2: 1
COMMAND PARAMETER VALUES USED:
TITLE= Sampling
PATH= /user
COUNTER SET= BASIC,PROBLEM-STATE
DURATION= 10 (MINUTES)
BUFCNT= 25 (PAGES/PROCESSOR)
SAMPTYPE= BASIC
SAMPFREQ= 800000 (SAMPLES/MINUTE)
DATALOSS= IGNORE
CNTFILE= NO
MAPJOB= OMVS J* GRS
HISSERV STATUS: ACTIVE
EVENT
AUTHORIZED= BASIC,PROBLEM-STATE,CRYPTO-ACTIVITY,EXTENDED
ENABLED= BASIC,PROBLEM-STATE
SAMPLE
AUTHORIZED= BASIC
ENABLED= BASIC
BUFCNT= 25 (PAGES/PROCESSOR)
SAMPFREQ= 800000 (SAMPLES/MINUTE)
PROFILER
NAME START QUERY SAMPLE S F
HISAPP 2012/12/20 12:59:59 00:15:00:123456 172468 S HIS015I 18.41.33 DISPLAY HIS 201
HIS 0023 IDLE
COMMAND: MODIFY HIS,B,TT=’map-only’,MAPONLY,MAS=(1,EC),MJOB=(J*,GRS)
START TIME: 2007/11/08 13:41:29
END TIME: 2007/11/08 13:41:30
COMPLETION STATUS: NORMAL
FILE PREFIX: SYSHIS20071108.134129
COMMAND PARAMETER VALUES USED:
TITLE= map-only
PATH= .
MAPONLY
MAPASID= 0001 0007 0010 0016 001A 001C 00EC
MAPJOB= J* GRS
HISSERV STATUS: INACTIVE
EVENT
AUTHORIZED= BASIC,PROBLEM-STATE,CRYPTO-ACTIVITY,EXTENDED
ENABLED= NONE
SAMPLE
AUTHORIZED= BASIC
ENABLED= NONE
BUFCNT= 25(PAGES/PROCESSOR)
SAMPFREQ= 800000 (SAMPLES/MINUTE)Example 3: The following D HIS command output shows a counters-only run, to collect only event counter set data, specifying all the counter sets. Note that the DISPLAY command was issued while the data collection was still ongoing.
The
HIS Profiler (the collection started by F hisproc,BEGIN)
and BADEXP are currently exploiting the HISSERV service. Notice how
the BADEXP exploiter queries for counter data every .5 seconds, and
handles sample data in an untimely manner. If hardware event data
collection is degrading system performance, BADEXP might be the reason.HIS015I 19.18.33 DISPLAY HIS 201
HIS 0022 ACTIVE
COMMAND: MODIFY HIS,B,CTRSET=ALL,TITLE=’Counters only’,CTRONLY
START TIME: 2007/11/09 19:17:55
END TIME: ----/--/-- --:--:--
COMPLETION STATUS: --------
FILE PREFIX: SYSHIS20071109.191755
COUNTER VERSION NUMBER 1: 1 COUNTER VERSION NUMBER 2: 1
COMMAND PARAMETER VALUES USED:
TITLE= Counters only
PATH= .
COUNTER SET= BASIC, PROBLEM-STATE, CRYPTO-ACTIVITY, EXTENDED
DURATION= NOLIMIT
CTRONLY
CNTFILE= NO
MAPJOB= J* GRS
HISSERV STATUS: ACTIVE
EVENT
AUTHORIZED= BASIC,PROBLEM-STATE,CRYPTO-ACTIVITY,EXTENDED
ENABLED= BASIC,PROBLEM-STATE,CRYPTO-ACTIVITY,EXTENDED
SAMPLE
AUTHORIZED= BASIC
ENABLED= BASIC
BUFCNT= 4 (PAGES/PROCESSOR)
SAMPFREQ= 800000 (SAMPLES/MINUTE)
PROFILER
NAME START QUERY SAMPLE S F
HISPROF 2012/12/20 12:59:59 00:15:00:123456 ------
BADEXP 2012/12/21 06:00:00 00:00:00:538521 +999999 S