The statistics recording status is set at CICS® startup by the system initialization parameter STATRCD. The end-of-day time is set by the system initialization parameter STATEOD, and the recording interval is set by the system initialization parameter STATINT.
You can modify all these values using the CEMT and EXEC CICS SET STATISTICS command. For details of how to use the CEMT SET STATISTICS command, see CICS Supplied Transactions. For programming information about the equivalent EXEC CICS command, see the CICS System Programming Reference.
The system initialization parameters can be used as follows:
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 the equivalent of the ENDOFDAY option on the CEMT and EXEC CICS SET STATISTICS command, which you can use to modify the value set by STATEOD.
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 the equivalent of the INTERVAL option on the CEMT and EXEC CICS SET STATISTICS command, which you can use to modify the value set by STATINT.
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 as resources are discarded or closed.
On a cold start of a CICS region, interval statistics are recorded by default at three-hourly intervals. All intervals are timed using the end-of-day time (midnight is the default) as a base starting time (not CICS startup time). This means that the default settings give collections at 00.00, 03.00, 06.00, 09.00, and so on, regardless of the time that you start CICS.
You can change the statistics recording status at any time as follows:
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 the CEMT or EXEC CICS PERFORM STATISTICS command. 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 either of the following:
For details of how to use the CEMT PERFORM STATISTICS command, see CICS Supplied Transactions. For programming information about the equivalent EXEC CICS command, see the CICS System Programming Reference.
Job to run the DFHSTUP program gives information about how to use the DFHSTUP program to select and format CICS statistics.