INQUIRE STATISTICS

Retrieve statistics information.

INQUIRE STATISTICS

end time

end of day mins,secs

int time

interval mins,secs

next time

next time mins,secs

Conditions: NOTAUTH

This command is threadsafe.

For more information about the use of CVDAs, see CICS-value data areas (CVDAs).

Description

The INQUIRE STATISTICS command returns information about the recording of CICS resource and system statistics. CICS records system 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.

There are two formats for each of the time values that you can retrieve with this command (the end-of-day time, the recording interval, and the next time that recording will occur):

A 4-byte packed decimal composite (0hhmmss+), which you obtain by using the ENDOFDAY, INTERVAL, and NEXTTIME options.
Separate hours, minutes, and seconds, which you obtain by specifying the ENDOFDAYHRS, ENDOFDAYMINS, and ENDOFDAYSECS options (instead of ENDOFDAY), INTERVALHRS, INTERVALMINS, and INTERVALSECS (instead of INTERVAL) and NEXTTIMEHRS, NEXTTIMEMINS, and NEXTTIMESECS (instead of NEXTTIME).

The Introduction to CICS statistics contains more detail about CICS statistics, and the description of the SET STATISTICS command describes the relationship between the interval and end-of-day times.

Options

ENDOFDAY(data-area)

returns 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.

ENDOFDAYHRS(data-area)

returns the hours component of the end-of-day time, in fullword binary form.

ENDOFDAYMINS(data-area)

returns the minutes component of the end-of-day time, in fullword binary form.

ENDOFDAYSECS(data-area)

returns the seconds component of the end-of-day time, in fullword binary form.

INTERVAL(data-area)

returns a 4-byte packed decimal field giving the recording interval for system statistics.

INTERVALHRS(data-area)

returns the hours component of the recording interval, in fullword binary form.

INTERVALMINS(data-area)

returns the minutes component of the recording interval, in fullword binary form.

INTERVALSECS(data-area)

returns the seconds component of the recording interval, in fullword binary form.

NEXTTIME(data-area)

returns a 4-byte packed decimal field giving the time at which statistics are recorded next (assuming that the RECORDING switch is not changed from its current value). This is the end-of-day time if RECORDING is currently off, and the earlier of end-of-day and the end of the current interval otherwise.

NEXTTIMEHRS(data-area)

returns the hours component of the next recording time, in fullword binary form.

NEXTTIMEMINS(data-area)

returns the minutes component of the next recording time, in fullword binary format.

NEXTTIMESECS(data-area)

returns the seconds component of the next recording time, in fullword binary format.

RECORDING(cvda)

controls the recording of interval statistics, End-of-day statistics, requested statistics and unsolicited statistics are always recorded, irrespective 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: switches off the recording of interval statistics.
ON: switches on the recording of interval statistics.

Conditions

NOTAUTH

RESP2 values:

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