Select Page

Deciphering the Resulting Status Codes in RightFax

RightFax shows a status message for each fax in Faxutil and Webutil. To learn more about why a fax transmission may have failed, the fax history includes status codes that offer concise information. This Knowledge Base article helps to decipher these Resulting status codes.

Often, with failed faxes, information on the failure can be found in the transmission record for the fax.

Resulting Status Codes

RightFax shows the line status and the fax status for T.30 (PSTN) and T.38 (FOIP) fax transmissions. These status messages can be useful in analyzing fax errors and in helping to determine the nature of a failure (to assist with issue resolution).

However, these status messages, in conjunction with troubleshooting the telephony integration, can be useful in determining the nature of failures. As the success or failure of a fax transmission is entirely dependent on the telephony transport being used, these status messages can help to determine the underlying deficiency in end-to-end communication and can be used effectively to isolate an issue when combined with further troubleshooting and error reporting in the telephony network itself.

Interpreting the Resulting Status Codes

The fax history shows a Resulting fax status code. Both the first and second sets of numbers are gathered by the Brooktrout API to report on the call progress (reflected in the first set of numbers before the semi-colon) and the fax progress (reflected in the second set of numbers after the semi-colon).

A failure to send a fax using the server computer’s telephony integration can be generally classified into one of these two categories.

Call Setup Failures

Call setup failures occur when a call cannot be successfully placed to a dialed number. The first set of numbers can be helpful in determining call setup failures. This is especially true with Analog, Analog DID, BRI, and T1 integrations. For FoIP (either TR1034 ethernet enabled fax boards or SR140 “Boardless” fax boards), the Wireshark Network capture utility is considerably more useful for troubleshooting call setup errors.

First Set of Numbers – Call Progress Status

The first set of numbers represents the RightFax call status and the call line status. The first number is typically zero (“0”) and means that the call was placed. The second number can be found in Table 1 below.

Second Set of Numbers – Fax Progress Status

(This is generally where transmission failures are reflected.)

Transmission errors occur when a call is successfully placed from the fax server to the end point fax device (or from an end point sending device to the fax server), but the overall quality of the connection between the two end points is insufficient to convey the fax data effectively to or from the remote device.

The second set of numbers in the Resulting status code reflects the outcome of the fax transmission. This information does not yield any data about why a fax failed (that is, it does not indicate the specific reason why the communication between the two end points was unsuccessful). However, it does show what happened at the time that the fax failed.

For example, a Resulting status code of “0/339; 4/75” indicates that a DCN message was received from the remote device (a DCN is the signal sent from a t.30 device that states “I’m disconnecting”). This information indicates that the remote side terminated the call, but it does not indicate specifically why the remote side terminated the call. Therefore, since this information does not explain why the remote device terminated the call, it is more useful for identifying a behavior pattern, rather than for explaining the failure of an isolated fax call.

If you are having issues with RightFax Error Codes, or any other RightFax error, please contact us at 1-866-730-1700 or [email protected]

Table 1: RightFax Call Line Status

RightFax Call Line StatusMessage in HistoryStatus in Faxutil or Webutil
258Dial Er: no dial toneError: No Dial Tone
259Dial Er: no loop currentError: Phoneline Problem
260Dial Er: local in useError: Line in Use
301Normal BusyError: Busy
302Normal BusyError: Busy
303Fast BusyError: Busy
304Recall Dial ToneError: Phoneline Problem
305Confirmation toneError: Unknown Error
306PulseError: Unknown Error
308Ringing DetectedError: No Answer
309Double Ringing DetectedError: No Answer
316Answer (probably human)Error: Human Answered
317Answered, quiet followedError: Human Answered
318Dial tone after dialingError: Phoneline Problem
324Silence, no signal or CNGError: Phoneline Problem
325Ringing, no answerError: No Answer
326Group 2 Fax MachineError: G2 Fax Machine
327Special Info ToneError: Phoneline Problem
328Dead line (after dialing)Error: Human Answered
329Vacant tone (invalid phone num?)Error: Phoneline Problem
330Reorder tone (PBX/Carrier failure)Error: Busy
331No circuit tone (dead line?)Error: Phoneline Problem
332CNG fax tone detectedError: Unknown Error
333Remote off-hookError: Unknown Error
334Special CPError: Unknown Error
339**Answer Tone DetectedSuccess

** If the status in FaxUtil shows “Transmission Error” and the Resulting Status Code in Fax History shows 0/339 in the first two digits, then one or both of the third and fourth digits will have values greater than 0. In this case, the phone call was answered (code 339) but failed at some point afterward. Match the 3rd and 4th digits of the Resulting Status Code (e.g. 4/27 in the code 0/339;4/27) to their corresponding values in tables two and three respectively.

Table 2: Dialogic Status Types

Call StatusDialogic Call StatusDescription
0BT_STATUS_OKNormal return
2BT_STATUS_ERRORError return
3BT_STATUS_ERROR_DIALDialing error
4BT_STATUS_ERROR_HANGUPHangup error
5BT_STATUS_USER_TERMINATEDUser function caused termination
6BT_STATUS_TIMEOUTTimeout occurred
7BT_STATUS_ALERTAlert occurred

Table 3: Dialogic Return Codes from the Dialogic API 6.3

 

Dialogic CodeValueCodeDescription
BT_STATUS_ERROR2/0APIERR_UNCLASSIFIEDNo further info provided.
BT_STATUS_ERROR2/1APIERR_FILEIOFile I/O error occurred.
BT_STATUS_ERROR2/2APIERR_FILEFORMATBad file format.
BT_STATUS_ERROR2/3APIERR_BOARDCAPABILITYHardware or firmware does not support capability.
BT_STATUS_ERROR2/4APIERR_NOTCONNECTEDChannel not in proper state.
BT_STATUS_ERROR2/5APIERR_BADPARAMETERBad parameter value used.
BT_STATUS_ERROR2/6APIERR_MEMORYMemory allocation error.
BT_STATUS_ERROR2/7APIERR_BADSTATEThe channel is not in a required state.
BT_STATUS_ERROR2/8APIERR_TOOSOONDialing was attempted too soon.
BT_STATUS_ERROR2/9APIERR_BUSYResource busy.
BT_STATUS_ERROR2/10APIERR_DRV_OPEN_ERRORDriver open call failed, invalid channel or driver not correctly installed.
BT_STATUS_ERROR2/11APIERR_DRV_IOCTL_ERRORDriver call failed.
BT_STATUS_ERROR2/12APIERR_VERSIONIncompatible driver version.
BT_STATUS_ERROR2/13APIERR_INVALID_PORTInvalid port; faxinit probably not run correctly.
BT_STATUS_ERROR2/14APIERR_RINGINGRinging during dialing attempt.
BT_STATUS_ERROR2/15APIERR_INFOPKT_NESTINGIndir infopkt nesting level too deep.
BT_STATUS_ERROR2/16APIERR_MAX_TAGSMaximum number of TIFF tags exceeded.
BT_STATUS_ERROR2/17APIERR_LOCK_FAILEDAn attempt to gain a lock failed.
BT_STATUS_ERROR2/18APIERR_INSUFF_BUFFERBuffer size too small to receive data.
BT_STATUS_ERROR2/19APIERR_INVALID_DEST_ADDRDestination address not found or invalid.
BT_STATUS_ERROR2/20APIERR_PACKET_CREATIONPacket or command creation error.
BT_STATUS_ERROR2/21APIERR_PACKET_PARSEPacket or command parse error.
BT_STATUS_ERROR2/22APIERR_PACKET_SENDPacket send error.
BT_STATUS_ERROR2/23APIERR_PACKET_RECEIVEPacket receive error.
BT_STATUS_ERROR2/24APIERR_DATADATA encountered during command processing.
BT_STATUS_ERROR2/25APIERR_INVAL_BOARD_PARAMInvalid parameter values received from firmware.
BT_STATUS_ERROR2/26APIERR_FIRMWARE_ERR_DETECTEDFirmware detected an error.
BT_STATUS_ERROR2/27APIERR_MODULE_REMOVEDModule was removed.
BT_STATUS_ERROR2/28APIERR_BOARD_NO_RESPONSEBoard not responding.
BT_STATUS_ERROR2/29APIERR_ASYNC_LP_ERRAsync_lp value error.
BT_STATUS_ERROR2/30APIERR_ASYNC_CONTEXT_ERRAsync context error.
BT_STATUS_ERROR2/31APIERR_DRV_RESOURCESDriver out of resources.
BT_STATUS_ERROR2/32APIERR_MODULE_RESET_FAILUREModule reset failure.
BT_STATUS_ERROR2/33APIERR_MODULE_I20_FAILUREModule I20 enable failure.
BT_STATUS_ERROR2/34APIERR_MODULE_CONFIG_TIMEOUTNo valid response for module configuration.
BT_STATUS_ERROR_DIAL3/257DIAL_OKDialing completed successfully.
BT_STATUS_ERROR_DIAL3/258DIAL_NO_DIAL_TONENo dial tone detected.
BT_STATUS_ERROR_DIAL3/259DIAL_NO_LOOP_CURNo loop current detected.
BT_STATUS_ERROR_DIAL3/260DIAL_LOCAL_IN_USELocal phone in use successfully.
BT_STATUS_ERROR_DIAL3/261DIAL_TRUNK_BUSYBusy trunk line detected.
BT_STATUS_ERROR_DIAL3/265DIAL_SLOT_BUSYT1 time slot busy.
BT_STATUS_ERROR_DIAL3/266DIAL_CALL_COLLISIONRinging detected during dialing.
BT_STATUS_ERROR_DIAL3/267DIAL_NO_WINK2nd or later wink missing for Feature Group D.
BT_STATUS_ERROR_HANGUP4/0HNG_NORMAL_XMITNormal and proper end of connection.
BT_STATUS_ERROR_HANGUP4/1HNG_RNG_DETRing detected without a successful handshake.
BT_STATUS_ERROR_HANGUP4/2HNG_ABORTCall Aborted.
BT_STATUS_ERROR_HANGUP4/3HNG_NO_LOOP_CURRENTNo loop current or A/B signaling bits.
BT_STATUS_ERROR_HANGUP4/4HNG_ISDN_DISCONNECTISDN disconnection.
BT_STATUS_ERROR_HANGUP4/11HNG_T1_TIMEOUTNo answer, T.30 T1 timeout.
BT_STATUS_ERROR_HANGUP4/20HNG_XMITB_TIMEOUTUnspecified transmit Phase B error.
BT_STATUS_ERROR_HANGUP4/21HNG_XMITB_NORMRemote cannot receive or send.
BT_STATUS_ERROR_HANGUP4/22HNG_XMITB_MISCCOMREC error, Phase B transmit.
BT_STATUS_ERROR_HANGUP4/23HNG_XMITB_COMREC_VCNRCOMREC invalid command received.
BT_STATUS_ERROR_HANGUP4/24HNG_XMITB_SERSPREC error.
BT_STATUS_ERROR_HANGUP4/25HNG_XMITB_DCS_FTCDCS send three times without response.
BT_STATUS_ERROR_HANGUP4/26HNG_XMITB_DIS_FTCDIS/DTC received three times; DCS not recognized.
BT_STATUS_ERROR_HANGUP4/27HNG_XMITB_TRAINFAILFailure to train.
BT_STATUS_ERROR_HANGUP4/28HNG_XMITB_RSPREC_VCNRRSPREC invalid response received.
BT_STATUS_ERROR_HANGUP4/29HNG_XMITB_COMREC_DCNDCN (fax disconnect message) received in COMREC.
BT_STATUS_ERROR_HANGUP4/30HNG_XMITB_RSPREC_DCNDCN received in RSPREC.
BT_STATUS_ERROR_HANGUP4/33HNG_PHASEB_INCOMPAT_FMTIncompatible fax formats, for example, a page width mismatch.
BT_STATUS_ERROR_HANGUP4/34HNG_XMITB_INVAL_DMACNTInvalid DMA count specified for transmitter.
BT_STATUS_ERROR_HANGUP4/35HNG_XMITB_FTM_NOECMBinary File Transfer specified, but ECM not enabled on transmitter.
BT_STATUS_ERROR_HANGUP4/36HNG_XMITB_INCMP_FTMBinary File Transfer mode specified, but not supported by receiver.
BT_STATUS_ERROR_HANGUP4/40HNG_XMITD_RR_NORESNo response to RR after three tries.
BT_STATUS_ERROR_HANGUP4/41HNG_XMITD_CTC_NORESNo response to CTC, or response was not CTR.
BT_STATUS_ERROR_HANGUP4/42HNG_XMITD_T5TO_RRT5 time out since receiving first RNR.
BT_STATUS_ERROR_HANGUP4/43HNG_XMITD_NOCONT_NSTMSGDo not continue with next message after receiving ERR.
BT_STATUS_ERROR_HANGUP4/44HNG_XMITD_ERRRES_EOREOPERR response to EOR-EOP or EOR-PRI-EOP.
BT_STATUS_ERROR_HANGUP4/45HNG_XMITD_RTN_DCNTransmitted DCN after receiving RTN.
BT_STATUS_ERROR_HANGUP4/46HNG_XMITD_PPR_EOREOR-MPS, EOR-EOM, EOR-NULL, EOR-PRI-MPS, or EOR-PRI-EOM sent after fourth PPR received.
BT_STATUS_ERROR_HANGUP4/51HNG_XMITD_SERSPREC error.
BT_STATUS_ERROR_HANGUP4/52HNG_XMITD_MPS_FTCNo response to MPS, repeated three times.
BT_STATUS_ERROR_HANGUP4/53HNG_XMITD_MPS_VCNRInvalid response to MPS.
BT_STATUS_ERROR_HANGUP4/54HNG_XMITD_EOP_FTCNo response to EOP repeated three times.
BT_STATUS_ERROR_HANGUP4/55HNG_XMITD_EOP_VCNRInvalid response to EOP.
BT_STATUS_ERROR_HANGUP4/56HNG_XMITD_EOM_FTCNo response to EOM, repeated three times.
BT_STATUS_ERROR_HANGUP4/57HNG_XMITD_EOM_VCNRInvalid response to EOM.
BT_STATUS_ERROR_HANGUP4/60HNG_XMITD_RSPREC_DCNDCN received in RSPREC.
BT_STATUS_ERROR_HANGUP4/61HNG_XMITD_PPSNULL_NORESNo response received after third try for PPS-NULL.
BT_STATUS_ERROR_HANGUP4/62HNG_XMITD_PPSMPS_NORESNo response received after third try for PPS-MPS.
BT_STATUS_ERROR_HANGUP4/63HNG_XMITD_PPSEOP_NORESNo response received after third try for PPS-EOP.
BT_STATUS_ERROR_HANGUP4/64HNG_XMITD_PPSEOM_NORESNo response received after third try for PPS-EOM.
BT_STATUS_ERROR_HANGUP4/65HNG_XMITD_EORNULL_NORESNo response received after third try for EOR-NULL.
BT_STATUS_ERROR_HANGUP4/66HNG_XMITD_EORMPS_NORESNo response received after third try for EOR-MPS.
BT_STATUS_ERROR_HANGUP4/67HNG_XMITD_EOREOP_NORESNo response received after third try for EOR-EOP.
BT_STATUS_ERROR_HANGUP4/68HNG_XMITD_EOREOM_NORESNo response received after third try for EOR-EOM.
BT_STATUS_ERROR_HANGUP4/70HNG_RCVB_TIMEOUTUnspecified receive Phase B error.
BT_STATUS_ERROR_HANGUP4/71HNG_RCVB_SERSPREC error.
BT_STATUS_ERROR_HANGUP4/72HNG_RCVB_MISCCOMREC error.
BT_STATUS_ERROR_HANGUP4/73HNG_T2_PNOTREC T.30T2 timeout, expected page not received.
BT_STATUS_ERROR_HANGUP4/74HNG_RCVB_T1_TIMEOUTT.30 T1 timeout after EOM received.
BT_STATUS_ERROR_HANGUP4/75HNG_NORMAL_RCVDCN received in COMREC.
BT_STATUS_ERROR_HANGUP4/76HNG_RCVB_RSPREC_DCNDCN received in RSPREC.
BT_STATUS_ERROR_HANGUP4/77HNG_T2_TIMEOUT T.30T2 timeout, expected page received.
BT_STATUS_ERROR_HANGUP4/78HNG_RCVB_INVAL_DMACNTInvalid DMA count specified for receiver.
BT_STATUS_ERROR_HANGUP4/79HNG_RCVB_FTM_NOECMBinary File Transfer specified, but ECM not supported by receiver.
BT_STATUS_ERROR_HANGUP4/101HNG_RCVD_SE_VCNRSPREC invalid response received.
BT_STATUS_ERROR_HANGUP4/102HNG_RCVD_COMREC_VCNRCOMREC invalid response received.
BT_STATUS_ERROR_HANGUP4/103HNG_RCVD_T3TO_NORESPT3 timeout; no local response for remote voice interrupt.
BT_STATUS_ERROR_HANGUP4/104HNG_RCVD_T2TOT2 timeout; no command received after responding RNR.
BT_STATUS_ERROR_HANGUP4/105HNG_RCVD_DCN_COMRECDCN received for command received.
BT_STATUS_ERROR_HANGUP4/106HNG_RCVD_COMREC_ERRCommand receive error.
BT_STATUS_ERROR_HANGUP4/107HNG_RCVD_BLKCT_ERRReceive block count error in ECM mode.
BT_STATUS_ERROR_HANGUP4/108HNG_RCVD_PGCT_ERRReceive page count error in ECM mode.
BT_STATUS_ERROR_HANGUP4/240HNG_INTERRUPT_ACKNo interrupt acknowledges, timeout.
BT_STATUS_ERROR_HANGUP4/241HNG_COMM_FAULTLoop current still present while playing reorder tone after timeout.
BT_STATUS_ERROR_HANGUP4/242HNG_T30_HOLDUPT.30 holdup timeout.
BT_STATUS_ERROR_HANGUP4/243HNG_HOLDUP_DCNDCN received from host in receive holdup section for FAX PAD mode.
BT_STATUS_ERROR_HANGUP4/244HNG_HOLDUP_DCN_NON_FPADDCN received from host in receive holdup section for non-FAX PAD mode.
BT_STATUS_ERROR_HANGUP4/500HNG_ERROR_INTERRUPTAn error interrupt occurred, indicating a problem with the channel too severe to continue. The value of the error interrupt can be obtained with the LINE_ERROR_INTR macro.
BT_STATUS_ERROR_HANGUP4/501HNG_INTERRUPT_OVERRUNThe application was unable to process incoming interrupts/commands fast enough, and information was lost.
BT_STATUS_ERROR_HANGUP4/502HNG_UNEXPECTED_IRSDONEThe channel generated an unexpected 03 (reset done) or 7F interrupt, indicating the existence of a firmware or hardware problem.
BT_STATUS_ERROR_HANGUP4/503HNG_IOCTL_ERRORAn Bfv API command to the driver returned an error value, indicating that the driver or the operating system detected an error.
BT_STATUS_ERROR_HANGUP4/504HNG_OVERLAY_DLOAD_ERRError reported at termination of fax overlay download.
BT_STATUS_ERROR_HANGUP4/505HNG_MAX_TIMEOUTMaximum timeout exceeded. This code occurs when the user configuration file parameter max_timeout has been enabled and the specified timeout has expired.

Table 4: Resulting Status

Resulting StatusValue
Status_OK0
Status_Error2

Table 5: Line Status

Line StatusValue
SEND_SUCCESS0
SEND_FAILURE_PASS1101
SEND_FAILURE_PASS2102
SEND_FAILURE_PASS3103
SEND_FAILURE_DBCONNECTIONERROR105
SEND_FAILURE_REGISTRARSERVICE_UNREACHABLE106
SEND_FAILURE_RECEIVER_NOT_AVAILABLE107
SEND_FAILURE_RECEIVER_NOT_REACHABLE108
SEND_FAILURE_RF_DELIVERY_FAILURE109
TRANSMITTER_SEND_FAILURE_LICENSE_EXPIRED_OR_NOT_AVAILABLE116
SEND_FAILURE_RECEIVER_ERROR900
SEND_FAILURE_EXCEPTION998
SEND_FAILURE_UNKNOWN999

NOTE: The SEND_FAILURE_PASS# defines an attempt to send a fax in which a failure occurs.

  • PASS1 is the first send failure to the specified number.
  • PASS2 is the second failure to the specified number, and so on, in which case a PSTN retry occurs.

Additional Information

For more information on fax statuses, see the Webutil help topic “Fax Status Messages.”

 

To view a list of Dialogic return codes, see the following:

http://www.cantata.com/support/download/Brooktrout%20Return%20Error%20Codes.rtf

OR

http://www.dialogic.com/webhelp/Brooktrout/SDK62/ref_apiset.pdf

If this list is unavailable, search the Dialogic website for ref_apiset.pdf:

http://www.dialogic.com

For values related to RightFax Connect, see:

http://www.dialogic.com

 

Related Information

Definition of Abbreviations within Error Code Descriptions:
CFR Confirmation to receive.

CIG Calling subscriber identification.

CRP Command repeat.

CSI Called subscriber identification.

CTC Continue to correct.

CTR Response to CTC.

DCN Disconnect

DCS Digital command signal.

DIS Digital identification signal.

DTC Digital transmit command.

EOM End of message.

EOP End of procedures.

EOR End of retransmission.

ERR Response to EOR.

FTT Failure to train.

MCF Message confirmation.

MPS Multipage signal.

NSC Nonstandard facilities command.

NSF Nonstandard facilities.

NSS Nonstandard facilities setup.

PIN Procedure interrupt negative.

PIP Procedure interrupt positive.

PPR Partial page request.

PPS Partial page signal.

PRI-EOM Procedure interrupt—End of message.

PRI-EOP Procedure interrupt—End of procedures.

PRI-MPS Procedure interrupt—Multipage signal.

PWD Password.

RNR Receive not ready.

RR Receive ready.

RTN Retrain negative.

RTP Retrain positive.

SEP Selective polling.

SUB Subaddress.

TSI Transmitting subscriber identification.

This blog is tagged as: Error | Failures | FaxUtil | Numbers | Results | RightFax | Status Codes | WebUtil

Join Our Newsletter

Quick Links

Popular Resources

Contact Us

If you would like to learn more or speak to one of our dedicated RightFax experts, please contact us using the request button below or call us directly at 866-730-1700.

Register for Exclusive Access to the

RightFax Resource Center

Sign-up to learn the ins and outs of your RightFax system and become an expert.

  • This field is for validation purposes and should be left unchanged.