home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / BBSEE20B.ZIP / BBSEE.DOC < prev    next >
Text File  |  1992-05-31  |  127KB  |  3,137 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.         ░░░░░░░░░░░   ░░░░░░░░░░░    ░░░░░░░░░░  ░░░░░░░░░░░   ░░░░░░░░░░░
  10.         ░░        ░░  ░░        ░░  ░░           ░░            ░░
  11.         ░░        ░░  ░░        ░░  ░░           ░░            ░░
  12.         ░░░░░░░░░░    ░░░░░░░░░░     ░░░░░░░░░░  ░░░░░░░░░░    ░░░░░░░░░░░
  13.         ░░        ░░  ░░        ░░            ░░ ░░            ░░
  14.         ░░        ░░  ░░        ░░            ░░ ░░            ░░
  15.         ░░░░░░░░░░░   ░░░░░░░░░░░    ░░░░░░░░░░  ░░░░░░░░░░░   ░░░░░░░░░░░
  16.  
  17.  
  18.  
  19.         BBSee 2.0 User's Manual And Reference
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.         Copyright (C) 1991,1992  Martin Vallevand
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.         Table of Contents
  36.  
  37.         Chapter 1 General Information . . . . . . . . . . . . . . . . . .    1
  38.              1.1  What does BBSee do? . . . . . . . . . . . . . . . . . .    1
  39.              1.2  License . . . . . . . . . . . . . . . . . . . . . . . .    1
  40.              1.3  BBSee Files.  . . . . . . . . . . . . . . . . . . . . .    2
  41.              1.4  On-Line Help  . . . . . . . . . . . . . . . . . . . . .    3
  42.              1.5  System requirements . . . . . . . . . . . . . . . . . .    3
  43.              1.6  Background  . . . . . . . . . . . . . . . . . . . . . .    4
  44.              1.7  Credits . . . . . . . . . . . . . . . . . . . . . . . .    5
  45.  
  46.         Chapter 2 Configuration . . . . . . . . . . . . . . . . . . . . .    6
  47.              2.1  BBSEE.CFG . . . . . . . . . . . . . . . . . . . . . . .    6
  48.              2.2  Database Filenames  . . . . . . . . . . . . . . . . . .    7
  49.              2.3  General directory and files . . . . . . . . . . . . . .    8
  50.              2.4  Tag Files Facility. . . . . . . . . . . . . . . . . . .    9
  51.              2.5  Output Directory files  . . . . . . . . . . . . . . . .    9
  52.              2.6  Single word exclusions, . . . . . . . . . . . . . . . .   11
  53.              2.7  Source / BBS Board Selection  . . . . . . . . . . . . .   11
  54.              2.8  Area/Conference Support.    . . . . . . . . . . . . . .   13
  55.  
  56.         2.9  Catalog Configuration  . . . . . . . . . . . . . . . . . . .   13
  57.              2.10 Fill Configuration  . . . . . . . . . . . . . . . . . .   14
  58.              2.11 Function Keys . . . . . . . . . . . . . . . . . . . . .   14
  59.              2.12 Volume Templates  . . . . . . . . . . . . . . . . . . .   15
  60.              2.13 Analyze Directory . . . . . . . . . . . . . . . . . . .   15
  61.              2.14 Hardware Installation . . . . . . . . . . . . . . . . .   15
  62.                   2.14.1 Video Installation . . . . . . . . . . . . . . .   15
  63.                   2.14.2 EMS Support. . . . . . . . . . . . . . . . . . .   16
  64.                   2.14.3 Mouse Support. . . . . . . . . . . . . . . . . .   17
  65.                   2.14.4 Sound  . . . . . . . . . . . . . . . . . . . . .   17
  66.              2.15 Miscellaneous . . . . . . . . . . . . . . . . . . . . .   17
  67.              2.16 Print Order Form. . . . . . . . . . . . . . . . . . . .   17
  68.  
  69.         Chapter 3 File Function . . . . . . . . . . . . . . . . . . . . .   18
  70.              3.1  File importation  . . . . . . . . . . . . . . . . . . .   18
  71.              3.2  File Duplication  . . . . . . . . . . . . . . . . . . .   20
  72.              3.3  Uncompress and Import NEWFILES.DAT  . . . . . . . . . .   20
  73.              3.4  Modify Import Options . . . . . . . . . . . . . . . . .   21
  74.              3.5  Create Record . . . . . . . . . . . . . . . . . . . . .   21
  75.              3.6  File Manager  . . . . . . . . . . . . . . . . . . . . .   21
  76.                   3.6.1 List file . . . . . . . . . . . . . . . . . . . .   22
  77.              3.7  Floppy Directory  . . . . . . . . . . . . . . . . . . .   23
  78.              3.8  BBSee Shell . . . . . . . . . . . . . . . . . . . . . .   23
  79.              3.9  DOS Shell . . . . . . . . . . . . . . . . . . . . . . .   23
  80.  
  81.         Chapter 4 Search Function . . . . . . . . . . . . . . . . . . . .   24
  82.              4.1  Word Search . . . . . . . . . . . . . . . . . . . . . .   24
  83.              4.2  Filename Search . . . . . . . . . . . . . . . . . . . .   24
  84.              4.3  Output Search List  . . . . . . . . . . . . . . . . . .   25
  85.              4.4  Show All/Show Catalog/Show Uncat'd  . . . . . . . . . .   25
  86.              4.5  Local BBS Searching . . . . . . . . . . . . . . . . . .   25
  87.  
  88.         Chapter 5 Catalog Function  . . . . . . . . . . . . . . . . . . .   26
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.              5.1  Catalog   . . . . . . . . . . . . . . . . . . . . . . .   26
  97.              5.2  Uncatalog   . . . . . . . . . . . . . . . . . . . . . .   26
  98.              5.3  Label floppy  . . . . . . . . . . . . . . . . . . . . .   27
  99.                   5.3.1 Label Templates . . . . . . . . . . . . . . . . .   27
  100.              5.4  Make Catalog File . . . . . . . . . . . . . . . . . . .   28
  101.              5.5  Fill  . . . . . . . . . . . . . . . . . . . . . . . . .   28
  102.              5.6  View Catalog  . . . . . . . . . . . . . . . . . . . . .   29
  103.              5.7  Show Catalog Files  . . . . . . . . . . . . . . . . . .   29
  104.              5.8  Show Archive Files  . . . . . . . . . . . . . . . . . .   29
  105.              5.9  Modify Options  . . . . . . . . . . . . . . . . . . . .   30
  106.              5.10 Catalog eXtract, Copy and View. . . . . . . . . . . . .   30
  107.                   5.10.1 eXtract  . . . . . . . . . . . . . . . . . . . .   30
  108.                   5.10.2 Copy File  . . . . . . . . . . . . . . . . . . .   30
  109.                   5.10.3 View File  . . . . . . . . . . . . . . . . . . .   30
  110.  
  111.         Chapter 6 Tag Function  . . . . . . . . . . . . . . . . . . . . .   31
  112.              6.1  Delete tagged file  . . . . . . . . . . . . . . . . . .   31
  113.              6.2  Create download file  . . . . . . . . . . . . . . . . .   31
  114.              6.3  Remove tags . . . . . . . . . . . . . . . . . . . . . .   31
  115.              6.4  Create upload files . . . . . . . . . . . . . . . . . .   31
  116.              6.5  Output tags to disk . . . . . . . . . . . . . . . . . .   32
  117.              6.6  View tags . . . . . . . . . . . . . . . . . . . . . . .   32
  118.              6.7  Edit Tags . . . . . . . . . . . . . . . . . . . . . . .   32
  119.              6.8  Load Tags . . . . . . . . . . . . . . . . . . . . . . .   32
  120.  
  121.         Chapter 7 Describe Function . . . . . . . . . . . . . . . . . . .   33
  122.              7.1  Input File List . . . . . . . . . . . . . . . . . . . .   33
  123.              7.2  4DOS Description. . . . . . . . . . . . . . . . . . . .   33
  124.              7.3  Describe Floppy . . . . . . . . . . . . . . . . . . . .   33
  125.              7.4  Cross Reference . . . . . . . . . . . . . . . . . . . .   33
  126.              7.5  Report Options  . . . . . . . . . . . . . . . . . . . .   34
  127.              7.6  Analyze directory . . . . . . . . . . . . . . . . . . .   34
  128.  
  129.         Chapter 8 Using the program . . . . . . . . . . . . . . . . . . .   35
  130.  
  131.         Chapter 9 Command line arguments  . . . . . . . . . . . . . . . .   36
  132.  
  133.         Appendix A     Registration Information . . . . . . . . . . . . .   38
  134.  
  135.         Appendix B     Program Return Codes . . . . . . . . . . . . . . .   40
  136.  
  137.         Appendix C     Cursor Movement and Editing Keys . . . . . . . . .   41
  138.  
  139.         Appendix D     Mouse Support. . . . . . . . . . . . . . . . . . .   42
  140.  
  141.         Appendix E     Import Usage . . . . . . . . . . . . . . . . . . .   44
  142.  
  143.         Appendix F     Database Packing . . . . . . . . . . . . . . . . .   46
  144.  
  145.         Appendix G     Deleted File List Maintenance  . . . . . . . . . .   47
  146.  
  147.         Appendix H     Robocomm download support. . . . . . . . . . . . .   49
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.                                   BBSee Version 2.0
  156.  
  157.         Chapter 1 General Information
  158.  
  159.         1.1  What does BBSee do?
  160.  
  161.         BBSee  is a  program designed  to help people  who accumulate  lots of
  162.         files, easily find the files they have access to, in their catalogs or
  163.         on BBS's or other source.  The heart of the program are two databases,
  164.         the  database  of the  filelists obtained  from  the BBS's  and online
  165.         services you use, and the database of your cataloged  floppies.  Using
  166.         these databases, BBSee will provides  various advanced options to help
  167.         manage these files.
  168.  
  169.         The principle functions in BBSee are;
  170.  
  171.              The file import function which allows you to bring file  list and
  172.              description  files into  the database  from most  popular BBS'es.
  173.              This database file  will normally be  smaller than your  original
  174.              BBS  list  and  can  be  configured  to  meet  personal  database
  175.              preferences.
  176.  
  177.              The fast and powerful search function which enables you to locate
  178.              files  from up  to 16  BBS lists,  and your  own floppies  in one
  179.              search.   This search can be an instantaneous filename search, or
  180.              a complex but quick multi-word search.
  181.  
  182.              The floppy  catalog function  with capabilities designed  to help
  183.              manage your files, with a minimum amount of time and effort.
  184.  
  185.              The fill floppy  function which provides  a method of  optimizing
  186.              floppy disk use.
  187.  
  188.              An interface to many automated BBS programs and scripts (eg. QMM,
  189.              Liberator,  CatCalls,  Telix   Square,  Intellicomm,  Boyan,  and
  190.              Robocomm),  allowing you to  tag files  for up/and  download, and
  191.              create the files required by these excellent programs.
  192.  
  193.  
  194.         1.2  License
  195.  
  196.              BBSee is  a  commercial package,  that  is being  distributed  as
  197.              shareware  for  evaluation purposes  only.   This  is  not public
  198.              domain,   or  free  software.    After  a  one  month  period  of
  199.              evaluation, if you decide not to purchase a registered version of
  200.              BBSee, you must delete all copies of BBSee, in uncompressed form,
  201.              that  you  have  in your  possession.    You  are permitted,  and
  202.              encouraged,  to  distribute  the  shareware  package  freely,  to
  203.              potential users and on-line BBS's,  as long as you do not  charge
  204.              for  this service, beyond the material  cost of distribution, and
  205.              you  provide a complete set  of programs as  specified in section
  206.              1.3 of this document.
  207.  
  208.                                         Page 1
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.                                   BBSee Version 2.0
  217.  
  218.              BBSee has been subject to  thorough testing, and every reasonable
  219.              effort has been made to make BBSee  a safe, fast, and easy to use
  220.              package.  However the  databases that BBSee makes, can  easily be
  221.              the largest databases  that many  people will ever  see on  their
  222.              computers.    With such  large systems,  there  are many  ways to
  223.              corrupt  the  database,  including   rebooting  the  computer  or
  224.              powering down during use of BBSee, so care is advised. 
  225.  
  226.              Also,  it  is  impossible  to  test  this  program  on  the  many
  227.              combinations of  computer software and hardware  available in the
  228.              PC  marketplace,  and  to   anticipate  all  uses  for  software.
  229.              Therefore  all copies of BBSee, and  any program distributed with
  230.              the  package, shareware, or registered,  are purchased AS IS, and
  231.              Martin  Vallevand will not be held responsible for any damage, to
  232.              your computer, programs, data, or  anything else for that matter,
  233.              that  may result from its use.  By  using BBSee you consent to do
  234.              so at your own risk.  If you find that this is unsatisfactory, DO
  235.              NOT run BBSee.
  236.  
  237.              See Appendix A for further information on registering BBSee.
  238.  
  239.         1.3  BBSee Files.
  240.  
  241.              Files on the 'Program' archive #1            BBSEE20A.ZIP
  242.              BBSEE.EXE      Program File
  243.              BBSETUP.EXE    Modifies BBSEE.CFG
  244.              README.2ND     Latest file information.
  245.              QUICKST.ART    Start using BBSee now.
  246.              BBSEE.HLP      On-Line Help File
  247.              FILE_ID.DIZ    Description File
  248.  
  249.              Files on the 'Program' archive #2            BBSEE20B.ZIP
  250.              BBSEE.DOC      Documentation
  251.              IMPORT.EXE     General BBS file listing conversion utility.
  252.              2ROBO.EXE      Interface to Robocomm.
  253.              WHATS.NEW      Information on new features in this release.
  254.              HISTORY        Revision history for BBSee.
  255.              SAMPLE         A file for use as a test import.
  256.              REGISTER.FRM   Form used to register BBSee.
  257.              GO.BAT         The first thing most people do.
  258.              BBSEE1.ICO     Microsoft Windows Icon
  259.              BBSEE2.ICO     "         "         "
  260.              FILE_ID.DIZ    Description File
  261.  
  262.              These two archive files  make up the files required  for standard
  263.              distribution of the BBSee program.
  264.  
  265.  
  266.  
  267.  
  268.  
  269.                                         Page 2
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.                                   BBSee Version 2.0
  278.  
  279.              Files on the 'Extras' archive                BBSEE20X.ZIP
  280.  
  281.              READDEL.EXE    Delete file reader.
  282.              WRITEDEL.EXE   Delete file writer.
  283.              PACBBSEE.EXE   Database 'pack' utility.
  284.              REBOBBS.EXE    Utility to re-structure the BBS information.
  285.              BBC2PCB.EXE    Utility  to  create  a  PCBoard-like  list  of the
  286.                             entire master database.
  287.              4DLS.EXE       Utility to  create a file  which could be  used by
  288.                             the program DLS.EXE to print  labels for cataloged
  289.                             floppies.
  290.              FILE_ID.DIZ    Description File
  291.  
  292.              The files in the extras archives are not  essential to run BBSee,
  293.              but they certainly will  make its use more versatile.   Depending
  294.              on file import needs  other utilities may be added  to this list.
  295.              Check the README file for the latest information.
  296.  
  297.              Files in the 'Conversion' archive            BBSEE20C.ZIP
  298.  
  299.              CDSKCON.EXE    Conversion from CatDisk to BBSee catalog format.
  300.              ICATCON.EXE    Conversion   from   Intelicat  to   BBSee  catalog
  301.                             format.
  302.              CONVERT.EXE    Conversion from BBSee version 1.0 to version 2.0.
  303.              FILE_ID.DIZ    Description File
  304.  
  305.              These are  various files used  to convert catalog  databases from
  306.              other programs to BBSee 2.0 format.
  307.  
  308.         1.4  On-Line Help
  309.  
  310.              The  file  BBSEE.HLP provides  on-line help  for  BBSee.   To run
  311.              properly BBSEE.HLP should be located  in the same subdirectory as
  312.              BBSEE.EXE.   This will allow BBSee  to run from a  path and still
  313.              access the help file.  BBSee will run without the  help file, but
  314.              it  will display  an  error message  when  the help  function  is
  315.              called.
  316.  
  317.              Online  help  is  not meant  as  a  substitute  for reading  this
  318.              documentation,  but  as a  quick  reference  to  most of  BBSee's
  319.              functions.  The help is available by  pressing <F1> from any menu
  320.              or sub-menu option.
  321.  
  322.         1.5  System requirements
  323.  
  324.              100% IBM compatible computer.
  325.              MS-DOS 3.30 or higher. (lower versions were not tested)
  326.              A minimum 480K free RAM, or 420K and use of 100K of EMS.
  327.              12 file handles and open DOS files (from CONFIG.SYS).  
  328.              You must have a line of FILES=20 or more in your CONFIG.SYS file.
  329.  
  330.                                         Page 3
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.                                   BBSee Version 2.0
  339.  
  340.              Hard disk strongly recommended.
  341.  
  342.              BBSee will use as much disk space as you would like  to devote to
  343.              BBS  file listings. The faster the disk transfer rate the better.
  344.              The  addition  of  disk caching,  even  as  small  as 128K,  will
  345.              significantly improve performance.
  346.  
  347.         1.6  Background
  348.  
  349.              This program is written  in the large  model of Borland C++  2.0,
  350.              CXL 5.2 and the MIX C/database toolchest.  I believe these to all
  351.              be excellent, inexpensive, packages although the database package
  352.              can be slow on adding records to a large database.  A fast string
  353.              search  algorithm, the  Boyer-Moore  algorithm, is  used to  find
  354.              words.  To me this is to  brute force searching, what qsort is to
  355.              a bubble  sort.  Most of the  overhead is in the  disk read.  CXL
  356.              has  been superseded  by TCXL  however I  found too many  bugs in
  357.              version  5.51  to use  it,  and  have  not  yet tried  the  later
  358.              versions.
  359.  
  360.              BBSee and  BBSetup have been  compressed with LZEXE,  and further
  361.              processed  to  disable UNLZEXEing  as  a  very  limited means  of
  362.              protecting the programs from  alteration.  The registered version
  363.              can be ordered in  uncompressed format if you specify this on the
  364.              order form.
  365.  
  366.              All the file writes  in the BBSee program use  standard Borland C
  367.              calls, with  the exception  of the  routines that  manipulate the
  368.              label  on the floppy, which use extended FCBs and DOS interrupts.
  369.              Other than directly writing  to the floppy disk sectors,  I don't
  370.              believe there  is another method  to write the  volume label.   I
  371.              have  read, that  everyone should  use the  DOS label  program to
  372.              label diskettes,  for technical  reasons, so  I will  mirror that
  373.              recommendation.
  374.  
  375.              Regardless  of whether you use BBSee or not, I strongly recommend
  376.              that all users of DOS 4.0, always run the DOS  SHARE.EXE command,
  377.              to protect themselves from deficiencies in  the FCB structures in
  378.              their version  of DOS.   As  well, if  your  drives support  disk
  379.              change indication,  you will  be provided with  better protection
  380.              for your valuable  archive floppy disks.   Upgrading to DOS 5  is
  381.              highly recommended.
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.                                         Page 4
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.                                   BBSee Version 2.0
  400.  
  401.         1.7  Credits
  402.  
  403.              I  would like to  thank the following people  for assisting me in
  404.              the development of this software.  The diligent work of this team
  405.              of beta  testers and proof readers  has helped me so  much, and I
  406.              believe  their   many  suggestions  have  greatly   enhanced  the
  407.              functionality of BBSee.
  408.  
  409.              Bernard "The Exterminator" Desruisseaux  for finding bugs big and
  410.              small, and for providing many good (and sound) ideas.
  411.  
  412.              Paul "The  Cosmetician" Loshuk for keeping  the documentation and
  413.              help clean, and for prompting me  to take BBSee beyond the simple
  414.              program I first intended.
  415.  
  416.              John  Zaharychuk for  providing good ideas,  'different' hardware
  417.              platforms and putting up with 2400 baud file transfers.
  418.  
  419.              Daniel  Verreault for  having the  knack of  identifying database
  420.              problems.   Also  his help  with help  and the  documentation for
  421.              version 2.0 are appreciated.
  422.  
  423.              Michel Tordion,  Phil Lachance,  Gordon  Haff, Tony  Dibenedetto,
  424.              John Lindeyer, Dominique Plante, Dan  Wood, Serge Cote and others
  425.              for taking the time to help with the beta testing.
  426.  
  427.              All the people who have registered so far, they propel me to keep
  428.              on.
  429.  
  430.              Angela Tweeddale for putting up with me through all of this
  431.  
  432.              Daniel Coulombe for allowing SYNAPSE to be used as the basis  for
  433.              the beta testing, and the 'home' of BBSee.
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.                                         Page 5
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.                                   BBSee Version 2.0
  461.  
  462.         Chapter 2 Configuration
  463.  
  464.         Because of the many  options available in BBSee, the  most complicated
  465.         aspect of  using BBSee, is  in configuring  it to your  needs.   BBSee
  466.         needs  to know the location of many  files and programs, if you intend
  467.         to use  all its options.   If you  don't install BBSee  correctly then
  468.         these options may not function properly, and/or BBSee may exit with an
  469.         error code.   Also BBSee will  overwrite certain  files if they  exist
  470.         (although  BBSee's  'filenames' should  not  conflict  with files  you
  471.         have), so some care should be used in reviewing default filenames.
  472.  
  473.         BBSee  configuration  is  performed  in a  program,  BBSETUP.EXE  that
  474.         handles all  aspects of  BBSee configuration.   Although this  program
  475.         MUST  be run initially, it also can  be used to reconfigure options at
  476.         any time.   As  you become proficient  in the use  of BBSee,  you will
  477.         probably  go into  BBSetup, many  times, to  change the  inclusion and
  478.         exclusion word lists, and to fine-tune things to your liking.
  479.  
  480.         Note as a general rule whenever user input is required in BBSEE.EXE or
  481.         BBSETUP.EXE, selecting <Esc> will cancel the  operation, <F1> will get
  482.         help (in  BBSee), <Enter> will select  the option or move  to the next
  483.         option and  <Ctrl Enter> will process  an entire set of  choices.  See
  484.         Appendix C for further information.
  485.  
  486.  
  487.         2.1  BBSEE.CFG
  488.  
  489.              All configuration information is contained in the file BBSEE.CFG.
  490.              BBSee searches for the  file BBSEE.CFG in the  default directory,
  491.              and  if not  found  BBSee searches  in  the same  directory  that
  492.              BBSEE.EXE was run from. 
  493.          
  494.              If  BBSEE.CFG is  not found in  the above steps  BBSee will abort
  495.              indicating that BBSETUP.EXE must be run first.
  496.  
  497.              To  create  BBSEE.CFG  it   is  necessary  to  run  the   program
  498.              BBSETUP.EXE first.   Do not create this  file manually.  The rest
  499.              of this  section deals with using  this program.  You  can opt to
  500.              install  BBSee with  only default  information however  some more
  501.              advanced features will not be available, or work properly.
  502.  
  503.  
  504.              BBSetup.
  505.  
  506.              BBSetup  is a  DOS program  that runs  from the  DOS prompt.   It
  507.              creates  the  file described  above,  BBSEE.CFG,  in the  default
  508.              directory.  You can create  as many BBSEE.CFG files as you  wish.
  509.              The main purpose  for doing  this would be  to maintain  separate
  510.              database files, exclusion lists and floppy catalogs.
  511.  
  512.  
  513.                                         Page 6
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.                                   BBSee Version 2.0
  522.  
  523.              The main menu for BBSETUP.EXE is as follows:
  524.  
  525.                                 ╒═════ BBSee Configuration ═════╕
  526.                                 │ Database Filenames            │
  527.                                 │ General directories and files │
  528.                                 │ Output directory files        │
  529.                                 │ ───────────────────────────── │
  530.                                 │ Single word exclusions        │
  531.                                 │ Paired word exclusions        │
  532.                                 │ File Extension exclusions     │
  533.                                 │ Required words                │
  534.                                 │ BBS/Source names              │
  535.                                 │ Local BBS's                   │
  536.                                 │ Area/Conferences              │
  537.                                 │ ───────────────────────────── │
  538.                                 │ Catalog Options               │
  539.                                 │ Function Keys                 │
  540.                                 │ Volume Template               │
  541.                                 │ Analyze Directory             │
  542.                                 │ Hardware Installation         │
  543.                                 │ Miscellaneous                 │
  544.                                 │ Print Order Form              │
  545.                                 │ Quit                          │
  546.                                 ╘═══════════════════════════════╛
  547.  
  548.  
  549.         The directories and filenames for all files used by BBSee are outlined
  550.         in this section.  Note that  the sub-directory mentioned should be  of
  551.         the  form drive:\subdirectory with no trailing backslash.  If you must
  552.         use the root  directory, which I don't  recommend, DO NOT include  the
  553.         backslash.   These fields are  checked for the existence  of drives or
  554.         directories,  however you should ensure that they are correct.  PLEASE
  555.         BE CAREFUL.   Also note  that if you  re-organize your hard  disk, you
  556.         will have to make corresponding changes to BBSEE.CFG.
  557.  
  558.         2.2  Database Filenames
  559.  
  560.              The first  step in  configuration is  to  enter the  name of  the
  561.              master  database and the catalog  database.  The  reason that the
  562.              database  filenames are not fixed  is to allow  multiple BBS list
  563.              databases  and disk  catalogs,  in  separate sub-directories,  if
  564.              desired.  
  565.  
  566.              BBSee creates in total ten permanent database files,
  567.  
  568.              1.   the  master database  file  and  index,  (mastername.DB  and
  569.                   .IDX),
  570.              2.   the index of deleted files, ( mastername.DEL ),
  571.              3.   the catalog file and index, (catalogname.DB and .IDX),
  572.  
  573.  
  574.                                         Page 7
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.                                   BBSee Version 2.0
  583.  
  584.              4.   the catalog  volume database file and  index (volumes.DB and
  585.                   .IDX),
  586.              5.   the archive content database file and index (archives.DB and
  587.                   .IDX).
  588.  
  589.              It  is possible  to have  different combinations  of catalog  and
  590.              description databases.  If you have multiple catalogs please note
  591.              that  the volume and archive content files are related, and their
  592.              names should  be changed as a pair.  If you do not catalog within
  593.              archives or in only one catalog this is not a consideration.
  594.  
  595.         2.3  General directory and files
  596.  
  597.              The BBS description  directory is the sub-directory where most of
  598.              your  file  description  lists will  be  located.    This can  be
  599.              modified during the import function of BBSee.
  600.  
  601.              The  Download  File directory  is  the  sub-directory where  your
  602.              telecommunication program places downloaded  files.  This is used
  603.              in  the  Analyze  Directory option  of  Catalog.    As well  this
  604.              directory is searched before download files lists are created.
  605.  
  606.              Archive Files directory is the sub-directory where files could be
  607.              moved after  being downloaded, but  before being moved  to floppy
  608.              disk.   This is  used in the  Analyze Directory option.   As well
  609.              this  directory  is  searched  before download  files  lists  are
  610.              created.
  611.  
  612.              Qmail File directory is  the sub-directory where your  .QWK files
  613.              are kept.  NEWFILES.DAT files in the .QWK files, can be extracted
  614.              from  these files and imported  into the master  database.  Other
  615.              .QWK  files in  other sub-directories  on the  same drive  can be
  616.              selected by navigating through  the disk using the cursor.   This
  617.              directory is used in the Unarc/Import Newfiles option.
  618.  
  619.              Uncompress Program Directory is the sub-directory where your file
  620.              archivers  exist.   This  is used  in  the Unarc/Import  Newfiles
  621.              option, and in the eXtract function.
  622.  
  623.              The BBSee  Output directory  is the working  directory BBSee  for
  624.              storing  temporary files  including those  created by  the Search
  625.              Word function,  and possibly by  DOS Shells.  These  files can be
  626.              large so the drive where this directory is located should have at
  627.              least  .5MB free.   Also, many  BBSee output file  are created in
  628.              this  directory.  See Section  2.5 on the  output directory files
  629.              for further information.
  630.  
  631.              The  Virus Scan  Directory  is the  directory  where the  program
  632.              SCAN.EXE  resides.  This is  used if you  enable the eXtract Scan
  633.              option.
  634.  
  635.                                         Page 8
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.                                   BBSee Version 2.0
  644.  
  645.              The  Upload  Files Directory  is  the  directory from  where  you
  646.              usually upload files.
  647.  
  648.              The General Directory is any directory that you would like to pop
  649.              up in the File Manager.
  650.  
  651.              The Archive Viewer Directory is the directory  where your archive
  652.              viewer is located.   The  Viewer name is  configured below  this.
  653.              The Viewer could be a program  like FV which writes to the screen
  654.              or it could be a stand-alone program like SHEZ, Arc Master, ZRAY,
  655.              or VPIC.  If you wish to use a stand-alone program enter Y in the
  656.              Shell program field.
  657.  
  658.         2.4  Tag Files Facility.
  659.  
  660.              The  Tag files directory is  where BBSee places  the download and
  661.              upload  files from  the tagged file  option. The  extension field
  662.              should  contain the extension that will be appended to the output
  663.              file  that BBSee  creates,  depending on  whether  the upload  or
  664.              download  option was selected within BBSee.  A blank is possible.
  665.              The first part of the filename will be the name of the BBS.  This
  666.              feature  is   intended  to  be  used   with  automated  file/mail
  667.              management   programs,  such  as  Access(QMM),  Liberator,  Telix
  668.              Square, and CatCalls, Intellicomm, Boyan 5.0, and Robocomm.  
  669.  
  670.                   Q - QMM/Access*                             
  671.                   L - Liberator*
  672.                   W - CatCalls - Wildcat 3.0         *  marked automater types
  673.                   2 - CatCalls - Wildcat 2.0              use BBSee conference
  674.                   S - Telix Square
  675.                   I - Intellicomm*
  676.                   B - Boyan*
  677.                   R - Robocom 
  678.  
  679.              Note that the Upload  and Download file extensions need  to match
  680.              those specified for use with your program.  I will attempt to add
  681.              support for additional  Upload/Download types if  the appropriate
  682.              file specifications are provided to me.  
  683.  
  684.              See Appendix H for special instruction for use with Robocomm.
  685.  
  686.         2.5  Output Directory files
  687.  
  688.              This screen  contains the default filenames for  the files, other
  689.              than the databases,  created by  BBSee.  All  of these files  are
  690.              placed in  the output directory.   If you don't want  to create a
  691.              file for any of these options, specify NUL as the filename.
  692.  
  693.              The Added  file is the filename  used as output of  all new files
  694.              added  to the  database.   This is  useful when batch  updates of
  695.  
  696.                                         Page 9
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.                                   BBSee Version 2.0
  705.  
  706.              files are undertaken, however  for the most part I  recommend NUL
  707.              as the device for this option when you are importing ALLFILES.LST
  708.              types, as it  causes a lot of disk overhead.   You should however
  709.              enable this option when you are adding from NEWFILES.DAT or daily
  710.              imports, and use the List/tag mode to tag new files.
  711.  
  712.              The Added file will also  have a list of files that  are modified
  713.              for higher priority BBS.  In this way you can  see files that you
  714.              may have chosen  to disregard  on a long-distance  call BBS,  but
  715.              sounds more  attractive, for a  local call.   These modifications
  716.              are indicated with the » marker on the description.
  717.  
  718.              You  can  also choose  to have  BBSee  check your  catalog before
  719.              adding files to your Added  file list.  This is configured  using
  720.              the Search Catalog for adds option. 
  721.  
  722.              The  Discard file  is the  name of  the file  that is  to contain
  723.              information  about files  that were  discarded during  the import
  724.              process, for each of  the various rules used in the  import. Note
  725.              that  this file is opened in append  mode. I suggest that you use
  726.              the NUL  device once you  have a reasonable  idea of how  data is
  727.              imported. While  learning BBSee  I suggest that  you create  this
  728.              discard file, and examine it to see what BBSee rejects, until you
  729.              are satisfied with your exclusion words list.
  730.  
  731.              The Duplicate file shows filenames and descriptions when there is
  732.              potential  for  a description  change.   A  '>' indicates  that a
  733.              description was replaced.  This  file should be watched carefully
  734.              as the potential exists that file descriptions will not match the
  735.              filename  that  is  duplicated.    Filenames  with  3   or  fewer
  736.              characters  in  the  filename  should  normally  not  have  their
  737.              descriptions  replaced,  as the  short  filenames  are often  not
  738.              unique,  especially  when you  access many  BBS  sources.   It is
  739.              possible to configure the default for duplicate replacements from
  740.              0-9 (in the Misc section).  The smaller the number the more there
  741.              is a chance for duplicates.
  742.  
  743.              The  Word Search Output file is the file which BBSee creates when
  744.              you output the results of a  search or the output of tagged files
  745.              to disk.  This is  a PCBoard-like file with the inclusion  of the
  746.              BBS and file  catalog locations.   Output  to this  file will  be
  747.              added to the end of the file if the indicated file is found.
  748.  
  749.              The Catalog  files are the output  files chosen in  the output of
  750.              the floppy catalog filename  and volume options.  There  are also
  751.              .DUP, .VER and  .BBS extensions  possible.  See  Section 5.4  for
  752.              further information.
  753.  
  754.  
  755.  
  756.  
  757.                                        Page 10
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.                                   BBSee Version 2.0
  766.  
  767.              The Cross Reference extension  is the extension used in  making a
  768.              BBS  cross  reference  file.     See  Section  7.4   for  further
  769.              information.
  770.  
  771.              The  floppy  description file  is  the output  from  the Describe
  772.              Floppy  option  of   catalog.    See  Section   7.5  for  further
  773.              information.
  774.  
  775.              The  usage log  is  a facility  that  allows you  to log  certain
  776.              activities within BBSee.   The main purpose is  to log errors and
  777.              additions  to the database, for those people that want to monitor
  778.              database growth.
  779.  
  780.         2.6  Single word exclusions,
  781.              Paired word exclusions,
  782.              File extension exclusions and
  783.              Required words.
  784.  
  785.              These options allow for processing  of file descriptions based on
  786.              certain  words, (actually strings) so that the file can either be
  787.              included,  or excluded from addition  to the BBSee  database.  If
  788.              you include and exclude words 'smartly' the size of your database
  789.              can be greatly  limited.   Note, if for  example, you specify  to
  790.              exclude  the word 'windows' (you do not want all files associated
  791.              with Windows v3.1 to be in you database);  should you later start
  792.              running Windows  and want files and  accompanying descriptions to
  793.              be included, you must reread in the entire original file list(s).
  794.              A certain amount of  thought, both about your present  and future
  795.              computing  needs  should  be done  before  deciding  on words  to
  796.              exclude and include.  
  797.  
  798.              Some strings may be better specified as words, ie you may wish to
  799.              exclude descriptions  with the  word BMP,  forgetting that  it is
  800.              included in some words ( IBMPC ).  To include  an entire word use
  801.              the leading and/or trailing spaces by enclosing the word with the
  802.              space in double quotes.  ("gif ", " pcx "," bmp", etc.).
  803.  
  804.         2.7  Source / BBS Board Selection
  805.  
  806.              The third  part of the configuration  is a list of  the BBS names
  807.              that  you plan to include in the list.  The order of  these names
  808.              is  important.  See the  section on file  duplication for further
  809.              information. You can also include the name of a friend as a 'BBS'
  810.              if you  intend to  share  file lists.    The Format  and  Options
  811.              selections are used in processing non-PCBoard files.
  812.  
  813.              Note  that in the  shareware version of  BBSee, if  you have more
  814.              than  3 BBS/Source  selections configured  you will  experience a
  815.              delay on start-up.  Once  you register BBSee you will be  give an
  816.              activation key which provide unrestricted access.
  817.  
  818.                                        Page 11
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.                                   BBSee Version 2.0
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.                                        Page 12
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.                                   BBSee Version 2.0
  888.  
  889.         2.8  Area/Conference Support.  
  890.  
  891.              This  option allows you to assign BBS Conference and Area numbers
  892.              when a file is imported.  The BBSee numbers (0-15)  correspond to
  893.              data input in the second column which is the actual  area on your
  894.              BBS.   The  output in  BBSee and  in download  files will  be the
  895.              entered data in column 2.
  896.  
  897.              In the third column you may enter the conference name.  This will
  898.              allow you  to select the name from an F2 picklist in BBSee rather
  899.              than by the BBSee number.
  900.  
  901.         2.9  Catalog Configuration
  902.  
  903.              Default Drive:  This is the default cataloging drive, A or B.
  904.  
  905.              Default Category: This  is the default  category assigned when  a
  906.              volume is  cataloged.  It can  be changed using the  View Catalog
  907.              D(etails) option.
  908.  
  909.              Catalog  within  archives: BBSee  can  be  configured to  catalog
  910.              within  archives if desired.   Enter the Y(es)  option of Catalog
  911.              Within Archives,  to catalog  every filename within  the archive,
  912.              with the exception  of READM*.* files.  If you  have a restricted
  913.              need  type  C(ustom), and  if you  don't  want to  catalog within
  914.              archives  type  N(o).   This  can be  modified  temporarily while
  915.              running BBSee.  
  916.  
  917.              If you use  the C(ustom)  option to  customize cataloging  within
  918.              archives, various  options are available  to you, in  a secondary
  919.              window.  This feature  allows you to restrict the  filenames that
  920.              are cataloged within archives by specific extension.  The Archive
  921.              Extension selection  allows you  to choose archive  cataloging of
  922.              standard  extensions.   The standard  extensions are  .ZIP, .PAK,
  923.              .ARC,  .LZH,  .ARJ, .COM,  .EXE, .SDN,  and  .GIF.   Filenames in
  924.              imbedded  archives will  not  be  cataloged.    In  addition,  OR
  925.              instead, you  can specify file  extension(s) that you  would like
  926.              cataloged by adding the specific extensions (without the dot). 
  927.  
  928.              Extract Descriptions: You are able to select automatic extraction
  929.              of  the BBS description files  FILE_ID.DIZ and DESC.SDI from your
  930.              files  while cataloging.  Enable this feature by entering a Y(es)
  931.              in  extract descriptions.   More and  more authors  are including
  932.              these files.
  933.  
  934.              Find 4DOS  Descriptions: Enabling  this option will  take catalog
  935.              descriptions from 4DOS/NDOS the descript.ion file.
  936.  
  937.              Recatalog: There are two methods of cataloging; cataloging entire
  938.              disk contents and cataloging updates to disk contents.  The major
  939.  
  940.                                        Page 13
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.                                   BBSee Version 2.0
  949.  
  950.              difference  between the two options is that in update mode, BBSee
  951.              will  not  do the  normal  uncatalog/catalog  performed by  other
  952.              programs,  it only updates the database  on the specific filename
  953.              changes.   Minor limitations on the update exist when a cataloged
  954.              file  'changes', but its name does not change.  For example, data
  955.              changes (size, dates) for a filename, will not cause the database
  956.              to be modified, nor will any changes in the contents of archives.
  957.              Manual uncataloging  and then a re-catalog  will correctly handle
  958.              these situations.
  959.  
  960.         2.10 Fill Configuration
  961.  
  962.              The Fill setup options that will require configuration are:
  963.  
  964.              Default category -  {99999} - This  is the category  used in  the
  965.              Fill process as a default, and which is temporarily reset using a
  966.              Fill.  A normal disk when cataloged is given a category of 99999.
  967.              If this disk  is updated using a Fill category  BBSee will update
  968.              the volume category.
  969.  
  970.              Update  BBSee Catalog  - This  will cause  disks to  be cataloged
  971.              during the Fill.
  972.  
  973.              Create Volume Label - This option  will cause disks with no label
  974.              to  automatically  be  sequentially labelled  using  the selected
  975.              label template.  See Section 5.3.1 for further information.
  976.  
  977.              Perform  Validity  Check -  This option  will  cause a  32bit CRC
  978.              check to be performed on all copies to the floppy disk, including
  979.              those done in  the File  Manager.   Using this  option is  highly
  980.              recommended, as I have found DOS (and Verify) to be unreliable in
  981.              determining faulty diskettes.
  982.  
  983.              Mark Filled Files -  This option allows BBSee's  Fill to use  the
  984.              archive bit as  an indicator  that a file  has been  successfully
  985.              copied to disk.   When this option is enabled,  it is possible to
  986.              interrupt a large Fill, and come back to the same point later on.
  987.              It  is a good  idea to use  the File  Manager to ensure  that the
  988.              files in the directory you wish  to Fill from have their  archive
  989.              bit set (Upper  case) properly  before starting the  Fill.   Note
  990.              that  many programs, not only BBSee, including the DOS BACKUP and
  991.              ATTRIB commands, will modify the archive bit.  After  the Fill it
  992.              is  possible  to use the File Manager to mark and delete the Fill
  993.              'copied files' (showing  in lower  case) from the  hard disk,  if
  994.              desired.
  995.  
  996.         2.11 Function Keys
  997.  
  998.              To  run programs  using  the BBSee  Shell  facility you  need  to
  999.              identify  the program  name (format  DRIVE:\DIRECTORY\PROGRAM ie.
  1000.  
  1001.                                        Page 14
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.                                   BBSee Version 2.0
  1010.  
  1011.              C:\DOS\FORMAT.COM), and optionally the DRIVE:\DIR where you would
  1012.              like to run this program from.
  1013.  
  1014.              The reset video  commands, no swap, and command  line parameters,
  1015.              allow you to  configure other shell characteristics.  Reset video
  1016.              returns the video back to 80x25  if it has been changed by BBSee.
  1017.              Setting EMS/XMS swapping  to N(o)  will causee BBSee  to swap  to
  1018.              disk  rather then EMS or  XMS, which will  reserve EMS/XMS memory
  1019.              for the shelled  program.  If EMS use is  disabled this will have
  1020.              no effect.
  1021.  
  1022.              The Command  line parameters are  those commands  you might  have
  1023.              typed if you had entered the program on the command line 
  1024.              ie (for the FORMAT example ) a: /n:9 /t:80
  1025.  
  1026.         2.12 Volume Templates
  1027.  
  1028.              This  option allows  you to  create Volume  templates for  use in
  1029.              BBSee's  automatic Volume  labelling.   (see section  on template
  1030.              labelling).    The first  template is  the default  template, the
  1031.              second set are for selection from a pick list.
  1032.  
  1033.         2.13 Analyze Directory
  1034.  
  1035.              This  option provides a means to create a personalized batch file
  1036.              that can  process files on your computer  in any manner you wish.
  1037.              The ~ macro allows  substitution of default directory information
  1038.              into  the  batch file  when  the  batch file  is  created.   This
  1039.              information comes  from other  options within BBSETUP.EXE.   NOTE
  1040.              that lines two  and three of this batch file  ONLY apply to files
  1041.              with the .ZIP extension.
  1042.  
  1043.              There  are two  files created  in the  Output Directory  for this
  1044.              option, which are set by the top two fields on  this screen.  See
  1045.              Section 7.6 for  a detailed  explanation of how  these files  are
  1046.              created and used.
  1047.  
  1048.         2.14 Hardware Installation
  1049.  
  1050.         2.14.1 Video Installation
  1051.  
  1052.              Various colours,  and video  modes options  are available  to the
  1053.              BBSee user.  This section details these options.
  1054.  
  1055.              BBSee is written independent  of the normal 80x25 screen,  and if
  1056.              you start  BBSee, with  other configurations  BBSee will  use it.
  1057.              Having   less  than  70  columns  would  be  for  the  most  part
  1058.              unsatisfactory.   BBSee  should  work  with Ultravision  extended
  1059.              modes if they are enabled before BBSee  is run.  Note that if you
  1060.              desire to use  custom VGA fonts with  BBSee, you should  only run
  1061.  
  1062.                                        Page 15
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.                                   BBSee Version 2.0
  1071.  
  1072.              BBSee  in 80x25 mode, or  change the video  before running BBSee.
  1073.              If you don't  BBSee video resets could 'lose' your  font when you
  1074.              exit to DOS.
  1075.  
  1076.              This  Change Colours  option will  allow for  setting  up colours
  1077.              within  the various  menus/windows in  BBSee.   In the  shareware
  1078.              version you  are able to  explore this  feature, but it  will not
  1079.              save  changes for  any  option except  the  Search Window.    The
  1080.              registered version of BBSee provides further colour configuration
  1081.              capabilities.
  1082.  
  1083.              If  you a have a  CGA that produces  flicker, flicker elimination
  1084.              can be obtained by  instructing BBSee to wait for  video retraces
  1085.              before writes.  Mono  mode disables colour settings for  use with
  1086.              monochrome  monitors.   Enter  a Y  in  the appropriate  field to
  1087.              enable these selections.
  1088.  
  1089.              If   you  have   a  VGA   monitor,  BBSee  can   generate  screen
  1090.              combinations, other than  80x25.  One 'interesting'  mode, the 90
  1091.              column mode, provides a  lot more information on the  screen with
  1092.              very  little loss of readability.  Although SVGA is not required,
  1093.              this mode has not worked on every VGA card/monitor combinations.
  1094.  
  1095.              Various screen row  (line) lengths are available  including 21 (a
  1096.              slightly bigger font), 25 (normal) and 28, 43, and 50, and 60 row
  1097.              modes.  Additionally the 50 row mode can be set  to only function
  1098.              during a  word search, to allow  more data on the  screen at that
  1099.              time.  
  1100.  
  1101.              It is also possible to use special  mode(s) available on many VGA
  1102.              cards.  Refer to your documentation, and if you find a mode you'd
  1103.              like to try, use 0  as the number of screen lines and set the DOS
  1104.              variable BBVMODE= to the desired  mode.  Note that most  VGA card
  1105.              documentation   manuals   specify   the   non-standard   mode  in
  1106.              hexadecimal   notation,  and   BBVMODE   would  be   the  decimal
  1107.              equivalent.
  1108.  
  1109.              For special environments,  DesqView and  Memory Commander  (RSIS)
  1110.              video  specifications are followed to allow  'fast' video.  Also,
  1111.              BBSee will  not attempt to switch  video modes if Windows  3.X is
  1112.              running, although it will accept the Windows 3.1 50 line mode.
  1113.  
  1114.         2.14.2 EMS Support.
  1115.  
  1116.              BBSee  will use  expanded  memory for  some  functions to  reduce
  1117.              memory requirements.  The  savings are most dramatic in  the word
  1118.              search  (although  EMS memory  is  slightly  slower than  regular
  1119.              memory).  Use of EMS is configured on and off in BBSetup.  Use of
  1120.              EMS  can reduce  memory requirements  by about  70K and  speed up
  1121.              certain shell related functions.
  1122.  
  1123.                                        Page 16
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.                                   BBSee Version 2.0
  1132.  
  1133.         2.14.3 Mouse Support.
  1134.  
  1135.              BBSee has full mouse support  which can be configured off or  on.
  1136.              The mouse can be either  an arrow with fixed colours, or  a block
  1137.              cursor  with  screen   related  colours.    See  Appendix  D  for
  1138.              information on using the mouse in BBSee.
  1139.  
  1140.         2.14.4 Sound
  1141.  
  1142.              There is an option  to configure 'completion' sounds on  and off.
  1143.              Error sounds will remain if sound is configured off
  1144.  
  1145.         2.15 Miscellaneous
  1146.  
  1147.              Under this option there are data fields that are used  in various
  1148.              functions  of BBSee.  The  file date option  excludes files older
  1149.              than a  certain date  from being  added to  the  database.   This
  1150.              exclusion  date default is not  permanent, it can  be modified in
  1151.              the  File  menu selection  of  BBSee,  under the  "Modify  Import
  1152.              Options" sub option.  Although you may want to specify that older
  1153.              files,  such as pre-1986 be excluded, you must remember that some
  1154.              sources have files dated as  early as 01-01-80.  A  suggestion is
  1155.              to  browse through  the lists  you wish  to read  into  BBSee and
  1156.              determine if any of these files exist.
  1157.  
  1158.              The  duplicate length is the  minimum length of  filename used by
  1159.              BBSee  in  determining if  descriptions  should  be replaced  for
  1160.              matching filenames from various BBS's.
  1161.  
  1162.              SCAN extracts  is the  option to  use if you  plan to  have BBSee
  1163.              perform a McAfee SCAN.EXE of files that you 'eXtract'
  1164.  
  1165.              The effective cps is the  cps rate used to estimate  the download
  1166.              time for marked files.  You may wish to change this to match your
  1167.              effective  modem speed (ie 270 for 2400  baud MNP, 1650 for a USR
  1168.              HST).  Of course, the BBS you are calling will have to match your
  1169.              modem speed.
  1170.  
  1171.              The two locks configure the File Detail Window in the Search Word
  1172.              and List/Tag windows on and off  (using Y(es) and N(o).).
  1173.  
  1174.         2.16 Print Order Form.
  1175.  
  1176.              I hope this is  the most used option!   This will create  a BBSee
  1177.              order form, which you  could mail in for  registration.  You  can
  1178.              have as the  destination any DOS device  (PRN,LPT1,LPT2, COM1) if
  1179.              you  wish,  although  no  checking  for  device  availability  is
  1180.              performed.  See Appendix A for further registration information.
  1181.  
  1182.  
  1183.  
  1184.                                        Page 17
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.                                   BBSee Version 2.0
  1193.  
  1194.         Chapter 3 File Function
  1195.  
  1196.         The  heart  of  the  BBSee  program  is  a  master  database  of  file
  1197.         descriptions  that  can come  from  many  sources.   File  description
  1198.         listings  can  be imported  from  BBS directory  listings,  QWK format
  1199.         files, telecommunication  program screen captures and  log files, file
  1200.         output from BBSee itself, and they can be entered manually.
  1201.  
  1202.  
  1203.         3.1  File importation
  1204.  
  1205.              Importation is the method  of bringing a file list into BBSee and
  1206.              processing  the  listing,  line-by-line, into  a  BBSee  database
  1207.              record.   Because of  the many, many different  list types, it is
  1208.              impossible  to guarantee  that  all  files  in  a  list  will  be
  1209.              included.  
  1210.  
  1211.              BBS file  listing, are  incorporated into  the  database using  a
  1212.              sequential read of a  DOS text (ASCII) file, each line  being one
  1213.              record.  The layout of a file description 'record' is  one that I
  1214.              have adopted based on  viewing PCBoard file description listings.
  1215.              Anyone having definitive specifications  is encouraged to forward
  1216.              them to me as described in Appendix A.  The  file "record' layout
  1217.              that BBSee expects is:
  1218.  
  1219.              filename    position  1-12
  1220.              spaces      position 13-14
  1221.              filesize    position 15-21
  1222.              spaces      position 22-23
  1223.              date        position 24-31  ( format mm-dd-yy )
  1224.              spaces      position 32-33
  1225.              description position 34-80
  1226.  
  1227.              Any lines that follow this original record with blanks in columns
  1228.              1-33  and text in columns 34 -  80 are treated as continuation of
  1229.              the  description  record.   The pipe  character  | is  allowed to
  1230.              indicate  the start  of a continuation  line if  it is  the first
  1231.              character of a line.
  1232.  
  1233.              An  asterisk in position 32 is allowed.  This sometimes indicates
  1234.              a new file in a BBS on-line search.
  1235.  
  1236.              Data is incorporated into the database from the parsed text file,
  1237.              using the  exceptions input in BBSetup.  The rules built into the
  1238.              BBSee import logic function as follow:
  1239.  
  1240.              -    Filenames must be uppercase.
  1241.  
  1242.  
  1243.  
  1244.  
  1245.                                        Page 18
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.                                   BBSee Version 2.0
  1254.  
  1255.              -    All descriptions are converted to lower case.  The character
  1256.                   set is limited to  the extended ASCII characters  between 32
  1257.                   and 165.  No allowance is made for code pages.
  1258.  
  1259.              -    If  the  file  contains one  of  the  required  words it  is
  1260.                   considered  mandatory.   This  file  will  be added  in  all
  1261.                   instances.
  1262.  
  1263.              -    Records with a  description containing two  paired exclusion
  1264.                   strings, will not be entered into the database.   
  1265.  
  1266.              -    Any file description continuation  lines that begin with the
  1267.                   words 'Uploaded by .....' or 'Last  filedate in .ZIP ..'  or
  1268.                   containing 'files - New:' will be stripped out.
  1269.  
  1270.              -    Ending punctation character . and ! are removed.
  1271.  
  1272.              -    Catalog only descriptions always replaced.
  1273.  
  1274.              -    Files descriptions beginning with  (CRS) will have the (CRS)
  1275.                   stripped.  the 'Last Revision Date...' string for  CRS files
  1276.                   will also be stripped.
  1277.  
  1278.              Note that if you manually create a PCBoard-like text file using a
  1279.              text  editor, you  should ensure  no tab  characters are  in your
  1280.              output document,  as they can make it  appear that the file meets
  1281.              specifications, when it truly does not.
  1282.  
  1283.              Another  program supplied  in BBSee,  IMPORT.EXE, is  intended to
  1284.              assist in the automatic  creation of file lists, by  parsing non-
  1285.              standard  file lists into the PCBoard 'standard' that BBSee uses.
  1286.              In general, if you don't know if a BBS is a PCBoard type, run the
  1287.              import  file through  the import program  to see if  it meets the
  1288.              PCBoard column specs.  General use of this program is outlined in
  1289.              Appendix D.
  1290.  
  1291.              If  this non-standard  BBS  file can  be converted  automatically
  1292.              using  IMPORT,  BBSee  has  the  capability  of  performing  this
  1293.              conversion  when a file is imported.  (BBSee can presently import
  1294.              more  than 50 different BBS  list formats).   Specify in BBSetup,
  1295.              that the file type is type AUT, (for automatic), rather than PCB,
  1296.              and the appropriate option (see Appendix D).  If the BBS requires
  1297.              a manual  use of IMPORT, specify ASK for the file type, and BBSee
  1298.              will prompt you before importing the file.  
  1299.  
  1300.              Note that the  nature of  the database will  not allow  automatic
  1301.              determination,   and  indication  of   various  file   areas  and
  1302.              conferences  on the BBS.   This is extremely  difficult to detect
  1303.              automatically,  and so  the feature  is not  available.   You can
  1304.  
  1305.  
  1306.                                        Page 19
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.                                   BBSee Version 2.0
  1315.  
  1316.              however,  set a  limited number  of conference  numbers prior  to
  1317.              doing an import.
  1318.  
  1319.         3.2  File Duplication
  1320.  
  1321.              There  is a  mechanism  in  place  to  prevent  the  addition  of
  1322.              filenames  with   different   descriptions,  sizes,   times   and
  1323.              extensions into the master  database.  Filenames from description
  1324.              listings (  excluding extension) are compared to those already in
  1325.              the  database  and if  the  filename  is found  certain  database
  1326.              modifications may  take place.  PRIORITY will be given to the BBS
  1327.              names  higher on  the  configuration list  of sources  (the lower
  1328.              number).  The  extension, file date, and file size  stored in the
  1329.              database will be that of the highest priority source.  
  1330.  
  1331.              The  same is true of the description, although if the filename is
  1332.              more  than  the configure  duplicate  minimum  (default is  three
  1333.              characters long),   the description having the most characters is
  1334.              stored  in the  database, regardless  of the  source.   No method
  1335.              exists to eliminate  this problem, or  to prevent replacing  file
  1336.              descriptions,  without user  prompting,  which is  not desirable.
  1337.              This number  can be changed temporarily if desired, in the File -
  1338.              Modify Import Options window, or permanently in BBSetup.
  1339.  
  1340.         3.3  Uncompress and Import NEWFILES.DAT
  1341.  
  1342.              Users of  Qmail, MarkMail, Rosemail etc with offline mail readers
  1343.              are probably aware that it is possible to browse all files new to
  1344.              the BBS from a previous date, offline.   I am not going to try to
  1345.              explain  how these programs work, rather I will explain how BBSee
  1346.              handles  the importation  of the  new file  information contained
  1347.              within them.  If you  plan to use a BBS regularly, and it has the
  1348.              option of  using an  offline mail  reader, usually  configured as
  1349.              doors,  I suggest that you investigate them.
  1350.  
  1351.              Contained  in  most  .QWK files  downloaded  with  the  'scan for
  1352.              newfiles' option of  the mail door  turned on, is  a file  called
  1353.              NEWFILES.DAT.  BBSee  will allow for  a semi-automatic import  of
  1354.              this  file description  list  into the  master database.   Within
  1355.              BBSee,  after  selecting the  Unzip  option,  use  the cursor  to
  1356.              select the .QWK file  that you wish to import into  the database.
  1357.              After  this, select  the  BBS source  of  this  file.   The  file
  1358.              description records will then be entered into the database.  This
  1359.              of course assumes  proper configuration of  the mail and  archive
  1360.              file directories. 
  1361.  
  1362.              If your BBS has this capability, regular use of this feature will
  1363.              keep  your  database  up-to-date,   and  eliminate  the  need  to
  1364.              regularly  download the  entire list  of  newfiles added  to your
  1365.              BBS's.
  1366.  
  1367.                                        Page 20
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.                                   BBSee Version 2.0
  1376.  
  1377.              BBSee  will automatically  sense  if the  .QWK  package has  been
  1378.              compressed  with ZIP, ARC, ARJ,  or LZH formats  and will extract
  1379.              accordingly.
  1380.  
  1381.         3.4  Modify Import Options
  1382.  
  1383.              This  option allows  you to  temporarily change  specific options
  1384.              related  to file imports.  The various import-output files can be
  1385.              modified,  and  exclusion  dates  and duplicate  lengths  can  be
  1386.              specified.
  1387.  
  1388.              There is also an  option to configure a BBSee  conference number.
  1389.              Before  loading a  specific  file which  you  know relates  to  a
  1390.              specific BBS conference, enter the BBSee number 0-15 that relates
  1391.              to that conference.   A pick list is available  using the F2 key.
  1392.              At the  end of your  import this  option will be  reset to  BBSee
  1393.              conference 0.
  1394.  
  1395.              A final option is available to import specific description files,
  1396.              regardless  of length.   The  purpose of  this is  for customized
  1397.              lists containing information that you do not wish to be ignored.
  1398.  
  1399.         3.5  Create Record
  1400.  
  1401.              Using  this option  it is  possible to  create a  master database
  1402.              entry.  The  best use for  this option is  to add unknown  files,
  1403.              personal  files, and obsolete files  to the database  so that the
  1404.              floppy disk catalog can  also be updated.  This  file description
  1405.              is not subject to any of BBSee's import 'rules'.
  1406.  
  1407.         3.6  File Manager
  1408.  
  1409.              BBSee includes a  simple disk management facility  under the main
  1410.              menu  File  option,  the File  Manager.    It  is also  available
  1411.              globally  using <Ctrl-M>.   It  is not  meant to  compete against
  1412.              other commericial  file managers, but  it could assist  you while
  1413.              using BBSee. 
  1414.  
  1415.              Most  of the  functions,  are self-explanatory.   Some  points of
  1416.              interest
  1417.  
  1418.              -    The  lower case  names  are files  that  have their  Archive
  1419.                   attribute bit set.   The Catalog Fill  can make use of  this
  1420.                   bit.
  1421.  
  1422.              -    Files copied to a floppy using File manager, will have their
  1423.                   archive  bit removed if Fill  - Mark Archives  is Enabled in
  1424.                   BBSetup.
  1425.  
  1426.  
  1427.  
  1428.                                        Page 21
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.                                   BBSee Version 2.0
  1437.  
  1438.              -    All copies, and moves to a FLOPPY disk will use CRC checking
  1439.                   if the Perform Validity  Check option is enabled  in BBSetup
  1440.                   (under Catalog/Fill options).
  1441.  
  1442.              -    The eXtract option functions as described in Chapter 1.
  1443.  
  1444.              -    Cataloging of floppies is available in the File Manager.
  1445.  
  1446.              -    File manager will copy over existing files. 
  1447.  
  1448.              -    File manager  will not try to  copy one file if  there is no
  1449.                   room. 
  1450.  
  1451.              -    A Move onto another  directory on the same drive  is treated
  1452.                   as a  rename, to function quickly.   This is one good reason
  1453.                   for   keeping  up/down/archive   directories  on   the  same
  1454.                   partition when they are going to be used for cataloging. 
  1455.  
  1456.              -    The V command will bring up a program viewer.  This can be a
  1457.                   standalone program for archives (SHEZ, AM, ZRAY etc) graphic
  1458.                   viewers (VPIC, VUIMG,  GWS etc)  or it can  be program  like
  1459.                   FV.COM which displays to standard output.
  1460.  
  1461.         3.6.1 List file
  1462.  
  1463.              Within  the  File Manager  there is  a  list command  designed to
  1464.              browse  ASCII text  files.   The  commands  available within  the
  1465.              lister are:
  1466.  
  1467.              Cursor Up/Down/Left/Right, Home,  End, <Ctrl Left>,  <Ctrl Right>
  1468.              (scrolling full left and right)
  1469.  
  1470.              F    Find text
  1471.              N    Next (find Next occurrence of text)
  1472.              Z    Zoom List to full screen.
  1473.              T    This is a special function,  in that it allows you to  enter
  1474.                   BBSee's List/Tag mode during a normal text file 'list'.  The
  1475.                   primary  use of this mode is to browse the PROGRAMS.NEW file
  1476.                   created during  an import and  then tag  selected files  for
  1477.                   download.  This mode can be enabled on a 'Zoomed' list.
  1478.  
  1479.              There  is also  a  configuration option  in BBSetup  , as  in the
  1480.              Search  Word  option that  enables a    Detail Window  within the
  1481.              List/Tag mode  to show possible BBSee information  on a filename.
  1482.              If no BBSee description  information is found for the  file, this
  1483.              window is left blank.
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.                                        Page 22
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.                                   BBSee Version 2.0
  1498.  
  1499.         3.7  Floppy Directory
  1500.  
  1501.              This option allows you to see a list of all files on the selected
  1502.              floppy,  including  all sub-directories,  with  one  entry.   The
  1503.              filenames  shown  on the  left  have descriptions  in  your BBSee
  1504.              master  database,  the  filenames  on the  right  would,  if  you
  1505.              cataloged  this  disk,  be  cataloged  with  description 'catalog
  1506.              only'.   This option is  available anywhere in  BBSee by entering
  1507.              <Ctrl-F>.
  1508.  
  1509.         3.8  BBSee Shell
  1510.  
  1511.              It  is now  possible to  shell to  specific DOS  programs by
  1512.              function key <CtrlF2-10>, through a pop-up interface,  under
  1513.              File option BBSee Shell, or through <Ctrl-B> almost anywhere
  1514.              in BBSee. 
  1515.              If you  change video modes while  you are in the  shell BBSee may
  1516.              exit to DOS  when you return, if the previous  video state cannot
  1517.              be properly restored.
  1518.  
  1519.         3.9  DOS Shell
  1520.  
  1521.              This  option allows exiting to  DOS to execute  many DOS programs
  1522.              and commands.   Do  not run  any TSR's, reboot,  or turn  off you
  1523.              machine while you are  in the shell.  To return to BBSee you must
  1524.              type the command EXIT at  the DOS prompt.   It is better to  quit
  1525.              BBSee and  come back  if you  must leave the  program for  a long
  1526.              period of time.  
  1527.  
  1528.              If you  use BBSetup in the  shell, the changes you  make will not
  1529.              take place, until you quit BBSee and rerun it.
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.                                        Page 23
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.                                   BBSee Version 2.0
  1559.  
  1560.         Chapter 4 Search Function
  1561.  
  1562.         Search for words and/or filenames.  Outputs the filename if found, and
  1563.         if the filename has been cataloged on disk, the label and directory of
  1564.         the  cataloged  disk  will  be  displayed.    Graphic  resolution  for
  1565.         cataloged GIF, and JPEG files will also be displayed.
  1566.  
  1567.         4.1  Word Search
  1568.  
  1569.              This option allows you to search for strings within the database.
  1570.              Because of the nature of  the search the most unique  word should
  1571.              be in  the primary word field.   The primary word  is searched in
  1572.              all filenames and description.  
  1573.  
  1574.              The search on a word continues until the entire database  is read
  1575.              or a complete screen  of information is displayed, at  which time
  1576.              the filename  will be  highlighted with a  selection bar.   It is
  1577.              then  possible to select filenames by moving the selection bar up
  1578.              and  down using  the cursor.   Full  database information  on the
  1579.              selected  filename  is  available by  typing  the  letter D  (for
  1580.              Detail).  <ESC> will abandon the  search at this point.  Also see
  1581.              the TAG option.
  1582.  
  1583.              Under the Search  Word option  BBSee saves all  output for  later
  1584.              review, [in a file called  BBSCREEN.TMP].  You can PgUp and  Down
  1585.              through a file as well as  use ^Home and ^End to get to  the top,
  1586.              and last screen of the present search. 
  1587.  
  1588.              Typing <D> will lock on the Detail Window until <D>  is pressed a
  1589.              second time.  The  default Detail Window lock on, Y(es)  or N(o),
  1590.              is configured in BBSetup.
  1591.  
  1592.              The BBSee catalog <X> eXtract, <C> Copy and <V> View features are
  1593.              available  in  this  window.    See  Section   5.10  for  further
  1594.              information.
  1595.  
  1596.         4.2  Filename Search
  1597.  
  1598.              Using this option  will allow you to perform an indexed search on
  1599.              the filename.  This is by far the speediest search, if you have a
  1600.              pretty good idea of the filename, or you want to look for various
  1601.              versions  of a particular file.   This is equivalent to a PCBoard
  1602.              <L>ocate without requiring the trailing *.*.
  1603.  
  1604.              To 'browse' the file near the search, the page/cursor up and down
  1605.              keys can  be used.  A file also  can be T(agged),  and U(ntagged)
  1606.              using the <T> or <U> keys.  See tags for further information.
  1607.  
  1608.              Typing   <E>  will  open  up  an  edit  window  for  the  current
  1609.              description.
  1610.  
  1611.                                        Page 24
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.                                   BBSee Version 2.0
  1620.  
  1621.              The BBSee catalog <X> eXtract, <C> Copy and <V> View features are
  1622.              available  for  retrieved files.   See  Section 5.10  for further
  1623.              information.
  1624.  
  1625.         4.3  Output Search List
  1626.  
  1627.              This option creates  an ASCII listing of the files  that meet the
  1628.              same search criteria as an on screen search.  This  listing is in
  1629.              PCBoard like format with the addition of the BBS  source, and any
  1630.              disk  cataloging information that you may have.  This listing can
  1631.              be  imported into  BBSee.  If  this file  exists it  is opened in
  1632.              append mode.
  1633.  
  1634.         4.4  Show All/Show Catalog/Show Uncat'd
  1635.  
  1636.              To toggle the search results from displaying  the master database
  1637.              description   information,   to   displaying  only   descriptions
  1638.              contained in the floppy  catalog, to displaying only descriptions
  1639.              of files you have not cataloged, hit enter on this option.
  1640.  
  1641.         4.5  Local BBS Searching
  1642.  
  1643.              Under  the BBS/Source option it  is possible to restrict searches
  1644.              to specific  BBS(es), using  what I  call a  'Local' search.   An
  1645.              asterisk will indicate that you are running a 'local' search.  To
  1646.              disable the 'local'  search hit enter  on the Show  option.   The
  1647.              defaults for the 'Local' BBS's are established in BBSetup.
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.                                        Page 25
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.                                   BBSee Version 2.0
  1681.  
  1682.         Chapter 5 Catalog Function
  1683.  
  1684.         The  purpose  of these  functions is  to  improve disk  maintenance of
  1685.         downloaded  files, and  other files  that you  accumulate and  wish to
  1686.         store on floppy.   If you accumulate a  large number of files  on your
  1687.         hard disk, especially from downloads, that  you do not want to  delete
  1688.         but  you wish  to  remove  for  later  retrieval,  using  the  various
  1689.         cataloging features  of BBSee  should drastically reduce  problems you
  1690.         may have finding them.
  1691.  
  1692.         Cataloging within BBSee is designed  to be both powerful and   simple.
  1693.         After  initial configuration, it can be as  simple as running BBSEE /A
  1694.         at the command line to catalog  a disk.  You can also  configure BBSee
  1695.         to do just about everything any other catalog system on  the PC market
  1696.         can do.
  1697.  
  1698.         The cataloging system uses three database, volume (info. on the entire
  1699.         disk), catalog  (file data on  each file on  the disk) ,  and archives
  1700.         (file data within arc,  arj, lzh, and zip files).   I could add  other
  1701.         archive types,  but I will  wait to see  what you  users demand.   The
  1702.         catalog  structure is tied to the master file description database for
  1703.         storage of  the 512 character descriptions, but a BBS file list is not
  1704.         required.   However using BBS lists, or stealing descriptions from BBS
  1705.         lists will make finding archive files that much easier.
  1706.  
  1707.         One difference between BBSee  and other catalogers is that  BBSee uses
  1708.         the DOS 4+ disk serial number  in conjunction with the volume label to
  1709.         produce a 'unique' identifier for disks.  BBSee will not prompt you to
  1710.         update a serialized/labelled disk,  as the chance of error  is reduced
  1711.         to what I  consider to be  acceptable.  If  the disk  does not have  a
  1712.         serial number, prompting will be required as with other programs.
  1713.  
  1714.         BBSee will  automatically extract GIF and  JPEG resolution information
  1715.         from .GIF and .JPG  files.  If the GIFLITE  string is left in  a .GIF,
  1716.         BBSee will also identify it in the resolution ( 640 X 480 normal 640 x
  1717.         480 GIFLITE).
  1718.  
  1719.         5.1  Catalog Disk
  1720.         5.2  Uncatalog Disk
  1721.  
  1722.              Both of these functions  will work by specifying the drive  to be
  1723.              cataloged,  and inserting  the  disk if  it  is removable  media.
  1724.              Additionally a disk can be uncataloged by volume label name.
  1725.  
  1726.              A disk  can be cataloged, if  it meets two criteria,  a) the disk
  1727.              has a volume label and b) a matching volume label has not already
  1728.              been cataloged.  (Note that in BBSee the volume label is not case
  1729.              sensitive).   If  files  exist  on  the disk  that  do  not  have
  1730.              descriptions in the BBSee master database, you may wish to create
  1731.              a   'Floppy'  description   file,   edit  it   with  the   proper
  1732.  
  1733.                                        Page 26
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.                                   BBSee Version 2.0
  1742.  
  1743.              descriptions, and  import this  edited file  into BBSee,  with an
  1744.              unknown category.  If no descriptions  from a file exist an entry
  1745.              with  the 'Catalog  only'  description will  be entered  into the
  1746.              master database.
  1747.  
  1748.              If you  try to  catalog a disk  that has already  been cataloged,
  1749.              BBSee will  check the serial  number and  if they match,  it will
  1750.              automatically catalog the disk  for you.  If they don't  you will
  1751.              need to Uncatalog the disk manually.  
  1752.  
  1753.              If the disk  you are using does not  have a serial number  or you
  1754.              are using DOS older than version 4, BBSee will ask if you want to
  1755.              replace  the existing catalog entry  for that label.   Be careful
  1756.              when  you  physically  label your  floppies,  as  it  is easy  to
  1757.              overwrite your  catalog database entries  if you use  very common
  1758.              volume labels.
  1759.  
  1760.         5.3  Label floppy
  1761.  
  1762.              This  option allows you to label floppies without exiting to DOS.
  1763.              If there  is no  volume label on  your floppy,  a default  unique
  1764.              label  assigned by  BBSee will  be displayed.    You can  edit or
  1765.              change this if you desire.
  1766.  
  1767.              If a volume label exists on a floppy that you are labelling,  the
  1768.              existing label will be shown in the input window.   If you desire
  1769.              to use  the automatic template label feature described below, you
  1770.              must first  delete any existing  label, by inserting  spaces, and
  1771.              then re-enter the label function again, to get the proper default
  1772.              label.
  1773.  
  1774.         5.3.1 Label Templates
  1775.  
  1776.              The  default layout of the  default label name  is established in
  1777.              BBSetup.   There are two  components, the name  component and the
  1778.              number  component.  The name component is up to seven characters,
  1779.              the number  component is up to 99999. They must be separated by a
  1780.              space. BBSee will increment the number component automatically to
  1781.              allow for the unique label,    sequential.  BBSee does not modify
  1782.              the BBSEE.CFG file in  performing this function, so holes  can be
  1783.              found.  You  cannot label a  disk in BBSee  with a template  name
  1784.              that is the same as a cataloged floppy.
  1785.  
  1786.              If  you enter  a volume  label manually  which uses  the template
  1787.              formula  described  above,  automatic  increments of  the  number
  1788.              component based  on volume  database, will  be made,  without you
  1789.              specifically configuring  the template.  Subsequent  calls to the
  1790.              label  function will give you  the next available  number of this
  1791.              new template.  Remember  to include the number of  leading zeroes
  1792.              you feel will be appropriate.
  1793.  
  1794.                                        Page 27
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.                                   BBSee Version 2.0
  1803.  
  1804.              A pick list  of possible  label templates is  also available,  by
  1805.              hitting function key F2, if the templates have been configured in
  1806.              BBSetup.
  1807.  
  1808.         5.4  Make Catalog File
  1809.  
  1810.              Filename/Volume Reports
  1811.  
  1812.              These options create a  list of files you have  cataloged, sorted
  1813.              by either disk volume, or filename.  This list is useful as it is
  1814.              output in a format that BBSee can use as input.  This  allows for
  1815.              sharing file lists with friends and other user groups.
  1816.  
  1817.              Volume reports for  a single BBSee cataloged volume are available
  1818.              in the View Catalog option.
  1819.  
  1820.              Duplicate/New Version/BBS Version Reports
  1821.  
  1822.              These useful reports are designed to give  you a list of possible
  1823.              duplicates and new versions of files that you have cataloged.
  1824.  
  1825.              The  two version  reports  use logic  to  determine if  you  have
  1826.              'different' versions of  the same program,  or that possible  new
  1827.              versions exist of files  you have already downloaded.   The logic
  1828.              is not  absolute,  but it  is still  beneficial.   Using the  New
  1829.              version  report you  can,  much  like  in the  duplicate  report,
  1830.              determine  obsolete files you may  have.  The  BBS version report
  1831.              identifies  files that you have, that also have newer versions in
  1832.              your  imported BBS lists.  This helps determine two things, files
  1833.              you might have missed in BBS lists  and should download, or files
  1834.              that probably should be  deleted since you didn't like  it enough
  1835.              to download a newer version.
  1836.  
  1837.         5.5  Fill
  1838.  
  1839.              One  very useful  feature of  BBSee's cataloging function  is the
  1840.              Fill option.  What this option does is allow you to copy files to
  1841.              floppy  disk,  in an  optimum manner,  much like  other programs,
  1842.              (FILL, ICOPY, DISKFILL), but BBSee will catalog after the Fill to
  1843.              save  disk swaps, and  will catalog archive  contents and extract
  1844.              description  files from the hard disk rather than the much slower
  1845.              floppy disk.
  1846.  
  1847.              When  Fill  is  started  you  can  enter  volume  and/or category
  1848.              information.  During a Fill, BBSee will determine if you have the
  1849.              free space on existing cataloged  disks with the indicated volume
  1850.              template or category and provide you with name of matching volume
  1851.              names so that you  can optimally Fill existing disks  before each
  1852.              disk change.
  1853.  
  1854.  
  1855.                                        Page 28
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.                                   BBSee Version 2.0
  1864.  
  1865.         5.6  View Catalog
  1866.  
  1867.              This  option  provides a  visual  'directory'  of your  cataloged
  1868.              files.  Hitting enter on a highlighted volume will provide a file
  1869.              list  on the item selected  by the current  cursor position.  The
  1870.              next enter  will provide the  description contained in  the BBSee
  1871.              database for the highlighted  filename (All the options available
  1872.              in  the  Search  Filename option  are  available  to  you on  the
  1873.              description).
  1874.  
  1875.              To change the selected  volume you can navigate in  various ways.
  1876.              Cursor up/down,  page up/down and  F(ind) and N(ext)  options are
  1877.              available.    Find  will search  both  the  volume  name and  any
  1878.              description that you may have provided to get to specific volume.
  1879.              Next continues the search from the current location.
  1880.  
  1881.              If you wish to  view archive file contents or  graphic resolution
  1882.              information, the D(etails) option is available when the cursor is
  1883.              on a filename.
  1884.  
  1885.              If the cursor  is on  a volume, additional  keyboard options  are
  1886.              available.  These are:
  1887.  
  1888.              -    E(dit) to change the description or category for this file.
  1889.              -    O(rder)  will  output  the  list  in  various  sort  orders,
  1890.                   including,  label name, space  available, category  and disk
  1891.                   number (order cataloged).
  1892.              -    R(eport) to create a disk report MYBBSEE.VOL for highlighted
  1893.                   volume.
  1894.              -    S(ummary)  to  create  a  summary  of  statistics  for  your
  1895.                   cataloged files.
  1896.  
  1897.         5.7  Show Catalog Files
  1898.         5.8  Show Archive Files
  1899.  
  1900.              These options provide on-line browsing of all catalog and archive
  1901.              files respectively.
  1902.  
  1903.              To change the selected filename you can navigate in various ways.
  1904.              Cursor  up/down, page up/down  and F(ind) and  N(ext) options are
  1905.              available.  Find will  search for the filename that you  may have
  1906.              provided.  You also have the option to move by Shift-Letter to go
  1907.              to the first file beginning with that letter.
  1908.  
  1909.              Hitting  <Enter>  on a  file will  bring  up the  Search Filename
  1910.              description for the current file.   Hitting D(etail) will provide
  1911.              any  archive contents for  the current file.   Note  that for the
  1912.              Show Archive  file option,  the description and  archive contents
  1913.              will be for the 'parent' archive file, not the highlighted file.
  1914.  
  1915.  
  1916.                                        Page 29
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.                                   BBSee Version 2.0
  1925.  
  1926.         5.9  Modify Options
  1927.  
  1928.              This option  allows you to temporarily  configure various Catalog
  1929.              and  Fill options  established  in BBSetup  on  and off.    These
  1930.              options  are: Catalog in  Archives, Extract  Descriptions, Update
  1931.              Catalog,  Create Volume  Label, Perform  Validity Check  and Mark
  1932.              Filled Files.  See chapter 2 for further information.
  1933.  
  1934.         5.10 Catalog eXtract, Copy and View.
  1935.  
  1936.              These  functions  are  designed  to  make  it  easier  to  manage
  1937.              cataloged files.  Using these options you will be able to perform
  1938.              specialized functions  on catalog files, without  having to rekey
  1939.              the catalog name.  After typing the 'action' letter (X,  C or V),
  1940.              you will be  prompted with the  volume name, and when  you accept
  1941.              (your disk is ready), the function will be performed.
  1942.  
  1943.         5.10.1 eXtract
  1944.  
  1945.              The  purpose  of this  function  is to  automatically  extract an
  1946.              archived  files based  on the  archiver's extension  (.ZIP, .ARJ,
  1947.              .LZH, and .ARC extensions).   To use this function type X  when a
  1948.              cataloged file is found in a Word of Filename Search.
  1949.  
  1950.              The  operation of  this  function is  as  follows.   BBSee  first
  1951.              creates  a  directory in  the BBSee    output directory  with the
  1952.              filename of  the archive, (without  extension) and the  files are
  1953.              extracted  into it.    The location  of  the appropriate  archive
  1954.              utility must exist in the archive directory configured in BBSetup
  1955.              for this function to perform.
  1956.  
  1957.              Additionally, BBSee can be configured in BBSetup to automatically
  1958.              run SCAN when  you perform an eXtract.  SCAN  from BBSee uses the
  1959.              /NOMEM and /REPORT option,  so memory is not checked for a virus.
  1960.              A file called SCANNED is created in the output directory when you
  1961.              scan the file.  BBSEE.USE is also updated to show the name of the
  1962.              scanned directory and the return code from SCAN.
  1963.  
  1964.         5.10.2 Copy File
  1965.  
  1966.              This  feature will copy a file from  a cataloged disk to an input
  1967.              disk,  after  you are  prompted for  the  appropriate disk.   The
  1968.              destination disk must be different from the source disk.
  1969.  
  1970.         5.10.3 View File
  1971.  
  1972.              This  feature  loads  the  configured archive  viewer  using  the
  1973.              current cataloged file as the command line argument.
  1974.  
  1975.  
  1976.  
  1977.                                        Page 30
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.                                   BBSee Version 2.0
  1986.  
  1987.         Chapter 6 Tag Function
  1988.  
  1989.         When one  of the various file  searches take place, it  is possible to
  1990.         'tag'  a  file.   This  is  done using  the  <T>  key.   Files  can be
  1991.         individually untagged  with  the  <U> key.    Additional  options  are
  1992.         available  in  the Word  Search  Option,  <Ctrl T>  tags  a screen  of
  1993.         filename  'hits', and  <Alt T>  tags all  screens of  filename 'hits'.
  1994.         File tags are indicated with the  character.
  1995.         Tags can also be toggled with the <Enter> or <Space> keys.
  1996.  
  1997.         There is a limit of 300 tagged files at one time.
  1998.  
  1999.         6.1  Delete tagged file
  2000.  
  2001.              This  option deletes all tagged  files from the  database.  These
  2002.              filenames are permanently removed from the database.  You will be
  2003.              provided with an option to add  these files to the Deleted  files
  2004.              database so that they cannot be  re-added (See Appendix E).  This
  2005.              feature is to ensure that you don't have to delete the same files
  2006.              every time a complete BBS file list is subsequently imported, for
  2007.              update purposes.  This will also remove the tags.
  2008.  
  2009.         6.2  Create download file
  2010.  
  2011.              This option  creates a download file in the tagged file dir.  The
  2012.              format   of  the   filename  is   bbsname.{defaultextension}  ie.
  2013.              SYNAPSE.DOW.  The layout  of this file is based  on the configure
  2014.              automation  program being  used, and  consists of  a list  of all
  2015.              filenames that are found  in the master database on  the selected
  2016.              BBS.  This will remove all tags from the selected BBS, unless the
  2017.              indicated bbsname has no tagged files.
  2018.  
  2019.              Conference support is provided  for Intelicomm, Liberator and AXS
  2020.              program/scripts.
  2021.  
  2022.         6.3  Remove tags
  2023.  
  2024.              The  tag is removed from every tagged file.  All file information
  2025.              is left unchanged.
  2026.  
  2027.         6.4  Create upload files
  2028.  
  2029.              This option  creates an  output list of  all tagged  files, in  a
  2030.              format  that can be edited  to use with  automatic file uploading
  2031.              facilities of  scripts Liberator, Access (QMM),  Telix Square and
  2032.              CatCalls,  and   Intellicomm,  and  macros  available for  Boyan.
  2033.              Direct  area/conference support and  support for  Robocomm upload
  2034.              agendas are not available at this time.
  2035.  
  2036.  
  2037.  
  2038.                                        Page 31
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.                                   BBSee Version 2.0
  2047.  
  2048.         6.5  Output tags to disk
  2049.  
  2050.              This option creates an output list of all tagged files in PCBoard
  2051.              format.  This file is opened in append mode.  
  2052.  
  2053.         6.6  View tags
  2054.  
  2055.              This  function  gives you  a display  of  all filenames  you have
  2056.              tagged during a search or in list/tag mode.   By entering O(rder)
  2057.              this list  will be toggled  between filename order,  BBS priority
  2058.              order and catalog label order.  An estimate of file download time
  2059.              is also presented.
  2060.  
  2061.              Entering  D(etails)  allows  you  to enter  the  Search  Filename
  2062.              function at the current file, to assist in finding newer versions
  2063.              that  may  exist  on  the  database,  which  may  not  have  been
  2064.              identified.  Because you  are in Search Filename mode,  access to
  2065.              all of its options are available at that point.
  2066.  
  2067.              Entering a S(ave)  will allow you  to save your  tag list in  the
  2068.              current  sort order to  disk.  Section  6.8 explains how  to Load
  2069.              this file.
  2070.  
  2071.              Tagging and untagging files is also possible on this screen using
  2072.              the enter or space keys.  Any tags you remove will not take place
  2073.              until you exit the window, or type R(edraw).
  2074.  
  2075.         6.7  Edit Tags
  2076.  
  2077.              This option allows you to edit the  description for each file you
  2078.              have tagged.  Selective editing can be performed in  the View tag
  2079.              window, by  going through  the Search  Word window, available  as
  2080.              D(etails).
  2081.  
  2082.         6.8  Load Tags
  2083.  
  2084.              Use this option to read  a file of filenames, and then  have them
  2085.              automatically  tagged  by  BBSee.    Many  uses  for  this  exist
  2086.              including, loading want lists, and special upload and delete file
  2087.              lists (possibly an edited version of the Cross Reference file).
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.                                        Page 32
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.                                   BBSee Version 2.0
  2108.  
  2109.         Chapter 7 Describe Function
  2110.  
  2111.         The Describe function provides various means of using the BBSee master
  2112.         database to assist you or produce speciality reports.
  2113.  
  2114.         7.1  Input File List
  2115.  
  2116.              This function allows you to read almost any ASCII text file which
  2117.              has  a filename as the starting  word, and provide a PCBoard like
  2118.              output-file containing the description found in your BBSee master
  2119.              database  for each  file  'found'.    The  input  file  for  this
  2120.              function, can include such things as redirected DIR  listings and
  2121.              output from BBSee itself.
  2122.  
  2123.              The main  use of this  function is to  provide a means  of either
  2124.              giving descriptions of files you are giving 'friends', or getting
  2125.              descriptions for files that you have stored as 'catalog only'.
  2126.  
  2127.         7.2  4DOS Description.
  2128.  
  2129.              This option  creates a 4DOS/NDOS  descript.ion file based  on the
  2130.              contents of  your master description database,  for the indicated
  2131.              directory.  This option  will OVERWRITE any existing descript.ion
  2132.              file  so  be  careful,  if you  have  entered  some  descriptions
  2133.              manually.
  2134.  
  2135.         7.3  Describe Floppy
  2136.  
  2137.              This option allows for the creation of a file, in PCBoard format,
  2138.              containing  any  file descriptions  associated  with  files on  a
  2139.              floppy.  If a file has no description in the master database, the
  2140.              message,  'Not in BBSee  catalog' is output  to the file,  in the
  2141.              description.  Since this file  is in PCBoard format, if  you edit
  2142.              the  'not  in  BBSee  catalog' message  with  a  more appropriate
  2143.              description  and  then import  the  file into  BBSee,  the master
  2144.              database will have more valid data.
  2145.  
  2146.         7.4  Cross Reference
  2147.  
  2148.              A  catalog cross  reference  creates a  list  of files  you  have
  2149.              cataloged  against  a  list  from  another  source.    The  cross
  2150.              reference output file is a list of differences.  This should make
  2151.              it easier to determine what to upload to other sources.  Remember
  2152.              to check a BBS before  uploading to ensure that you  don't upload
  2153.              something they received since your last file import.
  2154.  
  2155.              To make use  of this file  with an automated  upload, edit it  as
  2156.              required and use  the Load tags  facility.  This  will provide  a
  2157.              list  in Catalog label order if required, and also can output the
  2158.              desired upload file for you.
  2159.  
  2160.                                        Page 33
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.                                   BBSee Version 2.0
  2169.  
  2170.         7.5  Report Options
  2171.  
  2172.              This option allows you  to identify which reports you  would like
  2173.              to have output the BBSee Source and Catalog information.  As well
  2174.              a Quick  Catalog Report  Selection which creates  catalog reports
  2175.              with no  descriptions, (which because  of database access  can be
  2176.              significantly faster).
  2177.  
  2178.              This option is available globally as <Ctrl-R>.
  2179.  
  2180.  
  2181.         7.6  Analyze directory
  2182.  
  2183.              This option  uses the  batch file  specifications created in  the
  2184.              configuration.    Reviewing  what  I do,  should  assist  you  in
  2185.              creating a usable analyze.bat  file.  These are implemented  as a
  2186.              batch file so that you may inspect the file prior  to running it.
  2187.              This  sample could  be  further modified  to  meet your  personal
  2188.              requirements.
  2189.  
  2190.              The default  configuration functions as  follows.   Files in  the
  2191.              download directory  are compared  with the  description database.
  2192.              If  they  are  found they  are  added  to  a  file,  by  default,
  2193.              ANALYZE.BAT,   that can  perform the   following  operations when
  2194.              executed.  Note that in all cases batch options 2 and 3 will only
  2195.              work for .ZIP files.
  2196.  
  2197.              1.   File is copied from download to archive directory.
  2198.              2.   README.ROS and READ_ME.TXT  ( Rose Media  ads ) are  removed
  2199.                   from the ZIP file.
  2200.              3.   Comments are  removed  from  the  file  (  This  requires  a
  2201.                   shareware package STRIPZIP).
  2202.              4.   Original file is deleted from the download directory.
  2203.  
  2204.              I would recommend  that if you  approximate my archiving  method,
  2205.              that you also investigate programs such as FILL  or ICOPY.  These
  2206.              will  assist in  copying  files from  this  archive directory  to
  2207.              floppy disk, and they will maximize your floppy disk utilization.
  2208.  
  2209.              A  second output file  from this option  is a list  of files that
  2210.              were  not  found in  the  master  database.   A  single  file, by
  2211.              default, NOTFOUND.ADD is created that meets the specification for
  2212.              a BBS file listing.   This file description can be edited  with a
  2213.              text editor (the description is initially indicated *Not Found*),
  2214.              and  can be imported directly into the  database.  BBSee does not
  2215.              like  the tab  character so  be careful  when you  use your  text
  2216.              editor.
  2217.  
  2218.  
  2219.  
  2220.  
  2221.                                        Page 34
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.                                   BBSee Version 2.0
  2230.  
  2231.         Chapter 8 Using the program
  2232.  
  2233.         I  have included a  file, SAMPLE, that is  simply a small NEWFILES.DAT
  2234.         file from SYNAPSE  to help you test  BBSee.  You can later  expand the
  2235.         actual master database by  importing your BBS's allfiles listings.   I
  2236.         suggest that  you investigate  various exclusion word  combinations in
  2237.         BBSETUP prior to creating your 'good' database.  Once you have got the
  2238.         hang of it, you can of course import files from any sources you want.
  2239.  
  2240.         The first step, which I again emphasize as probably the most important
  2241.         is to  understand how to configure all the directories properly.  Read
  2242.         the configuration section, if you have not done so already.
  2243.  
  2244.         It is now time to run the program, that is after all why you have read
  2245.         all of this in the first place.
  2246.  
  2247.         1.   Run BBSETUP.EXE at  the DOS prompt.   I would recommend  that you
  2248.              make a temporary  subdirectory for  this purpose.   Files can  be
  2249.              moved at a later date.
  2250.  
  2251.         2.   Continue through BBSetup configuration.
  2252.  
  2253.         3.   Place  the desired  file(s) to  be imported  in  your description
  2254.              directory.
  2255.  
  2256.         4.   Run BBSee and select the File Import Option.
  2257.  
  2258.         5.   Enter the filename (wildcards are possible).
  2259.  
  2260.         6.   When you are  prompted to  Select a  BBS, moving  the cursor,  or
  2261.              selecting the first character, will scroll through valid options.
  2262.  
  2263.         7.   <Enter> to add files, <Esc> to abort
  2264.  
  2265.         8.   When the  file update  is complete  you are  free to  explore the
  2266.         program.
  2267.  
  2268.  
  2269.         Enjoy, and good luck!
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.                                        Page 35
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.                                   BBSee Version 2.0
  2291.  
  2292.         Chapter 9 Command line arguments
  2293.  
  2294.         1.   BBSEE [primary word [qualifier 1 [qualifier 2 [exception 1]]] ]
  2295.  
  2296.              This  will start word searches directly.  Blanks are not allowed,
  2297.              unless they are enclosed in quotes.
  2298.  
  2299.              ie BBSEE QMAIL
  2300.                   searches all filenames and descriptions with qmail in them
  2301.  
  2302.                  BBSEE QMAIL READ OFFLINE CIS
  2303.                   search all filenames and descriptions with qmail and  ( read
  2304.                   or offline) but not containing the string cis
  2305.  
  2306.         2.   BBSEE [-u [[drive:]directory]filename[ext] ]
  2307.  
  2308.              This option allows  for automatic updates  of Qmail packages,  if
  2309.              you have configured the Source/BBS name to be the same as that of
  2310.              your mail package.  The default extension is .QWK.
  2311.  
  2312.              ie.  BBSEE -u SYNAPSE    
  2313.                   update the master database  with files from the newfiles.dat
  2314.                   contained in synapse.qwk in the default mail directory.
  2315.  
  2316.                   BBSEE -U C:\MAIL\SYNAPSE.QWK
  2317.                   as above but override using the default mail directory.
  2318.  
  2319.  
  2320.         3.   BBSEE [-i [[drive:]directory]filespec Source ]
  2321.  
  2322.              This option allows for automatic importation of a file list using
  2323.              the corresponding source.
  2324.  
  2325.              ie.  BBSEE -I *.* SYNAPSE
  2326.                   update the  master database with all files  in the temporary
  2327.                   directory for the source SYNAPSE.
  2328.  
  2329.                   BBSEE -i D:\MYDIR\FILES.LST BBS1
  2330.                   update the  master database with descriptions  from the file
  2331.                   FILES.LST contained  in  directory D:\MYDIR  for the  source
  2332.                   BBS1.
  2333.  
  2334.         4.   BBSEE -4 directory
  2335.  
  2336.              This   option   creates  a   4DOS/NDOS   descript.ion   files  of
  2337.              'directory'.  See Section 7.2 for further information.
  2338.  
  2339.  
  2340.  
  2341.  
  2342.  
  2343.                                        Page 36
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.                                   BBSee Version 2.0
  2352.  
  2353.         5.   BBSEE -o source destination
  2354.  
  2355.              This option creates a BBSee description destination file based on
  2356.              the  filenames listed  in source.   See  Section 7.1  for further
  2357.              information.
  2358.  
  2359.         6.   BBSEE /A   or BBSEE /B
  2360.  
  2361.              These  options allow you to  catalog the indicated  disk from the
  2362.              command line.  These will allow cataloging in batch files.
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.  
  2386.  
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.                                        Page 37
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.                                   BBSee Version 2.0
  2413.  
  2414.         Appendix A     Registration Information
  2415.  
  2416.         I have tried to keep the price for the BBSee package  extremely low to
  2417.         encourage people to register.   At these low prices, if you  use BBSee
  2418.         there  should  be  no  reason  to  NOT  register.    I   plan  to  add
  2419.         functionality  which BBSee does not  yet have, however  this will only
  2420.         come  into  being with  your support.   The  pricing  for BBSee  is as
  2421.         follows:
  2422.  
  2423.         #1 $15.00 A license to use BBSee with a Registration Key.
  2424.         #2 $20.00 #1 plus a  floppy containing  any new  utilities and  import
  2425.                   functions,  a  program  to  install  the  Registration  Key,
  2426.                   support in use  of the product and notification  of upcoming
  2427.                   releases.
  2428.         #3 $25.00 #2 plus automatic delivery of version 3, whether I decide to
  2429.                   release it as shareware or not.
  2430.  
  2431.         Bank or postal money orders should be sent when possible.  Please make
  2432.         these out to Martin Vallevand.   If you send  me a cheque I will  wait
  2433.         for it to clear, before I mail out anything.  All orders must  be pre-
  2434.         paid.
  2435.  
  2436.         In Canada these  prices are  in Canadian dollars.   Ontario  residents
  2437.         also must include the 8% PST.
  2438.  
  2439.         All orders from outside of  Canada must be paid  in $US dollars.   The
  2440.         exchange difference will also be used to pay the difference in postage
  2441.         and applicable  taxes.  Money  orders are  preferred.  If  you send  a
  2442.         cheque, (on American banks only), add $5 to the appropriate cost. 
  2443.  
  2444.         These prices are subject to change at any time. 
  2445.  
  2446.         If you are the author of a useful shareware package, and you send me a
  2447.         copy  of your  product, registered  and licensed  in my  name,  I will
  2448.         either return your package, or more  likely, register you and send you
  2449.         the activation key to for BBSee.  Barterware?
  2450.  
  2451.         I can be reached at 
  2452.  
  2453.              Martin Vallevand
  2454.              Suite 100
  2455.              56 Fourth Avenue
  2456.              Ottawa, Ontario
  2457.              K1S 2L2
  2458.  
  2459.         for further  information on obtaining this package.  I am also open to
  2460.         suggestions  on methods of improving BBSee, by adding new functions or
  2461.         by enhancing existing methods.
  2462.  
  2463.  
  2464.  
  2465.                                        Page 38
  2466.  
  2467.  
  2468.  
  2469.  
  2470.  
  2471.  
  2472.  
  2473.                                   BBSee Version 2.0
  2474.  
  2475.         I  cannot respond to  letters or phone  calls from users  who have not
  2476.         opted for the  purchase of product support.    Also I  cannot return a
  2477.         disk forwarded to me with a BBS listing,  or other information, unless
  2478.         return CANADIAN postage is also enclosed.
  2479.  
  2480.         I  monitor  many shareware  related  conferences  on Smartnet,  Nanet,
  2481.         RelayNet,  and IntelecNet.  Although  I cannot guarantee  a reply, you
  2482.         may try to contact me through these networks.
  2483.  
  2484.         I  can also  be reached  at SYNAPSE  BBS.   This BBS  is an  excellent
  2485.         IBM-only PCBoard BBS located  in Gatineau, Quebec, (very  near Ottawa,
  2486.         the Capital of Canada).   The SYNAPSE BBS  Sysop, Daniel Coulombe  has
  2487.         graciously allowed  me  to use  his BBS  as a  'home' for  BBSee.   An
  2488.         account  has been set up for BBSEE USER with a password of VISITOR for
  2489.         the sole purpose  of downloading the  current BBSee files.   The phone
  2490.         numbers for Synapse BBS are:
  2491.  
  2492.         Area Code  ( 819 )
  2493.  
  2494.         561-5268  Node #1,           14.4K SupraFAXmodem 
  2495.         243-7179  Node #2,            9600 Compucom
  2496.         561-6745  Node #3,           16.8K bps HST Dual Std 
  2497.         243-0306  Node #4,#8          9600 Hayes 
  2498.         561-3740  Node #6,#7         14.4K HST 
  2499.         561-4321  Node #9,#5,#10,#14  9600 bps ATI 
  2500.         561-0950  Node #12,#11       14.4K bps HST Dual Std 
  2501.         561-4992  Node #13,#15        9600 CompuCom
  2502.         246-2344  Node #16            9600 GVC v.32 [for New Users ONLY]
  2503.  
  2504.  
  2505.         I  will attempt to maintain the  latest version of all BBSee shareware
  2506.         products on SYNAPSE BBS.  The format for the program archive filenames
  2507.         are BBSEE##A.ZIP and BBSEE##B.ZIP where ## is the version number.  The
  2508.         'Extra'  archive is  available as  BBSEE##X.ZIP, and  the 'Conversion'
  2509.         archive is available as BBSEE##C.ZIP.
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.  
  2518.  
  2519.  
  2520.  
  2521.  
  2522.  
  2523.  
  2524.  
  2525.  
  2526.                                        Page 39
  2527.  
  2528.  
  2529.  
  2530.  
  2531.  
  2532.  
  2533.  
  2534.                                   BBSee Version 2.0
  2535.  
  2536.         Appendix B     Program Return Codes
  2537.  
  2538.         0         Normal exit
  2539.  
  2540.         1         Not authorized
  2541.         2-6       Error in BBSEE.CFG
  2542.         7-10      Error in master database
  2543.         11-12     Error in deleted file database
  2544.         13-16     Error in floppy catalog database
  2545.         17        Not enough memory for BBSee
  2546.         18        Input file error
  2547.         19        Could not open add file
  2548.         20        Could not open error file
  2549.         21        Could not open download file
  2550.         22-23     Error on -u
  2551.         24        Could not open master database file for word search
  2552.         25        Could not open output catalog file
  2553.         26        Could not open cross reference file
  2554.         27        Index error - rebuild index
  2555.         28        Could not open upload file
  2556.         29        Could not open duplicate file
  2557.         30        Cannot run BBSee in its Shell.
  2558.         31        No NEWFILES.DAT or error in UNZIP in batch .qwk file
  2559.         32        Error on batch import option
  2560.         33-34     Error on -u
  2561.         35        BBS name not found
  2562.         36        Could not open floppy description file.
  2563.         37-39     Error on -i 
  2564.         40        Conversion error 
  2565.         41        Database add error
  2566.         42-43     Directory error in shell.
  2567.         44        Changed video returned to BBSee from shell.
  2568.         45        EMS error Search Word
  2569.         46        Error in the search temporary file.
  2570.         47        EMS error in Fill.
  2571.         50-52     Error in floppy catalog database
  2572.         53-60     Errors in volume database.
  2573.         61-64     Errors in archive database.
  2574.         65-66     Error in floppy catalog database
  2575.         67        Catalog duplicate file error.
  2576.         68        Error reading JPEG information.
  2577.         70        Volume database error.
  2578.         71-72     Error on -i -u
  2579.         73        Error on /a /b
  2580.         74-76     Error on -o -4
  2581.  
  2582.         The remedy for  many of these  errors will be  to increase the  FILES=
  2583.         statement in your CONFIG.SYS file.
  2584.  
  2585.  
  2586.  
  2587.                                        Page 40
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.                                   BBSee Version 2.0
  2596.  
  2597.         Appendix C     Cursor Movement and Editing Keys
  2598.  
  2599.                           Cursor Movement
  2600.                           ---------------
  2601.  
  2602.                   Arrow keys      - cursor movement
  2603.                   Ctrl-LeftArrow  - word left
  2604.                   Ctrl-RightArrow - word right
  2605.                   Home            - beginning of field
  2606.                   End             - end of line/field
  2607.                   Ctrl-Home       - beginning of first field
  2608.                   Ctrl-End        - end of last field
  2609.                   Tab             - next field
  2610.                   Shift-Tab       - previous field
  2611.  
  2612.                         Inserting and Deleting
  2613.                         ----------------------
  2614.  
  2615.                   Ins             - toggle insert mode
  2616.                   Del             - delete character at cursor
  2617.                   BackSpace       - delete character left
  2618.                   Ctrl-BackSpace  - delete word left
  2619.                   Ctrl-T          - delete word right
  2620.                   Ctrl-U          - delete to end of field
  2621.                   Ctrl-Y          - delete to end of form
  2622.  
  2623.                          Other Editing Keys
  2624.                          ------------------
  2625.  
  2626.                   Enter           - process current field
  2627.                   Ctrl-Enter      - process all fields
  2628.                   Ctrl-R          - restore field
  2629.                   Esc             - abort data entry
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.                                        Page 41
  2649.  
  2650.  
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.                                   BBSee Version 2.0
  2657.  
  2658.         Appendix D     Mouse Support.
  2659.  
  2660.         Full mouse support  is available in BBSee, and it  is configured ON by
  2661.         default.    Should you  wish, it  can be  disabled  in BBSetup  in the
  2662.         Hardware  option.   Basic  operation is  that  the right  mouse button
  2663.         operates like the  <Esc> key and the  left mouse button  operates like
  2664.         the <Enter> key.   I will refer to a left mouse hit  as a 'click'.  If
  2665.         you don't  like the fixed  mouse arrow, it  can be turned off  (to the
  2666.         standard DOS block mouse).
  2667.  
  2668.         1.0  General Menu and option selection.
  2669.  
  2670.              For  navigation  within  the   basic  BBSee  menu  structure  and
  2671.              selection boxes, simply point the mouse block cursor at an option
  2672.              and click.  
  2673.  
  2674.              The  arrow up and down  keys on the  right hand side  of a window
  2675.              border can  be used  to scroll  a window if  the mouse  cursor is
  2676.              clicked on them.
  2677.  
  2678.         2.0  Advanced mouse use.
  2679.  
  2680.         2.1  File Manager.
  2681.  
  2682.              The File Manager is made up of two distinct windows for the mouse
  2683.              to select from.  There is the directory window of  filenames, and
  2684.              the command window with the possible commands.
  2685.  
  2686.              Selecting a file within the directory window by a point-and-shoot
  2687.              selection will  activate the currently highlighted  action in the
  2688.              command  window.  This default  action can be  changed by placing
  2689.              the mouse on  the 'Action  Command' line and  clicking, and  then
  2690.              making   the   actual   selection   of   the   default   command.
  2691.              Alternatively  you   can  manually  hit  the   <Tab>  or  <Slash>
  2692.              characters to open the Action window.
  2693.  
  2694.              You  can also  use  the  mouse  to select  the  option  you  want
  2695.              performed by clicking  on the appropriate  option in the  command
  2696.              window.  You may have to use the 'normal' cursor to highlight the
  2697.              appropriate filename first.
  2698.  
  2699.         2.2  Search Word.
  2700.  
  2701.              Moving  the filename cursor within  the search window  is done by
  2702.              clicking  the mouse on any element of  a file or its description.
  2703.              Clicking  an already highlighted file will toggle the tag of that
  2704.              filename.
  2705.  
  2706.         2.3  Search Filename
  2707.  
  2708.  
  2709.                                        Page 42
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715.  
  2716.  
  2717.                                   BBSee Version 2.0
  2718.  
  2719.              Clicking when this window  is active will toggle the tagging of a
  2720.              filename.
  2721.  
  2722.         2.4  View Catalog/List Catalog/List Archive
  2723.  
  2724.              Clicking on a volume  will bring up a list  of all files on  that
  2725.              volume.     Clicking  on  a  filename  line  will  bring  up  the
  2726.              description of that file.  If you  click on the left border of  a
  2727.              line, archive contents or  graphic resolution information will be
  2728.              displayed if available.
  2729.  
  2730.         2.5  View Tags.
  2731.  
  2732.              Clicking on the filename will toggle a tag of a filename.
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770.                                        Page 43
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.                                   BBSee Version 2.0
  2779.  
  2780.         Appendix E     Import Usage
  2781.  
  2782.         Attempting to import file description lists into BBSee that are not in
  2783.         PCBoard format,  can cause a  lot of  problems.  To  overcome some  of
  2784.         these problems, a utility program, IMPORT.EXE is included in the BBSee
  2785.         package to assist in the import process.  The function of this program
  2786.         is to  convert files into a  usable PCBoard-like data structure.   All
  2787.         non-PCBoard files should  be converted with  this program, before  you
  2788.         attempt to import them into BBSee.
  2789.  
  2790.         The primary syntax to the IMPORT program is:
  2791.  
  2792.         IMPORT {sourcename} {destname} PDM
  2793.  
  2794.         P    directs the number of passes that  IMPORT makes on the file.  The
  2795.              choice  is  1 or  2.   Some BBS  listings  require two  passes to
  2796.              eliminate CR/LF, and  Formfeed problems.   2 passes are  required
  2797.              for most Wildcat BBS lists.
  2798.  
  2799.              A  special parameter C (for  Caution!) is available  which can be
  2800.              used for some  BBS's which  have the description  on the  line(s)
  2801.              following the filename, but not directly under the initial line. 
  2802.              Files  created with this option should be reviewed to ensure that
  2803.              the descriptions created are what you expect.
  2804.  
  2805.         D    directs the date  determination of  the import,   Y indicates  to
  2806.              IMPORT to swap the day and month fields  (ie the format is MM-DD-
  2807.              YY), N indicates not to  swap the day and month, and  C indicates
  2808.              to check for the date format.  Of course if all days are < 13 the
  2809.              check will indicate not to swap the day and month.
  2810.  
  2811.              If your BBS  uses the  international YY-MM-DD format,  use the  R
  2812.              (for  reverse option).   The C  option can identify  this type as
  2813.              well.
  2814.  
  2815.         M    directs the mode of the import.  IMPORT will automatically try to
  2816.              (the  A option) determine the appropriate columns that it uses in
  2817.              the import process.  You can override this if automatic mode does
  2818.              not  produce a  workable  PCBoard-like listing,  by  using the  M
  2819.              (manual)  option.   This mode  will allow  you to  manually enter
  2820.              column details for  various fields.  The filename and description
  2821.              fields  must be  entered, if  the size  and/or date  are missing,
  2822.              indicate  this  by  entering 0  for  the  start  and stop  column
  2823.              locations.  
  2824.  
  2825.              In  using  manual  mode, step  through  the  file  using the  Get
  2826.              Filename  key,  and  then  modify  the various  fields  that  you
  2827.              require.  If a file date or size does not exist, enter 0 for both
  2828.              the  start and  end columns of  the field.   If the BBS  uses a K
  2829.              indicator include it within the filesize.
  2830.  
  2831.                                        Page 44
  2832.  
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.                                   BBSee Version 2.0
  2840.  
  2841.         The default if the PDM options are omitted is   2CA
  2842.  
  2843.         If  the automatic  mode of  IMPORT works  with your  description list,
  2844.         BBSee  can also perform the automatic conversion.  Use AUT (automatic)
  2845.         in the BBSetup  for the appropriate  BBS, and enter  the pd (pass  and
  2846.         date) parameters  as determined  above.  When  in doubt use  IMPORT to
  2847.         convert the file, and review it  before importing into BBSee, to avoid
  2848.         entering incorrect entries in  the database.  I do not  recommend that
  2849.         you use  the Caution mode as  the pass type, unless you  are very sure
  2850.         that it works with your BBS list regularly.
  2851.  
  2852.         You should also attempt to use one pass mode if you find that two pass
  2853.         mode is successful.  For many Wildcat! types this is not possible (due
  2854.         to the many differences available).
  2855.  
  2856.         Four other import modes exist within IMPORT.
  2857.  
  2858.         a.   IMPORT {sourcename} {destname} XPC
  2859.  
  2860.         This format is used to create a PCBoard file from  the XFER5K.TXT file
  2861.         available on EXEC-PC.
  2862.  
  2863.         b.   IMPORT {sourcename} {destname} MIN
  2864.  
  2865.         This mode can be used to compress a PCBoard file if there are a lot of
  2866.         spaces  and carriage  returns within  a description.   Some  BBS's and
  2867.         files created by IMPORT require this, if you want to capture more than
  2868.         11 lines of description within BBSee.
  2869.  
  2870.         c.   IMPORT {sourcename} {destname} WC3
  2871.              IMPORT {sourcename} {destname} WCF
  2872.  
  2873.         These two options create output from specific file lists from two type
  2874.         of Wildcat listings.
  2875.  
  2876.         If  you have  a  BBS listing  from  a  major BBS  that  does not  work
  2877.         automatically with IMPORT I would very much appreciate it if you would
  2878.         send me a disk, containing a sample, and I will attempt to incorporate
  2879.         its  structure  into  the  automatic  import.    See  Appendix  A  for
  2880.         information on contacting me.
  2881.  
  2882.         Other  utilities for  file conversion  may be  included on  the extras
  2883.         disk.  See the README.2ND file.
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.                                        Page 45
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.                                   BBSee Version 2.0
  2901.  
  2902.         Appendix F     Database Packing
  2903.  
  2904.         Most  database packages, do not actually delete files from a database,
  2905.         they  simply mark the  files for deletion.   The BBSee  database is no
  2906.         exception.   To  reclaim  this space  it  is necessary  to  'pack' the
  2907.         database.  In addition  to reclaiming disk space, (vis-a-vis  a random
  2908.         un-packed  database), the  packed file  is maintained  in alphabetical
  2909.         order.  Due to the nature of the BBSee database,  an undelete feature,
  2910.         before unpacking, is not possible.
  2911.  
  2912.         To pack the BBSee master database, run the program PACBBSEE at the DOS
  2913.         prompt, in a BBSee  directory.  PACBBSEE will read your BBSEE.CFG file
  2914.         and automatically  pack  the master  database.   During  the  PACBBSee
  2915.         operation, a record count will be displayed on the screen.
  2916.  
  2917.         Note  that to use  this program, a  new file is  actually created, and
  2918.         your old  file is maintained, in  case a problem is  encountered.  You
  2919.         will  therefore require  disk  space equal  to  that of  you  original
  2920.         database and index  to complete  the database  pack.   Because of  the
  2921.         extensive  hard  disk  activity  required,  this process  can  take  a
  2922.         considerable amount of time.  It  is not essential to the operation of
  2923.         BBSee,  and disk  savings can usually  only be achieved  after a large
  2924.         number of imports.   I would pack  the database after the  all of your
  2925.         bbs allfiles listings are included.
  2926.  
  2927.         There  is also a  command line option  (-c) to only pack  files in the
  2928.         floppy databases.  
  2929.  
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.                                        Page 46
  2954.  
  2955.  
  2956.  
  2957.  
  2958.  
  2959.  
  2960.  
  2961.                                   BBSee Version 2.0
  2962.  
  2963.         Appendix G     Deleted File List Maintenance
  2964.  
  2965.         Filenames  that you delete  from the master  database are  added to an
  2966.         index file (the  .DEL file) so that they are not added to the database
  2967.         again.  At times you may wish to  review your deleted files, and allow
  2968.         certain  deleted files  to  be added  as  your computing  requirements
  2969.         change.  To do this, the following steps should be followed.
  2970.  
  2971.         Step 1.
  2972.  
  2973.         The first step is to create an ASCII file of your present .DEL file.
  2974.         The program READDEL.EXE will read your present .DEL file and output it
  2975.         to standard output.  The format to view the file on the screen is
  2976.         READDEL  {master delete file}  To trap standard output to a file it is
  2977.         necessary  to  use the  DOS  redirect command.    The  syntax for  the
  2978.         redirect of READDEL is:
  2979.  
  2980.              READDEL {master delete file} > {filename}
  2981.  
  2982.         Care should be taken here as DOS does not prevent you from overwriting
  2983.         a file on a redirect.
  2984.  
  2985.         This program  can be used to  view the deleted file  list by reviewing
  2986.         the above file, or omitting the > filename.
  2987.  
  2988.         Step 2.
  2989.  
  2990.         The second step in editing the .DEL is to use an ASCII text editor on
  2991.         the filename output in the previous step.  Remove all the lines
  2992.         containing filenames that you  no longer wish excluded.  You  can also
  2993.         add
  2994.         filenames to this file at this point, that will cause the entered
  2995.         filenames to be removed from the master database in the next step.
  2996.  
  2997.         Ensure  that you use DOS  naming rules when  entering these filenames,
  2998.         and
  2999.         do not add a trailing dot.  DO NOT include the following extensions if
  3000.         you are manually entering filenames.
  3001.  
  3002.            ZIP, PAK, COM, LZH, EXE, ARC, SDN, GIF, ARJ, TXT,
  3003.            DOC, ZOO, BAT,  and SYS
  3004.          
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.                                        Page 47
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.                                   BBSee Version 2.0
  3023.  
  3024.         Step 3.
  3025.  
  3026.         The third step is to write a new .DEL file using the WRITEDEL.EXE
  3027.         program.  This program, will read the list that you have edited above,
  3028.         delete records from the master database if necessary, and create a new
  3029.         .DEL file.  The syntax for use of this program is:
  3030.  
  3031.              WRITEDEL {input file} {output file}
  3032.  
  3033.         The output file is  the name of you master .DB  and .DEL files without
  3034.         an extension.  It will not overwrite your present .DEL file.  You must
  3035.         first delete (or rename) the appropriate  .DEL file.  If you don't run
  3036.         this program from your database directory, ensure that the output file
  3037.         includes the proper sub-directory information.
  3038.  
  3039.         WRITEDEL  will check to  see if the  input file is  in the appropriate
  3040.         format.  This checking is not all inclusive so be careful.
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.  
  3050.  
  3051.  
  3052.  
  3053.  
  3054.  
  3055.  
  3056.  
  3057.  
  3058.  
  3059.  
  3060.  
  3061.  
  3062.  
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  
  3073.  
  3074.  
  3075.                                        Page 48
  3076.  
  3077.  
  3078.  
  3079.  
  3080.  
  3081.  
  3082.  
  3083.                                   BBSee Version 2.0
  3084.  
  3085.         Appendix H     Robocomm download support.
  3086.  
  3087.         Support  in  BBSee for  Robocomm 4.1  depends  on an  external program
  3088.         2ROBO.EXE which  directly access the Robocomm  Clipper database files,
  3089.         rather then intermediate files like the other supported automaters.  I
  3090.         would  prefer that BBSee remain independent of other program files but
  3091.         no other approach appears to work.  To use 2ROBO 
  3092.  
  3093.              Setup:
  3094.  
  3095.              1.   Copy 2ROBO.EXE to your Robocomm directory.
  3096.              2.   Configure  the tag facility in BBSetup, to have the Tag File
  3097.                   Destination directory to be the Robocomm directory.
  3098.              3.   Use .DLR as the download file tag extension in BBSetup.
  3099.              4.   Configure Robocomm as the automater type.          
  3100.              5.   Ensure that  the BBS name  you configure in  BBSetup matches
  3101.                   the one you use in Robocomm.
  3102.  
  3103.              Running the program.
  3104.  
  3105.              The syntax to run the program is
  3106.  
  3107.                   2ROBO agenda bbsname
  3108.  
  3109.              Program notes.
  3110.  
  3111.              -    If the agenda is not found, it will be added.
  3112.              -    All the files in BBSNAME.DLR will be inserted in the agenda,
  3113.                   after any old items.
  3114.              -    The file BBSNAME.DLR will be deleted.  
  3115.              -    You should  not  run 2ROBO  until  just before  running  the
  3116.                   agenda,  as BBSee will check for duplicates in the DLR file,
  3117.                   not the agenda.
  3118.  
  3119.         I will try to add extra support for Robocomm based on REGISTERED users
  3120.         requests.   I would also ask  that Robocomm users try  to persuade the
  3121.         Robocomm  author (Dan  Parsons), to  allow an  independent up/download
  3122.         file mechanism which would provide better portability between Robocomm
  3123.         and specialized programs like BBSee.
  3124.  
  3125.  
  3126.  
  3127.  
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.  
  3134.  
  3135.  
  3136.                                        Page 49
  3137.