home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 October / PCO1097.ISO / FilesBBS / FREI / PB-DBV12.EXE / PB-DBV.DOC < prev    next >
Encoding:
Text File  |  1997-06-29  |  8.0 KB  |  214 lines
  1. ┌─────────────────────────────────────────────────────────────────────────────
  2. │  PB-DBV 1.2                                 written by Peter van der Linde
  3. └─────────────────────────────────────────────────────────────────────────────
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.        A dBase3/4 compatible *.dbf-Viewer/Editor for ProBoard BBS 2.1x
  13.                             Freeware version 1.2 
  14.         copyright(c)1996,97  Peter van der Linde, all rights reserved
  15.                     2:285/305.9 - pvdl@aoxomox.xs4all.nl
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  FEATURES:
  26.  PB-DBV is a VIEWER/EDITOR PEX that gives ProBoard-users access to 
  27.  *.DBF files produced by dBase3/4 or compatible database programs.
  28.  Users can browse, list, search, and optionally, add, edit or delete
  29.  records. 
  30.  User search-activities can be logged..
  31.  PB-DBV scans user-settings for the correct screenlength.
  32.  
  33.  LIMITATIONS:
  34.  index files are not supported, memo-fields will not be visible 
  35.  Max. 128 fields 
  36.  No maintainance yet.. (sorting, deleting, creating of *.dbf files),
  37.  PB-DBV is a *.dbf viewer/editor only. 
  38.  It is recommended to use dBase 3 or higher for maintainance.
  39.  
  40.  CHANGES:
  41.  1.2 + Dates from year 1000 to 9999),
  42.  
  43.      + Added backward scrolling for most commands.
  44.  
  45.      - Corrected many bugs and cut off some 'fat'.
  46.  
  47.  1.1 + Users can interrupt the searchroutine now..
  48.  
  49.  
  50.  INSTALLATION.
  51.  In the menu-editor use function 60 to install PB-DBV.PEX
  52.  
  53.  Syntax: pb-dbv <path>filename<.dbf> [add] [edit] [del] [log]
  54.                                                                                 
  55.  ╔════════════════════════════════════════════════════════════════════════════╗
  56.  ║ 0        1         2         3         4         5         6         7     ║
  57.  ║ 12345678901234567890123456789012345678901234567890123456789012345678901234 ║
  58.  ║ ;░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ║
  59.  ║                                                                            ║
  60.  ║ Hotkey   : 0                                                               ║
  61.  ║ Function : 60 - Run ProBoard SDK File                                      ║
  62.  ║ Data     : pb-dbv c:\dbase\dbf\sell.dbf                                    ║
  63.  ║                                                                            ║
  64.  ║ Min.Level: 25                                                              ║
  65.  ║ Flags    : --------------------------------                                ║
  66.  ║                                                                            ║
  67.  ╚════════════════════════════════════════════════════════════════════════════╝
  68.  
  69.  Above example shows how to allow the user searching and browsing through
  70.  'sell.dbf'.
  71.  
  72.  
  73.  
  74. SECURITY.
  75.  
  76.  Adding records allowed:
  77.           pb-dbv c:\dbase\dbf\sell.dbf add
  78.  
  79.  Adding and editing allowed:
  80.           pb-dbv c:\dbase\dbf\sell.dbf add edit
  81.  
  82.  Deleting (,adding and editing) allowed:
  83.           pb-dbv c:\dbase\dbf\sell.dbf del
  84.  
  85.  When the Delete option is activated, the user can also add and edit
  86.  records. If a user is allowed to delete records it's obvious to allow 
  87.  him/her the 'ADD' and 'EDIT' functions too.. (?)
  88.  
  89.  ProBoard Level and Flags can further securely decide which users or levels 
  90.  are allowed to use the add/edit/delete options..
  91.  Only if activated the add, edit or delete-option will be visible in
  92.  the menu as to spare users a frustrating "not allowed to..." message. 
  93.  
  94.  PB-DBV logs its activities to PROBOARD.LOG
  95.  The search actions of users can also written to PROBOARD.LOG when
  96.  activated by adding the 'f' switch:
  97.           pb-dbv c:\dbase\dbf\sell.dbf log
  98.  
  99.  
  100.  
  101.  Commands    Description
  102. ──────────────────────────────────────────────────────────────────────────────  
  103.  [N]ext      (or +) goto next record                                            
  104.  [P]revious  (or -) goto previous record                                        
  105.  [L]ist      list records (FROM number or from current recordnumber)            
  106.  [T]op       goto first record                                                  
  107.  [B]ottom    goto last record                                                   
  108.  [G]oto      goto recordnumber                                                  
  109.  [F]ind      find 'searchstring' (case sensitive!)                              
  110.  [I]nfo      information about the currently opened DBF file                    
  111.  [S]tructure list fieldstructure of the currently opened DBF file               
  112.  [A]dd       add a record                                                       
  113.  [E]dit      edit current record                                                
  114.  [D]elete    (un)mark current record for Deletion                               
  115.  [M]         toggle menubar                                                     
  116.  e[X]it      stop the program                                                   
  117.  >           waiting for command
  118.  --          end of record                                                      
  119.  -EOF-       end of database, last record                                       
  120.                                                                                 
  121.  
  122.  
  123. NOTE.
  124.  
  125.  Records will only be marked to be deleted. Packing and sorting records
  126.  will have to be done by dBase3/4 or any other program which can do
  127.  maintainance on *.DBF files.
  128.  
  129.  
  130.  
  131. MAINTAINANCE EXAMPLE WITH dBASE3/4.
  132.  
  133.  An example for Packing Records with dBase3/4 using a backup-file
  134.  (k_sell.dbf) for deleted records:
  135.  
  136.   - Copy the filestructure of sell.dbf to k_sell.dbf
  137.   - Create textfile 'k_sell.prg':
  138.  
  139.  use sell.dbf
  140.  set deleted off
  141.  copy all for deleted() to tempfile
  142.  pack
  143.  use k_sell.dbf
  144.  append from tempfile
  145.  close databases
  146.  erase tempfile.dbf
  147.  quit
  148.  
  149.  In the nightly maintainance-event the (marked to be) deleted records
  150.  will be removed from sell.dbf and copied to k_sell.dbf.
  151.  In the bbsbatch-file:
  152.  
  153.    <path> dbase k_sell.prg
  154.  
  155.  dBase will wait 10 seconds for a keypress and then start executing 
  156.  k_sell.prg. After (dbase) k_sell.prg is finished, it returns control 
  157.  to the maintainance batch-file.
  158.  Deleted and packed records can always be recovered this way depending
  159.  on how long the backup-file (k_sell.dbf) will be kept.
  160.  (In the included sell.dbf example 1 record is marked for deletion and 
  161.   will be deleted and moved to k_sell.dbf using dbase3/4 and k_sell.prg)
  162.  
  163.  
  164. DISCLAIMER.
  165.  
  166.  This program is provided as is.  You may use it at your own risk.
  167.  There is no warranty of any kind or any form covering this program.
  168.  Although this software has been tested thoroughly and prior to release,
  169.  there is NO guarantee it is 100% error or bug free. The author of PB-DBV
  170.  will not be held responsible for any damage done to your software/hardware
  171.  in any case.
  172.  
  173.  
  174. REGISTRATION.
  175.  
  176.  PB-DBV 1.2 is a FreeWare version and you may use and distribute it freely!
  177.  But the writing of almost 3000 lines of code takes a lot of time..
  178.  If, after a trial period of say maximum 180 days, you (and your users)
  179.  still like and use this program, you are encouraged to register PB-DBV.
  180.  That would really motivate and stimulate a programmer to keep him supporting 
  181.  and improving his software..
  182.  There are NO 'please register' messages or delays built into this version
  183.  of PB-DBV.
  184.  
  185.  Registered users will be supported and notified by netmail or email of 
  186.  bugfixes and/or updates. Their suggestions will be taken seriously!
  187.  
  188.  To receive a registrationform, send a netmail to:
  189.           Peter van der Linde at 2:285/305.9  Subject: pb-dbv.reg
  190.  
  191.  or mailto: fileserver@aoxomox.xs4all.nl
  192.  in the messagebody:
  193.           get proboard/pb-dbv.reg
  194.  
  195.  
  196.  PB-DBV 1.2 can be file-requested via internet by sending an email to:
  197.           fileserver@aoxomox.xs4all.nl
  198.  in the messagebody:
  199.           get proboard/pb-dbv12.zip uue
  200.  or
  201.           get proboard/pb-dbv12.zip mime
  202.  
  203.  PB-DBV 1.2 will then be sent to you MIME or UUEncoded.
  204.  
  205.  If you have any problems or remarks, please report them to:
  206.           pvdl@aoxomox.xs4all.nl
  207.           or to: Peter van der Linde at 2:285/305.9
  208.  
  209.  
  210.  
  211. Thank you for reading this far ;-)
  212. regards,
  213. Peter.
  214.