home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_ra / rad211.arj / RADPLUS.DOC < prev    next >
Text File  |  1991-11-18  |  22KB  |  541 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.           :::::::::::::::        :::::::::::::      ::::::::::::::
  22.           ::::::::::::::::      :::::::::::::::     ::::::::::::::::
  23.           :::::       :::::    :::::       :::::    :::::      ::::::
  24.           :::::       :::::    :::::       :::::    :::::       :::::
  25.           ::::::::::::::::     :::::::::::::::::    :::::       :::::
  26.           :::::::::::::::      :::::::::::::::::    :::::       :::::
  27.           :::::    :::::       :::::       :::::    :::::       :::::
  28.           :::::     :::::      :::::       :::::    :::::      ::::::
  29.           :::::      :::::     :::::       :::::    ::::::::::::::::
  30.           :::::       :::::    :::::       :::::    ::::::::::::::   Plus
  31.  
  32.  
  33.                           Remote Access Database v2.11
  34.  
  35.                      (dBASE III & dBASE III Plus Compatible)
  36.  
  37.                          Copyright (C) 1990 Overerx Inc.
  38.                 Box 323 Sta A, Kingston, Ontario, Canada K7M 6R2
  39.                        Harvey Parisien * FidoNet 1:249/114
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                                RAD Plus - Remote Access Database
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.                            Background / What is RAD?
  72.  
  73.  
  74.  
  75.          RAD v1.00 series has been around for a while now.  It is a
  76.          simple online database system with it's own dedicated file
  77.          structure.  It is simple to operate, and serves a purpose.
  78.          Primarily it is directed towards BBS use.  It is available on
  79.          a shareware basis and distributed via SDS (Software
  80.          Distribution System).
  81.  
  82.          RAD Plus v2.00 series is the commercial version which is in
  83.          dBASE III format file structure for optimum flexibility and
  84.          compatibility with current and future environments.  It tends
  85.          to simulate standard dBASE<tm> type commands, which are
  86.          familiar to dBASE users.  It is also offered on a shareware
  87.          basis and distributed via SDS.
  88.  
  89.          This document will deal only with RAD Plus, but will simply
  90.          make reference to the name RAD to save key strokes.
  91.  
  92.          We will refer to the RAD Operator, and the RAD User.  The RAD
  93.          Operator is the System Operator (SysOp) or the System
  94.          Administrator whatever the case may be.  The RAD User is the
  95.          remote caller.
  96.  
  97.          RAD is designed with many considerations to offer maximum
  98.          security to the BBS SysOp, and in non-bbs (less secure)
  99.          environments.  However, the concern for security does not
  100.          make remote maintenance difficult for the RAD Operator.  All
  101.          maintenance can be performed remotely with the correct
  102.          security level.  For non-bbs type setups, you may request
  103.          from the author a Host/Terminal system which will allow
  104.          control of your computer remotely (including file transfers),
  105.          and can be used to answer the phone for RAD, clear passwords,
  106.          and so on (it will create a dorinfo1.def exit file - more on
  107.          that later).  HTERM is a nice terminal for the remote user as
  108.          well, written by the author of RAD.  It is available as
  109.          freeware on most BBS systems, or request HTERM from the
  110.          FidoNet address stated below.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                                                                           Page 1
  121.                                                RAD Plus - Remote Access Database
  122.  
  123.                          Files required to setup RAD...
  124.  
  125. RAD comes in an archived format.  We use LHA as our standard, but some BBS's or
  126. distribution systems may convert the archive structure.  The archive name is
  127. usually RAD???.LZH where ??? is the version number.  IE:  RAD209.LZH is the
  128. archive for version 2.09.
  129.  
  130. The files in RAD???.LZH are:
  131.  
  132.     DB.EXE       A dBASE III file editor (used for setup).
  133.     DB.DOC       Documentation for above.
  134.   * RADPLUS.EXE  RAD the program.
  135.     RADPLUS.DOC  This document.
  136.   * RADCFG.DBF   RAD's main configuration file.
  137.   * RADDIR.DBF   RAD's file directory/file subject file.
  138.  
  139.                  * = required for RAD to operate.
  140.  
  141.     ARTICLES DBF   Sample database...
  142.     BOOKS    DBF   Sample database...
  143.     SERVICES DBF   Sample database...
  144.     SUPPORT  DBF   Sample database...
  145.  
  146.     INFO.TXT   Some general information text files...
  147.     RAD2??.SDA Some general information text files...
  148.  
  149.     REGISTER.TXT   An application for to register RAD.
  150.  
  151.     DORINFO1 DEF   Sample exit file (created by BBS or other answering devices)
  152.  
  153. The only files required to run RAD are the ones marked with a *.  Your security
  154. levels and modem information etc. are contained in RADCFG.DBF and RADDIR.DBF.
  155. Let's look at each file and discuss them in detail.  Use DB.EXE to edit both
  156. RADDIR.DBF and RADCFG.DBF for your initial setup.
  157.  
  158.  
  159.                                    RADCFG.DBF
  160.  
  161. Record:  1  of  1
  162.  
  163. SYSOP_NAME :Harvey Parisien                    :
  164. SYSTEMNAME :The Lighthouse BBS                      :
  165. KEY        :0000000000000000000000000000:
  166. LEVEL1     :    5:
  167. LEVEL2     :   20:
  168. LEVEL3     :   40:
  169. LEVEL4     :  100:
  170. USAGE_LOG  :                                        :
  171. DOOR_INFO  :dorinfo1.def                            :
  172. MIN_TIME   :     5:
  173. MAX_TIME   :   120:
  174. COM_PORT   :COM1:
  175. MAX_BAUD   :2400  :
  176. USE_SCREEN :T:
  177.  
  178. SYSOP_NAME is the name of the System Operator (can be a department or company
  179.  
  180.                                                                           Page 2
  181.                                                RAD Plus - Remote Access Database
  182.  
  183. name also), and SYSTEMNAME is the BBS name (can be just an internal system name
  184. of any sort).  The KEY field must contain the key you receive when you register
  185. RAD Plus.  When you have the key entered, it will not bother reminding you to
  186. register any more.  RAD is fully functional with or without a key.
  187.  
  188. Level1 through to level4 are basically translation tables to translate your
  189. numeric security levels from your BBS, to RAD's 4 basic user levels.  In the
  190. scenario above, in order to have level 3 access, your BBS access level must be
  191. at least 40 or greater.
  192.  
  193. If you would like RAD to keep a usage log for you, enter a complete drive spec
  194. and path for your log file.  The log will record logons, and database changes,
  195. and each applicable record number.  Here's an example...
  196.  
  197. + 29 Sep 21:09:25 BINK end, Binkley 2.40
  198. + 01 Oct 19:21:00 MAX  Begin, v2.00
  199. + 01 Oct 19:21:01 MAX  Harvey Parisien calling (U#=0)
  200. # 01 Oct 19:21:02 MAX  Given 10000 min.
  201. # 01 Oct 19:21:10 MAX  External program: `C:\bc7\bin\radplus.exe /pC:\max\rad'
  202. + 01 Oct 19:21:11 RAD  Begin, v2.09 (user='HARVEY PARISIEN')
  203. + 01 Oct 19:21:11 RAD  File write: SUPPORT.DBF # 59
  204. + 01 Oct 19:21:11 RAD  End, v2.09
  205. : 01 Oct 19:21:31 MAX  Return from: `C:\bc7\bin\radplus.exe /pC:\max\rad' (0)
  206. + 01 Oct 19:21:34 MAX  Harvey Parisien off-line. Calls=429, Len=0, Today=0
  207. : 01 Oct 19:21:35 MAX  End, v2.00 (5)
  208.  
  209. As you can see, RAD has a log format compatible with Binkley, and/or Maximus.
  210. There are 3 entries above...
  211.  
  212. DORINFO1.DEF is a standard exit control file produced by QuickBBS and other
  213. popular BBS systems, containing the current users information.  As your BBS
  214. system exits to operate an external program like RAD, it writes this little
  215. file to allow the external program to read it and have the current transfer
  216. information.  Take a look at the file description that follows for the type of
  217. information it contains.  If you describe dorinfo1.def complete with drive spec
  218. and path, it will be used to decide whether the user can support ANSI/Color, how
  219. much time he/she has left online, current access level, etc...
  220.  
  221. If you do not have a parent system that creates DORINFO1.DEF, let us know and
  222. we'll try to accommodate.  Most BBS systems produce exit control files of one
  223. type or another, and there are many little conversion programs available on
  224. BBS's that will convert from one to another.  In that case you would have to run
  225. RADPLUS from a batch file.  For example
  226.  
  227. Sample batch for systems that don't produce dorinfo1.def
  228.  
  229. WINGWANG     ... THE BBS SYSTEM
  230. CONVERT      ... THE CONVERTER (changes wingwang.xit to dorinfo1.def)
  231. RADPLUS      ... RADPLUS
  232.  
  233. Sample dorinfo1.def...
  234.  
  235. The Lighthouse BBS      ;Systems name
  236. HARVEY                  ;SysOps first name
  237. PARISIEN                ;SysOps last name
  238. COM1                    ;Current port
  239.  
  240.                                                                           Page 3
  241.                                                RAD Plus - Remote Access Database
  242.  
  243. 2400 BAUD,N,8,1         ;Current connection information
  244. 0
  245. JOHN                    ;User's first name
  246. SMITH                   ;User's last name
  247. KINGSTON, ON            ;User's address
  248. 1                       ;ANSI on/off flag
  249. 20                      ;User's SECURITY LEVEL
  250. 59                      ;User's MAX TIME ALLOWED (balance of time from recent
  251.                                                   BBS activities)
  252.  
  253. The next fields MIN_TIME and MAX_TIME are online time limits, and are in
  254. minutes.  If you enter information here, it overrides dorinfo1.def (can be used
  255. for systems that don't produce proper dorinfo1.def's to limit access time).  IE,
  256. if your user has 90 minutes left online and your MAX_TIME is set to 10, then
  257. he/she will have 10 minutes in RAD only.  It is recommended that you set
  258. MIN_TIME to 0 if it is your intention to NOT allow further access once a users
  259. time has run out.
  260.  
  261. Your COM_PORT must be described as COM1, COM2, COM3, or COM4.
  262.  
  263. Your MAX_BAUD can range from 300 baud to 115200 baud.
  264.  
  265. The USE_SCREEN field is a logical setting of T or F (true or false).  If you set
  266. this to F then the screen will remain BLANK during RAD operations.  This may be
  267. desirable for multitasking situations.  Normally this would be T.  It is
  268. possible for the SysOp while the user is online to turn the screen ON or OFF by
  269. pressing F2 (snoop) on the HOST system.  It is also possible for a user with the
  270. maximum level 4 setting to turn the screen on or off remotely.
  271.  
  272.                                    RADDIR.CFG
  273.  
  274.  
  275. Record:  1  of  8
  276.  
  277. FILE       :RADCFG.DBF  :
  278. SUBJECT    :RAD Main Configuration File             :
  279. DISPLAY_ON :T:
  280. USER_NOTES :SYSOP                                             :
  281. DISPLAY1   :Keep this file marked private                          :
  282. DISPLAY2   :                                                       :
  283. DISPLAY3   :This file contains your setup and default information. :
  284. DISPLAY4   :                                                       :
  285. DISPLAY5   :Use DB3ED (DB.EXE) or RAD to edit this file.           :
  286. DISPLAY6   :                                                       :
  287. DISPLAY7   :NOTE:  Leave the field DOOR_PATH blank if you will be  :
  288. DISPLAY8   :       using RAD offline only!                         :
  289. PASSWORD   :YOURPASSWORD    :
  290. MIN_LEVEL  :4:
  291.  
  292. This database file contains the FILE name and SUBJECT line for each file that is
  293. to be displayed by a DIR command online.  If a *.dbf file exists and is not
  294. recorded in the RADDIR file, it will show up in a DIR, but will have a ? for
  295. subject line and have no password or minimum level access requirement.  The
  296. third field DISPLAY_ON can be set to T or F.  It determines whether the Display1
  297. through to Display8 fields are displayed when the file is accessed with a DIR
  298. command.  Display1 to Display8 are not displayed when the file is accessed using
  299.  
  300.                                                                           Page 4
  301.                                                RAD Plus - Remote Access Database
  302.  
  303. a USE command.  See the next few screens which simulate the DIR and file
  304. selection screens.  USER_NOTES can be anything you like.  The person who lists
  305. the file usually puts his/her John/Martha Henry here.  PASSWORD is your 16
  306. character password required for this file.  You don't need a password for the
  307. MIN_LEVEL system to work.  The MIN_LEVEL is an absolute minimum access level
  308. required to even have the ability to enter a password.  The TWO levels of
  309. security for each database file should cover most situations.  MAKE SURE YOUR
  310. RADCFG.DBF AND RADDIR.DBF FILES ARE BOTH PASSWORDED AND SET TO 4 AS THE
  311. MIN_LEVEL.  If you do not want to allow online editing of these two files by a
  312. remote SysOp who has level4 access, then set the MIN_LEVEL to 5 so they can't be
  313. accessed at all.
  314.  
  315. Here is a DIR simulation from the dot prompt...
  316.  
  317. .dir
  318.  
  319. RAD v2.09 - Remote Access Database - Copyright (C) 1990 Overerx Inc.
  320.  
  321.   # Filename      Records  Updated   Subject
  322.   1 BBSLIST.DBF      1280  11/04/90  A list of BBS's with >= 100megs online
  323.   2 DB.DBF              3  11/04/90  A list of contacts for local services...
  324.   3 IDEAS.DBF           1  11/04/90  Ideas for RAD databases ...
  325.   4 SUPPORT.DBF        68  11/04/90  Computer related product support lines
  326.  
  327.   Enter # _
  328.  
  329. NOTE: RADCFG.DBF and RADDIR.DBF will not be displayed in a Directory.
  330.  
  331. When you enter RAD, you are presented with a pretty nifty title page (free ad
  332. for me), and then displayed your current stats like the following session
  333. simulation.
  334.  
  335.  
  336. RAD v2.09 - Remote Access Database - Copyright (C) 1990 Overerx Inc.
  337.  
  338. 11/05/90  9:48a
  339.  
  340. Registered to.......... The Lighthouse BBS
  341. System Operator........ Harvey Parisien
  342. User................... HARVEY PARISIEN
  343. User level............  4
  344. Balance online time...  19 minutes
  345.  
  346. Hello HARVEY ...
  347.  
  348. CHOICE: Help Dir Find Browse N]ext Prev Goto List Info Add Edit Cmd Quit _
  349.  
  350.  
  351. Rad starts up in MENU mode.  If the user has ansi.sys installed, they will be
  352. displayed a lotus like menu bar which has a description of each function in the
  353. menu bar itself.  For non ansi users, the basic menu bar shown above is used.
  354. Alternatively, you can choose command mode, which gives you a DOT prompt like
  355. dBASE.  In command mode you have the following commands, which can be displayed
  356. anytime by entering the command HELP.
  357.  
  358.  
  359.  
  360.                                                                           Page 5
  361.                                                RAD Plus - Remote Access Database
  362.  
  363. .HELP
  364.  
  365. Command:         Function:                                            Level:
  366. /                Invoke command MENU option.                               1
  367. HELP             (or ?) Display this screen                                1
  368. INFO             Display system and user information                       1
  369. CLS              Clears Screen and Resets FIND search to ALL               1
  370. DIR              Displays directory of *.DBF files                         1
  371. USE filename.dbf USE or LOAD database (.dbf not required)                  1
  372. LIST STRUCTURE   List the file structure for the current database          1
  373. FIND text        FIND and display record matching text                     1
  374. BROWSE text      FIND and list records (max fields that fit on one line)   1
  375. NEXT             FIND and display NEXT record (or just press ENTER)        1
  376. PREV             More to previous record                                   1
  377. GOTO n           where n is the record number (also GOTO FIRST or LAST)    1
  378. COUNT            FIND and COUNT occurrences of FIND                        1
  379. SUM fieldnumber  Add contents of a field and display total                 1
  380. ADD              ADD (or append) a new record                              2
  381. EDIT n           n is an optional record number (default = current record) 2
  382. DELETE n         n is an optional record number (default = current record) 2
  383. CREATE           Closes current file, and prompts for creation details     3
  384. PACK             Pack current database (removes deleted files)             3
  385. SORT fieldnumber SORT database on a field (will prompt for fieldnumber)    3
  386. QUIT             Exit program (closes all files)                           1
  387. .
  388.  
  389.  
  390. The online commands will be very intuitive to dBASE users and non dBASE users
  391. alike.  The screens and prompts should provide adequate information for the
  392. typical user online.
  393.  
  394.  
  395.                                  SYSOP FUNCTIONS
  396.  
  397. USER: Joe Blow                PARAM: COM1:2400,N,8,1,RB1024,XON       LEVEL:  3
  398. 1 CHAT |2 SNOOP|3      |4      |5      |6 JUMP |7      |8      |9 LEVEL|10 HANG
  399.  
  400. The last two lines on your HOST screen remain in position at all times.  They
  401. constantly display the Users name, and current communications data.  It shows
  402. the users level which can be toggled with F9.  OK, let's continue from right to
  403. left just to be different.  F10 causes an immediate hang up to which the user is
  404. given no indication or warning as to what happened.  F6 allows the host to jump
  405. to DOS.  F2 allows the HOST to toggle the HOST screen on/off.  F1 allows the
  406. host to enter into CHAT mode, where both host and user can chat to each other
  407. with their keyboards.  By the way, when a users time online gets to be 2 minutes
  408. or less, he/she is given a warning to that effect (even if in chat mode).  They
  409. can always enter INFO to see their current status.
  410.  
  411.  
  412.          Operating RAD Plus from the command line, or a parent program.
  413.  
  414. RADPLUS /Pdrive:fullpath
  415.  
  416. IE: from a DOS prompt...   D:\>c:\dbase\radplus /Pc:\dbase
  417.  
  418. drive:path is where RADPLUS.EXE RADDIR.DBF RADCFG.DIR AND *.DBF files are kept.
  419.  
  420.                                                                           Page 6
  421.                                                RAD Plus - Remote Access Database
  422.  
  423.  
  424. If no path is given the current directory is assumed.
  425.  
  426. IE: QuickBBS type 7 command line:  c:\rad\radplus.exe /Pc:\rad
  427.  
  428. IE: Maximus control lines for menus.ctl ...
  429.   NoDsp Display_File    misc\dorinfo                        Privil "Radplus"
  430.           Xtern_Run     C:\max\rad\radplus.exe_/pC:\max\rad Privil "Radplus"
  431.  
  432. It is important that if /P is used, that the path is complete with drive spec
  433. as in these examples.
  434.  
  435. If you are operating RAD locally (ie from your BBS in local mode) it will
  436. sense there is no carrier so it requires you to press L to enter locally or
  437. it exits back to the board automatically.  RAD has a built in carrier detect
  438. system.  If carrier is dropped while a user is in RAD (or on their way to rad),
  439. it gracefully exits back to your board and let's your board do it's own thing.
  440.  
  441.  
  442.  
  443.                                   MISC FEATURES
  444.  
  445. LOCK_EDIT
  446.  
  447. If the first field name in a database is called LOCK_EDIT, then the record will
  448. will automatically be restricted in terms of a users ability to edit it.  When a
  449. record is added, the current users name is automatically inserted into the
  450. LOCK_EDIT field.  This field can not be changed (except by the SysOp Level4).
  451. To Edit the record, you must be the user, or have level4 access.
  452.  
  453. AUTOEXEC.RAD
  454.  
  455. If a file called Autoexec.RAD exists in the Rad directory, RAD will look in tha
  456. file on the first line for a filename.  If it's a legal name IE: XXXXXXXX.DBF it
  457. will automatically be loaded.
  458.  
  459.  
  460.  
  461.                                     * * * * *
  462.  
  463. This program is shareware.  It may be used for a 20 day trial period, and then
  464. must be registered.
  465.  
  466.  
  467.                                   REGISTRATION
  468.  
  469.  
  470. RADCFG requires a unique KEY to be entered in the key field.  By providing us
  471. with your SYSOP_NAME and SYSTEMNAME field information from RADCFG, we can create
  472. the key.  Once you enter the key, you can't change SYSOP_NAME or SYSTEMNAME
  473. afterwards, or the key will not work.  This is our only protection.  There are
  474. not timers, or other sneaky methods implemented in your program.  RAD is fully
  475. functional.  To register, please fill out the REGISTER.TXT application.  You can
  476. load it into your word processor and edit it, or copy it to your printer and do
  477. it by hand (COPY REGISTER.TXT PRN).  Send it to Overerx Inc.  (address is
  478. contained in register.txt and also above).  (I would prefer that you also
  479.  
  480.                                                                           Page 7
  481.                                                RAD Plus - Remote Access Database
  482.  
  483. enclose a simple screen dump of your RADCFG file showing me the exact SYSOP_NAME
  484. and SYSTEMNAME entries for key creation)
  485.  
  486. When you receive your REGISTRATION KEY, enter it in the KEY field of RADCFG.
  487. RAD will then be registered and legally yours.  In addition, you will be able to
  488. use future updates of RAD Plus using the same REGISTRATION KEY.  So when you
  489. register once, you never pay again.
  490.  
  491.  
  492.                              Registration is $75.00.
  493.  
  494.           Non Commercial BBS SysOps may register RAD Plus for $ 25.00.
  495.  
  496.  
  497.                         CUSTOM APPLICATIONS AVAILABLE !!!
  498.  
  499.  
  500.  
  501.  
  502.                                    LEGAL STUFF
  503.  
  504. DISCLAIMER - This program is provided as is.  You may use it at your own risk.
  505. There is no warranty of any kind or any form covering this program.  The author
  506. may in no way be held liable for any damage of any form in connection or arising
  507. from the quality and/or use of this program and any associated files included
  508. with it.
  509.  
  510.  
  511.  
  512.      Please feel free to contact me via NETMAIL anytime for instant support.
  513.  
  514.  
  515.                        Harvey Parisien, FidoNet 1:249/114
  516.                 Box 323 Sta A, Kingston, Ontario, Canada K7M 6R2
  517.                                 613-389-3992 BBS
  518.  
  519.  
  520.                  ** YOUR FEEDBACK, AND SUPPORT IS APPRECIATED **
  521.  
  522.  
  523. Acknowledgments:
  524.  
  525. There are many people who have helped me in the development of RAD.  First I
  526. must say thanks to all the users who have contributed in different ways over the
  527. years.
  528.  
  529. A special thanks goes out to two local SysOps who you may or may not know of,
  530. Mr. Don Laverdure of FidoNet 1:249/124, and Scott Dudley of FidoNet 1:249/106
  531. for their testing time, and thoughts.
  532.  
  533.  
  534.                                       * * *
  535.  
  536.  
  537.  
  538.  
  539.  
  540.                                                                           Page 8
  541.