Function Keys

The list of trace options and corresponding function keys is as follows:

F1select summary screen
F2select trace screen
F3 select scrollback screen
F4Trace to display
F5Trace to file
F6Function entry/exit tracing
F7Thread tracing
F8IIF action tracing
F9Processing State tracing
F10Hardware Operations tracing
F11Temporary debugging messages
F12Outbound queue search tracing

DLL Address Display

If you press the 'D' key, a window will be displayed showing the load addresses of all the Copia and system DLLs in use by the COPIAFACTS program. You may be asked to do this by Copia support staff if problems are detected in one of the loaded DLLs. If the display is blank, this will usually be because PSAPI.DLL is not in your SYSTEM32 folder.

System License Information

The 'I' key displays a summary of system license information in the trace file or trace display.

Thread Utilization

The 'R' key places a snapshot of the CPU utilization of each thread in the registry at HKCU/Copia/CPU_Limit.  This is intended to assist Copia support staff in debugging thread issues. If you use the 'T' key, the snapshot is also written to FFTRACE, if running with COPIAFACTS selected under File/Applications.  It is not written to the engine trace file (.TRx) in case the issue being investigated is a problem associated with the trace file.

Handle Utilization

Pressing Control-H displays a count of the Windows handles in use by the process, and how it has changed since the program completed initialization.

Outbound Queue Statistics

The 'S' key (when the Summary or Trace tab is active) opens a window showing statistics about the scanning of the TOSEND folders.  This information can be used to tune the scheduling of TOSEND queue priorities, and in a multiple-node system may help to schedule work between different nodes. You can select bar-charts of three types:

An analysis of the time spent scanning in each folder, in seconds

A summary across all folders, showing items processed in green, items discarded without having to open the FS in yellow, and items discarded after opening the FS in red.

An analysis for each TOSEND folder of the outcomes of scanning.  These bar-charts show counts in the following categories:

Process: FS files assigned to a line/thread for processing (including the for processing of errors).

Pre-process: items moved to PREPROC for external processing, or for which an external pre-process was spawned.

Not Ready: FS files found with a future datestamp and not opened.

Suspended: FS files identified by their FS number as part of a suspended job, and not opened.

Active: FS files found to be active on this or another node, and not opened.

Error: FS files discarded after opening because an error or misconfiguration prevented assignment to a line.

Domain Limit: FS files discarded after failing a domain limit check.

Phone Mask: FS files discarded after matching an exclusion phone mask.

Busy Phone:  FS files discarded after failing on a self-busy check.

Suspended:  FS files discarded after checking the job status.

Send Time: FS files discarded after checking the fax send time, and being written back with a future timestamp.

No Line: FS files which could not be processed for lack of a suitable free line/thread to handle them, but without a $fax_send_line restriction.

Send Line: FS files which could not be processed for lack of a suitable free line/thread to handle them, in the presence of a $fax_send_line command.

The period covered by the analysis depends on the system load but should cover up to the previous hour on a rolling basis.

Note that the unprocessed files may have higher counts because they have been scanned many times during the period covered by an analysis window, whereas each 'processed' file is only counted as processed once, by definition.

This feature is currently experimental and is subject to change.

Line Current State

The 'C' key writes to the engine trace file a list of the current state of each line and whether it is currently connected to a telephony channel or processing an FS file.