Explanation
This message is issued in response to the DISPLAY
HIS command and displays the status or results of the latest MODIFY hisproc command
issued to start or stop collection of hardware event data. The contents
of the message will vary depending on the parameters issued with the
MODIFY hisproc command.
In
the message text:
- hh.mm.ss
- The time in hours (00-23), minutes (00-59), and seconds (00-59)
for the DISPLAY HIS command.
- hisproc
- The name of the (HIS) catalogued startup procedure.
- hisasid
- The address space ID of HIS.
- status
- The status of HIS, which is one of the following status:
- NOT STARTED
- HIS is not started.
- IDLE
- HIS is waiting for work.
- ACTIVE
- HIS is currently active and working.
- ENDED
- HIS has ended.
- COMMAND: command-data
- The text of the MODIFY hisproc command.
- START TIME: yyyy/mm/dd hh:mm:ss
- yyyy/mm/dd
- The date in year/month/day format when the MODIFY hisproc command
started.
- hh:mm:ss
- The time in hours (00-23): minutes (00-59):seconds (00-59) format
when the MODIFY hisproc command started.
- END TIME: yyyy/mm/dd hh:mm:ss
- yyyy/mm/dd
- The date in year/month/day format when the MODIFY hisproc command
ended. If data collection is still active, the end date will be displayed
as ----/--/--.
- hh:mm:ss
- The time in hours (00-23): minutes (00-59):seconds (00-59) format
when the MODIFY hisproc command ended. If data
collection is still active, the end time will be displayed as --:--:--.
- COMPLETION STATUS: comp-stat
- The command completion status can be:
- NORMAL
- The Modify hisproc command has completed normally.
SMF records and OMVS output files are valid.
- ABNORMAL
- The Modify hisproc command has abnormally ended.
SMF records and OMVS output files might be incomplete and unusable.
- --------
- Data collection is still active. Output files are incomplete.
- FILE PREFIX: fileprefix
- The prefix for all the data collection output files. fileprefix is
in the format SYSHISyyyymmdd.hhmmss.
- LOST SAMPLES: samplostcnt
- SampLostCnt is the cumulative running count
of lost samples on all the processors because of buffer overflow errors.
- COUNTER VERSION NUMBER 1: ctr-vers1
- ctr-vers1 is the version number for the basic
and problem state counter sets that HIS is recording.
Note
that the meaning and the number of counters in a counter set might
change with a new machine model. This counter set version number defines
the contents of the basic and problem-state counter sets that are
installed on the machine. For more information about
these counters for the supported counter version number for each model,
see publications on the Resource Link home page.
- COUNTER VERSION NUMBER 2: ctr-vers2
- ctr-vers2 is the version number for the crypto-activity,
extended and MT-diagnostic counter
sets that HIS is recording.
Note that the meaning
and the number of counters in a counter set might change with a new
machine model.
This counter set version number defines the
contents of the crypto-activity,
extended and MT-diagnostic counter sets that are installed on
the machine. For more information about these counters
for the supported counter version number for each model, see publications
on the Resource Link home page.
- TITLE= title
- title is the text data from the TITLE= parameter
on the MODIFY hisproc command.
- PATH= pathname
- pathname is the name of the path
specified on the PATH= parameter of the MODIFY hisproc command.
- DDNAME= ddname
- ddname is the data definition name specified
on the DDNAME= parameter of the MODIFY hisproc command.
- COUNTER SET= ctrset-values
- ctrset-values displays a list of the counter
sets requested in the MODIFY hisproc command.
- DURATION= duration-value (MINUTES)
- duration-value displays the duration value,
in minutes, of this run of HIS data collection.
- CTRONLY
- Indicates if you specified CTRONLY on the MODIFY hisproc command.
- MAPONLY
- Indicates if you specified MAPONLY on the MODIFY hisproc command.
- BUFCNT= bufcnt | PERSIST |
DEFAULT
- The BUFCNT parameter specified on the MODIFY hisproc command.
- bufcnt
- The value of the BUFCNT parameter in number of 4096-byte pages
per processor.
- PERSIST
- The command specified that the system not change the current buffer
count.
- DEFAULT
- The command did not specify the BUFCNT parameter and the system
is using the default BUFCNT.
- SAMPTYPE= samptype-values |
PERSIST | DEFAULT | NONE
- The status of the sample functions requested in the MODIFY hisproc command.
- samptype-values
- The list of the sample functions requested in the MODIFY hisproc command.
- PERSIST
- The command specified that the system not change the current sample
functions.
- DEFAULT
- The command did not specify the SAMPTYPE and the system is using
the default SAMPTYPE.
- NONE
- No sampling functions will be performed.
- SAMPFREQ= freq | PERSIST |
DEFAULT
- Displays the sample frequency requested on the SAMPFREQ parameter
on the MODIFY hisproc command.
- freq
- The sample frequency requested on the SAMPFREQ parameter on the
MODIFY hisproc command in number of samples per
minute.
- PERSIST
- The command specified that the system not change the current sampling
frequency.
- DEFAULT
- The command did not specify the SAMPFREQ parameter and the system
is using the default SAMPFREQ.
- DATALOSS= datalossact
- datalossact displays the action requested on
the DATALOSS parameter on the MODIFY hisproc command for when data loss occurs during the instrumentation
run. datalossact is one of the following:
- IGNORE
- Ignore the condition and continue with data collection.
- STOP
- End the data collection operation.
- STATECHANGE= statechange
- Displays the action requested in the MODIFY hisproc command
if a significant state change is detected. statechange is
one of the following:
- SAVE
- Save the run data, marking an interval. Start the next interval
for the current run.
- IGNORE
- Continue the current run.
- STOP
- Stop the run at the state change.
- SMFINTVAL= smfintval
- If SYNC, the recording is synchronized with the SMF global recording
interval. Otherwise, the duration of time between SMF record type
113, in minutes. For more information, see the topic on SMF global
recording interval in z/OS MVS System Management Facilities (SMF)z/OS MVS System Management Facilities (SMF).
- CNTFILE= YES|NO
- Indicates whether event counter set data is to be written to the
z/OS UNIX System Services .CNT output files, as requested on the MODIFY hisproc,BEGIN
command.
- YES
- The HIS Profiler writes event counter set data to z/OS UNIX System
Services .CNT output files.
- NO
- The HIS Profiler does not write event counter
set data to z/OS UNIX System Services .CNT output files.
- MAPASID= xxxx
- This field is displayed if you requested load module mapping in
the MODIFY hisproc command. This field displays
one or more address space IDs either from those entered on the MAPASID
parameter or derived from the MAPJOB parameter. The MAPASID parameter
specifies the address space ID for which you needed to collect load
module mapping data.
Note that the job names in the
MAPJOB parameter are converted to address space IDs at the point when
load module mapping data is to be collected, which is at the end of
the data collection. No derived address space IDs are displayed before
this point.
- MAPJOB= zzzz
- This field is displayed if you requested load module mapping in
the MODIFY hisproc command. This field displays
job name values from the MAPJOB parameter for which you needed to
collect load module mapping data.
- HISSERV STATUS: serv-stat
- The value of serv-stat may be:
- ACTIVE
- The HISSERV service is currenlty active.
- INACTIVE
- The HISSERV service is currently inactive.
- EVENT
- The list of active event sets.
- AUTHORIZED=serv-authevntyp-values
- The event types that are currently authorized by the service.
- ENABLED=serv-enabevntyp-values
- The event types that are currently enabled by the service.
- SAMPLE
- The sampling types that are currently active in the HISSERV service.
The value may be:
- AUTHORIZED=serv-authsmptyp-values
- The sampling types that are currently authorized by the service.
- ENABLED=serv-enabsmptyp-values
- The sampling types that are currently enabled by the service.
- BUFCNT:bufcnt
- The number of sampling buffers currently allocated for each CPU.
- SAMPREQ:freq
- The current sampling frequency goal.
- PROFILER
- information describing the profiler.
- NAME prodname
- The external identifier that this profiler uses for itself.
- START yyyy/mm/dd hh:mm:ss
- The date and time this profiler began profiling the system.
- QUERY +hh:mm:ss:uuuuuu
- The average time this profiler waits between querying for counter
data, where hh is hours (00-23) mm is
minutes (00-59) ss is seconds (00-59) and uuuuuu is
microseconds. The + indicates the exploiter averages
over 1 day between counter queries. The greater the number, the less
resource intensive the profiler is to the system.
- SAMPLE +uuuuuu
- The average number of microseconds the profiler takes to handle
a sampling data callback. The + indicates the exploiter
averages over 1 second per callback. The lower the number, the less
resource intensive the exploiter is to the system.
- SAMPLING_PROFILER s
- The sampling state of the profiler. s is one
of the following:
- S
- The profiler requested sampling
- blank
- The profiler did not request sampling
- failed f
- The state of the profiler's callback routine . f is one of the
following:
- F
- The profiler's callback routine has encountered an abend. See
preceding CSV430I messages for diagnostic information.
- blank
- The profiler's callback routine has not abended.
System action
The system continues processing
Operator response
System programmer response
Problem determination
Source
Hardware instrumentation services (HIS)
Module
Routing code
Descriptor code