(Page 2 of 10 in this chapter) Version

Using Voice and Fax: caller

Option	Description	Default
`-b` n	Specifies the AG board number n.	0
`-q`	Specifies that the board is a QX 2000 board.	AG board
`-s` n:m	Specifies the stream and timeslot.	0:0
`-r` resolution	Specifies the resolution (`low`, `high`, or `superhigh`).	`low`
`-e` encoding	Specifies the encoding (`1D`, `2D`, `MMR`, or `TIFF_S`).	1D
`-c` mode	Specifies conversion mode: `y` = yes `(NFX_OTF_ALWAYS`) `m` = maybe (`NFX_OTF_ONLY_IF_FAIL`) `n` = no (`NFX_OTF_NEVER`)	`m`
`-p` protocol	Specifies the protocol (TCP name).	`nocc`
`-d` telno	Specifies the telephone number.	No default.
`-E`	Toggles using ECM mode when encoding is 1D or 2D.	Do not use ECM.
`-v`	Toggles verbose reporting of event information.	Non-verbose mode.

caller can be used to automate running faxback. It places a call to the host running faxback, requests a document by sending a touchtone, and receives the faxed document using NaturalFax, CT Access, and ADI service functions. DTMF tones are used to synchronize faxback and caller.
caller begins by initializing the CT Access environment, and then opens the ADI service on a CTA context associated with the specified board, stream, and timeslot. It places the call, and after detecting the DTMF tone that signals the end of the prompt menu, it generates the DTMF tone that corresponds to a request for a document catalog.
caller then creates a document queue, enqueues nonexistent files that will store the received documents, sets receive parameters, and receives the document when faxback transmits it.
Specifying TIFF_S encoding causes the calling application to receive a file using TIFF-S attributes of 1D encoding, LOW resolution, and A4 pagewidth. TIFF-S encoding overrides any values specified on the command line.
caller monitors all events until it receives the NFXEVN_SESSION_DONE event, and takes appropriate actions if the call is disconnected or if a board error occurs. After the fax has been received, the document queue is destroyed, and caller is set to place another call. caller runs in an infinite loop. Enter Ctrl+C to terminate the demonstration program.

(Page 2 of 10 in this chapter) Version