home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / WWMAIL42.ZIP / WWIVMAIL.DOC < prev    next >
Text File  |  1992-08-12  |  38KB  |  805 lines
  1.  
  2.  
  3.      ▒▒▄   ▒▒▄  ▒▒▄   ▒▒▄  ▒▒▄  ▒▒▄ ▒▒█  ▒▒▒▄▄▒▒▒▄  ▒▒▒▒▒▒▄  ▒▒▄  ▒▒▄
  4.      ▒▒█   ▒▒█  ▒▒█   ▒▒█  ▒▒█  ▒▒█ ▒▒█  ▒▒█▒▒█▒▒█  ▒▒█▀▒▒█  ▒▒█  ▒▒█
  5.      ▒▒█   ▒▒█  ▒▒█   ▒▒█  ▒▒█  ▒▒█ ▒▒█  ▒▒█ ▀▀▒▒█  ▒▒▒▒▒▒█  ▒▒█  ▒▒█
  6.      ▒▒█▒▒▄▒▒█  ▒▒█▒▒▄▒▒█  ▒▒█   ▒▒▒▒█▀  ▒▒█   ▒▒█  ▒▒█ ▒▒█  ▒▒█  ▒▒█
  7.       ▀▒▒▒▒█▀▀   ▀▒▒▒▒█▀▀  ▒▒█    ▒▒█▀   ▒▒█   ▒▒█  ▒▒█ ▒▒█  ▒▒█  ▒▒▒▒▒▒▄
  8.         ▀▀▀▀       ▀▀▀▀     ▀▀     ▀▀     ▀▀    ▀▀   ▀▀  ▀▀   ▀▀   ▀▀▀▀▀▀
  9.  
  10.  
  11.                              WWIVMail/QWK V4.2
  12.                        Copyright 1992 By Michael Leib
  13.                   A .QWK Compatible Off-Line Mail Door For
  14.                              The WWIV BBS System
  15.  
  16.       =================================================================
  17.           WARNING: WWIVMail/QWK v4.2 is ONLY for WWIV v4.20+ or Newer.
  18.           (WWIVMail/QWK 4.2 NEEDS files only available under those versions
  19.            of WWIV) 
  20.       =================================================================      
  21.           WARNING: If you are upgrading from a previous version of
  22.           WWIVMail or WWIVMail/QWK, please delete the wwivmail.usr user
  23.           file...the record size is different and the file should be 
  24.           started clean.
  25.       =================================================================
  26.        
  27. Contents
  28. ========
  29. WWIVQWK.EXE   32/64-SUB SELF-DETECTING WWIVMail/QWK.
  30. WWIVCFG.EXE   CONFIGURATION PROGRAM FOR WWIVMail/QWK SYSOP OPTIONS.
  31. WWIVMAIL.DOC  DOCUMENTATION FOR WWIVMail/QWK. (THIS FILE)
  32. WWIVMAIL.REV  REVISION HISTORY/CHANGES IN WWIVMail/QWK.
  33. WWIVMAIL.CFG  SAMPLE OUTPUT FROM WWIVCFG.EXE.
  34. REGISTER.LST  LISTING OF ALL CURRENTLY REGISTERED SYSOP/BBS BOARDS.
  35. MORGUL01.MOD  MOD TO RUN WWIVMAIL/QWK OFF MAIN BBS MENU
  36.    AND
  37. QWK.LIB       WWIVMail/QWK LIBRARY TO LINK WITH USERREC.C
  38. QWK.BAT       .BAT FILE TO COMPILE AND LINK WWIVQWK.EXE
  39. USERREC.H     HEADER FILE FOR USERREC.C 
  40. USERREC.C     C FILE TO COMPILE WITH YOUR VARDEC.H AND LINK WITH QWK.LIB
  41.  
  42. Introduction
  43. ============
  44.         There have been MANY changes in this version of WWIVMail/QWK, so 
  45. please take the time to read this documentaion. 
  46.  
  47.         So, for those who haven't looked at this program before, WWIVMail/QWK
  48. (formally known as WWIVMail) is a fully .QWK (Q-Mail Packet (c)) Compatible
  49. Off-Line Mail Door for the WWIV BBS System. It generates .QWK Mail packets
  50. that can be read by a huge number of Public Domain/Freeware/ShareWare Mail 
  51. Readers and can accept response messages (.REP) from those readers and 
  52. incorporate those messages back into your WWIV BBS System.
  53.  
  54.         I am not going to go into a long dissertation about the history
  55. of .QWK Mail packets or about the structure thereof. Those questions
  56. can be answered by reading the documentation in any .QWK compliant Mail 
  57. Reader. Let me just say that, as far as I know, WWIVMail/QWK is the first 
  58. .QWK Mail Door available for the WWIV BBS System. WWIVMail, in it's earlier
  59. form, has been around for over 1 1/2 years with great success. I am proud 
  60. to be the author of this software, and will continue to support it until 
  61. I die or Wayne Bell does. (Well, maybe till I create something better!)
  62.  
  63.         WWIVMail/QWK supports all standard-documented features of the 
  64. original.QWK packet system as incorporated in the Q-Mail(c) Mail System
  65. approx 5+ years ago, as well as, the ADD/DROP Sub capability supported by
  66. several .QWK readers. The standard support in WWIVMail/QWK includes System
  67. Bulletins, Newsfile and an optional New Files Scan (which can be toggled 
  68. on and off by the user). This wasn't an easy task because of Wayne Bell's
  69. WWIV(c) message base design; however, WWIVMail/QWK converts all STANDARD 
  70. WWIV messages and e-mail into standard .QWK format. (message.dat)
  71.  
  72.         Personal E-mail, as well as all Public Posts, can also be uploaded 
  73. through WWIVMail/QWK in the .QWK stanadrd .REP response packet.
  74.  
  75.         WWIVMail/QWK Also supports WWIV BBS Systems with Modified Userrec
  76. vardec.h file structures by allowing you to compile your own version
  77. with a freely distribulted .LIB created for Borland C++ 2.0/3.0/3.1.
  78. (Full source code is available for download to registerred user's; however,
  79. everything you need for a modified userrec structure is included in this
  80. package). 
  81.  
  82. Files in a .QWK Packet That WWIVMail/QWK Creates:
  83. =================================================
  84. HELLO                =>    Openning BBS Welcome Screen       
  85.                            /* welcome.ans/.msg */
  86. GOODBYE              =>    Closing BBS Goodbye Screen
  87.                            /* logoff.ans/.msg */         
  88. BBSNEWS              =>    BBS News File          
  89.                            /* sysop optional/definable */             
  90. CONTROL  DAT         =>    BBS Message Subs/BBS Information Data File
  91.                            /* WWIVMail/QWK generated */
  92. DOOR     ID          =>    Information About WWIVMail/QWK
  93.                            /* WWIVMail/QWK generated */
  94. BLT-0    X           =>    BBS Bulletins (1-10)    
  95.                            /* sysop optional/definable */
  96. .
  97. .
  98. .
  99. MESSAGES DAT         =>    All Messages For User To Read
  100.                            /* WWIVMail/QWK generated */  
  101. 000      NDX         =>    Message Base Index Files (000-032/000-064)
  102.                            /* WWIVMail/QWK generated */    
  103. .
  104. .
  105. .
  106. NEWFILES.DAT         =>    NewFiles Since User Last Logged-On
  107.                            /* WWIVMail/QWK generated. User Option */
  108.  
  109. To see how to set the Sysop Options(mentioned above), see the information
  110. below regarding WWIVCFG.EXE.
  111.  
  112. Features (Among A Cast Of 1000's)
  113. ========
  114. (1)     Built-in Communication routines( no need to monitor dos interrupts ).
  115.         Including Built-In support for hardware flow-control and, hence,
  116.         support for comm port speeds up to 38,400.
  117. (2)     Ansi color graphics support.
  118. (3)     Easy to use interface.
  119. (4)     Use of External Transfer Protocol Engines (Such as DSZ ((c) Omen 
  120.         Technology)) to maintain high quality and compatibility among file
  121.         transfers.
  122.         See below for External Protocol documentation.
  123. (5)     Monitors Carrier Detect ( recycles back to the BBS ).
  124. (6)     2 minutes time-out between keystrokes.
  125. (7)     On-line Help.
  126. (8)     All system security is maintained( user will NOT have access to any 
  127.         message subs that they don't normally have access ) or be able
  128.         to Post on Subs that they are restricted from. Also, all Sysop
  129.         validation for Posts ( Net / User restrictions ) are maintained.
  130.         Also, the New Files scan option only looks at Transfer Section Areas
  131.         that the user has access to. (ie, AGE, DAR, AR, SL and DSL are
  132.         all checked ).
  133. (9)     Local User Q-Scan Data For Maximum User Friendliness....
  134. (10)    Optional Newfiles Scan right in the DOOR!
  135. (11)    Full WWIV Multi-Net(WWIV 4.21a) support capabilities built-in.
  136. (12)    Support for both 32 and 64 Messages Areas (Auto-Detecting). 
  137. (13)    Support for Modified Userrec's!
  138. (14)    Supports ANY compression programs that the BBS does(.zip,.arc,etc)...
  139.         Very helpful for non-IBM users.
  140. (15)    Translates WWIV Colors into ANSI codes if the user desires.
  141.  
  142. Registration/Compatibility/Licensing
  143. ====================================
  144.  
  145.         WWIVMail/QWK and it's related files are NOT public domain or freeware.
  146. The WWIVMail/QWK Mail Door is a copyrighted software product developed and
  147. owned by Michael Leib.
  148.  
  149.         The WWIVMail/QWK BBS executable is licensed "AS IS". Michael Leib
  150. is NOT responsible for any damage to your system, software or your life.
  151.  
  152.         There has been some concern with people who have been involved with 
  153. this project regarding compatibilty with their HEAVILY modified WWIV systems.
  154. Although WWIVMail/QWK can ( and will ) work with modified userrec's, I have
  155. fully tested this software with un-modified WWIV systems and have had
  156. no difficulty. However, this doesn't mean your WWIV will behave nicely if you
  157. have modified the way data is stored in the user's files( .dat, .sub, etc). 
  158. To get around this problem, I have no choice but to make the source code 
  159. available for you to compile with your vardec.h header file. At first I 
  160. really didn't want to do this but, in order to get everbody on the bandwagon
  161. ( as well as keep the spirit of WWIV alive), this seems the only fair 
  162. alternative..so, I have set-up the following standards:
  163.  
  164.         Registration:
  165.         =============
  166.         Lifetime Use of WWIVMail/QWK Door     -------------------   $20.00
  167.         Lifetime Use of WWIVMail/QWK Door Plus
  168.         Full Source Code                       -------------------  $30.00
  169.         (Compiles Under BC++ v2.0( or newer ) Compilers)
  170.         (Should work with TC++ 3.0( or newer ) as well.(untested)
  171.  
  172. (NOTE: If you are a registered owner of WWIVMail Source code, you
  173.        automatically receive ownership rights for WWIVMail/QWK. It will
  174.        cost you NOTHING to get the upgrade. Contact me (see below) and
  175.        I will let you know how to get the source code. Your key files
  176.        will still work with WWIVMail/QWK.)
  177.  
  178. I feel these prices are fair( in comparision to the other .QWK mail doors for
  179. Non-WWIV BBS systems) and the current cost of the WWIV BBS source code
  180. at 50.00..( Thanks Wayne! ) WWIVMail/QWK is almost a BBS in itself..It
  181. has built-in Communications routines, support for the upload and download
  182. of Public posts and E-mail, Full NET support, as well as the ability to scan
  183. the Transfer Section for New Files.
  184.  
  185. Now, why should I register?
  186.  
  187. 1)  WWIVMail/QWK is not crippled in any way. I have released it on trust.
  188.     I have, however, placed a key system in the door that places a 15 second 
  189.     delay banner in all UNREGISTERED door versions and flags all posts in
  190.     the tagline as [EVALUATION COPY]. Please take the time to register if 
  191.     you use this door, the cost is VERY low considering the time I have put
  192.     into creating it. I will respond to your mail the day I receive it 
  193.     (see below for address and contact information).
  194.  
  195.     WWIVMail and WWIVMail/QWK have been out for almost 2 years. I have spent
  196.     literally hundreds of hours working on this project and adding support
  197.     (compatibility) for all of Wayne Bell's enhancements. Please support my 
  198.     effort to enhance the capabilities of WWIVMail/QWK.
  199.  
  200. 2)  If you have modified the BBS's users files, the only way you'll get 
  201.     it to run is to purchase the rights to the source code. At the end of
  202.     this file you will see a listing of the BBS files that WWIVMail/QWK uses.
  203.     You can then compile the door with your modified vardec.h/net.h files
  204.     and then WWIVMail/QWK will run correctly. 
  205.  
  206.     Starting with WWIVMail/QWK  v4.0, I supply all the needed files to get
  207.     WWIVMail/QWK to run with a modifed userrec. However, if you have changed
  208.     ANY other structure that is in the list at the bottom of this file, you 
  209.     will have to get the source. (See below for info on compiling your own 
  210.     version of WWIVMail/QWK).
  211.  
  212. 3)  Sysop's who register always get priority regarding bug fixes and
  213.     enhancements....
  214.    
  215. 4) The time I have spent in writing WWIVMail/QWK is obvious. Please support
  216.    my endeavor and push me to continue to write support programs for 
  217.    WWIV. Among other programs created under my pen (actually, mouse!):
  218.  
  219.    WWIVFile : v1.1 External Transfer Section File Manager.
  220.                    Basically, an XTREE(c) Clone for WWIV Transfer Section
  221.                    management.
  222.    Topten   : v1.0 Lists the top Download Files from your BBS by section.
  223.    Master   : v1.0 BBS Door for users to Download A Master File List.
  224.  
  225.  
  226. Support
  227. =======
  228.  
  229. 1) Feel free to contact me via "The General" On Amber(#445@1)...
  230.    WWIV Home Board in Los Angeles, California.
  231.                          Or
  232.    "Michael Leib" on Rambo-Scan (#11@8856)
  233.  
  234. 2) Join the WWIVMail/QWK Support Sub on the WWIV Net.
  235.    Contact Rambo of Rambo-Scan BBS  (818) 566-7912.
  236.  
  237.    He will ALWAYS be runing the newest Beta of WWIVMail/QWK...
  238.    Beta copies may be picked-up (when available) to registered 
  239.    WWIVMail/QWK Sysops from Rambo-Scan.
  240.  
  241.    I call this board several times a week, if you post messages on
  242.    the WWIVMail/QWK sub, I will respond quickly.
  243.  
  244.    Send registration (or comments) to:
  245.  
  246.    Michael Leib
  247.    1740 N. Ontario St.
  248.    Burbank, Ca
  249.    91505
  250.   
  251.  
  252. Comments
  253. ========
  254.  
  255.         I currently support both working storage types of WWIV ver 4.2.
  256. Storage Type 0 stores each message in seperate files with a common header 
  257. file, whereas Storage Type 2( the default and most common ) stores all 
  258. messages in one .msg file. Type 1 is not functioning in WWIV 
  259. (last time I looked into it), so, I also fail to fully support it.
  260.  
  261.  
  262.         The .QWK message structure is a WHOLE lot different then the 
  263. standard WWIV message base system. In order to get Messages to fit properly,
  264. WWIVMail/QWK NEEDS to strip out all the WWIV color code sequences from
  265. posts. Also, the time and date structure is different (written out rather
  266. then military time standard); therefore, I have to convert those as well.
  267. Also, it appears as though SOME .QWK readers can only support 78 characters 
  268. accross the screen and, in ANSI mode, WWIV can do the full 80. Therefore, 
  269. SOME ANSI posts may not come out correctly. There is nothing that 
  270. WWIVMail/QWK can do. This is a design limitation of the .QWK packet 
  271. structure(and SOME of the readers!). So, although you may not have modified 
  272. any BBS structures, some small MODS that display the above functions 
  273. differently then in the stock manner may cause weird characters (or say 
  274. the loss of a date field or the such) to occur. This is normal and there 
  275. is nothing to worry about.
  276.  
  277. E-Mail
  278. ======
  279.         Since E-Mail in WWIV doesn't have a Message Sub, I send all
  280. Personal E-mail into Sub 0 in the .QWK Packet. This, in itself, doesn't
  281. hurt anthing BUT, if your 1st Message Base cannot be read by a User
  282. (They Don't Have Access To See It), then when they try to respond
  283. to their e-mail, they will not be able( get some error in a .QWK
  284. reader that the SUB doesn't exist). Therfore, I suggest that you make
  285. your first Message SUB viewable by all. They don't have to be able to
  286. Post on it, just read it. This has only been reported by One User, and,
  287. there really isn't anything I can do about it. The workaround, for the 
  288. User, is to pick another SUB, then everything will work well. This is
  289. a VERY rare problem, so, don't even worry about it but I did want to share
  290. the information!!!
  291.  
  292. Set-Up
  293. ======
  294.  
  295.         Ok, I assume that if you made it this far in the docs, I haven't 
  296. scared you away with all my talk of registration and compatibility.
  297.  
  298. 1) Executable 
  299.    Copy the file WWIVQWK.EXE to your main bbs dir.
  300.    (Where you keep your bbs.exe and config.dat )
  301.    
  302.    WWIVMail/QWK ver 4.2 has the ability to auto-detect whether you are using
  303.    a 32 or 64 sub version of WWIV. WWIVMail/QWK ONLY supports these 2 
  304.    configurations and their implementation as defined by Wayne Bell since
  305.    WWIV ver 4.12. Anything other then this will require you to register
  306.    and obtain the source from me for modification.
  307.  
  308.    This is the only file you will need.( See below for information regarding
  309.    the optional wwivmail.cfg file).
  310.  
  311. 2) Make sure you always maintain a couple of free megs of disk space for 
  312.    the .QWK packet creation( The user will be warned if disk space gets low ).
  313.    Since all upload and download packets are placed in the directory that
  314.    you have specified as your "TEMP" directory for WWIV, this is the place
  315.    that should have plenty of space....
  316.  
  317.    I allow the Sysop to override the location where the temporary packet
  318.    resides. If you wish the temporary files that WWIVMail/QWK creates to be
  319.    placed in any other location besides the BBS "TEMP" directory, you may 
  320.    set an environment variable to that location. In your autoexec.bat
  321.    (or in a .bat file that starts the BBS) put:
  322.  
  323.                         set wwivmail=xxxxxxxxxxxxxxxxxxxxxxxxxx.....
  324.  
  325.    where xxxxxxxxxxxxxxxxxxxxxxxxx represents the drive and path where the 
  326.    files will be placed. 
  327.    
  328.    Example: set wwivmail=d:\temp\files\junk\
  329.    (trailing \ is not needed..if you leave it off, I append it.)
  330.  
  331.    I find, however, that the "TEMP" directory works quite fine for 
  332.     most people. 
  333.  
  334. 3) Start the BBS and go into //chainedit:
  335.  
  336.         A. Description  : WWIVMail/QWK v4.2
  337.         B. Filename     : WWIVQWK.EXE
  338.         C. SL           : 10
  339.         D. AR           : None.
  340.         E. ANSI         : Optional
  341.        *F. DOS Interrupt: NOT Used
  342.         G. 300 Baud     : NOT Allowed
  343.        *H. Shrink       : Yes
  344.         I. Disable pause: No
  345.  
  346.         The only things you have to worry about here are these 2 options;
  347.         F. => DO NOT have the BBS monitor dos calls....this is not needed 
  348.               because WWIVMail/QWK has it's own com port initialization, 
  349.               reads and writes.
  350.         H. => You must have the BBS Shrink..not because my program takes alot 
  351.               of memory, but this is the only way in which WWIV will update
  352.               the qscan pointers...Don't worry, WWIVMail/QWK won't run if you
  353.               don't do this( and it will warn you ).
  354.        
  355. 4) Make sure you have a copy of ALL external programs in your path.  
  356.    [Used to compress the packets before transfer and the transfer protocols]
  357.  
  358.         WWIVMail/QWK's Use of External Protocols
  359.         ====================================
  360.         You must have DSZ(c) in your path because WWIV has Xmodem and Ymodem
  361.         built-in. WWIVMail/QWK doesn't...so, I use DSZ(c) to handle those two
  362.         basic protocols. After those two, WWIVMail/QWK will use the next six
  363.         transfer protocols as you have them set-up for the BBS( WWIVMail/QWK
  364.         will use the command-lines as they are in the INIT.EXE( stored in 
  365.         nextern.dat).
  366.  
  367.         This allows you to be assured that WWIVMail/QWK will run ( while 
  368.         transferring packets ) EXACTLY like the BBS. Any special command-lines
  369.         that you had to implement for your high-speed modem or strange 
  370.         configuration will be maintained in WWIVMail/QWK!. (Nifty Huh?)
  371.  
  372.    Due to the above, You will need (For Sure) a copy of Omen Technology's 
  373.    DSZ(c)in your path.(it need not be registered)(Available on almost any BBS)
  374.    [Used to transfer the packet for the default xmodem and ymodem choices]
  375.  
  376.    You will also need to have each compression program(.zip, .arc, etc)
  377.    that you have listed in your init.exe (config.dat) as supported on your 
  378.    BBS in your path so the user can pack/extract the .QWK/.REP packets.        
  379.  
  380.    The user has the option of selecting a default choice of transfer
  381.    protocol and compression type. The list they choose from is DIRECTLY
  382.    made off of your configuration in the INIT.EXE(config.dat). The more
  383.    you put into the BBS, the more functionality that goes into WWIVMail/QWK.
  384.    The extent of these functions is only limited by you.
  385.  
  386.         NOTE: These programs NEED to be a directory who is in your 
  387.         "path=" statment in your autoexec.bat. If not( although these
  388.         programs may be in your main wwiv bbs directory) it doesn't
  389.         matter. I change directories to your TEMP area for processing, 
  390.         so please have them in into your path. If not, WWIVMail/QWK will 
  391.         spawn for the external protcol and will fail attempting to complete 
  392.         the transfer or compress/uncompress the packet.
  393.  
  394.    For your information, the %1 (com port speed) and %4 (modem speed)
  395.    are taken directly from chain.txt (see userrec.c for code) so the
  396.    external protocols will run the same as they do from within the
  397.    BBS.
  398.  
  399. 5) What files does WWIVMail/QWK Create?
  400.  
  401.   As your users log into the Door and start selecting subs and
  402.   defaults(tansfer protocol and compression options), a file named
  403.   wwivmail.usr will be created and placed in your wwiv main directory.
  404.   The size of this file will grow as more users begin to use the door.
  405.  
  406.   Other then this file, everthing else that WWIVMail/QWK creates is
  407.   loacated in your TEMP directory location, so they get deleted after
  408.   every door session.
  409.  
  410.   The name of the .QWK packet for your BBS is created using the BBS NAME 
  411.   field from your INIT.EXE(config.dat). The packet name is based off of the 
  412.   first eight characters, with any blanks being replaced by underscores. 
  413.   The only problem I have encountered with this simple idea is one BBS that 
  414.   had ">" 's in the name....this CANNOT be used to create a valid file 
  415.   because it represents a standard dos redirection of output. So, a board 
  416.   name of say:
  417.  
  418.            Rambo Scan BBS   would become=>  RAMBO_SC.QWK
  419.  
  420.   That's it!!!!!! (simple in comparision to other bbs chains, huh?)
  421.  
  422. 5) OPTIONAL
  423.    ========
  424.    WWIVMail/QWK has MANY Sysop Definable options. To set them, you need
  425.    to create a file named wwivmail.cfg and place it in the main BBS
  426.    directory (along with wwivqwk.exe).
  427.  
  428.    (IF YOU ARE USING A WWIVMAIL.CFG MADE PRIOR TO THIS RELEASE(v4.2), DELETE 
  429.    IT.. THE FORMAT OF THIS FILE IS DIFFERENT)   
  430.  
  431.    In order to create the file, you need to run WWIVCFG.EXE.
  432.    When you do, you'll see:
  433.  
  434.   About                       Bauds                   Misc              Exit
  435. ════════════════════════════════════════════════════════════════════════════════
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.     ▒▒▄   ▒▒▄  ▒▒▄   ▒▒▄  ▒▒▄  ▒▒▄ ▒▒█     ▒▒▒▄▄▒▒▒▄  ▒▒▒▒▒▒▄  ▒▒▄  ▒▒▄
  443.     ▒▒█   ▒▒█  ▒▒█   ▒▒█  ▒▒█  ▒▒█ ▒▒█     ▒▒█▒▒█▒▒█  ▒▒█▀▒▒█  ▒▒█  ▒▒█
  444.     ▒▒█   ▒▒█  ▒▒█   ▒▒█  ▒▒█  ▒▒█ ▒▒█     ▒▒█ ▀▀▒▒█  ▒▒▒▒▒▒█  ▒▒█  ▒▒█
  445.     ▒▒█▒▒▄▒▒█  ▒▒█▒▒▄▒▒█  ▒▒█   ▒▒▒▒█▀     ▒▒█   ▒▒█  ▒▒█ ▒▒█  ▒▒█  ▒▒█
  446.      ▀▒▒▒▒█▀▀   ▀▒▒▒▒█▀▀  ▒▒█    ▒▒█▀      ▒▒█   ▒▒█  ▒▒█ ▒▒█  ▒▒█  ▒▒▒▒▒▒▄
  447.        ▀▀▀▀       ▀▀▀▀     ▀▀     ▀▀        ▀▀    ▀▀   ▀▀  ▀▀   ▀▀   ▀▀▀▀▀▀
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456. ════════════════════════════════════════════════════════════════════════════════
  457.  
  458. Select BAUDS--------------------
  459.                                |
  460.   About                       Bauds                   Misc              Exit
  461. ════════════════════════════════════════════════════════════════════════════════
  462.  
  463. ┌Press <ESC> to exit this screen───────┐
  464. │······························        │
  465. │                                      │
  466. │  300: ·········· msgs per pkt        │
  467. │                                      │
  468. │ 1200: ·········· msgs per pkt        │   ▒▒▒▄▄▒▒▒▄  ▒▒▒▒▒▒▄  ▒▒▄  ▒▒▄
  469. │                                      │   ▒▒█▒▒█▒▒█  ▒▒█▀▒▒█  ▒▒█  ▒▒█
  470. │ 2400: ·········· msgs per pkt        │   ▒▒█ ▀▀▒▒█  ▒▒▒▒▒▒█  ▒▒█  ▒▒█
  471. │                                      │   ▒▒█   ▒▒█  ▒▒█ ▒▒█  ▒▒█  ▒▒█
  472. │ 9600: ·········· msgs per pkt        │   ▒▒█   ▒▒█  ▒▒█ ▒▒█  ▒▒█  ▒▒▒▒▒▒▄
  473. │                                      │    ▀▀    ▀▀   ▀▀  ▀▀   ▀▀   ▀▀▀▀▀▀
  474. │14400: ·········· msgs per pkt        │
  475. │                                      │
  476. │19200: ·········· msgs per pkt        │
  477. │                                      │
  478. │38400: ·········· msgs per pkt        │
  479. └──────────────────────────────────────┘
  480.  
  481.  
  482. ════════════════════════════════════════════════════════════════════════════════
  483. Enter the City/State of this BBS
  484.  
  485. This is the first of two configuration screens. You don't have to
  486. fill-in every option, only those that apply to your needs. I do, however,
  487. encourage you to fill-in the first option. The City and State of your
  488. BBS Location is used in the DOOR.ID file in the .QWK packet. This information
  489. isn't stored in config.dat, so it would be nice if you supplied it to 
  490. WWIVMail/QWK. (EX; Burbank,Ca)
  491.  
  492. The other options represent the MAXIMUM number of messages that a user
  493. can download at any possible baud rate. You wouldn't want a 1200 baud
  494. user downloading 1000 messages, would you? For any bauds that you leave blank,
  495. the user will be able to download ALL un-read mail that he/she scans for.
  496.  
  497.  
  498. Select MISC--------------------------------------------
  499.                                                       | 
  500.   About                       Bauds                   Misc              Exit
  501. ════════════════════════════════════════════════════════════════════════════════
  502.  
  503. ┌Press <ESC> to exit this screen────────────────────────────────────────┐
  504. │ blt1  ····························································    │
  505. │ blt2  ····························································    │
  506. │ blt3  ····························································    │
  507. │ blt4  ····························································    │
  508. │ blt5  ····························································    │
  509. │ blt6  ····························································    │
  510. │ blt7  ····························································    │
  511. │ blt8  ····························································    │
  512. │ blt9  ····························································    │▒▄
  513. │ blt10 ····························································    │▀▀
  514. │ News  ····························································    │
  515. └───────────────────────────────────────────────────────────────────────┘
  516. ════════════════════════════════════════════════════════════════════════════════
  517.  
  518. You can list, up to 10, text files that you would like to have
  519. added to the packet as Bulletins for the user to read. Enter them, one
  520. by one, on each appropriate line. You MUST specify the FULL path and
  521. name for each file, or WWIVMail/QWK will not be able to find them.
  522.  
  523. ex: c:\wwiv\gfiles\data\news\today.txt
  524.  
  525. If the door cannot find the file, it will not be added to the .QWK packet.
  526. When the file is added to the packet, WWIVMail/QWK renames it during
  527. packet creation to a BLT-X.X file so .QWK readers will understand what it is.
  528. The original file(s) will maintain their original names. (they don't change)
  529.  
  530. The same as above applies to the NEWS option.
  531. Also, .QWK packets only support one NEWS file.
  532.  
  533. Select EXIT--------------------------------------------------------------
  534.                                                                         |
  535.   About                       Bauds                   Misc              Exit
  536. ═══════════════════════════════════════════════════════════════┌─────────────┐══
  537.                                                                │Exit/Save    │
  538.                                                                │Exit w/o Save│
  539.                                                                └─────────────┘
  540.  
  541.  
  542.  
  543.     ▒▒▄   ▒▒▄  ▒▒▄   ▒▒▄  ▒▒▄  ▒▒▄ ▒▒█     ▒▒▒▄▄▒▒▒▄  ▒▒▒▒▒▒▄  ▒▒▄  ▒▒▄
  544.     ▒▒█   ▒▒█  ▒▒█   ▒▒█  ▒▒█  ▒▒█ ▒▒█     ▒▒█▒▒█▒▒█  ▒▒█▀▒▒█  ▒▒█  ▒▒█
  545.     ▒▒█   ▒▒█  ▒▒█   ▒▒█  ▒▒█  ▒▒█ ▒▒█     ▒▒█ ▀▀▒▒█  ▒▒▒▒▒▒█  ▒▒█  ▒▒█
  546.     ▒▒█▒▒▄▒▒█  ▒▒█▒▒▄▒▒█  ▒▒█   ▒▒▒▒█▀     ▒▒█   ▒▒█  ▒▒█ ▒▒█  ▒▒█  ▒▒█
  547.      ▀▒▒▒▒█▀▀   ▀▒▒▒▒█▀▀  ▒▒█    ▒▒█▀      ▒▒█   ▒▒█  ▒▒█ ▒▒█  ▒▒█  ▒▒▒▒▒▒▄
  548.        ▀▀▀▀       ▀▀▀▀     ▀▀     ▀▀        ▀▀    ▀▀   ▀▀  ▀▀   ▀▀   ▀▀▀▀▀▀
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557. ════════════════════════════════════════════════════════════════════════════════
  558.  
  559. You can either abort or save your changes.
  560.  
  561. Command-Line Options
  562. ====================
  563.  
  564. 1) "wwivqwk local":
  565.  
  566.    WWIVMail/QWK can be run local but you need to use a special command-line
  567.    argument. This is due to the need for carrier detect under normal
  568.    conditions...if you don't use the correct parameters, it will drop you
  569.    back to dos. Type 'wwivqwk local' and the door will go into local mode.
  570.  
  571.    For Downloads: Go through the menus as you would if you were on-line!
  572.                   A valid packet wil be created. Then, take a look in your 
  573.                   directory that is specified in your bbs configuration as 
  574.                   your TEMP dir. The download packet will be in that 
  575.                   directory.
  576.    
  577.    For Uploads:   Create a valid upload response packet and place that packet
  578.                   in the TEMP dir (or location that you specified for packets
  579.                   to be placed). Go through the door as normal, and the 
  580.                   packet will be detected and imported....                
  581.  
  582. 2) "wwivqwk nowrite":
  583.  
  584.    WWIVMail/QWK reads and writes to MANY WWIV BBS data files (see below
  585.    for listing). If you aren't sure whether or not you have modified the
  586.    ways your modifed BBS writes to those files, you can try WWIVMail/QWK
  587.    with the "nowrite" option. This will cause the program to ONLY read
  588.    all files (except those which it creates). Doing this will save your
  589.    data, and you can see how the door behaves on your system. This is
  590.    basically an evaluation mode.
  591.  
  592.    Uploading Messages with this option enabled will not work because
  593.    it won't do anything ( no way to save your posts ).
  594.  
  595. 3) You can also use these parameters together, such as:
  596.    "wwivqwk local nowrite" or "wwivqwk nowrite local"
  597.  
  598. WWIVMail/QWK and Networked Subs
  599. ===============================
  600.     WWIVMail/QWK has full built-in support for Networked Subs. That is to
  601. say, WWIVmail/QWK is a full extension of your BBS. If a user posts on a
  602. Net Sub, that post WILL go out on the network. This is acomplished in
  603. one of two ways:
  604.  
  605. 1) If the sub is marked as Sysop Validate = YES, WWIVMail/QWK will place
  606.    the message in the local Sub and mark it as pending for net status.
  607.    When you, or anyone with access to validate, validates the message,
  608.    WWIV will process the post and add it to the p1.net file in your DATA
  609.    directory. When the user logs off, WWIV will run the NETWORK program(s)
  610.    on that file, and the messages will be sent out on the net.
  611.  
  612. 2) If the sub is marked as Sysop Validate = NO, WWIVMail/QWK will place
  613.    the message in the local sub AND will CREATE/ADD TO the p1.net file.
  614.    As in the case above, WWIV will process the p1.net file when the user
  615.    logs off the board, and the message(s) will be sent out on the net.
  616.  
  617. I create the p1.net file EXACTLY as Wayne Bell does, so the integrity of
  618. all net actions will be maintained.
  619.  
  620. This is also how e-mail networking is set-up. WWIVMail/QWK creates the
  621. p0.net file, and when the user hangs up, WWIV does a clean_upnet() on
  622. all the p*.net files. At this point, all e-mail destined for the NET
  623. will be sent.
  624.  
  625. Here is an example on how NET E-Mail looks on the receiver's end.
  626. I sent this personal e-mail (my config.sys), from my account on Rambo-Scan 
  627. to my account on Amber (#445@1 was how it was addressed).
  628. This is what I got...
  629.  
  630.  
  631. (1/1): Net E-mail test          
  632. Name: Michael Leib #11 @8856
  633. Date: Thu Jun 18 06:36:15 1992
  634. From: WWIVnet - Rambo-Scan BBS (Southern California) [818-566-7912]
  635.  
  636. Response To: #445@1                   
  637.  
  638. Does this get through..
  639.  
  640. shell=c:\drdos\command.com /P
  641. DEVICE=C:\QEMM\QEMM386.SYS RAM
  642. device=c:\qemm\loadhi.sys /r:1 c:\utils\aspi2dos.sys
  643. files=3
  644. hibuffers=20
  645. fcbs=1,0
  646. stacks=0,0
  647. hidos=on
  648.  
  649.  
  650. Michael
  651.  
  652. ---
  653.  ■ SLMR 2.1a ■ All hope abandon, ye who enter messages here.
  654.                                                                                
  655.                                         
  656. WWIVMail/QWK 4.2 [REGISTERED]: RAMBO-SCAN BBS - @8856
  657.  
  658. .....And this is what I expected.
  659.  
  660. Also, after I read the mail, I was notified that it was read on Rambo-Scan
  661. just as it was any other piece of E-Mail.
  662.  
  663.  
  664. Starting with WWIVMail/QWK ver 4.2, I support the optional Multi-Net 
  665. NETWORKS.DAT file used by WWIV ver 4.21a. WWIVMail/QWK will send Net posts
  666. and E-mail out on whichever NET is active for the Sub in question. If
  667. NETWORKS.DAT doesn't exist(for WWIV versions before 4.21a), WWIVMail/QWK
  668. looks for the net files (and writes the p0.net and p1.net files) in the
  669. \DATA directory(as it is defined in INIT.EXE).
  670.  
  671. ===============================================================================
  672. Thanks go out to:
  673.  
  674. Rambo........ (Of Rambo-Scan BBS ) who allows me the time and resources 
  675.                of his BBS and continues to be the main testing ground for 
  676.                WWIVMail/QWK.
  677.  
  678. Foundation....(Of Dark D.) who helped me design the network support.
  679.               Crashed him out a few times too...
  680.        
  681. Alex Sandor.. My close friend who wrote WWIVCFG.EXE with no compensation 
  682.               except a word of thanks. I told you .QWK packets were a pain!
  683.  
  684. Wayne Bell....what do ya want for 50 bux!
  685.  
  686. And all the people who have commented, helped in the coding, and design of
  687. WWIVMail/QWK. Also, thanks to those authors who compiled all the information
  688. I found in various places describing the structure/contents of the .QWK 
  689. packet.
  690.  
  691. ===============================================================================
  692.  
  693. Listing Of Vardec.h/Net.h Ties
  694. ==============================
  695.  
  696.         In order for WWIVMail/QWK to run correctly on your system, you must
  697. have NOT modified any of the Files listed below. If you have a modified
  698. bbs but have not made any changes to the vardec.h include file, then you
  699. should be fine( And forget you ever read this! ). Otherwise, do a comparision
  700. to the stock file (vardec.h/net.h as Wayne Bell created it) to make sure
  701. these Files aren't stored in a different way. If they are, then you will
  702. need to register your copy of WWIVMail/QWK and obtain the source code to
  703. compile with your modified header files.
  704.  
  705. FILES
  706. =====
  707. BBSDATA.NET
  708. CHAIN.TXT                                   
  709. CONFIG.DAT                                  
  710. DIRS.DAT                                    
  711. directory.filename.DIR ( all .DIR files )                    
  712. EMAIL.DAT                                   
  713. MODEM.DAT                                    
  714. N*.NET
  715. NEXTERN.DAT
  716. NN*.NET
  717. P0.NET
  718. P1.NET
  719. SMW.DAT
  720. STATUS.DAT
  721. SUBS.DAT
  722. subboards.filename.DAT ( all .DAT files )
  723. subboards.filename.SUB ( all .SUB files )
  724.  
  725. ===============================================================================
  726. What Do I Do if I have a modifed USERREC?
  727.  
  728. Although I have felt in the past that registerred user's did have userrec
  729. support, since they legally got the source code; but, some people couldn't
  730. evaluate the product before paying for it. In order to fix this, and give me
  731. equal advantage with any competetors (current or future), WWIVMail/QWK can
  732. now be compiled and linked via an object-oriented approach to match any
  733. userrec changes that you may have made. Any changes to the BBS structure,
  734. other then the userrec, however, will still require you to register and get
  735. the source. I hope by adding this feature that I will have satisfied many of 
  736. your needs and will have greatly enhanced the use, compatibility and quality 
  737. of the product.
  738.  
  739. REMINDER: You ONLY need to do this procedure, with 32 or 64 subs, if you
  740. have modifed your user.lst. If not, use the .exe included in this .zip file.
  741. It was made EXACTLY the same way as you are going to make yours(except with
  742. a stock vardec.h)...I used this .lib as well!
  743.  
  744. Needed Files:
  745. =============
  746. QWK.LIB     WWIVMail/QWK LIBRARY TO LINK WITH USERREC.OBJ
  747. QWK.BAT     .BAT FILE TO COMPILE AND LINK YOUR VERSION OF WWIVQWK.EXE
  748. USERREC.H   HEADER FILE FOR USERREC.C 
  749. USERREC.C   C FILE TO COMPILE WITH YOUR USERREC AND LINK WITH .LIB
  750.    
  751. 1) Get your programming environment set-up.
  752.    A) Copy the qwk.lib into your .lib directory.
  753.    B) Make sure your tools are in your path (bcc v2.0 or higher and tlink).
  754.       My Tools: bcc.exe    ver 2.0
  755.                 tlink.exe  ver 4.0
  756.                 tlib.exe   ver 3.01
  757.       This is what was used in the making of WWIVMail/QWK.
  758.  
  759.    C) You will HAVE to modify the .bat file to set-up the paths for the
  760.       include and library directories..
  761.  
  762.       ie; -Ic:\tc2\inc must be changed to match your system.
  763.  
  764.   
  765. change------------------------------------|      
  766.                                           |       
  767. bcc -wpro -wuse -DEXTENDED -c -G -ml -N -Y -Ic:\TC2\INCLUDE userrec.c
  768.  
  769. AND...
  770.  
  771. change-----------|
  772.                  |
  773. tlink /x/c/P-/Lc:\TC2\LIB c0l.obj userrec.obj, wwivqwk, wwivqwk, 
  774.                           emu.lib mathl.lib qwk.lib cl.lib 
  775.  
  776.  
  777. 2) Make sure your userrec.c and userrec.h files (this file contains the ONLY
  778.    places in WWIVMail/QWK where your userrec is accessed) are accessable.
  779.    Userrec.c uses vardec.h as well as userrec.h; therefore, make sure
  780.    your current modifed vardec.h header file is either in the current
  781.    directory or in the directory you have indicated as your INCLUDE
  782.    directory. Also, do NOT change any definitions in the userrec.h header
  783.    file...because all the code in the .lib was built using those
  784.    definitions.
  785.  
  786. 3) Type qwk.bat. It will attempt to compile (no link) your usserec.c
  787.    into userrec.obj using the large memory model. You should get NO errors.
  788.    There is one ANSI violation warning, but it can be ignored (main() doesn't
  789.    return a value..true!, and it shouldn't). If you get ANY more then that,
  790.    something is wrong. Try again till it compiles clean.  
  791.  
  792.    Notice that there is a -DEXTENDED in the bcc command-line. This needs
  793.    to be done so WWIVMail/QWK can detected whether you are using 32 or 64
  794.    Message Bases.
  795.  
  796. 4) After it completes a clean compile, it will execute the second line in the
  797.    .bat file and attempt to build a wwivqwk.exe. If all your .lib files can be
  798.    found, your done. If not, you will get some unresolved external errors 
  799.    during the link. Fix them (path isn't right...can't find the file...etc)
  800.    and THEN you are done. Copy the linked wwivqwk.exe to your WWIV main
  801.    directory and.....Enjoy.
  802.  
  803.  
  804.  
  805.