Control statement summary

Each collection mode is configured using control statements. A summary of each control statement can be found below, organized by the collection functions to which they relate. These collection functions are described as follows:*

Profiling

Record from the CICS internal trace for transaction profiling. Use either SERVER or RECORD FOR PROFILING collection modes to invoke this function.
Snap

Take a back-in-time snapshot of the CICS internal trace. Use the SERVER, SNAP, or RECORD FOR PROFILING collection modes to invoke this function.
AUXTRACE

Record from the CICS internal trace to an auxiliary trace data sets. Use the SERVER or RECORD TO AUXTRACE collection modes to invoke this function.
Import

Import auxiliary trace data sets into the C\Prof transaction profiler. Use the IMPORT collection mode to invoke this function.

A control statement may fall into one of the following categories, depending on the collection mode you have selected:

N/A

The control statement is not applicable to this collection mode. If the control statement is supplied in the configuration file, it may be ignored.
Required

The control statement must be supplied when using this mode. C\Prof will not work unless you specify this control statement in your configuration.
Optional

The control statement is not required, but may be used to enable certain features or further define the behavior of the collector.

More information for each control statement can be found on its associated reference page.

Managing archive and auxiliary trace data sets

Summary of C\Prof control statements for collector and utility program TXCMAIN used to manage archive and auxiliary trace data sets

Control statement	Description	Profiling	Snap	AUXTRACE	Import
CHECKPT=data-set-name	Register data set created by C\Prof in a checkpoint data set	Required	Optional	Optional	Required
ARCHDSN=pattern	Define a naming pattern for data sets created by C\Prof	Required	Optional	Optional	Required
AUXTRSW=option	Set creation and switching mode for auxiliary trace data sets	N/A	Optional	Required	N/A
+PREFIX=data-set-name-prefix	Set a data set naming prefix	Optional	Optional	Optional	Optional
SUMMARY	Define allocation attributes for dynamically allocated summary archive data sets	Required	N/A	N/A	Required
DETAIL	Define allocation attributes for dynamically allocated detail archive data sets	Required	N/A	N/A	Required
AUXILIARY	Define allocation attributes for dynamically allocated auxiliary trace data sets	N/A	Optional	Optional	N/A
OUTDD=ddname-pattern	Direct trace output to static auxiliary trace data set(s)	N/A	Optional	Optional	N/A
BLKSIZE=value	Set block size for new auxiliary trace data sets	N/A	Optional	Optional	N/A
INDD=pattern	Define input auxiliary trace data sets for import into the transaction profiler	N/A	N/A	N/A	Required

Define CICS regions and assign groups

Summary of C\Prof control statements for collector and utility program TXCMAIN used to define CICS regions and assign groups

Control statement	Description	Profiling	Snap	AUXTRACE	Import
CICS=jobname	Work with the specified CICS region	Required	Optional¹	Required	N/A
GROUP=name and GROUPEND	Group a set of CICS regions	Optional	N/A	Optional	Optional

Note 1: You can perform a snapshot on any CICS region using MVS system commands, even if that region is not defined in the collector configuration file.

Processing client requests

Summary of C\Prof control statements for collector and utility program TXCMAIN used for client request processing

Control statement	Description	Profiling	Snap	AUXTRACE	Import
SOCKET=zFS-path	Create a socket for ISPF user collection requests (option 1 Regions)	Optional	Optional	Optional	N/A
XCFGROUP=group-name	Assign the collector to an XCF group to connect it to a collection topology that may be spread across multiple collectors and LPARs	Optional	Optional	Optional	N/A

Collector startup and shutdown

Summary of C\Prof control statements for collector and utility program TXCMAIN used for collector startup and shutdown

Control statement	Description	Profiling	Snap	AUXTRACE	Import
SERVICE=service-class-name	Assign the collector a service class	Optional	Optional	Optional	Optional
LIMIT=value units	Shut down the collector after the specified time limit	Optional	N/A	Optional	N/A

Level of detail for profiling

Summary of C\Prof control statements for collector and utility program TXCMAIN used for setting the level of trace detail to capture

Control statement	Description	Profiling	Snap	AUXTRACE	Import
LEVEL=value	Set the level of trace detail to capture	Optional	N/A	N/A	Optional
SIZE=value	Set the maximum size of a transaction before it is flushed	Optional	N/A	N/A	Optional

Internal trace data collection and control

Summary of C\Prof control statements for collector and utility program TXCMAIN used for controlling the CICS internal trace

Control statement	Description	Profiling	Snap	AUXTRACE	Import
TRACECONTROL	Define the method for accessing the C\Prof trace control program	Optional	N/A	Optional	N/A
ACTIVATETRACE=(level [,START [,upsize][,recording-mode])	Configure the CICS internal trace before recording starts	Optional²	N/A	Optional	N/A
RESETTRACE=(level [,RESET] or [,STOP or START [,downsize])	Reset the CICS internal trace configuration when collection ends	Optional	N/A	Optional	N/A
STNTRxx=level	Activate additional trace domains for greater detail	Optional	N/A	Optional	N/A

Note 2: For a complete application perspective of the trace, you must at least set the trace points that are configured by the ACTIVATETRACE=1 control statement.

Filtering

Summary of C\Prof control statements for collector and utility program TXCMAIN used for filtering data collected from the CICS internal trace

Control statement	Description	Profiling	Snap	AUXTRACE	Import
TRAN=(name1,name2,...)	Filter transactions by ID	Optional	N/A	N/A	Optional
EXCLUDETRAN=(name1,name2,...)	Exclude specified transactions	Optional	N/A	N/A	Optional
PROGRAM=(name1,name1,...)	Filter transactions by the programs is uses	Optional	N/A	N/A	Optional
RESPONSE=(minimum,maximum)	Filter transactions by response time	Optional	N/A	N/A	Optional
ABEND=option	Filter transactions by abend	Optional	N/A	N/A	Optional