SET STATISTICS

Description

You can use the SET STATISTICS command to change values that control the recording of CICS statistics and to reset the counts.

CICS records system and resource statistics periodically if the RECORDING switch is on, at a frequency governed by the INTERVAL option. These statistics are called interval statistics. At end-of-day time (the ENDOFDAY option), CICS records end-of-day statistics, which are the statistics for the interval since the last resetting, whether or not the switch is on, ensuring that statistics are written at least once a day. Recording occurs on a system management facility (SMF) data set, and the counts are reset after recording.

When CICS is initialized, the length of the first interval is adjusted so that an integral number of intervals remains until end-of-day time. If you change the recording interval, the same adjustment is made to the current interval. The arrival of end-of-day time, whether changed or not, ends the current recording interval. After the statistics are written out, the next interval is adjusted again if necessary, so that the recording interval divides the time remaining to the next end-of-day time evenly.

These rules are illustrated by the following example. I indicates an interval recording and E indicates an end-of-day recording. The system is started cold with STATRCD, the option that sets the initial value for the RECORDING switch, set to ON.

The Introduction to CICS statistics contains more detail about CICS statistics, including the values to which various types of statistics are reinitialized.

Options

ENDOFDAY(data-value)

Specifies the end-of-day time as a 4-byte packed decimal field in the format 0hhmmss+.

End-of-day time is expressed in local time and must be in the range 00:00:00-23:59:59. When you use the ENDOFDAY option, or more than one of the separate end-of-day options, the minutes and the seconds portions each cannot exceed 59. If you use ENDOFDAYMINS alone, the limit is 1439. If you use ENDOFDAYSECS alone, the limit is 86399.

ENDOFDAYHRS(data-value)

Specifies the hours component of the end-of-day time, in fullword binary form. (See the ENDOFDAY option.)

ENDOFDAYMINS(data-value)

Specifies the minutes component of the end-of-day time, in fullword binary form. (See the ENDOFDAY option.)

ENDOFDAYSECS(data-value)

Specifies the seconds component of the end-of-day time, in fullword binary form. (See the ENDOFDAY option.)

INTERVAL(data-value)

Specifies the recording interval for system statistics, as a 4-byte packed decimal field in the format 0hhmmss+. The interval must be at least 1 minute and no more than 24 hours. When you use the INTERVAL option, or more than one of the separate interval options, the minutes and the seconds portions of the time each must not exceed 59. If you use INTERVALMINS alone, the range is 1 - 1440. If you use INTERVALSECS alone, the range is 60 - 86400.

INTERVALHRS(data-value)

Specifies the hours component of the recording interval, in fullword binary form. (See the INTERVAL option.)

INTERVALMINS(data-value)

Specifies the minutes component of the recording interval, in fullword binary form. (See the INTERVAL option.)

INTERVALSECS(data-value)

Specifies the seconds component of the recording interval, in fullword binary form. (See the INTERVAL option.)

RECORDING(cvda)

Specifies whether to record the interval statistics. End-of-day statistics, requested statistics, and unsolicited statistics are always recorded, irrespective of the setting of the RECORDING option. (Statistics are always accumulated, and end-of-day, unsolicited, and requested statistics always recorded, regardless of the setting of the RECORDING option. Unsolicited statistics are resource statistics, recorded when the resource is discarded. Requested statistics are those called for by a PERFORM STATISTICS RECORD command, or by a CEMT PERFORM STATISTICS transaction.)

CVDA values are:

OFF

Do not record interval statistics.

ON

Record interval statistics.

RECORDNOW

Specifies that the current statistics are written out immediately. The effect is the same as a PERFORM STATISTICS RECORD ALL command and, as in the case of that command, the counts are not reset unless you specify RESETNOW as well. RECORDNOW can be specified only when the RECORDING status is changed from ON to OFF, or from OFF to ON.

RESETNOW

Specifies that the statistics counters are reset to their initial values. The initial value for a given counter depends on the type of statistic being collected; see CICS statistics in DSECTs and DFHSTUP report for specific information. The reset can be requested only when the RECORDING status is changed from ON to OFF, or from OFF to ON.

Conditions

INVREQ

RESP2 values:

1

The INTERVAL value is out of range.

2

The ENDOFDAY value is out of range.

3

RECORDING has an invalid CVDA value.

4

The INTERVALHRS value is out of range.

5

The INTERVALMINS value is out of range.

6

The INTERVALSECS value is out of range.

7

More than one of the interval values has been used and the combination either exceeds 24 hours or is less than 1 minute.

8

The ENDOFDAYHRS value is out of range.

9

The ENDOFDAYMINS value is out of range.

10

The ENDOFDAYSECS value is out of range.

11

RESETNOW or RECORDNOW has been specified, but the RECORDING value has not been changed.

NOTAUTH

RESP2 values:

100

The user associated with the issuing task is not authorized to use this command.