Log files

Workflow log files

The OL Connect Send Workflow plugins write to the Workflow log file. Its location can be found in the Workflow Help (see help.objectiflune.com).

Printer log files

Each OL Connect Send printer logs its messages in a daily log file.
The log files are located under %ProgramData%\Objectif Lune\CPD\Log\<OLCS Printer Name> on the machine/s on which the Printer Driver has been installed.

The level of the messages that must be logged can be set and changed via the installer (see Logging). These log files can be used for troubleshooting (see Troubleshooting).

History log files

In addition to the printer log files, the OL Connect Send Printer Driver creates and fills a daily history log file, which can be used for both troubleshooting and reporting purposes.
The history log is a generic log file, independent of the printer (name), Job ID and log level settings. Each printer adds its important job related information to this file.

Note: The history log will only contain information about print job transfers, but not any information about later interactions. Interactions are handled outside the printer and printer driver and are managed on Workflow. Therefore all interaction related information has to be drawn from the Workflow logs.

The name of the history log file is:
%ProgramData%\Objectif Lune\CPD\Log\OLCSHistory_<YYYYMMDD>.csv

On the first line of this CSV file are its column headers:
{{Date;Time;Printer;Job ID;Document Path;Document Name;Pages;Chunks;Chunk No;Status;Mode;User;Target}}
The separator character is the semicolon (0x3B).
Each following line is one log entry.

The file can be loaded with e.g. Excel and filtered, ordered, sorted and modified as desired.

Note: When the history log file is open in another application (such as Excel), it is locked for write access, which means that OL Connect Send printers cannot add entries to it. The printer's normal log entries will be written but the related history log entries will be lost.

Logged events

Entries are written at the following events.

  • The Connect Send Printer Driver has been called by the spool system and a new job must be sent. (Status = "Initialized", Job mode = Unknown)
  • The Printer Driver received a reply from the server for the initial XFER request. In case of an unaccessible host, the log message will indicate the status "Unaccessible" and the Job mode will be Unknown. In case of a successful communication the status will be "Accepted" and the Job mode will be set related to the server reply.
  • The Printer Driver sends a chunk. (Status = Sending)
  • The job gets aborted. (Status = Aborted)
  • The job transfer fails. (Status = Failed)
  • The job transfer has finished successfully. (Status = Success)

Information per log entry

Log entries contain the following information.

  • Date stamp. Date = Current local date (non-UTC) in the format of YYYY-MM-DD.
  • Time stamp formatted as HH:MM:SS.sss. Local time including milliseconds in 24h format.
  • Printer name
  • Job ID
  • Document path as can be retrieved from the spooler information. Please be aware that some applications suppress this information.
  • Document name as can be retrieved from the spooler information. Please be aware that some applications modify, mix up, enhance or truncate this information.
  • Number of pages
  • Number of chunks
  • Chunk number = number of the currently transferred chunk
  • Job transfer status. Can be "Initialized", "Unaccessable", "Accepted", "Sending", "Success", "Failed", "Aborted"
  • Job mode: Licensed, Unlicensed, Unknown
  • User name
  • Target URL including respective HTTP action name (host name and port separated by a colon (0x3A))