Faximum TechNote #224

Faximum TechNote #224

(http://www.faximum.com/technotes/224)

*** DRAFT *** DRAFT *** DRAFT *** DRAFT *** DRAFT *** DRAFT *** DRAFT ***

TITLE:    #224 - Extended Fax Status Codes

KEYWORDS: extended fax error status code acct accounting log completion program

RELEASE:  Faximum ELS/PLUS v4 (and later)

CLASSIFICATION: All

PROBLEM:  This TN describes the additional status codes that are
	  recorded in the acct log (starting with Faximum v4)
	  and passed in the extended information file passed to
	  the completion program.

CAUSE:    N/A

SOLUTION: Note that the Faximum extended status codes are
	  32-bit hexadecimal number. The most-significant
	  16 bits are the type of error and the least-sig
	  16 bits provide additional information


	+==========+=================================================+
	|    Code  |  Cause Description                              |
	+==========+=================================================+
	|  0x10xx  |  Bad Request (Invalid request control file)     |
	+----------+-------------------------------------------------+
	|      01  |  bad speed                                      |
	|      02  |  missing data-file1                             |
	|      03  |  cannot open data-file1                         |
	|      04  |  missing device                                 |
	|      05  |  cannot open device                             |
	|      06  |  bad device field                               |
	|      07  |  cannot stat cf file                            |
	|      08  |  bad perms on cf file                           |
	|      09  |  cannot open cf file                            |
	|      0a  |  cannot lock cf file                            |
	|      0b  |  cannot read cf file                            |
	|      0c  |  bad level                                      |
	|      0d  |  bad level                                      |
	|      0e  |  bad level                                      |
	|      0f  |  bad level                                      |
	|      10  |  missing req id
	|      11  |  missing control file
	+==========+=================================================+
	|  0x20xx  |  Operating system error                         |
	+----------+-------------------------------------------------+
	|      xx  |  Standard UNIX/Linux errno.h error code         |
	|          |  (remember to convert between decimal and hex)  |
	+==========+=================================================+
	|  0x30xx  |  Retry limit exceeded                           |
	+----------+-------------------------------------------------+
	|      xx  |  Number of transmission attempts                |
	+==========+=================================================+
	|  0x40xx  |  Modem (text) Error Messages                    |
	+----------+-------------------------------------------------+
	|      01  |  data (i.e. non-fax) call                       |
	|      02  |  number is busy                                 |
	|      03  |  no answer                                      |
	|      04  |  no dialtone                                    |
	|      05  |  voice answer                                   |
	|      06  |  command error                                  |
	|      07  |  unrecognised response                          |
	|      08  |  unrecognised resp to dial                      |
	+==========+=================================================+
	|  0x50xx  |  FHNG Class 2/2.0 Fax Failure Code              |
	+----------+-------------------------------------------------+
	|      xx  |  See Class 2/2.0 spec. or TN #038               |
	|          |  (remember to convert between decimal and hex)  |
	+==========+=================================================+
	|  0x60xx  |  PPR Class 2/2.0 Fax Failure Code               |
	+----------+-------------------------------------------------+
	|      xx  |  See Class 2/2.0 spec.                          |
	+==========+=================================================+
	|  0x70xx  |  Everything Else                                |
	+----------+-------------------------------------------------+
	|      01  |  unspecified transient err                      |
	|      02  |  request expired                                |
	|      03  |  not a class 2 modem                            |
	|      04  |  unexpected response/state                      |
	|      05  |  timeout                                        |
	|      06  |  flush timeout                                  |
	|      07  |  read timeout                                   |
	|      08  |  read eof error                                 |
	|      09  |  read error                                     |
	|      0a  |  write timeout                                  |
	|      0b  |  CSI mismatch fail                              |
	|      0c  |  CSI unexpected fail                            |
	|      0d  |  CSI missing fail                               |
	|      0e  |  CSI missing dialstring                         |
	|      0f  |  CSI file error 1                               |
	|      10  |  tfwrite error                                  |
	|      11  |  malloc failure                                 |
	|      12  |  uucplock failure                               |
	|      13  |  missing modem type                             |
	|      14  |  internal error 1                               |
	|      15  |  DID too long                                   |
	|      16  |  DID unexpected msg                             |
	|      17  |  Unknown fax Error                              |
	|      18  |  User Cancelled                                 |
	+==========+=================================================+

	  For more information on MultiTech's implementation of the
	  Fax Class 2 "Standard" please see:

	    http://www.multitech.com/DOCUMENTS/manuals/82006502.pdf
	
TechNote: 224 - Copyright 2001 Faximum Software Inc., All Rights Reserved.
Last Updated: Fri Feb  2 00:49:40 PST 2001
Find all Faximum TechNotes at http://www.faximum.com/support

Copyright 2001 Faximum Software Inc. All Rights Reserved.