home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume6 / newbatcha / README < prev   
Encoding:
Text File  |  1986-11-30  |  3.0 KB  |  61 lines
  1. The program provides a better way to handling batching of USENET news
  2. to neighboring sites.  It works with 2.10B and later, including
  3. 2.10.3B, which provides compression batching.
  4.  
  5. Please send any questions and bug reports to me (bpa!espo) for
  6. distribution to the net.  This software is public domain, and cannot be
  7. sold for any profit.
  8.  
  9. Nbatcher was written for UNIX (trademark of AT&T) System V, but should
  10. be compatible with most version currently being used today.  It is
  11. presently running on a VAX (trademark of DEC) 11/780 feeding 5 remote
  12. sites with news.  Two important issues MUST be noted here.
  13.  
  14. Since nbatcher checks the UUCP directory for each site listed in the
  15. control file, directory configuration should be UUCPDIR/sitename, e.g.
  16. /usr/spool/uucp/foo for site foo.  But since not everyone is generic,
  17. I've allowed nbatcher to skip over the UUCP byte counting routine if
  18. this is not so.  In addition to this, some uucpcleanup daemons remove
  19. the site directory if there's nothing spooled there.  When this
  20. happens, nbatcher will notify you of this and continue on.
  21.  
  22. The other issue is that you MUST configure your NEWSLIB/sys file using the
  23. batch syntax as described in the USENET Installation document.  Field 3
  24. should contain the `F' flag indicating a batched transmission for that
  25. site and field 4 should contain the filename where news article's full
  26. pathname will be appended to.  Nbatcher requires that the filename in
  27. field 4 match the sitename in the control file.  For example, the entry:
  28.     foo:net,mod,usa,na,to.foo:F:/usr/spool/batchnews/foo
  29. says that all news articles going to site `foo' will be batched, using
  30. the file `foo' in /usr/spool/batchnews.  Nbatcher's control file entry:
  31.     foo:3,14,22:16:150000:
  32. will get the news article's full pathname from /usr/spool/batchnews/foo
  33. for batching.  This requirement MUST be adhered to for nbatcher to work
  34. correctly.  I believe most sites that batch news use this type of
  35. configuration, since its easy to keep track of a remote site's work.
  36. Note that the name of the directory "/usr/spool/batchnews" is set
  37. in the Makefile.
  38.  
  39. The manual page describes the control file, as does nbatcher.doc.  Note
  40. that even though nbatcher indicates max bytes has been reached, if that
  41. site gets compressed batches, the next time nbatcher runs for that site
  42. work could get scheduled.
  43.  
  44. Also included is a utility program called "bst," BatchSTatus, which
  45. shows who many news articles are currently in the batch file for each
  46. system.  Just type "make bst" for that and copy it to where you want,
  47. usually LIBDIR.  Note that bst does reads on the directory structure
  48. directly.
  49.  
  50. Installation is simple:  look at the first few #define's in nbatcher.h;
  51. also edit the Makefile for the appropriate BATCHDIR and LIBDIR for your
  52. site.  Type "make" or "make install."
  53.  
  54. NOTE:  Read the comments in parse.c concerning MAX_BYTES.  This is the
  55. maximum amount of bytes per site that's allowed in the control file for
  56. queue_size.  Change it at your own risk!
  57.  
  58.     Bob Esposito
  59.     bpa!espo
  60.     Bell of Penna.
  61.