Provided by: hylafax-server_4.2.5-1_i386 bug

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).  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> ‘‘owner’’

       A facsimile reception record is of the form:
            date  RECV commid modem <null> <null> fax ‘‘local-number’’ ‘‘TSI’’
       params #pages jobtime  conntime  ‘‘reason’’  ‘‘CIDName’’  ‘‘CIDNumber’’
       <null>

       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.

       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  negotiatated  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 occured 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.

       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)