home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / qwksplit.zip / QWKSPLIT.DOC < prev    next >
Text File  |  1994-07-15  |  4KB  |  91 lines
  1.  
  2.  
  3.  
  4.  
  5.           QWKSplit - A *.MSG creation tool for QWK style messages.
  6.  
  7.        Craig Morrison, 15 July 1994, Released into the Public Domain.
  8.  
  9.  
  10.  
  11.  
  12.  
  13.   QWKSplit takes a text file and splits it up into one or more QWK style
  14. messages which get placed into a *.MSG file, which can then be compressed into
  15. a *.REP file and uploaded to a QWK style mail door. I wrote this so that I
  16. could send UUENCODED files through the Internet via a TomCAT! mail door without
  17. the hassles of uuencoding the file and then breaking it up into separate
  18. messages by hand.
  19.  
  20.   Operation of the program is simple and straight-forward, at an OS/2 command
  21. prompt type:
  22.  
  23.     QWKSPLIT <qwksplit.cfg> <textfile>
  24.  
  25.   <qwksplit.cfg> is the name of a simple text configuration file that tells
  26.   QWKSPLIT what it needs to know to create the *.MSG file for the mail door
  27.   that you use.
  28.  
  29.   <textfile> is the name of the textfile you want split up.
  30.  
  31.   A sample QWKSPLIT.CFG is included with QWKSplit and an explanation of the
  32. keywords that can be used in the file follows..
  33.  
  34.                           Sample - QWKSPLIT.CFG
  35. ─────────────────────────────────────────────────────────────────────────────
  36. BBSID NFE
  37. Conference 14
  38. To Ronald Van Iwaarden
  39. From Craig Morrison
  40. InternetTo rvaniwaa@carbon.denver.colorado.edu
  41. Password
  42. Lines 50
  43. ─────────────────────────────────────────────────────────────────────────────
  44.  
  45. BBSID is the name that your mail door uses for your QWK files. If when you
  46. download a QWK packet and the name is MYQWKPKT.QWK, then the BBSID would be
  47. MYQWKPKT. This is REQUIRED and must be 8 characters or less.
  48.  
  49. Conference is the conference *_number_* of the message area that the messages
  50. should be placed in. If you need help with this one, ask the sysop of the BBS
  51. that you call to download your mail from. This is REQUIRED.
  52.  
  53. To is who you are addressing the message to, if it is not present, it defaults
  54. to ALL. 25 characters max for this one.
  55.  
  56. From is your name, 25 characters max.. It is REQUIRED.
  57.  
  58. InternetTo is for use when you are sending mail through a UUCP account or like
  59. I do, through a BBS that has a special area set up for Internet mail. It is the
  60. Internet address of the recipient of the message(s). QWKSplit will
  61. automatically generate a flush left line at the top of the message that is
  62. correctly formatted so that most UUCP software can figure out where to send the
  63. message to. This field is optional, it is only needed for Internet style
  64. addressing. 80 characters, max.
  65.  
  66. Password I don't really understand all too well. If you need to use a password
  67. in your QWK mail you'll know what this is for. It is optional and can be a
  68. maximum of 12 characters.
  69.  
  70. Lines is the maximum number of lines you want in each message. If left out, the
  71. default is 55.
  72.  
  73. The output file will be created in the current working directory and named
  74. BBSID.MSG, where BBSID is what you entered for BBSID in the configuration file.
  75. All that is left for you to do after running QWKSplit is to compress the
  76. BBSID.MSG file into a BBSID.REP file and upload it to the BBS you get your mail
  77. from.
  78.  
  79. The source code is included in the archive, if QWKSplit doesn't work for you,
  80. then fix it so it does and spread it around. Just don't try to make any money
  81. off of my work, I released it into the public domain for a reason. When I
  82. needed this type of utility I couldn't find one.
  83.  
  84. Have fun with it..
  85.  
  86. Craig
  87.  
  88. FIDONET:    1:201/60
  89. Internet:   craig.morrison@nfe.com
  90.  
  91.