HIS015I   hh.mm.ss DISPLAY HIS text

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.

hisproc  hisasid statusn 
COMMAND: MODIFY command-data
START TIME: yyyy/mm/dd hh:mm:ss 
END TIME:   yyyy/mm/dd hh:mm:ss 
COMPLETION STATUS: comp-stat
FILE PREFIX: fileprefix
LOST SAMPLES: samplostcnt
COUNTER VERSION NUMBER 1: ctr-vers1 
COUNTER VERSION NUMBER 2: ctr-vers2
COMMAND PARAMETER VALUES USED:  
 TITLE=  title     
 PATH=   pathname
 DDNAME= ddname
 DURATION= duration-value (MINUTES)
 DATALOSS= datalossact
 STATECHANGE= statechange
 SMP=YES|NO
       BUFCNT= bufcnt (PAGES/PROCESSOR) | PERSIST | DEFAULT
       SAMPTYPE= samptype-values  | PERSIST | DEFAULT | NONE
       SAMPFREQ= freq (SAMPLES/MINUTE) | PERSIST | DEFAULT 
 CNT=YES|NO
       COUNTER SET= ctrset-values
       CNTINTVAL= cntintval
       CNTFILE=YES|NO
 MAP=YES|NO
       MAPASID= xxxx
       MAPJOB=  zzzz
HISSERV STATUS: serv-stat
 EVENT
  AUTHORIZED=serv-authevntyp-values
             serv-authevntyp-values
  ENABLED=serv-enabevntyp-values
          serv-enabevntyp-values
 SAMPLE
  AUTHORIZED=serv-authsmptyp-values
  ENABLED=serv-enabsmptyp-values
  BUFCNT= serv-bufcnt(PAGES/PROCESSOR) 
  SAMPFREQ= serv-freq(SAMPLES/MINUTE)
PROFILER 
  NAME      START                 QUERY             SAMPLE   S F
  yyyyyyyy  yyyy/mm/dd hh:mm:ss  +hh:mm:ss:uuuuuu  +uuuuuu   s f

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.

DURATION= duration-value (MINUTES)

duration-value displays the duration value, in minutes, of this run of HIS data collection.

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.

SMP=YES|NO

Displays whether sampling was requested on the MODIFY hisproc,BEGIN command.

YES

The HIS Profiler is collecting sampling data.

NO

The HIS Profiler is not collecting sampling data.

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.

CNT=YES|NO

Displays whether counter data was requested on the MODIFY hisproc,BEGIN command.

YES

The HIS Profiler is collecting event counter set data.

NO

The HIS Profiler is not collecting event counter set data.

COUNTER SET= ctrset-values

ctrset-values displays a list of the counter sets requested in the MODIFY hisproc command.

CNTINTVAL= cntintval

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

Displays 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.

MAP=YES|NO

Displays whether map data was requested on the MODIFY hisproc,BEGIN command.

YES

The HIS Profiler is producing map data.

NO

The HIS Profiler is not producing map data.

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.