CLI uses these environment variables to decide whether to collect any CLI trace.
- Minimal tracing without parcel dumps
- Tracing with parcel dumps
- Tracing on a thread basis (Windows platforms only)
COPANOMLOG
COPANOMLOG should be set to the file name in which the user intends to collect the trace. On Windows platforms, the trace file name provided in the COPANOMLOG is appended with a .txt extension.
- Unix
my_copalog, my_copalog_0001, my_copalog_0002, my_copalog_0003
- Windows
my_copalog.txt, my_copalog_0001.txt, my_copalog_0002.txt, my_copalog_0003.txt
The COPANOMLOG_SIZE environment variable can change the maximum size of copanomlog. Most operating systems support files up to 2 GB.
NETRACE
- NETRACE = 0: (or environment variable not set) incoming/outgoing parcel dumps are disabled, only minimal tracing enabled.
- NETRACE = 1: incoming/outgoing parcel dumps are enabled. This is the most detailed logging option.
- NETRACE = 3: incoming/outgoing parcel dumps are enabled, timestamps are disabled.
- NETRACE = 5, 9, 17, etc. reserved for future options.
THREADLOGGING
- Windows:
- c:\temp\coplog.3fc0.txt
- c:\temp\coplog.3fc1.txt
- c:\temp\coplog.3fc2.txt
where 3fc0, 3fc1, and 3fc2 are thread IDs.
- Non-Windows:
- c:\temp\coplog.3fc0.23fc
- c:\temp\coplog.3fc1.23fc
- c:\temp\coplog.3fc2.23fc
where 3fc0, 3fc1, and 3fc2 are thread IDs, and 23fc is a process ID.
If data encryption is enabled by applications for a request, then request and response messages printed for that particular request in the trace will be encrypted.
On Windows platforms, the COPANOMLOG file names contain thread IDs. On Non-Windows platforms, the COPANOMLOG file names contain a thread ID and a process ID.
- Windows:
- c:\temp\coplog.3fc0.txt
- c:\temp\coplog.3fc0_0001.txt
- c:\temp\coplog.3fc0_0002.txt
- c:\temp\coplog.3fc0_0003.txt
where 3fc0 is a thread ID.
- Non-Windows:
- c:\temp\coplog.3fc0.23fc
- c:\temp\coplog.3fc0.23fc_0001
- c:\temp\coplog.3fc0.23fc_0002
- c:\temp\coplog.3fc0.23fc_0003
where 3fc0 is a thread ID, and 23fc is a process ID.
THREADONOFF Variable
The environment variable THREADONOFF turns multithreaded support on or off on UNIX and Linux platforms. Setting the variable to 1 turns on multithreaded support; 0 turns it off. Values other than 1 or 0 have no effect. The default value on UNIX and Linux is 0, that is, multithreaded support is turned off.