Most users will not need to change the pre-defined classes, which for voice fax and poll calls are as follows:
| A | Call placement: no Answer |
| C | Call placement: Call failure other than no answer, busy, no dial tone |
| D | Call placement: no Dial tone or no circuits |
| E | System Error: missing files, etc |
| F | Fax transmission failure |
| H | Fax failure at receiving station, e.g. remote Hang-up |
| I | Special 'ignore failure' class, which is always retried, and therefore for which delays cannot be set |
Different categories apply for e-mail calls:
| I | Special 'ignore failure' class, which is always retried, and therefore for which delays cannot be set |
If you wish to change the outcome class for an outcome code, you must change the retry parameters file. The data fields in this file (FF7.SMR) are as follows:
| Outcome Code | The status code corresponding to the call placement outcome or the fax transmission outcome. |
| Outcome Type | This special code is used to indicate that an entry is to be used only for fax-call placement, voice-call placement or poll-call placement. For example a call outcome indicating detection of a remote receiving fax machine would signify success for a fax transmit call, but failure for a voice call or fax poll call. Smart Retry is not yet implemented for voice and poll calls. |
| Outcome Class | The class letter you wish to allocate for this outcome (A to H, I, S or Z). |
| Page Adjust | A value of +1 or -1 to adjust the page-count for specific error outcome codes. You would use a value of +1 for an error code which is returned by the fax board (between pages) in which the preceding page has normally been sent correctly but not counted by the board interface. You would use a value of -1 for an error code normally signaled late by the board interface, after an incorrectly-sent page has been counted as sent. The successful use of this field is an art, not a science: its use may only be recommended if your fax recipients tend to have particular types of machine (e.g. home or office fax machines). A -1 value can also be used to forcibly fail a transmission for which an error code is reported even when the correct number of pages has been reported as sent (which normally causes success to be assumed). |
| Retry Action | A special action code to modify the retry operation: currently the available action codes specify either that the retry is to be sent all at the resolution of the first page, or all at low resolution. This code is useful if the outcome indicates that the remote fax is one of those which cannot change resolution during a transmission. |
The use of a special retry parameters file is specified using the $retry_parms command in the CopiaFacts configuration file. A different file may be specified for each line group. The supplied FF7.SMR file corresponds to the internal tables, and contains comments describing the content in more detail as well as a description of each code.
Note that FF7.SMR lists for convenience a number of codes which can arise on receive operations only. These are for reference only and have no connection with 'retry' procedures.
Topic url:
http://www.copia.com/support/refmanual/index.html?outcomeclasses.htm
