Displaying hardware event data collection status

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.

 
D HIS[,L=a|name|name-a]

The parameters are:

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.

The data collection was not complete when the D HIS command was issued, so the system had not yet converted the MAPJOB job names to MAPASID values at the time when DISPLAY command was issued, which results in the MAPASID values not being displayed in the output: Start of change

HIS015I 10.19.12 DISPLAY HIS 241 
HIS      001E ACTIVE                                                 
COMMAND: MODIFY HIS,B,TT='Sampling',BUF=25,PATH='/user',MJOB=(OMVS,J*,GRS)
START TIME:  2014/10/27 10:19:08                                     
END TIME:    ----/--/-- --:--:--                                     
COMPLETION STATUS: --------                                          
FILE PREFIX: SYSHIS20141027.101908.                                  
LOST SAMPLES: 0                                                      
COUNTER VERSION NUMBER 1: 1   COUNTER VERSION NUMBER 2: 3            
COMMAND PARAMETER VALUES USED:                                       
 TITLE=  Sampling                                                    
 PATH=   /user                                                       
 DURATION= 10 (MINUTES)                                              
 DATALOSS= IGNORE                                                    
 STATECHANGE= SAVE                                                   
 SMP= YES                                                            
  BUFCNT=   25 (PAGES/PROCESSOR)                                     
  SAMPTYPE= DEFAULT                                                  
  SAMPFREQ= DEFAULT                                                  
 CNT= YES                                                            
  COUNTER SET= BASIC,PROBLEM-STATE                                   
  CNTINTVAL= 15 (MINUTES)                                            
  CNTFILE= YES                                                       
 MAP= YES                                                            
  MAPJOB=  OMVS     J*       GRS                                     
HISSERV STATUS: ACTIVE                                               
 EVENT                                                               
  AUTHORIZED= BASIC,PROBLEM-STATE,CRYPTO-ACTIVITY,EXTENDED,ZOS       
  ENABLED= BASIC,PROBLEM-STATE                                       
 SAMPLE                                                              
  AUTHORIZED= BASIC                                                  
  ENABLED= BASIC                                                     
  BUFCNT=   25 (PAGES/PROCESSOR)                                     
  SAMPFREQ= 800000 (SAMPLES/MINUTE)                                  
 PROFILER                                                            
  NAME      START                 QUERY             SAMPLE  S F      
  HISPROF   2014/10/27 10:19:08   00:00:00.000017   ------  S

Example 2: In the second example, the DISPLAY command was issued after a hardware event data collection run that specified MAPONLY as well as MAPASID and MAPJOBs. There are no HISSERV exploiters at the time the DISPLAY command was issued. Start of change

HIS015I 10.40.43 DISPLAY HIS 381                                    
HIS      0030 IDLE                                                  
COMMAND: MODIFY HIS,B,TT='map-only',MAPONLY,MAS=(1,EC),MJOB=(J*,GRS)
START TIME:  2014/10/27 10:40:38                                    
END TIME:    ----/--/-- --:--:--                                    
COMPLETION STATUS: --------                                         
FILE PREFIX: SYSHIS20141027.104038.                                 
COMMAND PARAMETER VALUES USED:                                      
 TITLE=  map-only                                                   
 PATH=   .                                                          
 DURATION= NOLIMIT                                                  
 DATALOSS= IGNORE                                                   
 STATECHANGE= SAVE                                                  
 SMP= NO                                                            
 CNT= NO                                                            
 MAP= YES                                                           
  MAPASID=    1   EC   12   14   1D   2A    7                       
  MAPJOB=  J*       GRS                                             
HISSERV STATUS: INACTIVE                                            
 EVENT                                                              
  AUTHORIZED= BASIC,PROBLEM-STATE,CRYPTO-ACTIVITY,EXTENDED,ZOS      
  ENABLED= NONE                                                     
 SAMPLE                                                             
  AUTHORIZED= BASIC                                                 
  ENABLED= NONE                                                     
  BUFCNT=    9 (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. Start of change

HIS015I 10.42.54 DISPLAY HIS 394 
HIS      0030 ACTIVE                                            
COMMAND: MODIFY HIS,B,CNTSET=ALL,TITLE='Counters only',CNTONLY  
START TIME:  2014/10/27 10:42:50                                
END TIME:    ----/--/-- --:--:--                                
COMPLETION STATUS: --------                                     
FILE PREFIX: SYSHIS20141027.104250.                             
COUNTER VERSION NUMBER 1: 1   COUNTER VERSION NUMBER 2: 3       
COMMAND PARAMETER VALUES USED:                                  
 TITLE=  Counters only                                          
 PATH=   .                                                      
 DURATION= NOLIMIT                                              
 DATALOSS= IGNORE                                               
 STATECHANGE= SAVE                                              
 SMP= NO                                                        
 CNT= YES                                                       
  COUNTER SET= BASIC,PROBLEM-STATE,CRYPTO-ACTIVITY,EXTENDED     
  CNTINTVAL= 15 (MINUTES)                                       
  CNTFILE= YES                                                  
 MAP= NO                                                        
HISSERV STATUS: ACTIVE                                          
 EVENT                                                          
  AUTHORIZED= BASIC,PROBLEM-STATE,CRYPTO-ACTIVITY,EXTENDED,ZOS  
  ENABLED= BASIC,PROBLEM-STATE,CRYPTO-ACTIVITY,EXTENDED         
 SAMPLE                                                         
  AUTHORIZED= BASIC                                             
  ENABLED= NONE                                                 
  BUFCNT=    9 (PAGES/PROCESSOR)                                
  SAMPFREQ= 800000 (SAMPLES/MINUTE)                             
 PROFILER                                                       
  NAME      START                 QUERY             SAMPLE  S F 
  HISPROF   2014/10/27 10:42:50   00:00:00.000016   ------      
  BADEXP    2014/10/27 06:00:00   00:00:00:538521  +999999 S

For more information about HIS015I, see z/OS MVS System Messages, Vol 6 (GOS-IEA).