home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / ra / jcqwk100.zip / JCQWK.DOC < prev    next >
Text File  |  1993-06-15  |  30KB  |  808 lines
  1.  
  2.  
  3.  
  4. JCQWK 1.00 June '93 - QWK door for Remote Access 2.0 and 1.1.
  5. (c) Copyright 1993 Johan Corstjens - JC-TOOLS  All Rights Reserved.
  6. Docs by Kief Morris.
  7.  
  8.  
  9.       =========================================================
  10.                         TABLE OF CONTENTS
  11.                 ------------------------------------
  12.  
  13.  
  14.         1.0 INTRODUCTION
  15.             1.1 License
  16.             1.2 Disclaimer
  17.             1.3 Features
  18.             1.4 Files
  19.             1.5 What's New
  20.             
  21.         2.0 INSTALLATION
  22.             2.1 Files
  23.             2.2 Important Note
  24.             2.3 Language Files
  25.             2.4 Menu Files
  26.             2.5 Remote Access Menu
  27.             2.6 Logging
  28.  
  29.         3.0 JCQSETUP
  30.             3.1 System Details
  31.             3.2 Path Names
  32.             3.3 User Details
  33.             3.4 Exit
  34.  
  35.         4.0 NOTES
  36.             4.1 Offline Adding/Dropping Areas
  37.             4.2 Limitations
  38.             4.3 Support
  39.             4.4 Acknowledgements
  40.             4.5 Future Plans
  41.             4.6 Registration
  42.             4.7 Epilog
  43.             4.8 Latest Versions
  44.  
  45.  
  46.  
  47. ======================
  48. 1.0 LICENSE, ETC.
  49.  
  50. -----------------
  51. 1.1 LICENSE
  52.  
  53. This document and the associated files may be freely copied provided
  54. that:
  55.  
  56.      1)   All of the files are copied as a group (such as in a
  57.           single archive).  See below for a list of files.
  58.  
  59.      2)   The files are not modified in any way (including
  60.           removal or alteration of copyright notices or this
  61.           license)
  62.  
  63.      3)   No charge beyond a cost-recovery fee not to exceed
  64.           $5, or a general telecommunications connection fee,
  65.           is made.
  66.  
  67.      4)   After a month of evaluation the product must be
  68.           registered.
  69.  
  70.  
  71. This package may not be incorporated into programs or other products
  72. which are distributed or sold to others without the authors
  73. permission.
  74.  
  75.  
  76. -----------------
  77. 1.2 DISCLAIMER
  78.  
  79.  
  80. Although both others and I have tested this program, it is
  81. entirely possible that JCQWK may malfunction in environments or
  82. under circumstances in which it has not been tested. The author
  83. disclaims any and all responsibility for damages (both
  84. consequential and incidental) resulting from the use or misuse of
  85. JCQWK. Sole responsibility for determining the suitability of the
  86. program rests with the user.
  87.  
  88.  
  89. -----------------
  90. 1.3 FEATURES
  91.  
  92.  o   Downloading/uploading of QWK compatible mail packets
  93.  o   Numbering of downloaded packets up to 99 - e.g. BBS.Q01
  94.      (optional)
  95.  o   Modify pointers by message area
  96.  o   Select a number of messages instead of a lastread pointer (eg -
  97.      last 50 messages in each area, rather than message number 7,492)
  98.  o   Optional sending of index files (*.NDX)
  99.  o   Send an ASCII list of new files without online scan (optional)
  100.  o   Selecting/deselecting complete message groups
  101.  o   Change flags by area
  102.  o   Filters to receive only messages addressed to All, only personal
  103.      messages, and those written by the user.
  104.  o   Sysop controlled network status per area
  105.  o   Running on RA 2.00, RA 1.1x, and any other system using the
  106.      DOOR.SYS file
  107.  o   Supports Hudson style messagebase (and will support JAM!)
  108.  o   Multi language support - uses its own language files
  109.  o   Hotkeys changeable by sysop (per language file)
  110.  o   Single or double list displays of message areas
  111.  o   Flexible user editor
  112.  o   Areas can be added/dropped by writing a letter to JC QWK
  113.      (check your offline mailreader about this!)
  114.  o   Simple installation - Just install as a type 7 with no
  115.      parameters other than *M (needed to run some archive programs)
  116.  o   Define separate message number limits for each connect
  117.      speed.
  118.  o   Multinode/network aware
  119.  
  120. -----------------
  121. 1.4 FILES
  122.  
  123.  
  124. The disk or archive you received should contain the following
  125. files:
  126.  
  127.  
  128.         JCQWK01N.ZIP contains:
  129.         ======================
  130.  
  131.         !README.NOW   Last minute note's
  132.         JCQWK.DOC     This file - documentation
  133.         REGISTER.DOC  How to register this program
  134.         JCQWK.EXE     The door program itself
  135.         JCQSETUP.EXE  Setup program
  136.         ENGLISH.ZIP   English menu files (ASCII ANSI and AVATAR)
  137.         DUTCH.ZIP     Dutch menu files
  138.         LANGUAGE.ZIP  English and Dutch language files
  139.         CONFIG.ZIP    Sample config files for download protocols and
  140.                       Compression tools
  141.         --------------
  142.  
  143.  
  144.  
  145.         ENGLISH.ZIP and DUTCH.ZIP contains:
  146.         ===================================
  147.  
  148.         JCQ1TIME.ANS  Initial welcome screen
  149.         JCQ1TIME.ASC
  150.         JCQ1TIME.AVT
  151.         JCQHELP.ANS   User help screen
  152.         JCQHELP.ASC
  153.         JCQHELP.AVT
  154.         JCQMENU.ASC   Main menu screen
  155.         JCQMENU.AVT
  156.         JCQMENU.ANS
  157.         JCQWELC.ANS   Welcome screen
  158.         JCQWELC.ASC
  159.         JCQWELC.AVT
  160.         -----------
  161.  
  162.  
  163.         CONFIG.ZIP contains:
  164.         ====================
  165.  
  166.         JCQPACK.CFG   Demo setup for compression programs
  167.         JCQPROT.CFG   Demo setup for download protocols
  168.         -----------
  169.  
  170.  
  171.  
  172. -----------------
  173. 1.5 WHAT'S NEW
  174.  
  175.  
  176. Since this is the initial release you probably won't find
  177. any new stuff.
  178.  
  179.  
  180. ======================
  181. 2.0 INSTALLATION
  182.  
  183. INSTALLATION for RA 2.00 and RA 1.11
  184.  
  185. -----------------
  186. 2.1 FILES
  187.  
  188. Create a directory to run JCQWK from and copy the JCQWK.EXE,
  189. JCQSETUP.EXE files to it, along with the language (*.JCQ) and
  190. configuration (*.CFG) files. The directory should look something
  191. like this:
  192.  
  193.    Directory of Z:\BBS\JCQWK
  194.  
  195. DUTCH    JCQ     10348 05-23-93  10:32a
  196. ENGLISH  JCQ     10348 05-23-93  10:32a
  197. JCQPACK  CFG      1840 05-17-93  11:57p
  198. JCQPROT  CFG      1030 05-17-93  11:56p
  199. JCQSETUP EXE    155568 05-23-93  10:22a
  200. JCQUSERS DAT     16281 05-23-93  10:32a
  201. JCQWK    EXE     75074 05-23-93  10:30a
  202.         9 file(s)     404969 bytes
  203.  
  204. You can put these files anywhere, as long as they are together!
  205. (see file list if you can't find them.)
  206.  
  207. You can create/edit both *.JCQ and JCQUSERS.DAT with JCQSETUP.EXE
  208. - see the section about the setup program below.
  209.  
  210.  
  211. ----------------
  212. 2.2  *** IMPORTANT NOTE ***
  213.  
  214. Both JCQWK as JCQSETUP will look for the configuration files in
  215. the same directory they are located in, regardless of which
  216. directory you execute them from. So if you run the door as a type
  217. 7 in RA and you specify C:\BBS\JCQWK\JCQWK.EXE *M, it will find
  218. the config files fine if they are in that directory. The setup
  219. program must be in that same directory, or else you will be
  220. updating the wrong files when you run it! Check the main screen
  221. of the setup program (under the Copyright info) to see what
  222. directory the configs you are working on are in. (You can guess
  223. what will happen if there are several copies of the setup program
  224. lying around!)
  225.  
  226.  
  227. ----------------
  228. 2.3 LANGUAGE FILES
  229.  
  230. JCQWK uses its own language files, with a separate file for each
  231. language named *.JCQ. JCQWK decides which language file to use by
  232. checking what is being used in RA itself when the door is run.
  233. So, for each .RAL files you have available in RA you should have
  234. an identical .JCQ files, with the same base name - eg if you have
  235. a GERMAN.RAL file, you should also have a GERMAN.JCQ file. You
  236. should find ENGLISH.JCQ and DUTCH.JCQ files included with this
  237. package. If you have other languages in Remote Access, either
  238. copy other .JCQ files over to match the name, or use JCQSETUP to
  239. create your own language file. See the section on JCQSETUP below
  240. for more information.
  241.  
  242. -------------
  243. 2.4 MENU FILES
  244.  
  245. JCQWK will first look for its menu files (.ANS .AVT or .ASC) in
  246. the directory pointed to by the active language record for Remote
  247. Access. If the proper files aren't found there, JCQWK will then
  248. search its own directory. It expects files named like the ones in
  249. ENGLISH.ZIP and DUTCH.ZIP. These files are just like the ones
  250. used with Remote Access - you can even use all of the special RA
  251. textfile codes!
  252.  
  253. -------------
  254. 2.5 REMOTE ACCESS MENU
  255.  
  256. Installing JCQWK in RA is very simple. Just make a menu command
  257. entry for the QWK door and define it as a type 7 exit. The
  258. optional parameter should be the full path and name of JCQWK.EXE
  259. ending with *M. Swapping should not be needed for JCQWK, but will
  260. probably be needed by some archiving programs who need a lot of
  261. memory (ARJ, for example!)
  262.  
  263. It will look something like this:
  264.  
  265. --------------------------------------------------------------
  266.          1         2         3         4         5         6
  267. 12345678901234567890123456789012345678901234567890123456789012345
  268. ;
  269. z:\bbs\jcqwk\jcqwk.exe *m
  270.  
  271.  Action   Execute sub-program (Type 7)
  272.  Display
  273.  OptData
  274.  HotKey   Q
  275.  AutoExec No
  276.  Color   Color example
  277.  
  278.  MinSec   7                  TimeUsed 0                 FlatCost 0
  279.  MaxSec   61000              TimeLeft 0                 TimeCost 0
  280.  A flags  --------           Age      0                 Terminal Any
  281.  B flags  --------           MinSpeed 0                 Nodes
  282.  C flags  --------           MaxSpeed 0                 Groups
  283.  D flags  --------           Credit   0                 DayTimes
  284. ---------------------------------------------------------------------------
  285.  
  286.  
  287.  
  288. -------------------
  289. 2.6 LOGGING
  290.  
  291. Logging will take place in the logfile RA is writing to. If
  292. anything goes wrong, check this logfile first before asking for
  293. advice! Set logging on DEBUG MODE in JCQSETUP -> BBS setup to get more
  294. info if things go wrong. This option will write more information in
  295. the log file. If there is a Runtime Error there will be a seperate file
  296. in the node direcory (RUNERROR.LOG) containing the Runtime Error
  297. information.
  298.  
  299.  
  300. =======================
  301. 3.0 JCQSETUP
  302.  
  303. You can use JCQSETUP to edit all of the files needed: language
  304. files, user records, and configuration files. I strongly advise
  305. that you go through all items to make sure they are properly set
  306. for your system.
  307.  
  308. Firing up jcqsetup brings the following screen:
  309.  
  310. ----------------------------------------------------------------------------
  311.  
  312. System details               Path names          User details        Exit
  313. ═════════════════════════════╕══════════════════════════════════════════════
  314. ▒│ Personal details          │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  315. ▒│ BBS setup                 │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  316. ▒│ Packetnumbering is on now │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  317. ▒│ Download protocols        │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  318. ▒│ Compress tools            │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  319. ▒│ Limits                    │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  320. ▒│ Language definition       │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  321. ▒│ Columns (double now)      │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  322. ▒│ Forced areas              │▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  323. ▒╘═══════════════════════════╛▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  324. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  325. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Setup program for JC-QWK verion 1.0 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  326. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  327. ▒▒▒▒▒▒▒▒▒▒▒▒ Copyright (c) Johan Corstjens / JC-Tools 1993 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  328. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  329. ▒▒▒▒▒▒▒▒▒▒▒▒ Using config files in D:\PROGRAMS\BP\UNITS\ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  330. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  331. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  332. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  333. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  334. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  335. ────────────────────────────────────────────────────────────────────────────
  336. Menu for name, location and registration code
  337.  
  338.  
  339. Things to remember when you use this programs. are:
  340. o    Check the line stating the directory of the config files (in
  341.      the middle of the screen)
  342.  
  343. o    The last line gives you brief, context sensitive help on the
  344.      currently highlighted item (throughout the whole program) - in
  345.      this case telling you that the "Personal Details" option
  346.      will give you a menu to enter your name, location and
  347.      registration code.
  348.  
  349. -----------------
  350. 3.1 SYSTEM DETAILS
  351.  
  352. o    Personal details
  353.      Displays the personal details menu (see below)
  354. o    BBS Setup
  355.      Displays the BBS setup menu (see below)
  356. o    Use packet numbering
  357.      This item will toggle between using or not using the packet
  358.      number feature. This feature numbers the outgoing packets
  359.      for each user For example, the first time Mike Ehlert
  360.      downloads a packet it will be named BBSNAME.Q00 - his second
  361.      packet will be BBSNAME.Q01, up through BBSNAME.Q99. After he
  362.      reaches .Q99 it will start over at .Q00 again. This number
  363.      is kept in the userfile for each user separately, and will
  364.      be increased when a download is successful. It will only
  365.      affect the extension of the packet. If disabled, packets
  366.      will be named BBSNAME.QWK every time.
  367. o    Download protocols displays the protocol editor, so you
  368.      can define file transfer protocols available for users to
  369.      download from the QWK door. (see below)
  370. o    Compress tools displays the compression tools editor, so you
  371.      can define archivers available for compressing and
  372.      decompressing mail packets. (see below)
  373. o    Limits displays the Limits setup menu, so you can set the
  374.      maximum number of messages users may download according to
  375.      their modem speed. (see below)
  376. o    Language definition brings up a menu with .JCQ language
  377.      files (if any) to choose from. You can press DEL or INS to
  378.      delete or create one. Selecting a language brings you to the
  379.      language editor (see below)
  380. o    Columns will toggle between double and single display, to
  381.      determine whether available message areas and groups will be
  382.      displayed in one or two columns. If double is selected,
  383.      areas will be truncated at position 25
  384. o    Forced areas enables you to select areas a your is forced to
  385.      read
  386.  
  387. ----------------
  388. Personal details menu
  389.  
  390. ╒═══════════════════════════════════════ Personal Details ╕
  391. │ Your name:         Johan Corstjens                      │
  392. │ Your location:     Delft, The Netherlands               │
  393. │ Registration Code:                                      │
  394. ╘═════════════════════════════════════════════════════════╛
  395.  
  396. Fill in your name, Location and (if you have one) a registration
  397. key code.
  398.         
  399.  
  400. ----------------
  401. BBS Setup
  402.  
  403.  
  404. ╒═══════════════════════════════════════════════ BBS Details ╕
  405. │ BBS name     : The 1st Dutch MIDI BBS node 2               │
  406. │ BBS code     : MIDIBBS2                                    │
  407. │ BBS type     : RA 2.00                                     │
  408. │ Swap to      : Try best method                             │
  409. │ Log mode     : Normal logging                              │
  410. │ News file    : NEWS                                        │
  411. │ Newfile list : Z:\BBS\RA\NEW.FLS                           │
  412. │ Welcome file : WELCOME                                     │
  413. │ Goodbye file : GOODBYE                                     │
  414. ╘════════════════════════════════════════════════════════════╛
  415.  
  416.  
  417. Fill in the name of your BBS, and the base filename to use for
  418. the up/download packets (no extensions!) Toggle the BBS type so
  419. it reflects your setup (RA 2.00, RA 1.1? or other).
  420.  
  421. 'Swap to' can be toggled to force it to swap to disk, EMS, XMS and
  422. Extended memmory. Try best method will just look for the best way.
  423.  
  424. Log mode toggles between normal and debugging mode.
  425.  
  426. Enter the base filename of the files you want displayed to the
  427. offline reader for news, welcome, and goodbye. As with the menu
  428. screens, JCQWK will look in the text path directory pointed to by
  429. the language record in use on RA. If the user uses ANSI or Avatar
  430. it will search for those extensions, if not it will look for
  431. .ASC. If the appropriate file isn't found the JCQWK directory
  432. will then be searched. Don't supply the path!
  433.  
  434. If you have not registered JCQWK it will ignore the News entry
  435. and generate its own file with a nice message to the user.
  436.  
  437. The New Files list must be an ASCII textfile, which you can
  438. generate with one of the available file utilities, such as the
  439. RAFILE program which comes with RA 2.x. This is makes JCQWK much
  440. faster than it would be if it did an online scan of the file
  441. directories every time a caller downloaded a new packet! Make sure
  442. you include the drive and path to the file too!
  443.  
  444.  
  445.  
  446. ----------------
  447. Download protocols will present a selection screen to you from
  448. which you can add, delete or select a file transfer protocol
  449. available to users to download and upload their packets.
  450.  
  451. When you select a protocol, a screen will appear:
  452.  
  453. ╒══════════════════════════════════════════════════ Fill in ╕
  454. │                                                           │
  455. │ Name:         ZModem                                      │
  456. │ Download cmd: z:\bbs\ra\dsz.exe port *P pB4096 sz -Z -k -m│
  457. │ Upload cmd:   z:\bbs\ra\dsz.exe port *P rz                │
  458. │                                                           │
  459. ╘═══════════════════════════════════════════════════════════╛
  460.  
  461. The first line is the name of the protocol as it appears to the
  462. user. Download and Upload cmd are the commands to fire up the
  463. external protocol drivers. It has to be supplied with full
  464. pathname!
  465.  
  466. CHECK THIS BEFORE MAKING THE DOOR AVAILABLE!
  467.  
  468.  
  469. ----------------
  470. Compress tools:
  471.  
  472.  
  473. This is the same story as with the down/upload protocols,
  474. bringing up a selection screen with add, delete and select
  475. capabilities.
  476.  
  477. ╒════════════════════════════════════════════════ Fill in ╕
  478. │                                                         │
  479. │ Name:          ZIP                                      │
  480. │ Expand cmd:    f:\system\dosutl\pkunzip.exe -o          │
  481. │ Compress cmd:  f:\system\dosutl\pkzip.exe -ex           │
  482. │                                                         │
  483. ╘═════════════════════════════════════════════════════════╛
  484.  
  485. Again the same story, the Name is what will appear to the user,
  486. Expand/Compression commands must include the full and correct path
  487. names!
  488.  
  489.  
  490. ----------------
  491. Limits
  492.  
  493. This allows you to choose the maximum number of messages a user
  494. at each modem speed can download in a single packet.
  495.  
  496.  
  497.  ╒════════════════Choose╕
  498.  │ 300                  │
  499.  │ 1200                 │
  500.  │ 2400                 │
  501.  │ 9600                 │
  502.  │ 14k4                 │
  503.  │ Faster               │
  504.  ╘══════════════════════╛
  505.  
  506. ╔═════════════════════════════╗
  507. ║ Maximum for 14k4 BPS : 600  ║
  508. ╚═════════════════════════════╝
  509.  
  510.  
  511. Selecting a bps rate will pop up the screen below, in which you
  512. can control the maximum amount of messages present in one QWK
  513. packet. This allows you to permit those users with faster modems
  514. to download more messages, since they won't take up as much time
  515. as slower users.
  516.  
  517.  
  518. -------------------
  519. Language definition
  520.  
  521. There has to be a valid *.JCQ file for each language you
  522. define in RACONFIG!
  523.  
  524. ╒═ Pick a file ╕
  525. │  ENGLISH.JCQ │
  526. │    DUTCH.JCQ │
  527. ╘══════════════╛
  528.  
  529. This will be displayed when you first install JCQWK. If you want
  530. to create your own language file, press insert. You will be
  531. prompted for a language name. BE SURE IT IS THE SAME NAME THAT IS
  532. DEFINED IN RACONFIG!
  533.  
  534. When selecting (or creating a new one) you will get next
  535. screen:
  536.  
  537.  
  538. ▒╒═════════════════════════════════════════════════ Language ╕
  539. ▒│ EDIT MENU HOTKEYS                                         │
  540. ▒│ Press ? to get help on area flags                         │
  541. ▒│ <S>elect ALL, <D>eselect ALL, <C>hange flags              │
  542. ▒│ Help on flags used in area selection screen               │
  543. ▒│ Message area selected                                     │
  544. ▒│ Receive only those messages addressed to you              │
  545. ▒│ Receive only those messages addressed to ALL              │
  546. ▒│ Receive messages written by yourself                      │
  547. ▒│ When you have a QWK network                               │
  548. ▒╘═══════════════════════════════════════════════╡    More ╞═╛
  549. ▒▒╔════════════════════════════════════════════════════════╗▒▒
  550. ▒▒║Press ? to get help on area flags                       ║▒▒
  551.   ╚════════════════════════════════════════════════════════╝▒▒
  552. ─────────────────────────────────────────────────────────────
  553. Press ? to get help on flags
  554.  
  555.  
  556. Selecting the second item on this menu allows you to edit the
  557. description in the box below. At the bottom of the screen you can
  558. see the original description of the prompt. When creating a new
  559. language file it will be filled with the default English prompts.
  560. Notice the "More" indicator in the lower right - there are more
  561. prompts than shown on this screen. There are some prompts for
  562. which you have to provide a hotkey in addition to the line. This
  563. is done in a separate editing box (eg the Continue (Y/n/=)
  564. prompt). You can use all keys available, as long as the order
  565. doesn't change!
  566.  
  567.  
  568. -----------------
  569. Edit menu hotkeys
  570.  
  571.  
  572. -    This brings you to another menu, from which you can define
  573.      which hotkeys are used for each action available.
  574.  
  575. ╒═══════Change Select Character╕
  576. │    MAINSCREEN                │
  577. │ <D> Download                 │
  578. │ <U> Upload                   │
  579. │ <R> Restore pointers         │
  580. │ <M> Modify pointers          │
  581. │ <S> Select areas             │
  582. │ <I> Indexfiles toggle        │
  583. │ <N> New files toggle         │
  584. │ <C> Compression              │
  585. │ <T> Transmission protocol    │
  586. │ <?> Help key                 │
  587. │ <Q> Quit                     │
  588. │ <G> Goodbye - logoff         │
  589. │ <S> Stop - interrupt process │
  590. │    AREA SELECTION SCREEN     │
  591. │ <S> Select all               │
  592. │ <D> Deselect all             │
  593. │ <C> Change flags             │
  594. ╘══════════════════════════════╛
  595.  
  596. Just fill in the key you want to use for each action.
  597.  
  598.  
  599. -------------
  600. 3.2 PATH NAMES
  601.  
  602. Selecting an item from this screen lets you enter a pathname.
  603.  
  604.  
  605.  Path names
  606.  ╒════════════════════════╕
  607.  │ Local mail directory   │
  608.  │ Work directory         │
  609.  │ Path to mail directory │
  610.  ╘════════════════════════╛
  611.  
  612. ╔════════════════════════════════════════════════════════════╗
  613. ║  C:\TEMP\                                                  ║
  614. ╚════════════════════════════════════════════════════════════╝
  615.  
  616. Local mail directory is the directory mail packets should be
  617. placed in, and reply packets will be found in, when you run the
  618. door locally.
  619.  
  620. Work directory is used by JCQWK for temporary files and
  621. directories needed during processing of mail packets. This
  622. directory will be checked, and will be created if it doesn't
  623. already exist.
  624.  
  625. Path to mail directory is the directory where the Hudson MSG*.BBS
  626. files are located.
  627.  
  628. -----------------
  629. 3.3 USER DETAILS
  630.  
  631. User details will present a selection screen to you listing those
  632. users who have used the JCQWK door. If none are listed, you must
  633. enter one manually. You can select <enter> remove <del> and add
  634. <ins> users from this screen. When editing a user, the following
  635. screen appears:
  636.  
  637. ╒══════════════════════════════════════════════════ Fill in ╕
  638. │ Number in USERS.BBS :   1                                 │
  639. │ User name           :   Jc Qwk                            │
  640. │ Protocol            :   ZModem                            │
  641. │ Compression         :   ZIP                               │
  642. │ Receive bulletins   :   NO                                │
  643. │ Rcv list of new fls :   NO                                │
  644. │ Receive Index files :   NO                                │
  645. │ Messageareas        :   <Enter>                           │
  646. │                                                           │
  647. │                                                           │
  648. │                                                           │
  649. │                                                           │
  650. │                                                           │
  651. │                                                           │
  652. ╘═══════════════════════════════════════════════════════════╛
  653.  
  654. If the user is found in the RA USERS.BBS file the number of the
  655. user is shown. You can edit the user's name and toggle their
  656. flags. Selecting message areas will bring you to the next screen
  657. (if you use RA 2.x)
  658.  
  659. From this selection screen you can add, delete or edit an area.
  660.  
  661. ╒═══════════════════ Area: M_MAIN-BOARD ╕
  662. │ Actual lastread pointer       : 12265 │
  663. │ Last succeeded run pointer    : 10376 │
  664. │ Receive own messages only     : No    │
  665. │ Receive only to "ALL"         : No    │
  666. │ Receive self written messages : No    │
  667. │ Network status                : No    │
  668. ╘═══════════════════════════════════════╛
  669.  
  670.  
  671. Actual lastread pointer is the pointer found in LASTREAD.BBS
  672. for this user.
  673.  
  674. BE CAREFUL NOT TO MESS UP THIS POINTER AS YOUR USERS WILL NOT
  675. LIKE IT!
  676.  
  677. Last succeeded run pointer is the number of the highest message
  678. in their last downloaded packet.
  679.  
  680. Receive own messages only: the user will only receive messages
  681. addressed to them directly.
  682.  
  683. Receive only to all: Only messages to ALL will be selected.
  684.  
  685. Receive self written messages: the user gets the messages
  686. uploaded by him with the next package.
  687.  
  688. Network status: This will enable the user to upload mail with
  689. other names in the from field than that in their EXITINFO.BBS
  690. file, regardless of whether the area is defined as REAL NAMES- or
  691. HANDLES ONLY in MESSAGES.RA. Normally JCQWK checks MESSAGES.RA
  692. and enforces the use of the user's real name or handle if that is
  693. the restriction on the area, only allowing other names in PICK AN
  694. ALIAS areas. Netstatus allows that user to upload messages as if
  695. the area were PICK AN ALIAS, as they need to do if they are
  696. uploading packets from a QWK based network.
  697.  
  698.  
  699. -------------
  700. 3.4 EXIT
  701.  
  702. Well, this is a familiar one, I think.
  703.  
  704. Choose between "with" or "without" save.
  705.  
  706.  
  707. ======================
  708. 4.0 NOTES
  709.  
  710. ----------------------------
  711. 4.1 OFFLINE ADDING/DROPPING/RESETTING AREAS
  712.  
  713. This version supports RESET, ADD and DROP commands given by offline
  714. mailreaders. See the documentation of your offline reader for further
  715. details.
  716.  
  717. -----------------
  718. 4.2 LIMITATIONS
  719.  
  720. As this Gamma isn't ready yet (otherwise it wouldn't be a gamma!)
  721. there are some things to be done before the next release.
  722.  
  723. This release will work with RA 1.11, but some functions in the
  724. setup program only work with RA 2.00. I'm not sure if I'm going
  725. to fix this one. I only will do so if there are enough users
  726. requesting it.
  727.  
  728. -----------------
  729. 4.3 SUPPORT
  730.  
  731. Since I am using this program myself I will be supporting this
  732. program with every means I have to get it as perfect as possible.
  733. I have setup an area called JCQWK.SUP which is available for all
  734. questions/answers. It's available on the supportsites at this moment
  735. and when there is enough flow it will be put on the backbone.
  736.  
  737.  
  738. -----------------
  739. 4.4 ACKNOWLEDGEMENTS
  740.  
  741. Thanks to all my alpha/betatesters on whom I put a lot of
  742. pressure, since I wanted this release to be on its way ASAP.
  743. Thanks to Ron Huiskes and Hans Siemons who helped me out numbers
  744. of times. And offcource Kief Morris who updated these files (Besides
  745. of being a terrible programmer I also can't write docs...).
  746.  
  747. And of course my girlfriend Ingrid for her patience when I was to
  748. busy with programming to do anything.
  749.  
  750. -----------------
  751. 4.5 FUTURE PLANS
  752.  
  753. Next release will include a mode efficient routine for scanning messages.
  754. This will significant speed up selecting areas and scanning new mail.
  755. Adding file requests, making jcqwk more flexible.
  756.  
  757. If you have any requests for features, don't hasitate to contact me!
  758. If you don't say anything well, that's fine with me, but it won't improve
  759. JCQWK. So please contribute your input to this fine product!
  760.  
  761. ----------------------
  762. 4.6 REGISTRATION
  763.  
  764. You may use this version for about a month to see if it meets
  765. your demands. If you decide it's good enough to use longer than
  766. that, please register by sending the fee to one of the
  767. registration sites available.
  768.  
  769. Read the separate REGISTER.DOC about how to pay or ask for
  770. instructions at 1:102/1001 or 2:281/610.
  771.  
  772.  
  773. -----------------
  774. 4.7 EPILOG
  775.  
  776. If you find any errors or misbehavior of this program, please
  777. contact me via netmail (2:281/610) or echomail. I will read the
  778. RA_UTIL echo to see what's going on. Normally I will bring out
  779. bugfixes as soon as possible, at least one week after a bug has
  780. been reported. Note that there *IS* a special area for JCQWK named
  781. JCQWK.SUP, but since it takes a long time to have it available on
  782. the backbonesystem it is only available at the support sites at
  783. this moment.
  784.  
  785. -----------------
  786. 4.8 LATEST VERSIONS
  787.  
  788. The latest version of JCQWK will be available for request as
  789. JCQWK from:
  790.  
  791. Europe:
  792.  
  793. My node (2:281/610)
  794.  
  795. US sites:
  796.  
  797. Mike Janke (1:135/4)
  798. Mike Ehlert (1:102/1001)
  799.  
  800. I will release major updates in the common file echoes.
  801.  
  802.  
  803. (c) 1993 JC-Tools - Johan Corstjens
  804.     The First Dutch MIDI BBS
  805.     +31-15138754 V22 >> V32bis HST DS
  806.     The Netherlands
  807.  
  808.