ZOC Online Help Topic:

Session Profiles → Logging

This window is used to define file logging parameters.

       
Logfile name
 

The name defined here will be used as filename for the logfile. The name can contain absolute or relative folder paths (folders in the path, especially when containing placeholders, will be created as necessary).

It is also possible to create dynamic names and folders by using placeholders for date and time, which will be substituted with their respective values when the log is opened (see placeholder codes in the appendix). Examples are ^+_^1^2^3.log or Host_^+\Log_^3_^2_^1.log (the latter is a logfile in a dynamically created subfolder).

Note: Unless you supply an absolute path with the logfile name, the file will be placed in the log directory which is configured in Options→Program Settings→Folders.

If logfile exists:
 

If a logfile already exists, it can be overwritten (Overwrite file), or the new data can be appended (Append data to file). As an alternative the filename can be incremented (Increment filename) to make sure that no existing logfile will be overwritten.

Logging is now active
 

Enable saving incoming data in the logfile. This function is identical to setting checkmark near the logfile name in the status bar or to using the Log to File entry in the Logging menu.

Create a new logfile when the date or hour-placeholders change
 

If this option is active and if the filename for the logfile contains placeholders for year, month, day or hour, ZOC will create a new logfile as soon as a new day/hour/etc. begins.

Add time markers to each line
 

This option will insert time stamps before each line of the log. The time stamps will indicate, when exactly the data was received. A marker looks like [2026-10-05 16:47:58.2].

Include date in time markers
 

When time markers are enabled, this option includes the date in the marker, as in the example above. Without it, only the time is written.

Log session headers
 

Session headers are a few lines of extra information in the log. They contain information about when a session starts, which host you connected to etc.

Discard emulation control codes from log
 

Cursor placement, colors and other screen controls for terminal emulations are performed by adding invisible control codes to the data. This option controls, if these codes should be added to the logfile or not (normally they are of little interest to the end user).

Use large buffers when writing to logfile
 

This option improves performance when writing the logfile. ZOC collects more data in memory before writing it to the file.

DC2/DC4 control
 

Some hosts are able to remotely suspend/resume logging by sending DC2 (^R) and DC4 (^T) characters (the checkmark in the status line will turn gray if the host suspends logging for you). This option enables/disables the ability of the host to control the logging.

Show Logfiles…
 

Opens the logfiles folder. This is the same as Show Logfiles Folder in the Logging menu.

 

See also: Session Profiles, Customizing ZOC and Options Menu

 
← Back to Session Profiles