Specifications

HYLAFAX-CONFIG(5F) HYLAFAX-CONFIG(5F)
RingData
Amodem status string that identifies that an incoming call is for data use. This string should be
set when a phone line has been setup with distinctive ring service. See also RingFax and
RingVoice.
RingExtended
An identifier which matches the initial portion of an extended RING message sent by the modem
to relay CID and/or DNIS data instead of sending it formatted on separate lines.
RingFax
Amodem status string that identifies that an incoming call is for facsimile use. This string should
be set when a phone line has been setup with distinctive ring service. See also RingData and
RingVoice.
RingsBeforeAnswer
The number of rings to wait before answering the phone. If this value is set to 0, then the phone
will only be answered in response to an explicit answer command; see faxanswer(8C).
RingTimeout
If a ring is heard and the call is not answered, the time in ms to wait before reinitializing the
modem for the next call.
RingVoice
Amodem status string that identifies that an incoming call is for voice use. This string should be
set when a phone line has been setup with distinctive ring service. See also RingData and Ring-
Fax.
RTNHandlingMethod
Specifies howtoreact to an RTN signal receivedfrom the remote: one of ‘‘Retransmit’’,
‘‘Giveup’’,‘‘Ignore’’,or‘‘Retransmit-Ignore’’.
‘‘Retransmit’’ assumes that the page is not receivedsuccessfully.HylaFAX will makeuptotwo
additional attempts to send the page, decreasing signalling rate and retraining. If RTN continues,
up to 2 additional calls will be placed. The downside is that if the remote always responds with
RTN, the page will be sent 9 times and no following pages will be sent. Manyfax machines will
not behave this way,although T.30 specification seems clear that this is the intent of the RTN sig-
nal.
Manyfax machines will interpret RTN as meaning to not send the same data again. That is
because RTN may indicate problems with flowcontrol, incorrectly encoded T.4 data, or some
incompatibility other than line noise. Faxmachines that interpret RTN this way will disconnect
and require a manual retransmission. This ‘‘overand out’’behaviour can be activated by the
‘‘Giveup’’ value. The advantage to this behavior is that the same page of image data will not be
sent multiple times, but the downside is that the following pages will not be sent.
‘‘Ignore’’ issimilar to ‘‘Giveup’’ inthat it makes the assumption the data cannot be automatically
accepted by the receiver. Howev er, rather than disconnecting the page of image data is abandoned
and processing movesontothe next. The remote is left to decide what to do with the unaccept-
able page of image data. The downside to this behavior,isthat the remote may or may not have
kept the page, depending on its interpretation of the RTN signal - but it does allowustocontinue
on to the next page.
‘‘Retransmit-Ignore’’ isacombination of ‘‘Retransmit’’ and ‘‘Ignore’’.The page of image data is
retransmitted up to twoadditional times, but rather than disconnecting after a third RTN signal for
the same page, processing then continues on to the next page. This approach is an effort to satisfy
both interpretations of an RTN signal. It allows the receivertohopefully receive a better copyof
the image data while not failing to send subsequent pages. If the receiversav esorprints a copyof
pages for which it transmits RTN, then it could save orprint up to three copies of every page.
$Date$ 17