home *** CD-ROM | disk | FTP | other *** search
/ Telecom / 1996-04-telecom-walnutcreek.iso / technical / ixo.program.scripts / README < prev    next >
Text File  |  1993-02-14  |  2KB  |  61 lines
  1. READDME -- General information about "tpage"
  2.   by Tom Limoncelli, tal@warren.mentorg.com 
  3.  
  4.   Copyright (c) 1992, Tom Limoncelli
  5.   The sources can be freely copied for non-commercial use only
  6.   and only if the source is unmodified.
  7.  
  8. "tpage" or "Tom's Pager System" is a set of programs that let
  9. you send messages to alpha-numeric pagers using the "IXO" protocol.
  10. It supports a dialing directory, a "who's on duty now" schedule,
  11. and can do special tricks with RFC822-format email.
  12.  
  13. The system has the following features:
  14.  
  15. ...sends pages to any pager system that supports the IXO protocol.
  16.  
  17. ...additional protocols can be added. (I'll write the touch-tone
  18.       protocol soon).
  19.  
  20. ...can parse email messages and extract the interesting info from
  21.    them resulting in shorter messages.
  22.  
  23. ...can copy it's input to stdout and therefore can be used as a "tee".
  24.  
  25. ...maintains a directory of people's phone numbers/PINs.
  26.  
  27. ...can page "the person on duty" (searches a schedule).
  28.  
  29. ...schedule can have slots that are empty, but find someone anyway if
  30.    the message is marked "urgent".
  31.  
  32. ...with programs like procmail, permits you to send certain email
  33.    messages to your pager.
  34.  
  35. ...a list of modems can be given to the daemon.
  36.  
  37. How it works (and how all the programs fit together):
  38.  
  39. o  beep2.pl takes command-line and stdin, reads the schedule, looks
  40.    up people's paging info in the directory, and queues the message.
  41. o  tpaged.pl should always be running.  Every 30 seconds it wakes up
  42.    to check the queue for messages.
  43. o  tpaged.pl then sorts and batches the messages.
  44. o  tpaged.pl then calls the appropriate program to do the protocol
  45.    (currently that's ixocico but others can be written) and watches
  46.    the output for messages:
  47.    "#MESOK x" which means that message "x" was successful and can be
  48.        deleted from the queue.
  49.    "#MESREJECT x" which means that message "x" was rejected and should
  50.        be deleted from the queue.  Email will be sent to the person
  51.        that sent the page.
  52.     Messages that can't be deleted from the queue (due to NFS problems
  53.        or whatever) are added to a "blacklist" in memory, and are not
  54.        retried.
  55.  
  56. For installation instructions, read INSTALL.
  57. For program history, read HISTORY.
  58.  
  59. If you aren't using "procmail", you're working too hard.  Check
  60. "archie" for a location near you!
  61.