NAME

       xferfaxlog - HylaFAX activity log

DESCRIPTION

       The  file  etc/xferfaxlog contains information about inbound and outbound activities.  The
       file contains one line per inbound  or  outbound  call  (except  for  facsimile  documents
       retrieved by polling in which case multiple entries may be present for a single call).  If
       the modem config setting LogCalls is set to true, then the file also contains one line per
       received call.  Lines are fixed-format, tab-separated ASCII strings.

       Each record of a facsimile transmission is of the form:
            date  SEND  commid  modem  jobid  jobtag sender ``dest-number'' ``CSI'' params #pages
       jobtime conntime ``reason'' <null> <null> <null> ``owner'' ``dcs''

       A facsimile reception record is of the form:
            date RECV commid modem fax.tif <null>  fax  ``local-number''  ``TSI''  params  #pages
       jobtime conntime ``reason'' ``CallID1'' ``CallID2'' ``CallID3...CallIDn'' <null> ``dcs''

       Each inbound call record is of the form:
            date CALL commid modem <null> <null> fax ``local-number'' <null> 0 0 jobtime conntime
       ``reason'' ``CallID1'' ``CallID2'' ``CallID3..CallIDn'' <null> ``dcs''

       Each facsimile document retrieved by polling has a record of the form:
            date POLL commid modem jobid jobtag  sender  ``dest-number''  ``TSI''  params  #pages
       jobtime conntime ``reason'' <null> <null> <null>

       An alphanumeric pager request has a record of the form:
            date  PAGE  commid  modem  jobid jobtag sender ``dest-number'' ``<null>'' 0 0 jobtime
       conntime ``reason'' <null> <null> ``owner''

       The following describes the fields in the above records:

       date          The date and time of the transaction in the format MM/DD/YY HH:MM , where MM
                     is  the  numeric  month,  DD  the numeric day, YY the last two digits of the
                     year, and HH:MM is the time in 24-hour format.

       commid        The communication identifier for the call.

       modem         The device identifier for the modem that was used to do the send or receive.

       jobid         The job number for outbound calls.

       jobtag        The client-specified job tag for outbound calls.

       fax.tif       The associated recvq fax TIFF file for the event.

       sender        The sender/receiver's electronic mailing address (facsimile  receptions  are
                     always attributed to the ``fax'' user).

       dest-number   The phone number dialed for outgoing calls.

       TSI           The  Transmitter Subscriber Identification string (as received) for incoming
                     calls.

       CSI           The Caller Subscriber  Identification  string  of  the  remote  machine  (as
                     reported) for outgoing calls.

       local-number  The local phone number on which the data was received.

       params        The  negotiated  facsimile  session  parameters  used  for transferring data
                     encoded as described below.

       #pages        The total number of pages transferred.

       jobtime       The duration of the session; in the format  HH:MM:SS.   This  time  includes
                     setup overhead and any time spent cleaning up after a call.

       conntime      The  time  spent  on  the phone; in the format HH:MM:SS.  This should be the
                     time used by the PTT to calculate usage charges.

       reason        A string that indicates if any problem occurred during the session.

       CIDName       The received CIDName value for the session.

       CIDNumber     The received CIDNumber value for the session.

       owner         The login name of the job owner.

       dcs           The T.30 DCS string that was used in the facsimile communication.

       Note that fields may have embedded blanks.  Session parameters are encoded  as  a  decimal
       number  that  contains a packed set of Class 2 session parameter values.  The format is: 2
       bits for vertical resolution, 3 bits for signalling rate, 3 bits for page  width,  2  bits
       for  page  length,  2 bits for data format, 1 bit for ECM use, 1 bit of BF use, and 3 bits
       for the min scanline time.  The page counts are always integral  numbers.   Partial  pages
       that are to be retransmitted are not included in the page count.

       The simple ASCII format was designed to be easy to process with programs like awk(1).

NOTES

       The  sender  field  does  not  necessarily represent the submitter's actual identity.  For
       example, it reflects the value given by the sendfax(8) ``-f'' option.   Be  cautious  that
       this field is not utilized for auditing if the fax user base is not trusted.

BUGS

       The date format will ``break'' in the year 2000.  Information should be recorded on a per-
       page basis for facsimile communications.

SEE ALSO

       faxq(8) faxsend(8) faxgetty(8)

                                           June 5, 1996                             XFERFAXLOG(5)