The AUXTRSW control statement controls the creation and switching method for writing to auxiliary trace data sets. These options are divided into the following modes:
-
dynamic mode option ARCHIVE which instructs C\Prof to dynamically allocate new data sets. This option can be used when recording for profiling or for snap requests.
-
static mode options NO, NEXT, and ALL that use pre-defined data sets specified in your JCL. These static mode options only apply when recording to auxiliary trace data sets. You cannot use these options for snap requests.
Dynamic mode
The ARCHIVE option instructs C\Prof to dynamically allocate new data sets as required. Use AUXTRSW=ARCHIVE in combination with the AUXILIARY control statement to specify the allocation attributes of new data sets, including disk space size. More information on the AUXILIARY control statement can be found in SUMMARY, DETAIL, and AUXILIARY. You can use the ARCHIVE option when recording to auxiliary trace data sets, or for snap requests.
When collecting in dynamic mode, the CHECKPT control statement can also be used to register the data sets created by C\Prof. When used in combination with the RETPD option on the AUXILIARY control statement, you can use the C\Prof housekeeping feature to perform cleanup of old data sets. For more information on housekeeping, see Cleaning up old collection data via housekeeping.
Static mode
The AUXTRSW static mode options operate in a similar way to the CICS AUXTRSW system initialization parameter used by the CICS auxiliary trace facility. When recording to auxiliary trace data sets in static mode, the auxiliary trace data sets must be supplied in the JCL and referred to by a DD name pattern specified in the OUTDD control statement directly after the associated CICS control statement. AUXTRSW static mode options can only be applied when recording to auxiliary trace data sets. You cannot use these options for snap requests.
The following static mode options may be used in the AUXTRSW control statement:
C\Prof AUXTRSW options for static mode recording to auxiliary trace data sets
Option | Description |
---|---|
NO | Do not automatically switch to a new data set. When this option is set, C\Prof will write to the data set that matches the DD name specified in the OUTDD parameter. If the data set becomes full, collection will stop. No other data sets will be written. |
NEXT | Switch to the next data set when the previous data set becomes full until there are no more empty data sets. When this option is set, C\Prof will write to the first data set found using the DD name pattern specified in the OUTDD control statement. When the data set becomes full, the collector will move to the next listed data set that matches the name pattern. When all the data sets are full, collection will stop. Each data set is written to only once. |
ALL | Switch to the next data set when the previous data set becomes full. When there are no more empty data sets, restart at the first data set and overwrite. When this option is set, C\Prof will write to the first data set found using the DD name pattern specified in the OUTDD control statement. When the data set becomes full, the collector will move to the next data set that matches the name pattern. When all the data sets are full, the collector will return to the first data set and overwrite it. This process continues until collection is stopped. |
Note: The maximum number of auxiliary trace data sets that may be used in static mode for each CICS region is 32.