![]() |
CSTATRACE_MAX_FILE_INDEX - This environment variable controls the number of TSAPI trace files that will be created.
Each time the trace file reaches its maximum size (see CSTATRACE_MAX_FILE_SIZE, described below), the trace file will roll over. This means that if messages are being logged to file cstatrace, then the first time the trace file rolls over, that file is renamed as cstatrace.1 and a new cstatrace file is created to receive additional log output.
The file cstatrace.n is removed.
Any trace files (cstatrace.1, cstatrace.2, ..., cstatrace.n-1) that exist are renamed as (cstatrace.2, cstatrace.3, ..., cstatrace.n).
The file cstatrace is renamed cstatrace.1.
A new cstatrace file is created to receive additional log output.
In effect, the number of TSAPI trace files that may be created is limited to CSTATRACE_MAX_FILE_INDEX + 1.
Valid values for CSTATRACE_MAX_FILE_INDEX are 1-9. If CSTATRACE_MAX_FILE_SIZE is set but CSTATRACE_MAX_FILE_INDEX is not set, then CSTATRACE_MAX_FILE_INDEX defaults to 9.
CSTATRACE_MAX_FILE_SIZE - This environment variable controls the maximum size of each TSAPI trace file.
Valid values for CSTATRACE_MAX_FILE_SIZE are 1-10000 (MB). If CSTATRACE_MAX_FILE_INDEX is set but CSTATRACE_MAX_FILE_SIZE is not set, then CSTATRACE_MAX_FILE_SIZE defaults to 10 (MB).
When neither CSTATRACE_MAX_FILE_INDEX nor CSTATRACE_MAX_FILE_SIZE is set, then messages will be logged to a single file that grows without bound. Use caution when collecting TSAPI trace messages this way to avoid using excessive disk space.
Also, note that the TSAPI Message Tracing feature is provided for troubleshooting purposes only. Enabling this feature will degrade the performance of the TSAPI Linux client library.