READDME -- General information about "tpage" by Tom Limoncelli, tal@warren.mentorg.com Copyright (c) 1992, Tom Limoncelli The sources can be freely copied for non-commercial use only and only if the source is unmodified. "tpage" or "Tom's Pager System" is a set of programs that let you send messages to alpha-numeric pagers using the "IXO" protocol. It supports a dialing directory, a "who's on duty now" schedule, and can do special tricks with RFC822-format email. The system has the following features: ...sends pages to any pager system that supports the IXO protocol. ...additional protocols can be added. (I'll write the touch-tone protocol soon). ...can parse email messages and extract the interesting info from them resulting in shorter messages. ...can copy it's input to stdout and therefore can be used as a "tee". ...maintains a directory of people's phone numbers/PINs. ...can page "the person on duty" (searches a schedule). ...schedule can have slots that are empty, but find someone anyway if the message is marked "urgent". ...with programs like procmail, permits you to send certain email messages to your pager. ...a list of modems can be given to the daemon. How it works (and how all the programs fit together): o beep2.pl takes command-line and stdin, reads the schedule, looks up people's paging info in the directory, and queues the message. o tpaged.pl should always be running. Every 30 seconds it wakes up to check the queue for messages. o tpaged.pl then sorts and batches the messages. o tpaged.pl then calls the appropriate program to do the protocol (currently that's ixocico but others can be written) and watches the output for messages: "#MESOK x" which means that message "x" was successful and can be deleted from the queue. "#MESREJECT x" which means that message "x" was rejected and should be deleted from the queue. Email will be sent to the person that sent the page. Messages that can't be deleted from the queue (due to NFS problems or whatever) are added to a "blacklist" in memory, and are not retried. For installation instructions, read INSTALL. For program history, read HISTORY. If you aren't using "procmail", you're working too hard. Check "archie" for a location near you!