home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / OFFLINE / JCQWK201.ZIP / JCQWK.DOC < prev    next >
Text File  |  1993-10-03  |  53KB  |  1,224 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                      ──┬── ╓──┐     ╓──┐ ╥ ╥ ┬ ╥ ┌
  7.                        │   ║    ─── ║  │ ║ ║ │ ╟─┴┐
  8.                        │   ╙──┘     ╙─┼┘ ╙─╨─┘ ╨  ┴
  9.                        │     Offline Mail Door
  10.                    ╙───┘     Version 2.01gamma
  11.  
  12.  
  13.                   QWK Mail Door for RemoteAccess 2.x
  14.  
  15.                       Hudson and JAM Messagebases
  16.  
  17.               (c) Copyright 1993 Johan Corstjens - JC-TOOLS
  18.                          All rights reserved
  19.  
  20.                       Documentation by Kief Morris
  21.  
  22.  
  23.  
  24.       ─────────────────────────────────────────────────────────
  25.                          TABLE OF CONTENTS
  26.             ─────────────────────────────────────────────
  27.  
  28.  
  29.  
  30.         1.0 INTRODUCTION
  31.             1.1 ................................. License
  32.             1.2 .............................. Disclaimer
  33.             1.3 ................................ Features
  34.             1.4 ................................... Files
  35.             1.5 .............................. What's New
  36.             1.6 ............................ RIP Contest!
  37.             
  38.         2.0 INSTALLATION
  39.             2.1 ............................... Upgrading
  40.             2.2 ................................... Files
  41.             2.3 .................... *.JCQ & JCQUSERS.DAT
  42.             2.4 .......................... Language Files
  43.             2.5 .............................. Menu Files
  44.             2.6 ........................... RACONFIG Menu
  45.             2.7 .......................... Logging Levels
  46.  
  47.         3.0 JCQSETUP
  48.             3.1 .......................... System Details
  49.             3.2 .............................. Path Names
  50.             3.3 ............................ User Details
  51.             3.4 .................................... Exit
  52.  
  53.         4.0 NOTES
  54.             4.1 ........................... User Features
  55.             4.2 ................................. Netmail
  56.             4.3 ................................. Indexes
  57.             4.4 ................................. Support
  58.             4.5 ........................ Acknowledgements
  59.             4.6 ............................ Future Plans
  60.             4.7 ............................ Registration
  61.             4.8 .................................. Epilog
  62.             4.9 ......................... Latest Versions
  63.  
  64.  
  65. ────────────────────────────────────────────────────────────────────
  66.       ────────────────     INTRODUCTION     ────────────────
  67. ────────────────────────────────────────────────────────────────────
  68.  
  69.         JC-QWK is an offline mail door designed to create QWK format
  70.         mail packets for users of RemoteAccess BBS software version
  71.         2.x. It is designed to take advantage of special features of
  72.         RA 2.0 such as message groups and the new JAM messagebase.
  73.         JC-QWK can be used with Hudson message areas, JAM message
  74.         areas, or a combination of both.
  75.   
  76. ────────────────────────────────────────────────────────────────────
  77.        ────────────────     1.0 LICENSE     ────────────────
  78. ────────────────────────────────────────────────────────────────────
  79.  
  80.  
  81.   │ 1.1 LICENSE
  82. ────────────────────────────────────────
  83.   │
  84.  
  85.         This document and the associated files may be freely copied
  86.         provided that:
  87.  
  88.         (1)   All of the files are copied as a group (such as in a
  89.               single archive). See below for a list of files.
  90.  
  91.         (2)   The files are not modified in any way (including
  92.               removal or alteration of copyright notices or this
  93.               license)
  94.  
  95.         (3)   No charge beyond a cost-recovery fee not to exceed $5,
  96.               or a general telecommunications connection fee, is
  97.               made.
  98.  
  99.         (4)   After a month of evaluation the product must be
  100.               registered.
  101.  
  102.  
  103.         This package may not be incorporated into programs or other
  104.         products which are distributed or sold to others without the
  105.         authors permission.
  106.  
  107.  
  108.   │ 1.2 DISCLAIMER
  109. ────────────────────────────────────────
  110.   │
  111.  
  112.         Although this program has been tested by myself and others,
  113.         it is entirely possible that JC-QWK may malfunction in
  114.         environments or under circumstances in which it has not been
  115.         tested. The author disclaims any and all responsibility for
  116.         damages (both consequential and incidental) resulting from
  117.         the use or misuse of JC-QWK. Sole responsibility for
  118.         determining the suitability of the program rests with the
  119.         user.
  120.  
  121.  
  122.   │ 1.3 FEATURES
  123. ────────────────────────────────────────
  124.   │
  125.  
  126.         o   Downloading/uploading of QWK compatible mail packets
  127.         o   Supports Hudson and JAM style messagebases
  128.         o   Supports ASCII, ANSI, Avatar and RIP display formats
  129.         o   Fully configurable prompts
  130.         o   Supports RA control codes, including the ^K!TEXTFILE|
  131.             command.
  132.         o   Supports RA sysop keys, ALT-E, ALT-S, ALT-C, ALT-H etc.
  133.         o   Users may have their downloaded packets numbered up to
  134.             99 - e.g. BBS.Q01, BBS.Q02, etc.
  135.         o   Modify pointers by message area
  136.         o   Select a number of messages instead of a lastread
  137.             pointer (eg - last 50 messages in each area, rather than
  138.             message number 7,492)
  139.         o   Optional sending of index files (*.NDX)
  140.         o   Send an ASCII list of new files without online scan
  141.             (optional)
  142.         o   Selecting/deselecting complete message groups
  143.         o   Change flags by area
  144.         o   Filters to receive only messages addressed to All, only
  145.             personal messages, and those written by the user.
  146.         o   Sysop controlled network status per area
  147.         o   Multi language support - uses its own language files
  148.         o   Hotkeys changeable by sysop (per language file)
  149.         o   Single or double list displays of message areas
  150.         o   Flexible user editor
  151.         o   Areas can be added/dropped by addressing a message to JC
  152.             QWK (check your offline mailreader for instructions, if
  153.             it supports it)
  154.         o   Simple installation - Just install as a type 7 with no
  155.             parameters other than *M (needed to run some archive
  156.             programs)
  157.         o   Define separate message number limits for each connect
  158.             speed.
  159.         o   Multinode/network aware
  160.         o   Netmail support
  161.         o   Checks uploads for dupes
  162.         o   Automatic downloading
  163.  
  164.  
  165.   │ 1.4 FILES
  166. ────────────────────────────────────────
  167.   │
  168.  
  169.         The disk or archive you received should contain the
  170.         following files:
  171.  
  172.       JCQWK200.ZIP contains:
  173. ┌────────────────────────────────────────────────────────────────────┐
  174. │       !README.NOW   Last minute notes                              │
  175. │       USERCVT.EXE   The convert program for converting             │
  176. │                     the JCQ-userbase to 2.x format                 │
  177. │       JCQWK.DOC     This file - documentation                      │
  178. │       REGISTER.DOC  How to register this program                   │
  179. │       JCQWK.EXE     The door program itself                        │
  180. │       JCQSETUP.EXE  Setup program                                  │
  181. │       ENGLISH.ZIP   English menu files (ASCII, ANSI, Avatar & RIP) │
  182. │       DUTCH.ZIP     Dutch menu files (no Dutch RIP files yet)      │
  183. │       LANGUAGE.ZIP  English and Dutch language files               │
  184. │       CONFIG.ZIP    Sample config files for download               │
  185. │                     protocols and Compression tools                │
  186. └────────────────────────────────────────────────────────────────────┘
  187.  
  188.       ENGLISH.ZIP and DUTCH.ZIP contain:
  189. ┌────────────────────────────────────────────────────────────────────┐
  190. │       JCQ1TIME.ANS  Initial welcome screen                         │
  191. │       JCQ1TIME.ASC                                                 │
  192. │       JCQ1TIME.AVT                                                 │
  193. │       JCQHELP.ANS   User help screen                               │
  194. │       JCQHELP.ASC                                                  │
  195. │       JCQHELP.AVT                                                  │
  196. │       JCQMENU.ANS   Main menu screen                               │
  197. │       JCQMENU.ASC                                                  │
  198. │       JCQMENU.AVT                                                  │
  199. │       JCQWELC.ANS   Welcome screen                                 │
  200. │       JCQWELC.ASC                                                  │
  201. │       JCQWELC.AVT                                                  │
  202. └────────────────────────────────────────────────────────────────────┘
  203.  
  204.       ENGLISH.ZIP now also contains several RIP files! Be sure to
  205.       copy these all to your RA textfile directory. In addition to
  206.       the above names, the RIP collection also include several
  207.       additional langugae prompts, named JC-*.RIP JC-*.ASC.
  208. ┌────────────────────────────────────────────────────────────────────┐
  209. │       See FILENAME.DOC in the archive for a list and descriptions! │
  210. └────────────────────────────────────────────────────────────────────┘
  211.  
  212.      CONFIG.ZIP contains:
  213. ┌────────────────────────────────────────────────────────────────────┐
  214. │       JCQPACK.CFG   Demo setup for compression programs            │
  215. │       JCQPROT.CFG   Demo setup for download protocols              │
  216. └────────────────────────────────────────────────────────────────────┘
  217.  
  218.  
  219.   │ 1.5 WHAT'S NEW
  220. ────────────────────────────────────────
  221.   │
  222.  
  223.         JC-QWK is a young program, and will continue to add new
  224.         features. Be sure to let me know what you'd like to see
  225.         added! I can be reached in the JCQWK.SUP and RA_UTIL echoes.
  226.  
  227.         New since 2.0
  228.  
  229.         Version 2.01 adds RIP support, dupe checking, automatic
  230.         download, and short names for message areas, as well as some
  231.         minor additions and fixes. Version 2.0 had a problem with
  232.         message areas over 256, just as RA 2.0 did, but version 2.01
  233.         fixes it. Also added is Origin line handling - JC-QWK will
  234.         now put tearlines and Origin lines on uploaded messages.
  235.         Origin lines are also now retained for messages download
  236.         from JAM areas.
  237.  
  238.         New since 1.0
  239.  
  240.         Since the 1.0 release, many minor bugfixes have been made to
  241.         the program, and a few new features added. The big one, of
  242.         course, is the JAM support! Support for netmail was also
  243.         added.
  244.  
  245.         IMPORTANT!
  246.         If you are upgrading from v1.0 or below: DON'T FORGET TO RUN
  247.         THE CONVERT PROGRAM !! This program makes a backup from the
  248.         old 1.0 userbase and converts it to 2.x format.
  249.  
  250.  
  251.   │ 1.6 RIP CONTEST!
  252. ────────────────────────────────────────
  253.   │
  254.  
  255.         Do you think you're pretty handy with the RIP editor? If so,
  256.         you can win a free JC-QWK key and get your name mentioned in
  257.         JC-QWK docs - the first step to international stardom! :)
  258.  
  259.         Create the perfect JC-QWK menu and welcome screens and send
  260.         them to one of the support sites mentioned towards the end of
  261.         this file.  Be sure to archive the file, including a small
  262.         textfile with your name and electronic address (Fidonet etc),
  263.         your BBS phone number if nothing else) so we know who to send
  264.         the key to! Also be sure to name the archive something
  265.         distinctive, such as your fidonet address (110-210.ZIP, for
  266.         example).
  267.  
  268.         Deadline for entry is December 1, 1993. **** See !README.NOW
  269.         for Complete details and rules.
  270.  
  271.         Also feel free to send us .RIP files for other parts of
  272.         JC-QWK,  especially for languages other than English so that
  273.         we can include them in future releases.
  274.  
  275.  
  276.  
  277. ────────────────────────────────────────────────────────────────────
  278.     ────────────────     2.0 INSTALLATION     ────────────────
  279. ────────────────────────────────────────────────────────────────────
  280.  
  281.         Here's the part you've been looking for!
  282.  
  283.   │ 2.1 UPGRADING
  284. ────────────────────────────────────────
  285.   │
  286.  
  287.         FROM 2.0
  288.         Simply copy the new .EXE files over the old ones, be sure to
  289.         copy the new LANGUAGE.JCQ files over as well. Then copy the
  290.     new text files in ENGLISH.ZIP to your text file directory.
  291.         Next set up any of the new options you would like to change.
  292.     Note that some menu options have been added, so you will have
  293.     to change any customized menu screens you have.
  294.  
  295.         Note that the ENGLISH.JCQ included in the new LANGUAGE.ZIP
  296.         uses ^K!FILENAME| control codes in the place of many
  297.         prompts. These call external .ASC, .ANS, .AVT and .RIP files
  298.         (depending on what the user has). If you use the new
  299.         ENGLISH.JCQ you MUST also use all of the files in the
  300.         ENGLISH.ZIP (or make your own replacements for them). Put
  301.         these with your other JC-QWK menu display files (JCQWELC.*,
  302.         JCQMENU.*, etc). The purpose of this is to fully implement
  303.         .RIP in JC-QWK. See FILENAME.DOC in the ENGLISH.ZIP archive
  304.     for a complete description of all RIPed prompts and screens.
  305.  
  306.         If you don't want to implement RIP, use the Stock non-ripped
  307.     English file thats named STOCK.JCQ. Rename the STOCK.JCQ to be
  308.     ENGLISH.JCQ instead. Then you do not need any of the prompt
  309.     replacment (JC-?????.???) files either, so they can be removed.
  310.     
  311.     
  312.         FROM 1.0
  313.         Use the files from the new archive to replace all of the
  314.         old JC-QWK files. Then run CVTUSERB.EXE to convert the
  315.         JCQWK 1.0 userbase to the new format used by 2.x.
  316.  
  317.  
  318.   │ 2.1 DIRECTORIES AND FILES
  319. ────────────────────────────────────────
  320.   │
  321.  
  322.         Create a directory to run JC-QWK from and copy the JCQWK.EXE,
  323.         JCQSETUP.EXE files to it, along with the language (*.JCQ)
  324.         and configuration (*.CFG) files. The directory should look
  325.         something like this:
  326.  
  327. ┌────────────────────────────────────────────────────────────────────┐
  328. │          Directory of Z:\BBS\JCQWK                                 │
  329. │                                                                    │
  330. │       DUTCH    JCQ     10348 05-23-93  10:32a                      │
  331. │       ENGLISH  JCQ     10348 05-23-93  10:32a                      │
  332. │       JCQPACK  CFG      1840 05-17-93  11:57p                      │
  333. │       JCQPROT  CFG      1030 05-17-93  11:56p                      │
  334. │       JCQSETUP EXE    155568 05-23-93  10:22a                      │
  335. │       JCQUSERS DAT     16281 05-23-93  10:32a                      │
  336. │       JCQWK    EXE     75074 05-23-93  10:30a                      │
  337. │               9 file(s)     404969 bytes                           │
  338. └────────────────────────────────────────────────────────────────────┘
  339.  
  340.         You can put these files anywhere, as long as they are
  341.         together. (See the file list if you can't find them.)
  342.  
  343.  
  344.   │ 2.2 *.JCQ & JCQUSERS.DAT
  345. ────────────────────────────────────────
  346.   │
  347.  
  348.         You can create/edit both *.JCQ and JCQUSERS.DAT with
  349.         JCQSETUP.EXE. see section 3.0 for details on the different
  350.         options in JCQSETUP.
  351.  
  352.         You must keep JCQSETUP.EXE in the same directory as the copy
  353.         of JCQWK.EXE which you execute. JCQWK.EXE looks for the
  354.         configuration file in the directory it is in, and JCQSETUP
  355.         writes the configuration file in whatever directory *it* is
  356.         in, regardless of what directory you are in when you run
  357.         them.
  358.  
  359.  
  360.   │ 2.3 LANGUAGE FILES
  361. ────────────────────────────────────────
  362.   │
  363.  
  364.         JC-QWK uses its own language files, with a separate file for
  365.         each language named [language].JCQ. JC-QWK decides which
  366.         language file to use by checking what is being used in RA
  367.         itself when the door is run. So, for each .RAL files you
  368.         have available in RA you should have an identical .JCQ
  369.         files, with the same base name - eg if you have a GERMAN.RAL
  370.         file, you should also have a GERMAN.JCQ file. You should
  371.         find ENGLISH.JCQ and DUTCH.JCQ files included with this
  372.         package.
  373.  
  374.         This JC-QWK archive gives you two different options for the
  375.         English language. The default fully implements RIP throughout
  376.         JC-QWK. If you want a simpler, non-RIP implementation, use the
  377.         STOCK.JCQ file and rename it to ENGLISH.JCQ instead. If you
  378.         use the stock language, then you do not need to use any of the
  379.         external text prompt (JC-?????.*) files so they can be deleted.
  380.         
  381.         If you have other languages in RemoteAccess, either copy
  382.         other .JCQ files over to match the name, or use JCQSETUP to
  383.         create your own language file. See the section on JCQSETUP
  384.         below for more information.
  385.  
  386.  
  387.   │ 2.4 MENU FILES
  388. ────────────────────────────────────────
  389.   │
  390.  
  391.         JC-QWK will first look for its menu files (.RIP .ANS .AVT or
  392.         .ASC) in the directory pointed to by the active language
  393.         record for RemoteAccess. If the proper files aren't found
  394.         there, JC-QWK will then search its own directory. It expects
  395.         at least the files named like the ones in STOCK.ZIP and
  396.         DUTCH.ZIP. These files are just like the ones used with
  397.         RemoteAccess - you can even use all of the special RA
  398.         textfile codes!
  399.  
  400.         THE ENGLISH RIP FILES
  401.         If you use the default ENGLISH.JCQ language file found in
  402.         LANGUAGE.ZIP, you will need to use the menu and prompt
  403.         replacement textfiles found in the ENGLISH.ZIP archive. This
  404.         is because the default ENGLISH.JCQ calls external textfiles
  405.         in the place of normal prompts, so it can call .RIP files if
  406.         the user has RIP. If the user doesn't have RIP, then .ASC,
  407.         .ANS, and .AVT files must be available to use as prompts.
  408.         These are all provided in ENGLISH.ZIP, so you need only copy
  409.         all of the files in that archive to wherever you want to
  410.         keep your menu files.
  411.  
  412.         An alternative to this fully RIPed setup is to use the
  413.         ENGLISH.JCQ and the menu files found in the STOCK.ZIP file.
  414.         This is a normal, non-RIP setup that doesn't need as many
  415.         external files. If you use this setup, don't use the menus
  416.         in ENGLISH.RIP.
  417.  
  418.         JC-QWK determines if the user is using ANSI, Avatar, or RIP
  419.         from the dropfile passed to it by RA.
  420.  
  421.         Note that in the registered version of JC-QWK, the JCQWELC
  422.         screen can be supressed. You can combine this with custom
  423.         designed JC*.* menues to help your menus integrate
  424.         seamlessly with the look of your BBS.
  425.  
  426.  
  427.  
  428.   │ 2.5 RACONFIG MENU
  429. ────────────────────────────────────────
  430.   │
  431.  
  432.         Installing JC-QWK in RA is very simple. Just make a menu
  433.         command entry for the QWK door and define it as a type 7
  434.         exit. The optional parameter should be the full path and
  435.         name of JCQWK.EXE ending with *M. Swapping should not be
  436.         needed for JC-QWK, but will probably be needed by some
  437.         archiving programs who need a lot of memory (ARJ, for
  438.         example!)
  439.  
  440.         It will look something like this:
  441.  
  442. --------------------------------------------------------------
  443.          1         2         3         4         5         6
  444. 12345678901234567890123456789012345678901234567890123456789012345
  445. ;
  446. z:\bbs\jcqwk\jcqwk.exe *m
  447.  
  448.  Action   Execute sub-program (Type 7)
  449.  Display
  450.  OptData
  451.  HotKey   Q
  452.  AutoExec No
  453.  Color   Color example
  454.  
  455.  MinSec   7                  TimeUsed 0                 FlatCost 0
  456.  MaxSec   61000              TimeLeft 0                 TimeCost 0
  457.  A flags  --------           Age      0                 Terminal Any
  458.  B flags  --------           MinSpeed 0                 Nodes
  459.  C flags  --------           MaxSpeed 0                 Groups
  460.  D flags  --------           Credit   0                 DayTimes
  461. ---------------------------------------------------------------------------
  462.  
  463.  
  464.   │ 2.6 LOGGING LEVELS
  465. ────────────────────────────────────────
  466.   │
  467.  
  468.         Logging will take place in the logfile RA is writing to. If
  469.         anything goes wrong, check this logfile first before asking
  470.         for advice! Set logging on DEBUG MODE in JCQSETUP -> BBS
  471.         setup to get more info if things go wrong. This option will
  472.         write more information in the log file. If there is a
  473.         Runtime Error there will be a seperate file in the node
  474.         direcory (RUNERROR.LOG) containing the Runtime Error
  475.         information.
  476.  
  477.  
  478. ────────────────────────────────────────────────────────────────────
  479.        ────────────────     3.0 JCQSETUP     ────────────────
  480. ────────────────────────────────────────────────────────────────────
  481.  
  482.         You can use JCQSETUP to edit all of the files needed:
  483.         language files, user records, and configuration files. I
  484.         strongly advise that you go through all items to make sure
  485.         they are properly set for your system.
  486.  
  487.         Firing up jcqsetup brings the following screen:
  488.  
  489. ----------------------------------------------------------------------------
  490.  
  491. System details               Path names          User details        Exit
  492. ═════════════════════════════╕══════════════════════════════════════════════
  493. ▒│ Personal details          │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  494. ▒│ BBS setup                 │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  495. ▒│ Packetnumbering is on now │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  496. ▒│ Download protocols        │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  497. ▒│ Compress tools            │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  498. ▒│ Limits                    │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  499. ▒│ Language definition       │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  500. ▒│ Columns (double now)      │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  501. ▒│ Forced areas              │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  502. ▒╘═══════════════════════════╛▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  503. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  504. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Setup program for JC-QWK verion 2.01 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  505. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  506. ▒▒▒▒▒▒▒▒▒▒▒▒ Copyright (c) Johan Corstjens / JC-Tools 1993 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  507. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  508. ▒▒▒▒▒▒▒▒▒▒▒▒ Using config files in D:\PROGRAMS\BP\UNITS\ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  509. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  510. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  511. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  512. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  513. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  514. ────────────────────────────────────────────────────────────────────────────
  515. Menu for name, location and registration code
  516.  
  517.  
  518.         Things to remember when you use this program are:
  519.         o    Check the line stating the directory of the config
  520.              files (in the middle of the screen)
  521.  
  522.         o    The line at the bottom of the screen gives you brief,
  523.              context sensitive help on the currently highlighted
  524.              item (throughout the whole program) - in this case
  525.              telling you that the "Personal Details" option will
  526.              give you a menu to enter your name, location and
  527.              registration code.
  528.  
  529.  
  530.   │ 3.1 SYSTEM DETAILS
  531. ────────────────────────────────────────
  532.   │
  533.  
  534.         o    Personal details
  535.                 Displays the personal details menu (see below)
  536.         o    BBS Setup
  537.                 Displays the BBS setup menu (see below)
  538.         o    Use Packet Numbering
  539.                 This item will toggle between using or not using the
  540.                 packet number feature. This feature numbers the
  541.                 outgoing packets for each user For example, the
  542.                 first time Mike Ehlert downloads a packet it will be
  543.                 named BBSNAME.Q00 - his second packet will be
  544.                 BBSNAME.Q01, up through BBSNAME.Q99. After he
  545.                 reaches .Q99 it will start over at .Q00 again. This
  546.                 number is kept in the userfile for each user
  547.                 separately, and will be increased when a download is
  548.                 successful. It will only affect the extension of the
  549.                 packet. If disabled, packets will be named
  550.                 BBSNAME.QWK every time.
  551.         o    Download Protocols
  552.                 Displays the protocol editor, so you can define file
  553.                 transfer protocols available for users to download
  554.                 from the QWK door. (see below)
  555.         o    Compress Tools
  556.                 Displays the compression tools editor, so you can
  557.                 define archivers available for compressing and
  558.                 decompressing mail packets. (see below)
  559.         o    Limits
  560.                 The Limits setup menu, where you can set the maximum
  561.                 number of messages users may download according to
  562.                 their modem speed. (see below)
  563.         o    Language Definition
  564.                 Brings up a menu with .JCQ language files (if any)
  565.                 to choose from. You can press DEL or INS to delete
  566.                 or create one. Selecting a language brings you to
  567.                 the language editor (see below)
  568.         o    Columns
  569.                 Toggles between double and single display, to
  570.                 determine whether available message areas and groups
  571.                 will be displayed in one or two columns. If double
  572.                 is selected, areas will be truncated at position 25
  573.         o    Forced Areas
  574.                 Enables you to select areas all users are forced to
  575.                 read
  576.  
  577. Personal details menu
  578. ────────────────────────────────────────
  579.  
  580. ╒═══════════════════════════════════════ Personal Details ╕
  581. │ Your name:         Johan Corstjens                      │
  582. │ Your location:     Delft, The Netherlands               │
  583. │ Registration Code:                                      │
  584. ╘═════════════════════════════════════════════════════════╛
  585.  
  586.         Fill in your name, Location and (if you have one) your
  587.         registration key code.
  588.         
  589.  
  590. BBS Setup
  591. ────────────────────────────────────────
  592.  
  593. ╒═══════════════════════════════════════════════ BBS Details ╕
  594. │ BBS name     : The 1st Dutch MIDI BBS node 2               │
  595. │ BBS code     : MIDIBBS2                                    │
  596. │ Area names   : <ENTER> to set up area names                │
  597. │ Swap to      : Try best method                             │
  598. │ Log mode     : Normal logging                              │
  599. │ News file    : NEWS                                        │
  600. │ Newfile list : Z:\BBS\NEWFILES.LST                         │
  601. │ Welcome file : WELCOME                                     │
  602. │ Goodbye file : GOODBYE                                     │
  603. │ Dupe database: 0                                           │
  604. │ Show JCQWELC : True                                        │
  605. ╘════════════════════════════════════════════════════════════╛
  606.  
  607.         BBS NAME:
  608.         Fill in the name of your BBS
  609.  
  610.         BBS CODE:
  611.         Put the base filename you want your users .QWK and .REP
  612.         packets to have - don't include the extension. Obviously,
  613.         this should be a maximum of eight characters.
  614.  
  615.         AREA NAMES:
  616.         This part of the menu lets you set up shorter names for
  617.         message areas. The QWK format only allows 12 character names
  618.         for message areas, but often the descriptions in RA are
  619.         longer than this, and may be confusing to the user when
  620.         they're simply cut off at the limit.
  621.  
  622.         Hit enter on this selection, and arrow down over the
  623.         different message areas. The name as it will appear to the
  624.         QWK user in their reader is shown at the bottom of the
  625.         screen, so you can easily decide what can be left alone and
  626.         what needs changing. To change it, simply hit enter and type
  627.         the new name.
  628.         
  629.         SWAP TO:
  630.         'Swap to' can be toggled to force it to swap to disk, EMS,
  631.         XMS and Extended memmory. Try best method will just look for
  632.         the best way.
  633.  
  634.         LOG MODE:
  635.         This toggles between normal and debugging mode. JC-QWK logs
  636.         to the RA log.
  637.  
  638.         NEWS, WELCOME, GOODBYE:
  639.         Enter the base filename of the files you want displayed to
  640.         the offline reader for news, welcome, and goodbye. As with
  641.         the menu screens, JC-QWK will look in the text path directory
  642.         pointed to by the language record in use on RA. If the user
  643.         uses ANSI or Avatar it will search for those extensions, if
  644.         not it will look for .ASC. If the appropriate file isn't
  645.         found the JC-QWK directory will then be searched.
  646.  
  647.         {-} If you have not registered JC-QWK it will ignore the News
  648.         entry and generate its own file with a nice message to the
  649.         user.
  650.  
  651.         NEW FILES:
  652.         The New Files list must be an ASCII textfile, which you can
  653.         generate with one of the available file utilities, such as
  654.         the RAFILE program which comes with RA 2.x. This is makes
  655.         JC-QWK much faster than it would be if it did an online scan
  656.         of the file directories every time a caller downloaded a new
  657.         packet! Make sure you include the drive, path and complete
  658.         filename (with extension).
  659.  
  660.         DUPE DATABASE:
  661.         JC-QWK will check each message a user uploads to make sure
  662.         it isn't a dupe of one they uploaded before. It determines
  663.         this by a CRC check, which it stores in a dupefile. The
  664.         number you put here tells JC-QWK how many message CRC's to
  665.         keep in the database. If you have too many, it will slow
  666.         down message uploads and take up more disk space, but if you
  667.         have too few, dupes may get by.
  668.  
  669.         {+} SHOW JCQWELC:
  670.         If you have registered JC-QWK, you can tell it not to display
  671.         the JCQWELC screen to callers when they enter the door. This
  672.         helps to create the appearance that JC-QWK is simply another
  673.         menu on your BBS, rather than a separate program (especially
  674.         if you make custom JC*.* screens in the same style as your
  675.         RA menus).
  676.  
  677.  
  678. Download Protocols
  679. ────────────────────────────────────────
  680.  
  681.         Download protocols will present a selection screen to you
  682.         from which you can add, delete or select a file transfer
  683.         protocol available to users to download and upload their
  684.         packets.
  685.  
  686.         When you select a protocol, a screen will appear:
  687.  
  688. ╒═══════════════════════════════════════════════════════════ Fill in ╕
  689. │                                                                    │
  690. │ Name:         ZModem                                               │
  691. │ Download cmd: z:\bbs\ra\dsz.exe port *P est 0 *B pB4096 sz -Z -k -m│
  692. │ Upload cmd:   z:\bbs\ra\dsz.exe port *P est 0 *B rz                │
  693. │                                                                    │
  694. ╘════════════════════════════════════════════════════════════════════╛
  695.  
  696.         CHECK THIS BEFORE MAKING THE DOOR AVAILABLE!
  697.  
  698.         The first line is the name of the protocol as it appears to
  699.         the user. Download and Upload cmd are the commands to fire
  700.         up the external protocol drivers. JC-QWK doesn't use
  701.         internal protocols like RA does, so you need to have an
  702.         external driver available. The configuration comes properly
  703.         set up for DSZ.EXE, a very popular utility available on most
  704.         BBS's as "DSZ????.*".
  705.  
  706.  
  707.                 NOTE: DSZ comes in .EXE and .COM versions - make
  708.                 sure JCQSETUP is set up to call the proper one, or
  709.                 you won't be able to get file transfers to work
  710.                 properly!
  711.  
  712.  
  713.         If you modify these settings, or add other external
  714.         protocols, check the documentation of those protocols for
  715.         info on how to set it up. Make sure the Download and Upload
  716.         Command lines include the full path, including drive letter.
  717.         If you include "*B" (without quotes) in the command line,
  718.         JC-QWK will replace it with the baud rate.
  719.  
  720.  
  721.         INSTRUCTIONS FOR NON-STANDARD IRQ's
  722.  
  723.         If you are using non-standard IRQ's, remove "Port *P" from
  724.         the DSZ command lines in JCQSETUP. Then in each DOS window
  725.         define a %DSZPORT% environment variable to refer to each
  726.         node's Base Address and IRQ. For example:
  727.  
  728.         SET DSZPORT=3F8,5       (this would set the port as COM1, IRQ5)
  729.  
  730.         Nodes that use a standard COM port can have this environment
  731.         variable simply defined as COM number. For example:
  732.  
  733.         SET DSZPORT=1           (this would set the port as COM1, IRQ4)
  734.  
  735.         So, for example, if you run a 3 line BBS under DesqView, and
  736.         COM1 and COM2 are both standard, but COM3 uses a
  737.         non-standard IRQ, then you would define the following
  738.         %DSZPORT% variables:
  739.  
  740.         Node 1 startup batch:   SET DSZPORT=1
  741.         Node 2 startup batch:   SET DSZPORT=2
  742.         Node 3 startup batch:   SET DSZPORT=3E8,5
  743.  
  744.         The following Addresses and IRQ's apply to standard COM
  745.         ports:
  746.  
  747.         Port    Addr    IRQ
  748.         ───────────────────────────────────────────────────────────
  749.         COM1    3F8     4
  750.         COM2    2F8     3
  751.         COM3    3E8     4
  752.         COM4    2E8     3
  753.  
  754.  
  755.         Compress tools:
  756.         ────────────────────────────────────────
  757.  
  758.         This is the same story as with the down/upload protocols,
  759.         bringing up a selection screen with add, delete and select
  760.         capabilities.
  761.  
  762. ╒════════════════════════════════════════════════ Fill in ╕
  763. │                                                         │
  764. │ Name:          ZIP                                      │
  765. │ Expand cmd:    f:\system\dosutl\pkunzip.exe -o          │
  766. │ Compress cmd:  f:\system\dosutl\pkzip.exe -ex           │
  767. │                                                         │
  768. ╘═════════════════════════════════════════════════════════╛
  769.  
  770.         Again, the Name is what will appear to the user,
  771.         Expand/Compression commands must include the full and
  772.         correct path names! JC-QWK comes with the standard archivers
  773.         configured with the appropriate switches (of course, you
  774.         will probably have to change the paths). Refer to your
  775.         archiver's documentation if you would like to do anything
  776.         unusual with these.
  777.  
  778.  
  779. Limits
  780. ────────────────────────────────────────
  781.  
  782.         This allows you to choose the maximum number of messages a
  783.         user at each modem speed can download in a single packet.
  784.  
  785.  ╒════════════════Choose╕
  786.  │ 300                  │
  787.  │ 1200                 │
  788.  │ 2400                 │
  789.  │ 9600                 │
  790.  │ 14k4                 │
  791.  │ Faster               │
  792.  ╘══════════════════════╛
  793.  
  794.         Selecting a bps rate will pop up the screen below, in which
  795.         you can control the maximum amount of messages present in
  796.         one QWK packet. This allows you to permit those users with
  797.         faster modems to download more messages, since they won't
  798.         take up as much time as slower users.
  799.  
  800. ╔═════════════════════════════╗
  801. ║ Maximum for 14k4 BPS : 600  ║
  802. ╚═════════════════════════════╝
  803.  
  804. Language definition
  805. ────────────────────────────────────────
  806.  
  807.         There has to be a valid *.JCQ file for each language you
  808.         define in RACONFIG! In other words, if a user has selected
  809.         FRENCH.RAL in RA, they should have FRENCH.JCQ in JC-QWK.
  810.  
  811. ╒═ Pick a file ╕
  812. │  ENGLISH.JCQ │
  813. │    DUTCH.JCQ │
  814. │    STOCK.JCQ │
  815. ╘══════════════╛
  816.  
  817.         This will be displayed when you first install JC-QWK. If you
  818.         want to create your own language file, press insert. You
  819.         will be prompted for a language name. BE SURE IT IS THE SAME
  820.         NAME THAT IS DEFINED IN RACONFIG!
  821.  
  822.         When selecting (or creating a new one) you will get this
  823.         screen:
  824.  
  825. ▒╒═════════════════════════════════════════════════ Language ╕
  826. ▒│ EDIT MENU HOTKEYS                                         │
  827. ▒│ Press ? to get help on area flags                         │
  828. ▒│ <S>elect ALL, <D>eselect ALL, <C>hange flags              │
  829. ▒│ Help on flags used in area selection screen               │
  830. ▒│ Message area selected                                     │
  831. ▒│ Receive only those messages addressed to you              │
  832. ▒│ Receive only those messages addressed to ALL              │
  833. ▒│ Receive messages written by yourself                      │
  834. ▒│ When you have a QWK network                               │
  835. ▒╘═══════════════════════════════════════════════╡    More ╞═╛
  836. ▒▒╔════════════════════════════════════════════════════════╗▒▒
  837. ▒▒║Press ? to get help on area flags                       ║▒▒
  838.   ╚════════════════════════════════════════════════════════╝▒▒
  839. ─────────────────────────────────────────────────────────────
  840. Press ? to get help on flags
  841.  
  842.         Selecting the second item on this menu allows you to edit
  843.         the description in the box below. At the bottom of the
  844.         screen you can see the original description of the prompt.
  845.         When creating a new language file it will be filled with the
  846.         default English prompts. Notice the "More" indicator in the
  847.         lower right - there are more prompts than shown on this
  848.         screen. There are some prompts for which you have to provide
  849.         a hotkey in addition to the line. This is done in a separate
  850.         editing box (eg the Continue (Y/n/=) prompt). You can use
  851.         all keys available, as long as the order doesn't change!
  852.  
  853. Edit menu hotkeys
  854. ────────────────────────────────────────
  855.  
  856.         This brings you to another menu, from which you can define
  857.         which hotkeys are used for each action available.
  858.  
  859. ╒═══════Change Select Character╕
  860. │    MAINSCREEN                │
  861. │ <D> Download                 │
  862. │ <U> Upload                   │
  863. │ <R> Restore pointers         │
  864. │ <M> Modify pointers          │
  865. │ <S> Select areas             │
  866. │ <I> Indexfiles toggle        │
  867. │ <N> New files toggle         │
  868. │ <C> Compression              │
  869. │ <T> Transmission protocol    │
  870. │ <?> Help key                 │
  871. │ <Q> Quit                     │
  872. │ <G> Goodbye - logoff         │
  873. │ <S> Stop - interrupt process │
  874. │ <A> Auto Download            │
  875. │    AREA SELECTION SCREEN     │
  876. │ <S> Select all               │
  877. │ <D> Deselect all             │
  878. │ <C> Change flags             │
  879. ╘══════════════════════════════╛
  880.  
  881.         Just fill in the key you want to use for each action.
  882.  
  883.   │ 3.2 PATH NAMES
  884. ────────────────────────────────────────
  885.   │
  886.  
  887.         This lets you tell JC-QWK what directories to use. Selecting
  888.         an item from this screen lets you enter a pathname.
  889.  
  890.  Path names
  891.  ╒════════════════════════╕
  892.  │ Local mail directory   │
  893.  │ Work directory         │
  894.  │ Path to mail directory │
  895.  ╘════════════════════════╛
  896.  
  897. ╔════════════════════════════════════════════════════════════╗
  898. ║  C:\TEMP\                                                  ║
  899. ╚════════════════════════════════════════════════════════════╝
  900.  
  901.         LOCAL MAIL DIRECTORY:
  902.         Local mail directory is the directory mail packets should be
  903.         placed in, and reply packets will be found in, when you run
  904.         the door locally. Note that your mail reader may be set up
  905.         with separate directories for .QWK and .REP files - if so,
  906.         you will need to reconfigure it, or simply move packets, so
  907.         your reader can find them.
  908.  
  909.         WORK DIRECTORY:
  910.         Work directory is used by JC-QWK for temporary files and
  911.         directories needed during processing of mail packets. This
  912.         directory will be checked, and will be created if it doesn't
  913.         already exist.
  914.  
  915.         PATH TO MAIL DIRECTORY:
  916.         Path to mail directory is the directory where the files for
  917.         your Hudson messagebase are located. If you don't use Hudson
  918.         (if all your areas are JAM) you'll still need this directory
  919.         for the userbase files.
  920.  
  921.         You don't need to tell JC-QWK where your JAM areas are - it
  922.         locates them on its own, using the MESSAGES.RA file in your
  923.         BBS setup.
  924.  
  925.         A NOTE ON JAM SPEED!:
  926.         For optimum speed in all JAM activities (echomail
  927.         processing, scanning, and QWK packing), do not include more
  928.         than 32 JAM areas in a single directory. Users who have put
  929.         all of their JAM areas in a single directory have reported
  930.         it to be *very* slow.
  931.  
  932.  
  933.  
  934.   │ 3.3 USER DETAILS
  935. ────────────────────────────────────────
  936.   │
  937.  
  938.         User details will present a selection screen to you listing
  939.         those users who have used the JC-QWK door. If none are
  940.         listed, you must enter one manually. You can select <enter>;
  941.         remove <del>; and add <insert>; users from this screen. When
  942.         editing a user, the following screen appears:
  943.  
  944. ╒══════════════════════════════════════════════════ Fill in ╕
  945. │ Number in USERS.BBS :   1                                 │
  946. │ User name           :   Mike Ehlert                       │
  947. │ Protocol            :   ZModem                            │
  948. │ Compression         :   ZIP                               │
  949. │ Receive bulletins   :   NO                                │
  950. │ Rcv list of new fls :   NO                                │
  951. │ Receive Index files :   NO                                │
  952. │ Messageareas        :   <Enter>                           │
  953. │                                                           │
  954. │                                                           │
  955. │                                                           │
  956. │                                                           │
  957. │                                                           │
  958. │                                                           │
  959. ╘═══════════════════════════════════════════════════════════╛
  960.  
  961.         If the user is found in the RA USERS.BBS file the number of
  962.         the user is shown. You can edit the user's name and toggle
  963.         their flags. Selecting message areas will bring you to the
  964.         next screen (if you use RA 2.x)
  965.  
  966.         From this selection screen you can add, delete or edit an
  967.         area.
  968.  
  969. ╒═══════════════════ Area: M_MAIN-BOARD ╕
  970. │ Actual lastread pointer       : 12265 │
  971. │ Last succeeded run pointer    : 10376 │
  972. │ Receive own messages only     : No    │
  973. │ Receive only to "ALL"         : No    │
  974. │ Receive self written messages : No    │
  975. │ Network status                : No    │
  976. ╘═══════════════════════════════════════╛
  977.  
  978.         ACTUAL LASTREAD POINTER:
  979.         This is the pointer found in LASTREAD.BBS for this user.
  980.         It's the highest number message the user has read in this
  981.         message area. These are the same pointers used when the user
  982.         reads messages online, or in most other mail doors, so
  983.         changing this pointer affects which messages are considered
  984.         new not just in JC-QWK, but also in the RA editor and other
  985.         mail doors. Therefore:
  986.  
  987.         BE CAREFUL NOT TO MESS UP THIS POINTER! YOUR USERS MAY NOT
  988.         LIKE IT! Don't alter it unless you know exactly what you're
  989.         doing.
  990.  
  991.         LAST SUCCEEDED RUN POINTER:
  992.         Last succeeded run pointer is the number of the highest
  993.         message in their last downloaded packet. This is used when
  994.         the user resets their pointers to the previous run, in case
  995.         a QWK packet gets messed up and they want to re-download it.
  996.  
  997.         RECEIVE OWN MESSAGES ONLY:
  998.         Whether the user will only receive messages addressed to
  999.         them directly in that area. This can be toggled by the user
  1000.         online.
  1001.  
  1002.         RECEIVE ONLY TO ALL:
  1003.         Whether or not the user will only get the messages in this
  1004.         area which are addressed to "ALL". This can be toggled by
  1005.         the user online.
  1006.  
  1007.         RECEIVE SELF WRITTEN MESSAGES:
  1008.         Whether the user will get messages which they themselves
  1009.         uploaded to the area. This can also be toggled by the user
  1010.         online.
  1011.  
  1012.         NETWORK STATUS:
  1013.         This will enable the user to upload mail with other names in
  1014.         the "from" field than what's in their EXITINFO.BBS file,
  1015.         regardless of whether the area is set up as REAL NAMES- or
  1016.         HANDLES ONLY in MESSAGES.RA. Normally JC-QWK checks
  1017.         MESSAGES.RA and enforces the use of the user's real name or
  1018.         handle if that is the restriction on the area, only allowing
  1019.         other names in PICK AN ALIAS areas. Netstatus allows that
  1020.         user to upload messages as if the area were PICK AN ALIAS,
  1021.         which they need to do if they are uploading packets from a QWK
  1022.         based network.
  1023.  
  1024.  
  1025.   │ 3.4 EXIT
  1026. ────────────────────────────────────────
  1027.   │
  1028.  
  1029.         Well, this is a familiar one, I think! Choose between "with"
  1030.         or "without" save.
  1031.  
  1032.  
  1033. ────────────────────────────────────────────────────────────────────
  1034.         ────────────────    4.0 NOTES     ────────────────
  1035. ────────────────────────────────────────────────────────────────────
  1036.  
  1037.  
  1038.   │ 4.1 USER FEATURES
  1039. ────────────────────────────────────────
  1040.   │
  1041.  
  1042.         OFFLINE ADD/DROP/RESET:
  1043.  
  1044.         JC-QWK supports RESET, ADD and DROP commands given by
  1045.         offline mail readers. Users should refer to the
  1046.         documentation of their offline reader for further details.
  1047.  
  1048.  
  1049.         AUTO DOWNLOAD/UPLOAD:
  1050.  
  1051.         If a user selects this option, They can download new mail
  1052.         and upload a .REP packet with minimal supervision. Each time
  1053.         they enter the JC-QWK door they will automatically move to
  1054.         downloading a new packet. Once that is complete, they are
  1055.         offered the opportunity to press "U" and upload a .REP
  1056.         packet - otherwise they will be disconnected in 10 seconds.
  1057.         This way they can start the download and then leave it to
  1058.         run unattended, without having to worry about logging off.
  1059.  
  1060.         If the user wants to change their settings, or turn this
  1061.         feature off, they must wait until they reach the prompt that
  1062.         they are being logged off, and press "S" to stop the automatic
  1063.         disconnect. Then they will be at the regular JC-QWK menu.
  1064.  
  1065.  
  1066.   │ 4.2 NETMAIL
  1067. ────────────────────────────────────────
  1068.   │
  1069.  
  1070.         JC-QWK supports Fidonet netmail. When a netmail message is
  1071.         exported to a user's packet, the subject is moved to the
  1072.         first line of the message with a leading "Subj:" keyword.
  1073.  
  1074.         To write a netmail message offline, if your reader doesn't
  1075.         do it for you, put the address in the Subject field with a
  1076.         leading "@". The first line must start with "Subj:", with no
  1077.         leading spaces.
  1078.  
  1079.         JC-QWK understands both full addresses as well as a variety
  1080.         of short-form addresses (where the remaining part of the
  1081.         address is based on the main address or AKA for the netmail
  1082.         message area.
  1083.         Some examples (assuming an address of 1:110/290 would be:
  1084.  
  1085.         @151/223           send to 1:151/223
  1086.         @1:274/40          send to 1:274/40
  1087.         @270               send to 1:110/270
  1088.         @.1                send to 1:110/290.1
  1089.  
  1090.         On messages exported from the Bbs, the subject line will
  1091.         contain the originating address for netmail areas.  This
  1092.         was done to allow you to reply without entering an address,
  1093.         since it will already be in the subject line.
  1094.  
  1095.         A future version of JC-QWK will support the CRASH flag.
  1096.         In this version the default attributes that will be used for
  1097.         all netmail imported via JC-QWK are KILL/SEND,PRIVATE and
  1098.         LOCAL.
  1099.  
  1100.  
  1101.   │ 4.3 INDEXES
  1102. ────────────────────────────────────────
  1103.   │
  1104.  
  1105.         JC-QWK offers users the option as to whether the mail door
  1106.         should generate index files and include them in the .QWK
  1107.         packet. Most modern mail readers create this file themselves
  1108.         when they unpack the mail, but some do not. Since indexes
  1109.         are probably unecessary, and take extra time to generate,
  1110.         users may want to turn this off unless they find their
  1111.         reader needs them.
  1112.  
  1113.  
  1114.   │ 4.4 SUPPORT
  1115. ────────────────────────────────────────
  1116.   │
  1117.  
  1118.         Since I am using this program myself, I will be supporting
  1119.         this program with every means I have to get it as perfect as
  1120.         possible. I have setup an area called JCQWK.SUP which is
  1121.         available for all questions/answers. It's available on the
  1122.         support sites at this moment and when there is enough flow
  1123.         it will be put on the backbone. Just ask your host for it,
  1124.         or get it at the support site.
  1125.  
  1126.  
  1127.   │ 4.5 ACKNOWLEDGEMENTS
  1128. ────────────────────────────────────────
  1129.   │
  1130.  
  1131.         Thanks to all my alpha/betatesters on whom I put a lot of
  1132.         pressure, since I wanted this release to be on its way ASAP.
  1133.         Thanks to Ron Huiskes and Hans Siemons who helped me out
  1134.         numbers of times. And of course Kief Morris who updated
  1135.         these files (Besides being a terrible programmer I also can't
  1136.         write docs...). I also want to say thanks to Mark May who did a
  1137.         marvelous job on the JAM routines. Thanks Mark!
  1138.  
  1139.         And of course my girlfriend Ingrid for her patience when I
  1140.         was too busy with programming to do anything.
  1141.  
  1142.         < The JC Beta team would like to slip in congratulations and
  1143.         best wishes to Johan and Ingrid on their marriage - October 1,
  1144.         1993! >
  1145.  
  1146.  
  1147.   │ 4.6 FUTURE PLANS
  1148. ────────────────────────────────────────
  1149.   │
  1150.  
  1151.         Adding file requests, making JC-QWK more flexible, a kind
  1152.         of script language so download/upload goes automaticly and
  1153.         other features you suggest!
  1154.  
  1155.         If you have any requests for features, don't hesitate to
  1156.         contact me! If you don't say anything, that's fine with me,
  1157.         but it won't improve JC-QWK. So please contribute your input
  1158.         to this fine product!
  1159.  
  1160.  
  1161.   │ 4.7 REGISTRATION
  1162. ────────────────────────────────────────
  1163.   │
  1164.  
  1165.         You may use this version for one month to see if it meets
  1166.         your needs. If you decide it's good enough to use longer
  1167.         than that, please register by sending the fee to one of the
  1168.         registration sites available.
  1169.  
  1170.         Read the separate REGISTER.DOC about how to register, or ask
  1171.         for instructions at 1:102/1001 or 2:281/610.
  1172.  
  1173.  
  1174.   │ 4.8 EPILOG
  1175. ────────────────────────────────────────
  1176.   │
  1177.  
  1178.         If you find any errors or misbehavior of this program, or
  1179.         suggestions for new features or improvements, please contact
  1180.         me via netmail (2:281/610) or the JCQWK.SUP or RA_UTIL echo.
  1181.         Normally I will bring out bugfixes as soon as possible, at
  1182.         least one week after a bug has been reported. Note that the
  1183.         message echo for JC-QWK, named JCQWK.SUP, is available from
  1184.         support sites.
  1185.  
  1186.  
  1187.   │ 4.9 LATEST VERSIONS
  1188. ────────────────────────────────────────
  1189.   │
  1190.  
  1191.         The latest version of JC-QWK is available for download or
  1192.         file request as JCQWK from:
  1193.  
  1194.         EUROPE:
  1195.  
  1196.         Johan Corstjens (2:281/610)
  1197.         31-15-138754
  1198.         Delft, Netherlands
  1199.  
  1200.         UNITED STATES:
  1201.  
  1202.         Mike Janke (1:135/4)
  1203.         1-305-271-2146
  1204.         Miami, Florida
  1205.  
  1206.         Mike Ehlert (1:102/1001)
  1207.         Thousand Oaks, California
  1208.         1-805-494-8327
  1209.         1-805-494-8427
  1210.         1-805-494-9386
  1211.  
  1212.  
  1213.         Kief Morris (1:110/210)
  1214.         Yellow Springs, Ohio
  1215.         1-513-767-7896
  1216.  
  1217. I will release major updates in the common Fidonet file echoes.
  1218.  
  1219. (c) 1993 JC-Tools - Johan Corstjens
  1220.     The First Dutch MIDI BBS
  1221.     +31-15138754 V22 >> V32bis HST DS
  1222.     The Netherlands
  1223.  
  1224.