Hardware instrumentation services (HIS) is a function that collects hardware event data for IBM® System z10™ or later machines.
Before you start the HIS data collection, you may first need to authorize to the sampling facilities and counter set types you want to use through the support element (SE) console. For information about how to set up the authorization of the sampling facilities and counter sets, see Support Element Operations Guide for System z10 machine on the Resource Link home page.
In addition, with the enhanced-monitor facility hardware released with z196 machines, the HIS function expands into a z/OS software event data collector that will be used by IBM for improved problem analysis. The z/OS event counters are viewed as an additional hardware counter set, and there is no authorization required to use the hardware.
The HIS function will not work if your z/OS operating system is running on z/VM.
With HIS, you can either collect instrumentation data in UNIX files and SMF buffers through the HIS profiler, controlled through the F hisproc,BEGIN command, or you can collect instrumentation data dynamically through the HISSERV service. See HISSERV service overview. Both services require Initialization of the HIS address space.
To set up the HIS-started task to RACF, you need to define a profile for it to the RACF generic resource class called STARTED using the RDEFINE command.
//DAEMONS EXEC PGM=IKJEFT01
//SYSTSPRT DD SYSOUT=*
//SYSTSIN DD *
SETROPTS CLASSACT(STARTED)
SETROPTS RACLIST(STARTED)
SETROPTS GENERIC(STARTED)
RDEFINE STARTED HIS.* STDATA(USER(HIS) TRUSTED(YES))
SETROPTS RACLIST(STARTED) REFRESH
SETROPTS GENERIC(STARTED) REFRESH
adduser HIS omvs(uid(25) home('HIS'))
where
UID(25) is the OMVS uid and /HIS is the default home directory.//DAEMONS EXEC PGM=IKJEFT01
//SYSTSPRT DD SYSOUT=*
//SYSTSIN DD *
ADDUSER HIS OMVS(UID(12) HOME('/HIS'))
SETROPTS NOCLASSACT(SECLABEL) NORACLIST(SECLABEL)
ALTGROUP SYS1 OMVS(GID(0))/*
//DAEMONS EXEC PGM=IKJEFT01
//SYSTSPRT DD SYSOUT=*
//SYSTSIN DD *
SETROPTS CLASSACT(STARTED)
SETROPTS RACLIST(STARTED)
SETROPTS GENERIC(STARTED)
RDEFINE STARTED HIS.* STDATA(USER(HIS) TRUSTED(YES))
SETROPTS RACLIST(STARTED) REFRESH
SETROPTS GENERIC(STARTED) REFRESH
ADDUSER HIS OMVS(UID(12) HOME('/HIS'))
SETROPTS NOCLASSACT(SECLABEL) NORACLIST(SECLABEL)
ALTGROUP SYS1 OMVS(GID(0))
/*
omvs
tso omvs
mkdir /HIS
nn,sys(type(113)),intval(01),maxdorm(0100)
Then,
reply nn,U to continue.START hisproc
This
command performs the following actions:Note that it is important to assign a sufficiently high dispatch priority to the instrumentation started task hisproc, so that the task can write sampling data to the .SMP output files in a timely manner.
MODIFY hisproc,BEGIN
This data will be stored in the z/OS UNIX files and SMF
data sets.MODIFY hisproc,BEGIN,CTRONLY,CNTFILE=NO
You can specify in advance the duration of a run of data collection you want by using the DURATION parameter on the F hisproc,BEGIN command.
If you configure a new processor online in a system after you've already issued the F hisproc,BEGIN command to start a data collection run for that system, HIS will enable resources (counters/samplib) for that CPU. The system does not collect data on a processor that is configured offline.
Note that z/OS® IRD processor management can configure processors offline or online automatically. A processor is online at the start of the instrumentation run, but it might be configured offline (and sometimes online again) during the run. The system does not collect data on the offline processor.
See Starting, configuring, and stopping hardware event data collection for complete information about the MODIFY hisproc command.
MODIFY hisproc,END
Alternatively,
you can use the DURATION parameter on the F hisproc,BEGIN command
to specify when you want a data collection run to end. The system writes all the collected data to the z/OS UNIX System Services output files at the path specified and to the SMF data set that is set up by the installation, depending on the parameters provided on the F hisproc,BEGIN command.
You can also use the STOP hisproc command to stop a run of data collection. Note that if you use the STOP command, you must restart the address space again with the START command before starting the next run of data collection.
See Starting, configuring, and stopping hardware event data collection for complete information about the MODIFY hisproc command.