Technical information
97
Historical Logs
Historical Logs
Historical logs store detailed information about inbound and outbound faxes.
Important
The exact order of historical log tags is subject to change from release to release. Therefore, if you will be
evaluating historical logs via a script, it is best that you explicitly search for a particular tag name rather than use a
tag's current position in the log file. This will ensure that your scripts continue to work after product upgrades.
Outbound historical logs
Information about how outbound faxes were scheduled, sent and re-sent is stored in the ologgrp (for a group of
recipients), ologreg (for single recipient), and ologatt (fax attempts) databases. You can view this information using
the vfxolog command line utility or the VSI-FAX Server Administration plug-in.
If you use the vfxolog command line utility, the following information is displayed for each outbound fax:
Req-id Unique fax request ID number.
Submitted Actual transmission time displays in MM/DD HH:MM format. For example: 03/28 16:17
npg/nps
Number of pages in the fax (npg) and number of pages re-sent (nps). Normally, these two numbers
should be the same, indicating that all pages were successfully sent the first time. However, if a
problem occurred during transmission, VSI-FAX will automatically re-send the affected pages.
Clientid VSI-FAX user who submitted the fax request.
Phone
number
Destination fax number.
Attmpt Fax attempt status code. This is real-time status for the current fax attempt. Once the fax has been
successfully sent, this entry is blank. Entries will be one of the fax attempt status codes. Refer to
Command Reference in the Reference Addendum
documentation for additional information.
Result Final fax request status. Entries will be one of the fax request status codes. Refer to Command
Reference in the Reference Addendum
documentation for additional information.
att
Attempt number. The total number of attempts to send each fax request is controlled by the retry
strategy See Retry Strategies
.
An asterisk after the number indicates that this fax request is complete.
Tip
vfxolog typically only displays historical information for your outbound faxes. To view historical information for
all outbound faxes, log in as a user with fax administration privileges (e.g., user vsifax), then enter your vfxolog
command.
Inbound historical logs
Historical information about received (inbound) faxes is stored in the ilog database. You can view this information
using the vfxilog command line utility or the VSI-FAX Server Administration plug-in.