UUWORK
======

Syntax:
	UUWORK [-aAdcinpO] [-b <baud>] [-m <modemcmd>] [-x level]
		<host> ...

UUWORK serves to purposes: To call UUCICO to poll a number of hosts
now, or as a program that runs when the computer is idle. As such,
it can poll sites at predefined times, or answer the phone. In
either case it relies on the extended host file XHOSTS (CONFIG.SYS
line 103). (See xhosts(4).)

You can call UUWORK without host names (meaning continous operation),
or with one or more host names (meaning "call all those hosts now,
once").

To work properly, CONFIG.SYS line 107 must contain a command with
arguments (probably "hush c:\etc\doqueue.hsh" or something like that)
that calls something like  RSMTP, RMAIL, RNEWS (and possible REFLECT, 
FILESERV, and RMAIL again). That takes care of incoming and outgoing 
files. This command will be called at appropriate times when there
is work (*.X files) in the mail queue. If sites poll your site,
you should call BATCH and BATCHMAI for those sites from the doqueue
script.

Options:

-a	Activates auto-answer. This is absolutely vital if you want your
	site to accept incoming calls! Even with auto-answer mode enabled,
	outgoing calls occur as scheduled in XHOSTS. Incoming calls ought to
	be counted as successfull polls; alas, they are not.

-A	Answer the phone NOW. When it's already ringing. Like -a, but sort of
	an emergency jump start.

-b <baud>
	UUWORK tries to determine the type of modem it is talking to by sending
	it an ID request (ATI0). This another half-baked feature of UUWORK; it
	can output mode info after a successfull call, but only if connected to
	a Telebit Trailblazer. To talk to the modem, UUWORK needs to know what
	baud rate the modem is accepting as a default. If -a or -A is given,
	UUWORK takes this value from MODEM.INF, but otherwise it needs to be
	told with -b. A harmless warning message occurs if you don't give the
	baud rate.

-c	Disables monitoring the RI line (pin 22) in auto-answer mode. Some modems
	toggle this line seemingly at random. Others don't even have an RI
	line at all. If -c is given, UUWORK waits for characters on the serial
	port instead (e g, "RING").

-d	Selects direct mode (no modem).

-i	Enables auto-answer mode on the MIDI port. To reduce the number of false
	alarms, two characters must arrive in short succession. Then the program
	named in config line 118 (MIDILOGIN) is executed. Normally, you would use
	"login -a -b MIDI", which starts an interactive login on the MIDI port
	(hey, this really works!) Another possibility would be to start NET.TOS
	(KA9Q), the drawback being that you can't stop NET.TOS from the MIDI port.

-m <modemcmd>
	The command given is appended to the modem init string or send as an init
	string (with "AT" added (!) in front) of its own. A typical example would
	be "-mM3" to switch the modem's speaker on when you normally prefer it off.

-n	Disables automatic execution of the DOQUEUE command. This can be used both
	in poll and automatic mode to speed things up and leave accumulating stuff
	in MQUEUE for later. This can also be used if memory is tight and a
	DOQUEUE	from UUWORK will fail, whereas a DOQUEUE after UUWORK won't.

-N	Assume UUCICO is a "new-style" UUCICO (>= version 3.79); this is the
	default.
    
-O	Assume UUCICO is an "old-style" UUCICO (<= version 3.6).

-p	Disables automatic polls. Used to reserve the serial port for incoming
	calls (-pa). Also very handy for local tests with -d.

-x <n>
	Sets the UUCICO debug level (0..9).

In automatic mode, UUWORK waits for a signal on the RI line (pin 22), or for
incoming characters if told so (-c). It then sends ATA\r to the modem to answer
the phone and waits for a CONNECT. Then LOGIN is started (don't forget option
-a to LOGIN in CONFIG.SYS!). You must not (!) set the modem itself to auto-
answer; if you do, the ATA\r from UUWORK will reach the modem in the protocol
negotiation phase, which will make it hang up. The reason for this that HERMES
sites spend a considerable amount of time unpacking news batches, etc; if the
modem would auto-answer, there would be no login prompt, and the caller would
needlessly waste money on phone charges.
