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
>>-CEMT SET STATISTICS--+-----+--+----------+--+-----------+---->
+-ON--+ '-RESETNOW-' '-RECORDNOW-'
'-OFF-'
>--+------------------+--+------------------+------------------><
'-INTERVAL(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
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.