CICS Runtime Statistics

COBOL-IT provides you a profiling utility to analyze where your COBOL programs are spending time. This utility provides output (in Excel format) about the number of times a paragraph is to be executed, CPU time spent in each paragraph, and the elapsed time spent in each paragraph. ART for CICS integrates this profiling utility into CICS runtime.

Prerequisite

•	The COBOL runtime must be COBOL-IT.

•	Set environment variable KIX_PROFILING to YES. For more information, see KIX_PROFILING.

•	Compile CICS program with compiler flag -fprofiling when using COBOL compiler.

Statistics Data

When each CICS program exits, CICS runtime generates a file named [module]_[PID]_profile.xls. [module] is the CICS program name; [PID] is the process ID of the CICS runtime server in which the program is executed. This file is a tab-separated text file; you can directly open this file with a spreadsheet like Microsoft Excel.

If there are some subprogram calls, XCTL, or LINK commands inside CICS program, CICS runtime can also generate the statistics file for each subprogram or LINKed program.

All statistics files are generated in $APPDIR.

Disabling Profiling Function

There is a possibility of performance reduction for CICS runtime when profiling function is used; therefore, it is highly recommended to disable this profiling function in the productive environment after finishing the statistics analysis.

Do the followings to disable this profiling function.

•	Unset the environment variable KIX_PROFILING.

•	Re-compile the CICS program without setting -fprofiling flag.