TRACECONTROL

The optional TRACECONTROL control statement specifies the method that the C\Prof collector will use to control the CICS internal trace using the C\Prof trace control program, TXCCICS1. The invocation method defined by the TRACECONTROL control statement is used by the ACTIVATETRACE and RESETTRACE control statements when collection is started and stopped. The TRACECONTROL control statement is only required when automatic control of the status (STARTED or STOPPED) and size of the CICS internal trace is required. For instructions on how to set up automatic trace control, see Configuring automatic internal trace control for specific CICS regions.

You can configure TRACECONTROL to invoke the C\Prof trace control program using the external CICS interface (EXCI), or through a dedicated transaction that calls the trace control program. For most users, the EXCI method will be preferred as the changes to the CICS internal trace are made immediately as the call is made. This allows the C\Prof collector to start collection faster as it does not need to wait for a transaction to be queued, dispatched, and completed before commencing collection.

These methods are described below.

TRACECONTROL=(EXCI,program[,mirror])

Use the EXCI method to invoke the C\Prof trace control program. This method has the following parameters.

program parameter

The name of the C\Prof trace control program, TXCCICS1. To use this facility, the trace control program must be installed in each CICS region requiring trace control.

mirror parameter

Optional parameter. The name of the mirror transaction that invokes the trace control program. When using this option, consider using a dedicated mirror transaction to provide secured access to the C\Prof trace control program instead of using the default CICS supplied mirror transaction, CSMI. This ensures only authorized C\Prof collectors can invoke trace control.

Example

To instruct C\Prof to use the EXCI invocation method with a mirror transaction of TXCM, use the following control statement:

TRACECONTROL=(EXCI,TXCCICS1,TXCM)

To invoke trace control, add ACTIVATETRACE (see ACTIVATETRACE=(level [,START [,upsize][,recording-mode]) and RESETTRACE (see RESETTRACE=(level [,RESET] | [,STOP | START [,downsize]]) control statements as required.
 

TRACECONTROL=(CONSOLE,transaction[,timeout])

Use a transaction to invoke the C\Prof trace control program. This method has the following parameters.

transaction parameter

The name of the transaction that invokes the C\Prof trace control program TXCCICS1. To use this facility, the transaction and the trace control program must be installed in each CICS region requiring trace control.

timeout parameter

Optional parameter. Specify the number of seconds that the C\Prof collector will wait for the changes to the CICS internal trace to come into effect before abandoning the request. If the transaction is not scheduled and does not complete its adjustments within the time limit then collection does not proceed. A timeout value of 0 indicates no timeout. The maximum timeout value is 300 (seconds). If not specified, the default timeout value is 30 (seconds).

Example

To instruct C\Prof to use the transaction-based method for invoking the C\Prof trace control program using transaction TXC1 with a timeout of 60 seconds, use the following control statement:

TRACECONTROL=(CONSOLE,TXC1,60)

To invoke trace control, add ACTIVATETRACE (see ACTIVATETRACE=(level [,START [,upsize][,recording-mode]) and RESETTRACE (see RESETTRACE=(level [,RESET] | [,STOP | START [,downsize]]) control statements as required.