Setting the statistics recording status, end-of-day time and recording interval

The statistics recording status is set at CICS® startup by the STATRCD system initialization parameter. The end-of-day time is set by the STATEOD system initialization parameter, and the recording interval is set by the STATINT system initialization parameter.

About this task

You can modify all these values by using CEMT SET STATISTICS or the SET STATISTICS command. See CEMT SET STATISTICS and SET STATISTICS.

In the CICS Explorer®, the Regions view provides a functional equivalent to this command.

The system initialization parameters can be used as follows:

STATEOD

Specifies the end-of-day time in the format hhmmss. The default is 0, which is midnight.

End-of-day time is expressed in local time and must be in the range 00:00:00-23:59:59. That is, the hh value cannot exceed 23, and the mm and ss values can be specified in the range 00 to 59. If you leave out leading zeros, the DFHSIT macro inserts them. For example, 100 becomes 000100; that is, 1 minute 00 seconds past midnight.

This system initialization parameter is equivalent to the ENDOFDAY option on the CEMT SET STATISTICS and the SET STATISTICS command. You can use this option to modify the value set by STATEOD.

STATINT

Specifies the recording interval for system statistics in the format hhmmss. The default is 1 hour.

The interval must be at least one minute and cannot be more than 24 hours. The minutes and seconds part of the value can be specified in the range 00 to 59. If you leave out leading zeros, the DFHSIT macro inserts them. For example, 3000 becomes 003000; that is, an interval of 30 minutes.

This system initialization parameter is equivalent to the INTERVAL option on the CEMT SET STATISTICS and the SET STATISTICS command. You can use this option to modify the value set by STATINT.

STATRCD

Specifies whether interval statistics are collected. Values can be as follows:

OFF (default): Interval statistics are not collected.
End-of-day, unsolicited, and requested statistics are written to SMF regardless of the STATRCD setting. End-of-day statistics are collected at the logical end of day and on shutdown. Unsolicited statistics are written to SMF when resources are discarded or closed.
ON: Interval statistics are collected.
On a cold start of a CICS region, interval statistics are recorded by default at hourly intervals. All intervals are timed using the end-of-day time as a base starting time (not CICS startup time). The default end-of-day time is midnight, so the default settings result in collections at 00.00, 01.00, 02.00, 03.00, and so on, regardless of the time that you start CICS.

You can change the statistics recording status at any time in the following ways:

During a warm or emergency restart, by coding the STATRCD system initialization parameter.
While CICS is running, by using CEMT SET STATISTICS or the SET STATISTICS command.

Whatever the value of the STATRCD system initialization parameter, you can ask for requested statistics and requested reset statistics to be collected. You can get statistics on demand for all, or for specified, resource types by using CEMT PERFORM STATISTICS or the PERFORM STATISTICS command. See CEMT PERFORM STATISTICS and PERFORM STATISTICS.

The period covered for statistics requested in this way is from the last reset time up to the time that you issue the PERFORM STATISTICS command. The last reset time is one of the following:

The beginning of the current interval.
The logical end-of-day collection time.
The time that you last issued a SET or PERFORM STATISTICS command specifying the RESETNOW option.

Job to run the DFHSTUP program gives information about how to use the DFHSTUP program to select and format CICS statistics.