This topic lists environment variables relate to the tracing and debugging functionality.
|/F or -F
|Logs the details of CCI API calls to the trace file. The default is OFF, unless any other trace option is specified, in which case it is always ON.
|/P or -P
|Logs the details of protocol-level calls to the trace file. The default is OFF. If this flag is OFF, then only the details of the CCI user-level API will be traced. If this flag is ON, the level of function tracing can be increased.
|/D or -D
|Logs the contents of all buffers passed to and from the CCI functions. The default is OFF. Data tracing might not be allowed if the application has been coded to prohibit data tracing for security reasons.
The CCI.INI file can also be used to control trace options, but any values specified by the CCITRACE environment variable will take precedence.
Specifies additional directives to be used by Character Animator.
COBANIMOPT=directive-list export COBANIMOPT
When you invoke Character Animator, it first reads the directives you have specified in COBANIMOPT and then uses any directives you specify in the command line (which might override some of the directives you set in COBANIMOPT).
COBANIMOPT="MIXEDLANGDEBUG MULTITHREAD" export COBANIMOPT
Identifies which COBOL program a waiting Character Animator process should attach to.
COBANIMSRV=progid export COBANIMSRV
This environment variable is particularly useful for starting cross-session debugging.
In one console session:
myid is now a unique identifier that you can use to match Character Animator to a program. Type the command to start Character Animator:
The Character Animator waits for a COBOL program to start that has a matching identifier. In another console session:
export COBANIMSRV=myid cobrun prog1.int
When prog1.int starts, the unique identifier myid matches that of Character Animator; therefore, Character Animator attaches to this process. In console session 1, the Character Animator main screen is displayed and the cursor placed on the first line of prog1.int.
Specifies the directory that Animator is to search for the information (.idy) file for the program being animated if it is not found in the same directory as the intermediate code (.int) file. Animator can update the information file to record information held between sessions.
COBIDY=pathname export COBIDY
If you use a hyphen, the values you specify are the start and the end of the port range, and the second port number must be greater than the first.
If you specify a comma, the values you specify are the start of the port range and the number of ports available from the start of the range.
ES_DDBG_PORT_RANGE=value export ES_DDBG_PORT_RANGE
The following definition specifies that ports 8001 through 8040 are to be used:
The following definition specifies the same ports but using a different format: