home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / PPPBCKP / GRPS1020.ZIP / GRPS1020.FAQ < prev   
Text File  |  1997-10-21  |  12KB  |  274 lines
  1. ``Eileen Stone`` #2@2910.TerraNET
  2. Mon Oct 20 13:25:43 1997
  3. "FILEnet Newsgroups for Dummies FAQ" 
  4. FAQ version 0.13 
  5. Written by Eileen Stone of the MultiVersal Dreams BBS, 2@172.FILEnet
  6. Revised October 20, 1997
  7.  
  8.  
  9. TABLE OF CONTENTS:
  10. ===========================================================================
  11. I.    Files needed to run the Project.
  12. II.   Altering the network files to connect you to the newsgroup node.
  13.     1.  Create Group 99 in your BBSLIST.0 file.
  14.     2.  Create/Alter BBSLIST.99 file.
  15.     3.  Create/Alter CONNECT.99 file.
  16.     4.  CALLOUT.NET entry format.
  17.     5.  Force Analysis of your FILEnet Network connection.
  18. III.  Configuring the PPP Project files for your system's set up.
  19.     1.  News server in NET.INI must be defined.
  20.     2.  [NEWS] subsection must be uncommented.
  21.     3.  NEWSHOST line must also be uncommented and filled out.
  22. IV.   Setting up and using the NEWS.RC file.
  23.     1.  Creating NEWS.RC file.
  24.     2.  How to get the current list of newsgroups in a file named NEWSRC.
  25.     3.  Put newsgroups you want in NEWS.RC in the following format:
  26.         "THE NEWS.RC FORMAT DIAGRAM."
  27.     4.  How to spool a newsgroup instead of making it a sub.
  28.     5.  Subscribe to newsgroup via //Boardedit, with usage advise.
  29.     6.  Add @32767 to your N*.NET files for the newsgroups you want.
  30.     7.  Force a call to @32767 to download the NEWSRC file and newsgroups.
  31. V.    Removing a newsgroup.
  32.     1.  Remove the sub from //boardedit if you recieved it that way.
  33.     2.  Remove the newsgroup line from NEWS.RC.
  34. VI.   Mod to allow the "/" in callout net to parse as hours, not days.
  35.     1.  Explanation of mod, and mod code.
  36.     2.  Proper use of the mod.
  37. ==========================================================================
  38.  
  39.  
  40. I.   Firstly, are you set up with the latest files, version 1.4 or better?
  41. A good place to look is at http://www.owt.com/users/quixotic/ppp-WWIV.
  42.  
  43. The four files you need are: 
  44.  
  45. pppp4j14.zip, -- The newest basic file.
  46. ppp15b26.zip, -- The latest upgrade.
  47. klospppw.zip, -- Use this if you run a multitasker.  Use version 1.43
  48. exp097.zip,   -- The module for exporting to mail or newsgroups,
  49.                  or the EXP module distributed with the project.
  50.  
  51. It is also recommended that you get Quixotic Quest's FAQ, and the latest
  52. version of this FAQ.  Quixotic's FAQ goes into much more detail in sections
  53. I-II than this one does.  This FAQ only covers those subjects as they 
  54. relate to problems a reader might have with his newsgroup connection.
  55.  
  56.  
  57. II.  Second, make sure you are connected to the newsgroup node:
  58. Altering the FILEnet Network files in the drive:\bbs\net\FILE* dir.
  59.  
  60. (1)
  61. Check to see if there is a group 99 in the bottom of the BBSLIST.0 file.
  62. If there is not, add it to the file, in the same manner as the others
  63. are listed.
  64.  
  65. (2)
  66. Creat a BBSLIST.99 file, if you need one, and check to see if there is 
  67. a node @32767, in the BBSLIST.99 file, like this:
  68. @32767   *999-PPP-NEWS #00300   !$   [-1]   "Internet Newsgroups and Mail"
  69.  
  70. (3)
  71. Your CONNECT.99 file, which you may have to create, should look like this:
  72.  
  73. @your node 32767
  74. @32767 your node
  75.  
  76. (4)
  77. In your CALLOUT.NET; besides your other connects (and after them), you 
  78. should have a line that looks like this:
  79.  
  80. @32767 & 
  81.  
  82. NOTE: It is VERY important that you don't have the semi-colon ( ; ) used 
  83. for compression on this line.  You cannot connect to the newsgroups if
  84. you have this character included.
  85.  
  86. (5)
  87. Force a network analysis using the command Network3 .x Y from the DOS
  88. prompt in the main BBS directory.  Where x is one less than the network 
  89. number for FILEnet as shown in INIT.  Check the feedback from FILEnet.
  90. If all is OK, you should have one system routing through @32767.  If you
  91. have zero, make sure you edited the above files properly.  If you have 
  92. more than one, then make sure that @32767 is not listed in any of the
  93. other BBSLIST.x or CONNECT.x files.  (Node @32767 is a fictional node, used
  94. to trick the software to download newsgroups and Internet mail.  If more 
  95. than one system routes through #32767, you will lose all network traffic
  96. attempting to use that path.) 
  97.  
  98.  
  99. III.  Altering the PPP Software configuration files.
  100.  
  101. (1)  
  102. You must set up your NEWS server, defining it NET.INI, found in the main 
  103. bbs directory.
  104.  
  105. (2)  
  106. At the bottom of the same file, there should be a subsection called: [NEWS].  
  107. Make sure that is not commented out by having a semi-colon (;) in front 
  108. of this line.
  109.  
  110. (3) 
  111. Make sure the NEWSHOST line is uncommented as well.  Put in the name of
  112. your news server for your ISP on this line.  The numerical address seems 
  113. to work better than the alphanumeric version.
  114.  
  115.  
  116. IV.  Then, once you are connected to the newsgroup node:
  117.  
  118. (1) 
  119. Create a new file called NEWS.RC in the FILEnet Net directory.  You will 
  120. list your newsgroups in this file, one to a line.  For the proper format, 
  121. see Section IV-3.
  122.  
  123. (2)
  124. If you also want a list of all current newsgroups, put at the very top 
  125. of the file NEWS.RC "newsrc" (no quotes), and it will download the current 
  126. list for you.  It will make a file called NEWSRC with one newsgroup listed
  127. per line, for all the 18000 plus newsgroups, (or however many there are
  128. listed at your local host).
  129.  
  130. Previous to Beta 52, this will *NOT* update automatically for now.  If you
  131. wanted a new list before this version, you deleted or renamed the newsrc
  132. file, and did this step again.  See section IV-7 for how Beta 52 changed
  133. this situation, and how the auto-update functions.
  134.  
  135. HINT: If you want users to be able to request newsgroups, make the NEWSRC
  136. file available as a bulletin or as a file for downloading.
  137.  
  138. (3)
  139. In the NEWS.RC file put in (as a sample) some low-volume newsgroups, I used 
  140. alt.bbs.WWIV (pretty much devoted to PPP coversations, now).  
  141. In this format:
  142.  
  143. THE NEWS.RC FORMAT DIAGRAM
  144.  
  145. + CASE SENSITIVE NEWSGROUP NAME(a)
  146. |            + ---------------- LOWEST ARTICLE # READ(b)
  147. |            | + ------------------------------------ ALL NUMERIC SUBTYPE(c)
  148. V            V V                
  149. alt.bbs.WWIV 0 1001
  150.  
  151. Parts of the NEWS.RC format diagram.
  152.  
  153. a.  Name.
  154. Newsgroup Names are usally lower case.  Check NEWSRC for _exact_ syntax.
  155. Without the EXACT newsgroup name, you cannot connect to the group.
  156.  
  157. b.  Article number.  
  158. Once you have a current newsrc file, you can see the highest article number 
  159. listed at the server.  If you wish to sample the group, put in a number 
  160. that is perhaps 50 below this number.  If you put in 0, it will grab in the 
  161. latest x articles, where x is the maximum messages defined in Boardedit.
  162.  
  163. c.  Subtypes.  
  164. Before PPP 1.5 beta-25, the subtypes could only be numeric, but the 
  165. project can now accept alphanumeric subtypes standard to WWIV.  If you are 
  166. using numerical subtypes with an easily guessed scheme, CHANGE THEM NOW!
  167. There have been instances of boards hacking spam through legitimately
  168. posting boards, and better safe...  Be sure to delete your old N*.net 
  169. files, and add @32767 to the new alpha n*.net files, because WWIV will not 
  170. do that for you automatically.  If you are changing your subtypes, also be 
  171. sure to change the subtypes in your news.rc file, as that needs to coincide 
  172. with your new n*.net file.  I don't know why, but the alpha characters in 
  173. the subtypes in news.rc MUST be in ALL-CAPS, if not the messages bounce as 
  174. unknown/unwanted.  Maybe it's because most ISP's are UNIX boxes, and they 
  175. run on a case sensitive operating system, or maybe it's a quirk of the 
  176. current PPP program, but the result is that (in my experience) subtypes 
  177. with letters in them MUST be all *capital* letters.
  178.  
  179. (4)
  180. If you make the Subtype number 0, as well.  The articles will concatenate 
  181. as one file in the SPOOL directory.  This is useful for binary newsgroups.  
  182. This can also be used as another way to test a newsgroup before exposing 
  183. your readers to it.  (Testing for volume, content, etc.)
  184.  
  185. (5)
  186. In Boardedit subscribe to the newsgroup, using the subtype you determined 
  187. above, and making _yourself_ host.  (Recommended: say no to listing the sub 
  188. in the subs.lst, and say no for autorequests.  Since each member of FILEnet 
  189. connected to the Internet can better get newsgroups for themselves, there 
  190. is generally no benefit for gating them around.  Possible exceptions to 
  191. this rule of thumb include gating to local systems on other networks, to 
  192. Non-Internet connected FILEnet nodes, and in cases where a node's news 
  193. server is censoring newsgroups.)  Make a unique filename as usual.
  194.  
  195. NOTE: It also works to make @32767 to be the host of the newsgroup.  Using 
  196. this method eliminates the N*.NET files, and allows you to Net-Val for 
  197. *your* users if, for instance it's a moderated newsgroup and you don't want
  198. just any moron to post on it.  If you use this method, skip to part IV-7.
  199.  
  200. (6)
  201. In DOS, or whatever, edit the N*.NET file in your Filenet directory, (or 
  202. N####.NET where #### is the Subtype for the group) and add at the top 
  203. 32767.  Save the file.  You have manually added the ficticious newsgroup 
  204. node as a subscriber.
  205.  
  206. (7)
  207. Force a connect to @32767, it will download the current newsrc file if you 
  208. asked it to do so, as per section IV-2, and will give some posts from the
  209. newsgroups you defined.  They will be the latest available messages, so
  210. you'll probably have to wait a while to get any more posts.
  211.  
  212. It will delete the newsrc top line, and change the middle numbers of each
  213. of the other lines to the number of the highest article.  It will update
  214. this number every time you connect. Anytime you want to check for new
  215. messages, just force a callout, or if you're lucky, you can set it up to
  216. check automatically every hour or so.
  217.  
  218. [NEW!!] Starting with Beta 52, and perfected in Beta 53, the program will
  219. now automatically download a copy of the newest newsrc list at the first of
  220. every month, and then download daily updates of the changes that might show
  221. up in between the monthly events.
  222.  
  223.  
  224. V.  How to Remove newsgroups.
  225.  
  226. (1)  
  227. Remove the newsgroup subboard as usual in Boardedit.  If you had the 
  228. newsgroup set to spool, only the next step is neccessary.
  229.  
  230. (2)  
  231. Then remove the line in NEWS.RC that has that newsgroup defined.
  232. Failure to do this part may cause an error, as there is no subtype of
  233. the number you first defined, and the subtype is not 0.  See section
  234. III-3 for details of the results if you change the subtype to 0.
  235.  
  236.  
  237. VI.  FILEnet mod for CALLOUT.NET
  238.  
  239. (1)
  240. Since newsgroups are fairly active on the Internet, and most providers 
  241. don't increase your costs with a high number of calls, you might want to 
  242. have your board call out every few hours to pick up the latest messages 
  243. and/or network packets.  To do this, you'll need to make a mod to your 
  244. source code.  For WWIV 4.23 through 4.24a (and perhaps beyond), you need 
  245. to change one line in NETSUP.C, void attempt_callout(void):
  246.  
  247.       if ((ok) && (i2!=-1)) {
  248.         if (ncn[i2].bytes_waiting==0L)
  249.           if (con[i].call_anyway) {
  250.             l1=(l-ncn[i2].lastcontact+60*3)/SECONDS_PER_HOUR;   /* change */
  251.             if (((unsigned char)l1 < con[i].call_anyway) ||
  252.                ((con[i].options & options_sendback)==0))
  253.               if (!net_only)
  254.                 ok=0;
  255.  
  256. (2)
  257. To activate this "call anyway" feature, you need to add the / parameter to
  258. CALLOUT.NET.  Make your @32767 entry look like:
  259.  
  260. @32767 & /3
  261.  
  262. to force a callout roughly every three hours.  (Note without the mod, this
  263. means force a callout every three days).  You might want to make the same
  264. change to your other FILEnet Internet connects as well, to speed up the
  265. normal network packets as well.
  266.  
  267.  
  268. ==========================================================================
  269. Hope this helps, and I will update this file as the situation requires, 
  270. and repost it as needed.  I can autopost it monthly, and if there are any
  271. problems or suggestions, please email me.
  272.  
  273. Newsgroup FAQ maintainer: Eileen Stone, #2 @172.FILEnet
  274.