home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / CEL141.ZIP / CEL141C.ZIP / FILE17B.ZIP / FILE17B.DOC next >
Text File  |  1992-07-05  |  22KB  |  464 lines

  1.  --------------------------------------------
  2.  Celerity v1.39 - v1.40 File Base Editor v1.7 BETA
  3.  Written by: Sicko
  4.  --------------------------------------------
  5.  
  6.   If you are updating, its a good idea to read the last page or so of this
  7.    file to see whats new and then rescan the top-mid sections.
  8.  
  9.   Heres another stupid Celerity utility.
  10.  
  11.  Disclaimer: It works for me. But if it doesn't work for you don't cry to
  12.               me. Back-up before you run any utility like this.
  13.  
  14.  Features & Functions:
  15.  
  16. o Scroll-box/windowed displays.
  17. o Can access all 5 conferences and any file area within that conference.
  18. o View & Edit all fields of a File.
  19. o Files can be listed in 1 of 3 formats (changed on the fly).
  20. o Tag multiple files.
  21. o Move files between file areas and between conferences.
  22. o Delete files, both from Celerity and the actual DOS file (Tagged and
  23.     Duplicate).
  24. o Tag areas and have all OFFLINE files within those areas moved to
  25.    another area and/or conference.
  26. o During moves, Duplicates are tagged with a '*' and you may act apon those
  27.    files.
  28. o Viewing of ZIP & ARJ files.
  29. o Viewing of files with ZIP files.
  30. o Viewing of ASCII files.
  31. o Adding "blank/new" files, ie files that are not physically on the disk.
  32.    (Saves previous info for faster data entry).
  33. o Adding OFFLINE-files, a scroll-box with all the files that are not in
  34.    celerity is displayed and thencan be tagged and added to celerity.
  35. o Use of a "MASTER" list that will be searched for the dos file name,
  36.    locate the description (as best as possible) and use that as the
  37.    description when the file is added. (Makes adding large quantity of
  38.    files alot easier, ie tape trades).
  39. o Alot of error checking so that files are not lost.
  40. o If you use file points, it will calculate the number of file points
  41.    and automatically insert that number when you add new files.
  42. o You can now add all the files contained within the INFILES.DAT file
  43.    to Celerity, even if the files do not exist on the drive. This is
  44.    a good feature to use if you are converting from another BBS package
  45.    to Celerity and want to import all those "offline" files.
  46. o Mass addition of files into celerity that are not currently in 
  47.    Celerity. Those that do not find a matching filename within the
  48.    INFILES.DAT file are not added.
  49. o The parsing of the INFILES.DAT file can be configured to be "BEST FIND"
  50.    or you can define what columns the description and filename start in.
  51.  
  52.                                    -=-
  53.  
  54. Some Editing Tips: (this also goes for the user base editor I wrote)
  55.           Ctrl-Y : will erase the contents of the current field.
  56.           Insert : will toggle insert/over-write mode for that screen and
  57.                     following screens
  58.       Ctrl-Enter : Save current screen (file/user) and go to next.
  59.              ESC : Do not save current screen and exit.
  60.         Page-Dwn : Save current screen go to next (go to next depends on prog)
  61.          Page-Up : Save current screen go to previrous (            "        )
  62.  TAB / Shift TAB : Move from field to field
  63.           Arrows :            "
  64.         On Menus : Press the Number and it will goto the number
  65.  
  66.                                    -=-
  67.  
  68.  This here utility will allow you to edit all the file attributes in Celerity.
  69.  It will display the 5 conferences and ask you to pick one, if there are no
  70.  file areas in that conferece it will tell you so, if there are it will list
  71.  the file base areas for you to choose from. After you pick the file area it
  72.  display a scroll-box with the dos filename and description. (This may take
  73.  a few seconds/minutes depending on your machine and the number of files).
  74.  Now you can choose the file you want to edit. It will bring up the file, and
  75.  all its specs. You can Page-up & Page-Down through the directory, so you can
  76.  edit files faster. I made the cursor default to the description, since I
  77.  figured most sysops would use this utility to do that.
  78.  
  79.  This utility might come in handy for sysops that do tape trades and add
  80.  large quantities of files at a time. The idea is:
  81.  
  82.         1. Use this Utility (to add the files and pull the descriptions
  83.             from an ASCII list).
  84.  
  85.   You can move files between areas and between conferences. You can 
  86.   clean-up areas by moving all offline files into one area. You may delete
  87.   files from an area.
  88.  
  89.   Moving Files: Choose the conference, then choose the area, tag the files
  90.    you want to move with the TAB key, press the INSERT key, now pick the
  91.    conference and then the area you want to move the files to. The file
  92.    records will be moved to the new area, the dos file will be copied,
  93.    the path in the file record will be upadted, and then the old file
  94.    deleted.
  95.  
  96.    Note: You may not move files to the same area where they came from. If
  97.          a file exists in the destination directory it will tell you and
  98.          will NOT copy the files & will ask you to pick another area.
  99.          Offline files will be moved and reported to you that they do not
  100.          exists. The path names of the files will be updated in Celerity
  101.          to reflect the path of the area moved to.
  102.  
  103.          You can flip between the 3 display types.
  104.  
  105.   Cleaning-Up Dirs: Choose the Conference, the tag the areas to clean-up
  106.          with the TAB key, press the INSERT key, choose the destination
  107.          conference then choose the destination area. It will scan all the
  108.          picked areas for offline files and move them to the destination
  109.          dir (and update the path too, why?, why not.)
  110.  
  111.   Deleting Files: Just tag the files you want to delete, and press DEL, it
  112.          will ask you if you want to delete the celerity records, then
  113.          it will ask you if wish to delete the dos files too. If you answer
  114.          NO to the first question it will do nothing.
  115.  
  116.  
  117.   Adding OFFLINE files: Pick the conference and the area, press the key
  118.          that is associated with Add files (look at the bottom of the sceen)
  119.          and it displays a blank file entry screen. Add the neccessary info,
  120.          (ITS BEST TO ADD ALL THEN INFORMATION - DO NOT LEAVE key fields
  121.           blank, ie DOS NAME, size, uploader, stuff like that)
  122.          You can press Ctrl-Enter or page-down/page-up to get to the next
  123.          entry. The current data will be displayed for the next file, so
  124.          you may enter multiple file programs quickly.
  125.  
  126.          command : press [ from the pick area menu
  127.  
  128.    Adding files that are in the directory: You can add files that
  129.          are not listed in celerity but are on the disk now, this will
  130.          take some time as I have to check each file against the celerity
  131.          data file. Currently it will list all the files that it does not
  132.          find a match for in celerity and then you may tag the ones you
  133.          want and then added them (you have to enter most of the info for
  134.          them).
  135.  
  136.          command : press . from the pick area menu
  137.  
  138.    Mass Adding Files : press [DEL] on the area that you want to add these
  139.         files to, it will search the associate directory for all files
  140.         that are not in the area's list, then it will scan the infiles.dat
  141.         file, if it finds a matching filename it will add the file. It 
  142.         will report the number of files added and not added.
  143.  
  144.    Mass Adding of OFFLINE Files : Press ` and it will add ALL THE FILES
  145.        in the INFILES.DAT file to the associated directory. You MUST have
  146.        specified that you will use a FIXED FORMAT INFILES.DAT FILE. (look
  147.        at end of docs for more info on fixed format)
  148.  
  149.    If a file called infiles.dat exists in the current directory it will scan
  150.    the file for the dos file name and if found use the description found
  151.    as the description, saves you some typing.
  152.  
  153.  
  154. The Logic behind all the moves is as follows:
  155.  
  156.         1. Check drive space and see if a file already exists on the
  157.                 destination dir. If either true stop with error message.
  158.            a. If file can be moved via FAT move, then do not include
  159.                 that file in the disk free check.
  160.         2. Move Celerity records to destintion area.
  161.         3. Move DOS Files to destination area.
  162.         4. Delete DOS Files in source area.
  163.         4. Delete Records in source area.
  164.  
  165.  
  166.  
  167. Limits:
  168.  
  169.    50 File base areas per conference.
  170.  5000 Files per area.
  171.  I create a temporary file in the current directory that contains some
  172.   information, and you will see disk access as you scroll through the
  173.   various lists, this file is deleted after exiting. The filename that
  174.   is used is : "filer.sic"
  175.  
  176. NETWORKS:
  177.  
  178.  I've used this utility while 3 people have been online, and so far no
  179.  problems. I'm running Novell 3.11 so I have not tested it with LANtastics,
  180.  Desqview, or NETLite.
  181.  
  182.  I've noticed if I'm moving stuff on one node, while someone else is listing
  183.  the same base on another node, it will leave a bunch of blank records,
  184.  these can just be deleted. No harm is done to the bases.
  185.  
  186.                 -Sicko
  187.  
  188.    You can contact me via: -Private Celerity Net-Mail
  189.                            -Any of the Celerity Sysop Message Bases
  190.                            -on The BoG
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  History:
  197.  
  198.         4/19/92 - Version 1.0
  199.  
  200.         4/28/92 - Version 1.1
  201.            Fixed the problem of the file scroll box descriptions and file
  202.              names not being updated.
  203.  
  204.            Added Moving between conferences, Offline Clean-up, and File
  205.              deletion. Added more status messages and displays.
  206.  
  207.  4/29 - 5/10/92 - Version 1.2
  208.         a. Fixed some of the status messages, added more messages.
  209.         b. You may now add files that are not physically on the drive.
  210.         c. Rewrote the moving logic to handle FAT moves, I still check
  211.            each file being moved to see if there is enough space on the
  212.            disk, because I don't know if all the files being moved are
  213.            in the same directory/drive.
  214.            Again we, check to see if any of the files exist in the
  215.            destination dir and if so, we tell you.
  216.         d. You can now flip between 3 possible file listings, the dos
  217.            file name, the description & (date uploaded, or, size, or
  218.            number of disks)
  219.         E. Fixed a problem with FAT moving files that do not exist.
  220.         F. Fixed a problem of not closing a file, this caused a runtime
  221.             error after five or so moves.
  222.  
  223.  5/11-5/?? - Version 1.3
  224.         A. When you moved files to a different conference, the area
  225.            descriptions where displaying the areas from the source
  226.            conference, this has been fixed.
  227.         B. The check diskspace routine was comparing Bytes against
  228.            KBytes, fixed.
  229.  
  230.  5/15/92 - Version 1.3
  231.         A. Added offline file addition, this one checks each file in the
  232.            directory against the celerity dir data file and if there
  233.            is no entry it adds it to the list of files. This list of files
  234.            is displayed and you may tag the files you want to add and
  235.            then add them.
  236.  
  237.  5/19/92 - Version 1.4b
  238.         A. Fixed some display routines that were being over written.
  239.         B. You could not tag areas to be marked for offline file moving.
  240.         C. Bulls Won, Hawks Won.
  241.  
  242.  5/20/92
  243. Some Editing Tips: (this also goes for the user base editor I wrote)
  244.           Ctrl-Y : will erase the contents of the current field.
  245.           Insert : will toggle insert/over-write mode for that screen and
  246.                     following screens
  247.       Ctrl-Enter : Save current screen (file/user) and go to next.
  248.              ESC : Do not save current screen and exit.
  249.         Page-Dwn : Save current screen go to next (go to next depends on prog)
  250.          Page-Up : Save current screen go to previrous (            "        )
  251.  TAB / Shift TAB : Move from field to field
  252.           Arrows :            "
  253.  
  254.         A. I fixed more displays, made it look a little nicer.
  255.         B. If you move files to an area where 1 or more of the dosfiles
  256.             already exists, it still tells you that they exists and tells
  257.             you that you can pick another area to move "ALL" the files to
  258.             or you can press ESC and go back 1 menu to choose another
  259.             conference, and/or press ESC again to get back to the current
  260.             file area and all the files that were duplicates on the
  261.             destination dir will be marked with a "*".
  262.         C.  When you press DEL from the pick file list(menu) it will ask
  263.             you if you wish to delete duplicate files, marked with a "*",
  264.             then it will ask you if you want to delete tagged files, marked
  265.             with a "[" and a "]". It will then ask you if you wish to
  266.             delete the Celerity Records, if you answer no here it will
  267.             not delete anything and return you to the pick files menu. If
  268.             you answer "YES" it will ask you if you want to delete the
  269.             DOS files and will do so as you ask.
  270.  
  271.  
  272.         D. Added a feature that if a file called "infiles.dat" exists in the
  273.            default dir, which happens to be the dir you run filedtxx from,
  274.            which also happens to be your data directory, it will use this
  275.            file in the add new files process. If you add files that exist,
  276.            but not in celerity ("." command) it will scan infiles.dat for
  277.            the DOS filename minus the extension and if it finds a match
  278.            will scan the rest of the line and grab a 44 char description
  279.            and use it.
  280.  
  281.        THE FILE NAME AND EXTENSION SHOULD/MUST BE IN THE FIRST 25 CHARS!
  282.  
  283.  
  284.            The position of the filename and extenstion and description are
  285.            not important but the SEQUENCE is. There can be spaces between
  286.            the filename and the extension. 
  287.  
  288.            It will use the first DOS filename that matches, and if there
  289.            is no match it will use the description for the last file.
  290.  
  291.  
  292.         OK, this is what I've done:
  293.         1. I do a search to find the filename
  294.         2. when its found, I parse until I find a "." or the 25th char.
  295.         3. If I find a "." I skip 4 characers to skip any extension.
  296.         4. I parse until I get a character AFTER A SPACE, this takes
  297.         case of LSDs file listing of having the filesize with a k after it.
  298.         I did this cause most listings are like
  299.  
  300. Filename  Date  Size  Descritpion
  301.  
  302.         and since date and size are all BUT letters, I have just did a search
  303.         until I found a letter following a SPACE. Then I grab the next 44
  304.         characters as the description. This does no cover the "Resv", "Free",
  305.         whatever that can happen with celerity & LSD.
  306.  
  307.  
  308.         E. You can now view zip/arj files, just have the highlight bar on the
  309.            file you want to view and press ".". The draw back here is that
  310.            it has to rescan the directory when done, something that can not
  311.            be helped at this point.
  312.  
  313.         Note: If you want support for more archive formats tell me.
  314.  
  315.  
  316.         F. Increased the number of files per area to 5000 (one of my bases
  317.            went over 3000)
  318.  
  319. 6/1/92  G. Updated the search routines for infiles.dat to be more forgiving
  320.            and locate the description better. It works best when there is
  321.            no ansi, ie you select NO EMULATION when your on bbs's.
  322.  
  323.         H. Cleaned-up some pauses that were accidently left in v1.4, ie when
  324.            you move files you had to press a key for it to move them.
  325.  
  326.         I. If you move files and they exists or don't exist, it lists them
  327.            out, then it will wait for a key press before it moves them
  328.            so that you can see what files were noted. Same goes for offline
  329.            moves.
  330.  
  331.         J. Its summer time, and unless someone has a GREAT suggestion, I'm
  332.            gonna go outside and "play".
  333.  
  334.  
  335. 6/6/92 v1.6 (ok, theres been some bad weather)
  336.  
  337.         A. Someone asked for the file points to be automatically inserted
  338.            when adding files, DONE. There is now a required FILEBASE.DAT
  339.            file that contains the number of k per point. (Just like
  340.            Celerity). I've included a default one.
  341.            Line #1
  342.               ## = Number of k per Point.
  343.  
  344.         B. Tweaked the new file description search routines.
  345.  
  346.         C. Rewrote a bunch of the display and filescan logic.
  347.  
  348.         D. Added another couple lines to the FILEBASE.DAT file.
  349.             the second line should contain the file list option that
  350.             you want to default to:
  351.             Line #2
  352.                 0 = Date listed
  353.                 1 = Disk numbers listed
  354.                 2 = Size listed
  355.             Line #3
  356.                 The default uploaders name when adding new files,
  357.                  if you change it during the process it will keep
  358.                  that name as the uploader until you exit that
  359.                  upload session.
  360.             Line #4
  361.                 Empty Dir to extract files within zip files to display,
  362.                 preferably a local node's xfer dir or any blank dir.
  363.                 I unzip the file you want to extract to this dir,
  364.                 type it to the screen and then delete it. If it aleady
  365.                 exists, pkunzip will tell you so, and either way I delete
  366.                 the file after we are done. SO MAKE SURE YOU USE AN EMPTY
  367.                 DIRECTORY - DON'T COMPLAIN CAUSE YOU DID NOT READ THE DOCS.
  368.                 MAKE SURE THERE IS A \ at the end of the path name, like:
  369.  
  370.                 F:\CELERITY\XFER3\
  371.  
  372.                 This is a VERY crude way of looking at zip files, I havent
  373.                 looked for any of the pkzip programmer utils I have, so
  374.                 expect an upadate to this if people actualy use it.
  375.                 (Leave me mail)
  376.  
  377.         E. After 5 areas where scanned for offline file moves, it would
  378.             crash, (I forgot to close a file), this has been fixed.
  379.             Thanks to Night Ranger for bringing this one up.
  380.  
  381.         F. Shikägo, home of the booze.
  382.  
  383.         G. Added some checking of the FILEBASE.DAT file.
  384.  
  385. 7/2/92
  386.  
  387.         1.7Beta
  388.  
  389.         Night Ranger of Europe gave many ideas/suggestions that I have
  390.         incoporated into version 1.7, thanks NR!
  391.  
  392.         1. You may now add all the files in a directory to celerity that
  393.             are not already in celerity automatically, ie it will not
  394.             prompt you edit information for each file. You MUST have
  395.             an INFILES.DAT file for this to work. It will search the
  396.             INFILES.DAT for for the file name, if a match is found it
  397.             will add the record to celerity with the description,
  398.             uploader's name and file points (all values grabbed from the
  399.             FILEBASE.DAT file). If a filename match is not found it
  400.             won't add the file. It reports the number of files added and
  401.             not added.
  402.  
  403.         2. You may now have a configurable INFILES.DAT file. ie in the
  404.             FILEBASE.DAT file you specifiy the format of the INFILES.DAT
  405.             file and the parser will determine the exact column that
  406.             the filename and description are in and use these starting
  407.             points to get the filename and description. This comes in
  408.             handy when you are using a list that is all in one format.
  409.  
  410.         3. Point #2 leads into this one. You may now add all the files
  411.             in FILEBASE.DAT to celerity, EVEN IF THE FILES DON'T EXIST.
  412.             You must use a fixed formatted INFILES.DAT file as described
  413.             in pt #2. It will added every line in the infiles.dat file
  414.             to your celerity directory.
  415.  
  416.         4. The display of amount of k copied is now configurable, I test
  417.             this utility on a 486/33 and with a Novell Network, so I
  418.             think its pretty quick, but others think the copying could
  419.             use a kick in the pants.
  420.  
  421.         The FILEBASE.DAT file looks like:
  422.  
  423.           Number of k per file point
  424.           Default File listing configuration
  425.           Default Uploader
  426.           Temp directory to use to extract zip files in
  427.           Should the amount of k being copied be displayed
  428.           Use FIXED Format INFILES.DAT
  429.           FFFFFFFFFF    SSSSSSSS    DDDDDDDDDDDDDDDDDDDD
  430.  
  431. Example:
  432.           10
  433.           1
  434.           Sicko
  435.           f:\celerity\xfer3
  436.           N
  437.           Y
  438.           FFFFFFFFFFFF  SSSS        DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD
  439.  
  440.  would correspond to the infiles.dat file looking like
  441.  
  442.           celerity.zip  1000k       Celerity BBS
  443.           filebase.zip  100k        A Great Celerity Utility!!!!
  444.  
  445.           FFFF = Filename             (MUST BE IN CAPS)
  446.           SSSS = FIleSize             (not used yet)
  447.           DDDD = Description          (MUST BE IN CAPS)
  448.  
  449.           The first occurrance of F,S,& D must be placed in the column
  450.           where their respective titles start.
  451.  
  452.         4. I fixed the file point calculatoins, I now truncate instead
  453.             of rounding.
  454.  
  455.         Alot of these suggestions where added to try to bring over Vision
  456.          sysops to Celerity. They needed a utility that would convert
  457.          their Vision Filebases to Celerity. This utility does not do that
  458.          directly, but can be used with any Master list from any board to
  459.          populate celerity's filebases.
  460.  
  461.         5. You may now view ASCII files by highlighting the files and
  462.          press "." If the does not have ZIP or ARJ within the file name
  463.          it will prompt you if you wish to display it.
  464.