CICS Statistics

CICS statistics are counters that show how CICS resources are being used. They help you see trends, plan capacity, and confirm that tuning changes worked.

What statistics cover

• Statistics are kept for files, programs, transactions, terminals, storage, journals, connections, and more.
• Each counter shows things like number of requests, waits, errors, and peak usage.
• Statistics are written to SMF, usually type 110 subtype 2, so batch jobs can print and analyze them.

Types of statistics

• Interval statistics are written automatically every few minutes or hours. The interval is set by the SIT parameter.
• End-of-day statistics are written when CICS shuts down normally.
• Requested statistics are written when you ask for them, with CEMT PERFORM STATISTICS or EXEC CICS PERFORM STATISTICS.
• Unsolicited statistics are written when a resource is deleted or when a threshold is reached.

Reading statistics

• Use CEMT INQUIRE STATISTICS to see what statistics collection is active.
• Use the DFHSTUP batch utility to print statistics from the SMF dataset in readable form.
• Compare statistics before and after a tuning change to prove the change helped.
• Watch trends over weeks. A steady rise in file waits or storage use warns you before users complain.

Example: requesting statistics from a program

• A program can ask CICS to write statistics immediately instead of waiting for the next interval.
• PROCEDURE DIVISION. EXEC CICS PERFORM STATISTICS RECORD(RECORDTYPE(STATISTICS)) END-EXEC.
• This writes the current statistics counters to SMF at once.
• Use it in a test region to capture numbers around a specific test run.