home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbs / bbsee21c.zip / CONVERT.DOC < prev    next >
Text File  |  1992-06-28  |  7KB  |  159 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                      BBSee Catalog Database Conversion Utilities.
  10.  
  11.           1.   CONVERT.EXE
  12.  
  13.           The  layout of the catalog  file database has  changed with BBSee
  14.           version 2.0.  There are now three files, the catalog, archive and
  15.           volume  files  within  the catalog  database.    If  you have  an
  16.           existing BBSee version database you must perform a two step semi-
  17.           automatic conversion if you wish you  continue to use the new and
  18.           improved version.
  19.  
  20.                                       Step One.
  21.  
  22.           The first step  of the conversion is to create  the new files for
  23.           the  catalog  and  archive  contents, and  import  your  existing
  24.           catalog database information.   To initiate  this step, from  the
  25.           sub-directory where you have bbsee.cfg, execute the command 
  26.  
  27.           CONVERT /INITIAL
  28.  
  29.           This process creates  two intermediate files needed  in step two,
  30.           the new catalog files  temporarily named newcat.db and newcat.idx
  31.           and a file called BBSEE.CVT.
  32.  
  33.           BBSEE.CVT  is a file that  contains information for  later use in
  34.           CONVERT.   It is important  that you  change the first  letter of
  35.           each line  of this file to  match the drive where  you would have
  36.           cataloged  the specified volume. (This is required, if you are to
  37.           ever  wish to  use BBSee's  automated extract and  copy features.
  38.           Refer to BBSee's documentation for further information).  BE SURE
  39.           that the editor  you use to change the BBSEE.CVT  does not change
  40.           anything  but the first letter, (some place tab characters in the
  41.           file without you even knowing).
  42.  
  43.                                       Step Two.
  44.  
  45.           Once  you are satisfied with the BBSEE.CVT file, start the second
  46.           pass with the command
  47.  
  48.           CONVERT /VOLUME.
  49.  
  50.           This pass reads  the BBSEE.CVT  file and creates  the new  volume
  51.           database.   On  successful  exit, CONVERT  deletes its  temporary
  52.           files, and you should be ready to run BBSee Version 2.
  53.  
  54.           Note  that the  conversion process  keeps a  backup copy  of your
  55.           existing  file, at  the end  of pass  two, named  BACKCAT(.db and
  56.           .idx).   Once  you are  satisfied that  BBSee 2.0  is functioning
  57.           properly you can delete these files.  If you wish  you can backup
  58.           the catalog.db  and  idx  file(s)  that you  use  before  running
  59.           CONVERT.  The  conversion does not modify the  master description
  60.           database so these do not need to be backed up.
  61.  
  62.           If you use more than one catalog file that are stored in the same
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.           directory, you will need to individually and manually change  the
  71.           archives and volume filenames after the conversion.
  72.  
  73.           Note that  the DOS serial number  is not incorporated in  the old
  74.           file structure.   If you use  DOS 4.0 or  higher and the disk  do
  75.           actually  have a DOS serial number, during recatalog of converted
  76.           disks,  you will be notified  that the serial  number for the old
  77.           disk don't  match.   You will  need to  uncatalog  followed by  a
  78.           catalog to correct this situation.
  79.  
  80.           2.   CDISKCON.EXE
  81.  
  82.           The  purpose  of  this  program  is to  convert  CatDisk  catalog
  83.           databases to a format which can be used by BBSee.  The syntax for
  84.           the program is 
  85.  
  86.           CDISKCON database
  87.  
  88.           where  database is  your  CatDisk database  name (no  extension).
  89.           Note  that  CDISKCON will  first scan  the  volume labels  in the
  90.           BBSee and CatDisk databases to make sure there are no duplicates.
  91.  
  92.           For this  program to work  you should ensure  that a copy  of the
  93.           BBSEE.CFG  file  you  will  be  using  is  located  your  current
  94.           directory.
  95.  
  96.           Note that  when  you use  this conversion  certain features,  (ie
  97.           eXtract, Copy,  and View) will not work  because disk information
  98.           is missing.  As well you will need (if you use DOS 4.0 or higher)
  99.           to uncatalog and catalog on all cataloged disks, because the disk
  100.           serial number is missing.
  101.  
  102.           3.   ICATCON.EXE
  103.  
  104.           The  purpose of  this  program is  to  convert Intelicat  catalog
  105.           databases to a format which can be used by BBSee.  The syntax for
  106.           the program is 
  107.  
  108.           ICATCON database
  109.  
  110.           where database  is your  Intelicat database name  (no extension).
  111.           Note that ICATCON will quit if  it finds duplicate entries in you
  112.           Intelicat and BBSee databases.
  113.  
  114.           For  this program to  work you should  ensure that a  copy of the
  115.           BBSEE.CFG  file  you  will  be  using  is  located  your  current
  116.           directory.
  117.  
  118.           Note  that  when you  use this  conversion certain  features, (ie
  119.           eXtract,  Copy, and View) will not  work because disk information
  120.           is missing.  As well you will need (if you use DOS 4.0 or higher)
  121.           to uncatalog and catalog on all cataloged disks, because the disk
  122.           serial number is missing.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.           4.   DTCON.EXE
  131.  
  132.           The  purpose of  this program  is to  convert DiskTrak  7 catalog
  133.           databases to a format which can be used by BBSee.  The syntax for
  134.           the program is 
  135.  
  136.           DTCON database
  137.  
  138.           where  database is  your DiskTrak  database name  (no extension).
  139.           Note that DTCON  will quit if it  finds duplicate entries in  you
  140.           Intelicat and BBSee databases.
  141.  
  142.           For this program  to work you  should ensure that  a copy of  the
  143.           BBSEE.CFG  file  you  will  be  using  is  located  your  current
  144.           directory.
  145.  
  146.           Note  that when  you use  this conversion  certain features,  (ie
  147.           eXtract, Copy, and View) will  not work because disk  information
  148.           is missing.  File date and  size information is not available  in
  149.           the DT7  database.  As well you will need  (if you use DOS 4.0 or
  150.           higher) to uncatalog and catalog  on all cataloged disks, because
  151.           the disk serial number is missing.
  152.  
  153.           5.   FIXGIF.EXE
  154.  
  155.           This program is  designed to correct a bug caused  by the initial
  156.           BBSee version  1  to version  2  convertion.   If  you  used  the
  157.           previous CONVERT.EXE program, running FIXGIF should correctly re-
  158.           initialize the converted GIF resolution field.  
  159.