home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / dumpgrp.zip / dumpgrp.doc < prev    next >
Text File  |  1993-09-07  |  5KB  |  115 lines
  1. DUMPGRP Beta 1
  2.  
  3. This is a quick and dirty hack program with one purpose in life. For 
  4. those using OS/2 2.x and IBM TCP/IP, who have access to an NNTP server,
  5. this program provides the ability to get messages from a news group into 
  6. a flat file on your OS/2 machine. Personally, I use this in combination 
  7. with John Steven's (jstevens@csn.org) excellent unpost utility to 
  8. download binaries groups such as comp.binaries.os2 and unpack all the 
  9. executables in the background. Ain't OS/2 wonderful?
  10.  
  11. Note: the most recent version of DumpGrp and a version of the above 
  12. mentioned unpost utility compiled for OS/2 are available via anonymous 
  13. ftp from my desktop machine (elvis.wicat.com, 192.150.148.53). Note that 
  14. this is my development machine, so it may be down or intolerably slow at 
  15. any point. I will also send updates to hobbes (ftp-os2.nmsu.edu, 
  16. 128.123.35.151).
  17.  
  18. Using DUMPGRP:
  19.  
  20. To start up DUMPGRP, you will need OS/2 2.0 or higher, IBM TCP/IP 1.2.1 
  21. (preferably with the most recent CSD), and access to an NNTP server. If 
  22. you have all these things, you must first create a configuration file. 
  23. The default name for this file is DUMPGRP.CFG, but you can make it 
  24. anything you like. This should be a plain text file, with the following 
  25. information on each line:
  26.  
  27. <group name> <file name> <last message read>
  28.  
  29. The group name is (strangely enough) the name of the group you wish to
  30. download. The file name is the name of the file new messages in the 
  31. group will be dumped to. The last message read is maintained by DUMPGRP;
  32. you should initially set it to 0 (which means that all messages will be 
  33. read on the first run.)
  34.  
  35. For example, the following is a portion of my DUMPGRP.CFG:
  36.  
  37. comp.binaries.os2 c:\incoming\cbos2.uue 0
  38. comp.binaries.ibm.pc c:\incoming\cbibmpc.uue 0
  39.  
  40. DUMPGRP is not very clever about the configuration file; do not insert 
  41. blank lines or anything but lines in the above form.
  42.  
  43. Once you have a configuration file, you may run DUMPGRP. The program 
  44. takes the following parameters:
  45.  
  46. -s<server name> :       this is required, and specifies the name of your NNTP
  47.                         server.
  48.  
  49. -p<port number> :       this is optional, and specifies the NNTP port on the
  50.                         above server. The default value is 119, which should
  51.                         work pretty much everywhere.
  52.  
  53. -c<configuration file> :this is optional, and specifies the full name
  54.                         and path of a configuration file (as described 
  55.                         above). If this is not specified, DUMPGRP will
  56.                         look for DUMPGRP.CFG in the current directory 
  57.                         only, and will abort if it is not found.
  58.  
  59. -t<temporary file> :    this is optional and specifies the full name and
  60.                         path of a temporary file DumpGrp will use while 
  61.                         running. If this is not used, the path will be 
  62.                         the value of the TEMP or TMP environment 
  63.                         variable (or the root directory of the current 
  64.                         drive if neither is defined), and the filename 
  65.                         will be DUMPGRP.TMP.
  66.  
  67. -l<separator line> :    this is optional, and specifies the line of text
  68.                         which will separate messages in the output file.
  69.                         The string you specify may contain any ASCII 
  70.                         characters. The default is a line of asterisks.
  71.  
  72. -a :                    this is optional, and specifies Append mode. In 
  73.                         append mode, DumpGrp appends the new messages in 
  74.                         a group to the file specified in the 
  75.                         configuration file. By default, DumpGrp will 
  76.                         overwrite the output file each time it is run.
  77.  
  78. -r :                    this is optional, and specifies receive header mode.
  79.                         In this mode, the line
  80.  
  81.                             X-Received: MM:DD:YYYY HH:MM
  82.  
  83.                         will be written to the file before each message,
  84.                         giving the date and time the message was 
  85.                         received by DumpGrp. The only real reason for 
  86.                         this is to allow the Expire utility to work (see 
  87.                         EXPIRE.DOC).
  88.  
  89. For example, the following command:
  90.  
  91.     DUMPGRP -snntp.bogus.com -cc:\tcpip\etc\dumpgrp.cfg -l---END-ARTICLE---
  92.  
  93. will make DUMPGRP attach to the server nntp.bogus.com at the default
  94. port of 119 and use the specified configuration file rather than looking 
  95. in the current directory.
  96.  
  97. If all is well, DUMPGRP will fill the files specified in the 
  98. configuration file with all the messages since the last time DUMPGRP was 
  99. run. The line "---END-ARTICLE---" will appear after each message rather than
  100. the default line of asterisks.
  101.  
  102. Any existing files will be overwritten since the -a switch was not 
  103. passed to DumpGrp.
  104.  
  105. This program is copyrighted but free. Use it however you see fit, distribute
  106. it however you see fit. You may not, however, charge anything beyond a
  107. reasonable media or handling fee for the distribution of this program.
  108.  
  109. 5/23/93, Kevin Vigor
  110.  
  111. kevin@elvis.wicat.com
  112. kevin@wicat.com
  113. 72500.3705@compuserve.com
  114.  
  115.