By default, the CCI first failure log file is called
ccierr.log and located in the working directory of the application calling CCI.
To change the name and location, specify the
errlog_path option in a protocol-specific section of the configuration file (e.g.
[ccitcp]) or in the general section (i.e.
[cci]).
There are also other ways to set the location and filename of the log file. A valid setting is searched for in the following
order, and when one is found, subsequent settings are ignored:
- CCIERRLOG environment variable.
- errlog_path setting in a protocol-specific section of
CCI.INI.
- errlog_path setting in the general section of
CCI.INI.
- CCI-Option library routine.
Parameters:
The
errlog_path setting takes the following parameters:
- on/yes
- Sets the level of detail recorded to
FULL (see
filter-type), and uses the default location and log file.
- off/no
- Turns off tracing.
- file-string
- Sets the output location and filename of the log file. If the location is omitted, the application's working folder is used.
If the filename is omitted, the default name of
ccierr.log is used.
Note: If the specified location does not already exist, the log file is not created.
- filter-type
- Sets the level of detail recorded in the log file. One of:
- FULL or
BASEIO - all options; this is the same as
on or
yes.
- INIT - record only session establishment details.
- TERM - record only session termination details.
- INIT_TERM - record session creation and termination details.
- ALL_DATA - record all session data transmissions.
- SENT_DATA - record session transmission of data.
- RECEIVED_DATA - record session receipt of data.
Examples:
The following example records errors to the default file
ccierr.log in the location
c:\ccilogs\ (Windows) or
usr/ccilogs/ (UNIX).
Windows:
errlog_path=yes,c:\ccilogs\
UNIX:
errlog_path=yes,usr/ccilogs/
Note: If you are only specifying a location, ensure the pathname ends with
\ (Windows) or
/ (UNIX).
The following example records all listening and client endpoint startup details, plus any failure messages, to the default
location and filename.
errlog_path=INIT
The following example records the same level of detail as the previous example to the location and filename specified.
Windows:
errlog_path=INIT,c:\ccilogs\initoutput.log
UNIX:
errlog_path=INIT,usr/ccilogs/initoutput.log