CEMT SET STATISTICS

Change statistics attributes.

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

Description

You can use the SET STATISTICS command to change some values that control the accumulation and recording of statistics.

For information about printing statistics using the CICS-supplied utility program DFHSTUP, see Statistics utility program (DFHSTUP).

NEXTTIME cannot be specified on an INQUIRE or SET STATISTICS command, but its value is displayed when INQUIRE STATISTICS is issued. NEXTTIME indicates the time at which statistics will next be recorded and reset. If SET STATISTICS is in the OFF condition, this is at the end of the day. Otherwise, in the ON condition, it is the earlier time of either the next interval to occur, or the end of the day.

Syntax

Press the Clear key to clear the screen. You can start this transaction in two ways:
  • Type CEMT SET STATISTICS (or suitable abbreviations for the keywords). The resulting display lists the current status, similar to that obtained by using the CEMT INQUIRE STATISTICS command. You can tab to the highlighted or blank fields and overtype them with the required values.
  • Type CEMT SET STATISTICS (or suitable abbreviations for the keywords), followed by one or more attribute settings that you want to change. For example, cemt s st on res switches CICS® statistics ON and resets the statistics counters.

Typing ? at the beginning of either the first or second line gives a syntax prompt. Resetting the values takes effect immediately.

CEMT SET STATISTICS

Read syntax diagramSkip visual syntax diagramCEMT SET STATISTICSONOFFRESETNOWRECORDNOWINTERVAL( hhmmss)ENDOFDAY( hhmmss)

Options

ENDOFDAY (hhmmss)
Specifies the end-of-day time for recording statistics. At end-of-day, the current values of the CICS statistics counters are written out to an SMF data set, and the statistics counters are reset.

End-of-day times must be in the range 000000-235959. The default end-of-day time is 12 midnight (000000).

INTERVAL (hhmmss)
Specifies the length of time during which the statistics counters are incremented. At the end of each interval, the accumulated statistics are recorded and the statistics counters are reset.

Interval times must be in the range 000100 - 240000. The default interval value is 010000 (1 hour). These interval settings only take place if you set the statistics recording status to ON. You can set the statistics recording status ON or OFF by using the RECORDING option on this command, or by using the STATRCD system initialization parameter.

The arrival of the end-of-day time always ends the current interval (possibly prematurely) and starts a new interval. Only end-of-day statistics are recorded at the end-of-day time, even if it coincides exactly with the expiry of an interval.

Changing the ENDOFDAY value affects the times at which interval statistics are recorded immediately. New interval expiry times are recalibrated in accordance with the new end-of-day time.

When you change the INTERVAL value or the ENDOFDAY value (and also when CICS is initialized), the length of the current (or first) interval is adjusted so that it expires after an integral number of intervals from the end-of-day time.

These rules are illustrated by the following example, where I indicates an interval recording, INTERVAL is set at 3-hourly intervals, CICS is initialized at 08:15, and E indicates the ENDOFDAY setting at 17:00.

Figure 1. Changing the INTERVAL or ENDOFDAY value
On a time scale marked from 08 to 17, CICS is initialized at 08:15. I indicates interval recording at 11:00 and 14:00, and E indicates end-of-day at 17:00.
Note: In this example, if CICS is initialized earlier, there would be an interval at 08:00.

If you want your end-of-day recordings to cover 24 hours, set INTERVAL to 240000.

OFF
The recording of interval statistics is switched OFF. End-of-day, requested, and unsolicited statistics are always recorded. Counters are still incremented as usual and the recording of end-of-day, requested, and unsolicited statistics is still made. Statistics can be recorded at any time by issuing a CEMT PERFORM STATISTICS command.
ON
The recording of interval statistics is switched ON. Counters are incremented as usual, and are reset at the expiry of each interval and at end-of-day. Statistics can be recorded at any time by issuing a CEMT PERFORM STATISTICS command.
RECORDNOW
The existing statistics are written to an SMF data set. The statistics that are written are those collected since the last ENDOFDAY or INTERVAL collection, or since the last time the RESETNOW function was used in this or the PERFORM STATISTICS command. RECORDNOW RESETNOW only takes effect when the recording status is changed.
Note: RECORDNOW RESETNOW both resets the statistics counter and also writes the existing statistics to an SMF data set. The statistics that are written are those collected since the last ENDOFDAY or INTERVAL collection, or since the last time the RESETNOW function was used in this or the PERFORM STATISTICS command. RECORDNOW RESETNOW only takes effect when the recording status is changed.
RESETNOW
The statistics counters are to be reset. The reset takes effect only if the recording option is changed from OFF to ON, or from ON to OFF. For information about the effect of reset on each individual counter, see the CICS statistics tables in DFHSTUP reports.
The action, for each counter, is one of the following:
  • Not reset
  • Reset to zero
  • Reset to 1
  • Reset to current value (this applies to peak values)
  • An exception to the above.