home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / TELEGARD / TFM24.ZIP / FILEMAN.DOC next >
Encoding:
Text File  |  1990-04-02  |  34.0 KB  |  740 lines

  1.                        Telegard File Manager 2.4 -- Page 1
  2.  
  3.  
  4.  
  5.                        Telegard File Manager 2.4 (Turbo C)
  6.                        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  7.                          Copyright 1990, by Todd Bolitho
  8.                               All rights reserved.
  9.  
  10.              With grateful acknowledgement to the contributions of:
  11.                           Martin Pollard, and Eric Oman
  12.  
  13.         WARNING!
  14.         ~~~~~~~~
  15.         In versions 2.0 - 2.2, there was an error in the Telegard  record
  16.         structure header that File Manager was using.  Because of this, a
  17.         bug  appeared in many Telegard systems that was not the fault  of
  18.         Telegard.   In  fact, it was really no one's fault...  the  error
  19.         came about as the result of attempting to convey record structure
  20.         changes  over  the voice telephone.   A  simple  miscommunication
  21.         caused  File Manager to read and write data from the wrong  spot.
  22.         The  good news is that File Manager 2.3 will FIX this for you  on
  23.         the  very first execution.  You then should go into  your  System
  24.         Configuration <P, D, A> and reset "Max Private Posts Per Call".
  25.  
  26.         BUGS FIXED
  27.         ~~~~~~~~~~
  28.         v2.4
  29.         Thanks to PC-MD Computers and Steve Lennemann for allowing me  to
  30.         debug  File Manager on his systems.  Thanks to him,  the  various
  31.         reported  mouse  bugs  have all been fixed, and there  is  now  a
  32.         commandline  variable to enable File Manager to work  on  systems
  33.         utilizing  EGA  cards with CGA monitors -  "CGA/EGACARD"  is  the
  34.         parameter.
  35.  
  36.         Credit Due
  37.         ~~~~~~~~~~
  38.         While  I am the true author of this program (having coded  nearly
  39.         all it), I would be remiss not to acknowledge the help I received
  40.         from others.
  41.  
  42.         Martin  Pollard  has been my teacher in the C  language,  and  my
  43.         friend.   Several times in the course of coding this  project,  I
  44.         would  find  myself blocked by some lack of understanding  on  my
  45.         part.   Martin was always willing to step in and explain  what  I
  46.         didn't  know,  and he often provided models of his  own  code  to
  47.         assist  me  in  understanding whatever new concept  I  needed  to
  48.         grasp.   It's  rare to find a programmer of his  caliber  who  is
  49.         willing to make the effort to assist a hobbyist like myself,  and
  50.         I am grateful for his time.  I have found that in these  circles,
  51.         he is the exception, not the norm.  Most skilled programmers seem
  52.         to  feel personally threatened by newcomers, and while  they  are
  53.         more than willing to point out any shortcomings, they are unwill-
  54.         ing  to  provide  real help.  In addition, when  I  found  myself
  55.         struggling with a HUGE workload from my job, Martin saw my dilem-
  56.         ma  and contributed a couple of functions to ease my  load,  thus
  57.         helping me get this thing out sooner.  I am very grateful to  him
  58.         for all he has done.
  59.                        Telegard File Manager 2.4 -- Page 2
  60.  
  61.  
  62.         Eric  Oman, the ultimate "whiz kid", was also a big help in  this
  63.         project.   Some  of the routines in this  program  are  extremely
  64.         sophisticated, especially those dealing with dynamically allocat-
  65.         ing and freeing memory.  On more than one occasion, Eric was kind
  66.         enough  to provide guidance in the matters of  segmented  memory,
  67.         and he also contributed a function or two to the project.
  68.  
  69.         Thanks  guys!   This project would have taken  months  longer  to
  70.         complete without your help.
  71.  
  72.         Promises
  73.         ~~~~~~~~
  74.         I  promise that this program will take up space on your  disk  or
  75.         hard drive.  No, come to think of it, I don't even promise  that!
  76.         Seriously,  I am (as stated previously) a HOBBYIST.  I am  NOT  a
  77.         professional  programmer, nor do I ever intend to become one.   I
  78.         do  this because I love it, not because I am a well trained  pro-
  79.         fessional.   I use File Manager, and it works fine on my  system.
  80.         On your system, it may format your hard drive for all I know.  It
  81.         may utterly and totally destroy your computer, cause a short, and
  82.         burn  your  house down.  I didn't create it for  the  purpose  of
  83.         doing  harm to anyone or anything, but I don't promise  you  any-
  84.         thing.  I don't warrantee anything.  I owe you nothing.  I  shall
  85.         not  be  responsible for any damages,  direct  or  consequential,
  86.         resulting from File Manager, or its use.
  87.  
  88.         Raison D'Etre
  89.         ~~~~~~~~~~~~~
  90.         File  Manager  was originally conceived as a  simple  program  to
  91.         allow  SysOps  to take files on and offline in  Telegard  without
  92.         having  to log on and manually change the file listing  for  each
  93.         file.   Soon  afterwards,  Phil Katz came out with  his  new  and
  94.         improved compression method, so a routine to adjust file size  in
  95.         the  listing  was also added.  These early versions  were  simple
  96.         commandline  programs that ran through all the file bases on  the
  97.         system correcting all the listings as it went, much like the AUTO
  98.         mode  in  this new version does now.  These older  versions  were
  99.         slow, but they did the job.  It became apparent that a DOS  level
  100.         management system for TG *.DIR files was also needed.  I  decided
  101.         to  write the utility using some of the concepts and ideas in  my
  102.         early  File  Manager  versions.  While I kept some  of  the  same
  103.         concepts, I did not try to maintain compatibility, so if you  are
  104.         still  using  the old File Managers, you will need to  redo  your
  105.         batch calls to the new, and simpler, "FILEMAN AUTO" command.
  106.  
  107.         Another  reason for the project was to show all of  our  trusting
  108.         SysOps the direction we are taking Telegard in the new C version.
  109.         If you enjoy the look and feel of this new File Manager, you will
  110.         find  yourself very comfortable with the new C version  of  Tele-
  111.         gard.  The speed and ease of use will be in the new BBS software,
  112.         as will the more sophisticated windows and editing  capabilities.
  113.         It's  an  ENORMOUS  task, but it is the one we  have  chosen  for
  114.         ourselves.  We hope to have it out sometime this summer.
  115.                        Telegard File Manager 2.4 -- Page 3
  116.  
  117.  
  118.         Lastly, I wanted to set some sort of standard for Telegard utili-
  119.         ties.  It's all well and good when we sit in our Ivory Tower  and
  120.         tell people what a shareware utility ought to be like... I wanted
  121.         other  supporting  authors to see what we mean when we  say  that
  122.         shareware  ought  to be something special.  Simple  command  line
  123.         utilities  are very nice, and they are APPRECIATED!  Some  SysOps
  124.         lately have gotten the idea though that since Telegard will  soon
  125.         be  shareware, they too should charge for these little  programs.
  126.         The  Telegard  authors SUPPORT the notion of shareware,  but  let
  127.         these  shareware programs be worthy of the cash we are  asked  to
  128.         shell out.  Don't you agree?
  129.  
  130.         Money
  131.         ~~~~~
  132.         I want some.  This program is "shareware".  While I encourage you
  133.         to  send the complete ZIP file to any and all of your friends  to
  134.         try, you are given a 15 day trial period to evaluate File  Manag-
  135.         er.  If you have not "registered" your File Manager by then, your
  136.         free trial period is over.  Registration is $25.
  137.  
  138.         Originally,  File  Manager was to simply stop  working  after  15
  139.         days.   Some folks seem to feel that's a bit rough.   Fine.  File
  140.         Manager is now being released under the "Annoying Ware"  concept.
  141.         It is my hope you will be "annoyed" enough by the pop-up windows,
  142.         and missing features, that you will send me your registration!
  143.  
  144.         I have tried to make your registration as painless as possible by
  145.         providing a separate program to handle your registration for you.
  146.  
  147.             FILE MANAGER WILL NOT RUN UNTIL YOU FIRST RUN "REG.EXE"!
  148.  
  149.         If  you do not run "REG.EXE", File Manager will run it  for  you,
  150.         when  you  first attempt to run File Manager.   If  File  Manager
  151.         cannot  find  "REG.EXE" on it's first execution, it  will  simply
  152.         shut  down  and refuse to run until you first run  the  "REG.EXE"
  153.         program provided.
  154.  
  155.         REG.EXE
  156.         ~~~~~~~
  157.         REG.EXE is a registration program designed to make your registra-
  158.         tion  as  simple and painless as possible.  Simply turn  on  your
  159.         printer,  and run the program.  Alter the fields to  reflect  the
  160.         correct  information, and press <CTRL-ENTER> or just hit  <ENTER>
  161.         all  the  way through the last field.  REG.EXE  will  print  your
  162.         registration  form,  ALREADY FILLED OUT for you!  If you  do  not
  163.         have  a printer, run the program anyway, and write down  all  the
  164.         information presented on a piece of paper.  Just mail that  paper
  165.         along with a check, money order, or cashier's check  for $25 to:
  166.  
  167.                                              Todd Bolitho
  168.                                              1504 N. Vermont
  169.                                              Royal Oak, MI   48067
  170.                        Telegard File Manager 2.4 -- Page 4
  171.  
  172.  
  173.         New Features
  174.         ~~~~~~~~~~~~~
  175.         v2.2
  176.         Online Help - Press <F1> anywhere in File Manager, and up pops  a
  177.         help screen to tell you what you did wrong!  <heh>
  178.  
  179.         <Alt-F>  Registered  Versions Only - Filespec Upload.   Use  this
  180.         feature to bring whole groups of files into your DIR.   Automati-
  181.         cally sets the date, fills in the File Name, and places your name
  182.         into the uploader's name field.
  183.  
  184.         v2.4
  185.         Commandline  parameter - "CGA/EGACARD" allows for use on  systems
  186.         utilizing a CGA monitor with an EGA card.
  187.  
  188.  
  189.  
  190.                           *** Function Information ***
  191.  
  192.  
  193.         TG Structure
  194.         ~~~~~~~~~~~~
  195.         A little background information might be helpful in  understand-
  196.         ing all the power and uses of File Manager.  Telegard looks  for
  197.         the files you have in your bases, on your hard drive or  floppy,
  198.         according   to  the  DL Path.  Perhaps  you  have  wondered  how
  199.         Telegard  keeps track of all those files.  Telegard  stores  all
  200.         the   information on these bases in separate files with a  *.DIR
  201.         extension, one  "DIR"  file  for each base.  In other words,  to
  202.         find  out information  about the SysOp Directory on your system,
  203.         Telegard  must  look  in the file most  likely  named  (by  you)
  204.         "SYSOP"  with a "DIR" extension - "SYSOP.DIR".  It is these  DIR
  205.         files  that   File Manager is most concerned with  altering  and
  206.         modifying, according to your wishes.
  207.  
  208.         File  Manager  must also work with several other files  used  by
  209.         Telegard, but most of these are not important for you to  under-
  210.         stand.  The only exception might be "UPLOADS.DAT"  which  stores
  211.         the  DL  Paths and UL Paths for the various  file  bases.   File
  212.         Manager  has  a very powerful feature that allows  you  to  move
  213.         entire  bases to other drives or directories.  The  significance
  214.         of   UPLOADS.DAT  and the file paths is explained  elsewhere  in
  215.         the help system under "Move Files" and other functions.
  216.  
  217.  
  218.  
  219.         File Manager - How To Set It Up
  220.         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  221.         Place REG.EXE, FILEMAN.EXE, and FILEMAN.HLP anywhere you like in
  222.         your  system's PATH.  As  long  as your main BBS directory,  and
  223.         FILEMAN.HLP are somewhere in  the  path, File Manager will  find
  224.         them, and can run from anywhere.  If your main BBS directory  is
  225.         not in your path, place File  Manager, and it's associated files
  226.         in  the main BBS directory.  This is the directory with  BBS.EXE
  227.         and STATUS.DAT.
  228.                        Telegard File Manager 2.4 -- Page 5
  229.  
  230.  
  231.         I  strongly  urge you to also install, in your  path,    IFL.COM,
  232.         which  I have included in the TFM##.ZIP file.  This  well   known
  233.         and  widely  respected program (written by Martin  Pollard),   is
  234.         called   by  File  Manager to view the  interiors  of  all  known
  235.         compression   formats.    IFL.COM  is   included   in   TFM##.ZIP
  236.         with  Martin's  permission and blessings.   Execute REG.EXE,  and
  237.         when you are done with it - delete it.  Then run File Manager.
  238.  
  239.         See also:   ^Function Keys^    ^Alt Keys^    ^Command Line Help^
  240.  
  241.  
  242.         Function Keys
  243.         ~~~~~~~~~~~~~
  244.         <F1>  Online Help
  245.         <F2>  Smartload - Loads UPLOADS.DAT and DIR
  246.         <F3>  Direct Load - Loads DIR only
  247.         <F4>  Execute a single DIR
  248.         <F5>  Execute all DIRs in system
  249.         <F6>  Interior File List (IFL)
  250.         <F7>  Dos Shell
  251.         <F8>  Sort Method
  252.         <F9>  Write DIR file to disk
  253.         <F10> Accept Listing Editor's current fields
  254.  
  255.         See also:       ^TG Structure^         ^Alt Keys^
  256.  
  257.  
  258.         Alt Keys
  259.         ~~~~~~~~
  260.         <Alt-D>  Delete Listing
  261.         <Alt-I>  Insert New Listing (Registered Versions Only)
  262.         <Alt-F>  Filespec Upload    (Registered Versions Only)
  263.         <Alt-M>  Move File Listing  (Registered Versions Only)
  264.         <Alt-R>  Registration Info  (Registered Versions Only)
  265.         <Alt-U>  User Choose
  266.         <Alt-X>  Fast Exit
  267.  
  268.         See also:      ^TG Structure^        ^Function Keys^
  269.  
  270.  
  271.  
  272.         Smartload
  273.         ~~~~~~~~~
  274.         The  Smartload  function can be called by selecting  the  "File"
  275.         menu, moving the cursor to "Smartload" and pressing <ENTER>,  or
  276.         by  simply   pressing  F2.  Smartload  places  UPLOADS.DAT  into
  277.         memory,  and   then offers the user a choice of  file  bases  to
  278.         operate   on.   Smartload  is the method you should use  to  put
  279.         your   files  into memory  99% of the time, which is why  it  is
  280.         first  in  the  menu choices.  Smartload allows File Manager  to
  281.         know  where files  are actually kept, because UPLOADS.DAT is  in
  282.         memory  and  supplies the DL  Paths  needed to find  the  actual
  283.         files listed  in  each  DIR file.
  284.                        Telegard File Manager 2.4 -- Page 6
  285.  
  286.  
  287.         When  DIR files are Smartloaded, all of File Manager's  features
  288.         are fully functional.  The ONLY disadvantage is that UPLOADS.DAT
  289.         takes up space in memory, so if your system has limited  memory,
  290.         and  if you are working on extremely large DIR files (over  1000
  291.         listings), you may wish to opt to Direct Load instead.
  292.  
  293.         See also:    ^Direct Load^     ^Move Files^     ^TG Structure^
  294.  
  295.  
  296.         Direct Load
  297.         ~~~~~~~~~~~
  298.         Also  called by pressing F3, Direct Loading offers the  raw  DIR
  299.         filenames  as choices for loading.  Direct Loading is only  used
  300.         when  working  under severely constrained  memory  requirements.
  301.         In  cases  where  File Manager functions require a  DL  Path  to
  302.         operate,  these   functions have been disabled  or  modified  to
  303.         discard  the DIR file in memory, and Smartload the base instead.
  304.  
  305.         See also:    ^Smartload^      ^Move Files^      ^TG Structure^
  306.  
  307.  
  308.         Move Files
  309.         ~~~~~~~~~~
  310.         The Move Files command Smartloads a DIR file and allows the user
  311.         to  alter the DL Path.  File Manager knows where the current  DL
  312.         Path  is by looking  where this information is stored  by  Tele-
  313.         gard:  UPLOADS.DAT.   This is the reason for File  Manager  MUST
  314.         Smartload  a DIR if you have not already done so, whenever  this
  315.         function   is called.  Once the Smartload is done, File  Manager
  316.         will  ask  you for a NEW DL PATH.  When the new  path  has  been
  317.         entered, this function will move all listings in the DIR file to
  318.         the  new location you have specified.
  319.  
  320.         If  the  physical path does not exist, it will first  parse  the
  321.         path   given,  creating  all necessary  directories,  and   then
  322.         complete  it's task.  It will REWRITE your UPLOADS.DAT with  the
  323.         new  DL  Path so that Telegard will know where to find  all  the
  324.         files you just moved!
  325.  
  326.         WARNING:   The  UL PATH will also be reset to  the same  as  the
  327.         newly entered DL Path.  If you wish to have files uploaded to  a
  328.         separate directory, you MUST reset the path in Telegard.  Again,
  329.         the  UL Path is automatically written to be exactly the same  as
  330.         the DL Path whenever this function is called.
  331.                        Telegard File Manager 2.4 -- Page 7
  332.  
  333.  
  334.         Additional  Information:   If the drive of the new path  is  the
  335.         same  as  the  drive in the old path, File Manager  is  able  to
  336.         simply  rebuild the directory structure to each file,  and  thus
  337.         does not have to physically copy each file to it's new location,
  338.         then  delete the old files.  If the drive specifier in  the  new
  339.         path is different than the old one, File Manager will  dutifully
  340.         copy  and  delete as described above.  It is therefore  wise  to
  341.         always include the COMPLETE pathname, including the drive speci-
  342.         fier.   It won't hurt anything not to do this, but it will  slow
  343.         File  Manager down as it copies and deletes every  single  file,
  344.         instead  of just rebuilding the directory structures  underneath
  345.         the listings.
  346.  
  347.         See also:     ^Smartload^     ^Direct Load^     ^TG Structure^
  348.  
  349.  
  350.  
  351.  
  352.         Write *.DIR
  353.         ~~~~~~~~~~~
  354.         Selecting  this  function from the menu, or calling it  with  F9
  355.         will  cause the DIR file in memory to be written to your  drive.
  356.         It  is  necessary to call this function each time you  are  done
  357.         working on a DIR, and wish to save the work to disk.
  358.  
  359.         See also:        ^Function Keys^
  360.  
  361.         Erase*.DIR
  362.         ~~~~~~~~~~~
  363.         This function should be called with EXTREME CAUTION!  It is used
  364.         to DELETE a DIR file.  If you use this, and then attempt to view
  365.         the  listings in the base serviced by the now deleted DIR  file,
  366.         the  base will contain NO LISTINGS.  This function  has  limited
  367.         value, but is valuable when one wishes to erase old DIR files no
  368.         longer used.
  369.  
  370.  
  371.         DOS Shell
  372.         ~~~~~~~~~
  373.         "Drops  To DOS",  keeping  File Manager in memory.  Also  called
  374.         with F7, it is used when one wishes to operate on the DOS level,
  375.         without  losing place in File Manager.  Memory available to  DOS
  376.         will be sharply reduced, as File Manager is still in place,  and
  377.         taking up space in your machine's memory.
  378.  
  379.         See also:  ^Function Keys^
  380.                        Telegard File Manager 2.4 -- Page 8
  381.  
  382.  
  383.         Modify
  384.         ~~~~~~
  385.         Simply select "Modify" to enter File Manager's DIR file  editing
  386.         system.  If no DIR file is present in memory, File Manager  will
  387.         Smartload  the  DIR of your choice before entering  the  editor.
  388.         Use the regular PgUp/PgDn, Home, End, and arrow keys to move the
  389.         Edit Bar to various listings in your DIR.
  390.  
  391.         See also:                ^Edit DIR^              ^Edit Listing^
  392.  
  393.  
  394.         <ENTER> - The Listing Editor
  395.         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  396.         Place the Edit Bar on a listing, and press <ENTER>.  Voila!  You
  397.         are  in the Listing Editor.  Remember, this is an editor  within
  398.         an  editor, so try to keep the commands straight in  your  mind.
  399.         Here  you  may  alter all aspects of  the  listing  EXCEPT  it's
  400.         "Status".  Since "Status" is done automatically for you when you
  401.         "Execute"  File Manager's "Services", you have no need to do  it
  402.         manually.
  403.  
  404.  
  405.  
  406.         <ALT-A> (Registered Versions Only)
  407.         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  408.         Add To End - Selecting this function will create a new entry  at
  409.         the  end of your DIR that looks like this:  "*NEWFILE.NEW".   If
  410.         you do not edit this name with the Listing Editor, File  Manager
  411.         will remove the entry before saving your DIR back to disk.
  412.  
  413.         <ALT-D>
  414.         ~~~~~~~
  415.         Use  this  to  <D>elete a listing from your DIR.   If  you  have
  416.         Smartloaded  your  DIR  file, and if the  listed  file  actually
  417.         exists in the DL Path, File Manager will ask you whether or  not
  418.         you would like to delete the actual file as well.
  419.  
  420.         <ALT-F> (Registered Versions Only)
  421.         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  422.         Use Filespec Upload to bring whole groups of files into your DIR
  423.         according  to the wildcard specs you supply!  If you  wish,  you
  424.         may  also use this to upload single files by  simply  specifying
  425.         the exact filename to upload.
  426.  
  427.         <ALT-I> (Registered Versions Only)
  428.         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  429.         Insert Newfile - Selecting this function will insert a new entry
  430.         in your DIR that looks like this: "*NEWFILE.NEW".  If you do not
  431.         edit this name with the Listing Editor, File Manager will remove
  432.         the entry before saving your DIR back to disk.
  433.                        Telegard File Manager 2.4 -- Page 9
  434.  
  435.  
  436.         <ALT-M> (Registered Versions Only)
  437.         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  438.         Once in the DIR file editor, use <Alt-M> to <M>ove a listing  to
  439.         any  other base.  File Manager will prompt you for the  base  to
  440.         move the listing to, and if the physical file exists, will  also
  441.         ask  you  whether to move the file to the DL Path of  the  other
  442.         file base.  Since it is necessary to have UPLOADS.DAT in  memory
  443.         for File Manager to even know what the DL Paths are, this aspect
  444.         of  the single file move function will only operate if you  have
  445.         Smartloaded your DIR.
  446.  
  447.         <F6>
  448.         ~~~~
  449.         This function key, when in either the DIR Editor, or the Listing
  450.         Editor,  will call IFL.COM to show you what files are  contained
  451.         in  the  listing  selected.  IT should be obvious  that  if  the
  452.         listing is not a compressed format such as ZIP, ARC, ZOO,  etc.,
  453.         IFL will not be able to show that any files are contained within
  454.         the  listing.   For instance, if your Edit Bar is  on  FILE.TXT,
  455.         there  are  no files compressed in text files, so IFL  will  not
  456.         show  any  (duhhhhhh).  Also, if you have not  Smartloaded  your
  457.         DIR,  the DL Path is not available to File Manager, so it  would
  458.         not be able to call this function.
  459.  
  460.         See also:               ^Modify^                 ^Edit Listing^
  461.  
  462.         <PgDn/PgUp>
  463.         ~~~~~~~~~~~
  464.         By  pressing either of these keys, the Listing Editor  will  ad-
  465.         vance  to the next listing in the base.  All modifications  done
  466.         thus far become part of the DIR in memory and will be saved when
  467.         you press <F9> to save your work.
  468.  
  469.  
  470.         <F6>
  471.         ~~~~
  472.         This function key, when in either the DIR Editor, or the Listing
  473.         Editor,  will call IFL.COM to show you what files are  contained
  474.         in  the  listing  selected.  IT should be obvious  that  if  the
  475.         listing is not a compressed format such as ZIP, ARC, ZOO,  etc.,
  476.         IFL will not be able to show that any files are contained within
  477.         the  listing.   For instance, if your Edit Bar is  on  FILE.TXT,
  478.         there  are  no files compressed in text files, so IFL  will  not
  479.         show  any  (duhhhhhh).  Also, if you have not  Smartloaded  your
  480.         DIR,  the DL Path is not available to File Manager, so it  would
  481.         not be able to call this function.
  482.                        Telegard File Manager 2.4 -- Page 10
  483.  
  484.  
  485.         <ALT-U>
  486.         ~~~~~~~
  487.         This  command works ONLY when the cursor has been placed on  the
  488.         User NUMBER entry in the form.  Pressing <ALT-U> will provide  a
  489.         list  of  all the users on your system, choosing  one  of  these
  490.         users will place the user's name in the Uploader's Name & User #
  491.         entries  of  the form.  You may of course  edit  them  manually.
  492.         This is provided as a quick and helpful aid to the SysOp.
  493.  
  494.  
  495.         Verbose Descriptions
  496.         ~~~~~~~~~~~~~~~~~~~~
  497.         Due to a limitation in Telegard itself, when creating a  Verbose
  498.         Description, File Manager must immediately save the DIR file  or
  499.         the Verbose entry could be lost forever.
  500.  
  501.  
  502.         <CTRL-ENTER> or <F10>
  503.         ~~~~~~~~~~~~~~~~~~~~~
  504.         These functions place the alterations made to the current  list-
  505.         ing  into  the  DIR memory and return to the  DIR  Editor.   The
  506.         alterations  will  be  saved to disk with the DIR  file  if  you
  507.         choose the <F9> function.
  508.  
  509.         See also:            ^Modify^           ^Edit DIR^
  510.  
  511.  
  512.  
  513.         Execute
  514.         ~~~~~~~
  515.         These functions will execute all the "Services" provided by File
  516.         Manager  in  it's automatic modes.  You are  allowed  to  choose
  517.         between  executing  a single DIR, or ALL DIRs  in  your  system.
  518.         When  Executing, File Manager displays each listing, file  sizes
  519.         (in  blocks),  whether  or  not  the  listing  is  correct,  the
  520.         ONLINE/OFFLINE "Status" of each listed file, and again,  whether
  521.         or  not that is correct.  The far right column shows whether  or
  522.         not  File Manager has altered the listing on your behalf.   File
  523.         Manager will only alter these listings if you have  specifically
  524.         asked it to, by selecting the appropriate "Services".
  525.  
  526.         See also:            ^Single Execute^          ^All Execute^
  527.  
  528.  
  529.         Single DIR Execution
  530.         ~~~~~~~~~~~~~~~~~~~~
  531.         This  function  executes File Manager's services on the  DIR  in
  532.         memory.   It  will NOT save the changes to disk,  and  will  not
  533.         affect  any DIR other than the one you are working on.   If  you
  534.         wish to save the DIR after execution, press <F9>.
  535.  
  536.         See also:           ^Execute^                 ^All Execute^
  537.                        Telegard File Manager 2.4 -- Page 11
  538.  
  539.  
  540.         All Execute
  541.         ~~~~~~~~~~~
  542.         File  Manager's  Auto Mode.  This will  execute  File  Manager's
  543.         Services  on all the DIRs in your system.  Once started,  it  is
  544.         not  possible to stop without rebooting.  All changes are  saved
  545.         to  disk, memory is then cleared, and you may work  on  whatever
  546.         DIRs you wish.
  547.  
  548.         See also:            ^Execute^               ^Single Execute^
  549.  
  550.  
  551.  
  552.         Services
  553.         ~~~~~~~~
  554.         "Services"  are  "Executed" to make changes in a  DIR.   If  you
  555.         choose  not  to execute these services, File  Manager  will  not
  556.         provide  these  services  to you!  Check-mark  each  service  by
  557.         moving the cursor bar onto it, and pressing <ENTER>.
  558.  
  559.  
  560.         Correct File Sizes
  561.         ~~~~~~~~~~~~~~~~~~
  562.         If this flag is check-marked, File Manager will find the  actual
  563.         sizes  of each file listed in a DIR, compute it's  correct  size
  564.         (in blocks), and then alters each listing to reflect that.
  565.  
  566.  
  567.         Fix "Request Only"
  568.         ~~~~~~~~~~~~~~~~~~
  569.         If this flag is check-marked, File Manager will determine wheth-
  570.         er or not a physical file corresponding to each listing actually
  571.         exists.    File   Manager  compares  this  to   each   listings'
  572.         ONLINE/OFFLINE  status,  and  if the listing  is  incorrect,  it
  573.         alters  the listing to reflect the true condition.   This  is  a
  574.         VERY  handy feature.  Using this feature, you may remove  entire
  575.         GROUPS of files, run File Manager, and ALL the listings will  be
  576.         corrected  to show what files have been made  "Offline"!   Like-
  577.         wise, when you again place those files back onto your drive, you
  578.         may run File Manager to restore all the listings to "Online".
  579.  
  580.  
  581.         Verbose Packing
  582.         ~~~~~~~~~~~~~~~
  583.         Through a complex series of procedures, File Manager is able  to
  584.         reduce the amount of disk space used by VERBOSE.DAT.  Check-mark
  585.         this   flag  to  select  this  service.   This  maintains   your
  586.         VERBOSE.DAT in top condition each time you run it.
  587.  
  588.  
  589.         Sort Type
  590.         ~~~~~~~~~
  591.         Selected  through the menu, or by pressing F8, this is  used  to
  592.         pick the type of sorting you would like performed each time  you
  593.         Execute the Services in File Manager.  If you select "None", the
  594.         check-mark will disappear from this item.
  595.                        Telegard File Manager 2.4 -- Page 12
  596.  
  597.  
  598.         Backwards Sorting
  599.         ~~~~~~~~~~~~~~~~~
  600.         Duhhhhhh, what could this be?
  601.  
  602.  
  603.         Delete OLD *.DIRs
  604.         ~~~~~~~~~~~~~~~~~
  605.         When File Manager saves your DIR files back to disk, it does not
  606.         overwrite the old DIR file.  Rather, it RENAMES the old DIR file
  607.         to *.OLD, and then writes the new DIR file.  This is a  built-in
  608.         protection  provided in case you decide you have made  an  error
  609.         while  working  on your directories.  IF such an error  were  to
  610.         occur,  you  could drop to dos, go into your  GFILES  directory,
  611.         delete the *.DIR file you just wrote, and RENAME the *.OLD  file
  612.         to a DIR extension.
  613.  
  614.         Since  many  people are willing to risk the errors in  favor  of
  615.         having  more available disk space, a function has been  provided
  616.         to  AUTOMATICALLY  DELETE  *.OLD files each  time  File  Manager
  617.         writes  a DIR.  Theoretically, one could still drop to dos,  and
  618.         use  Norton or another disk utility to unerase the  *.OLD  file,
  619.         and  still save the day, but not when File Manager has  executed
  620.         ALL  the DIRs.  It's a judgment call.  File Manager defaults  to
  621.         preserving the *.OLD files.  Use it with caution.
  622.  
  623.         Kill "Offline"
  624.         ~~~~~~~~~~~~~~
  625.         If  you are not in the habit of keeping files "Offline" on  your
  626.         system, you may wish to select this service.  Check-marking this
  627.         flag  will cause File Manager to AUTOMATICALLY  DELETE  listings
  628.         that do not have physical files on the drive to correspond  with
  629.         each  listing.   This is handy for "Spring Cleaning"  your  hard
  630.         drive.  If the listing is marked as "Offline", File Manager will
  631.         not  delete it the listing until it first checks to see  if  the
  632.         physical file is on the drive.  If the file exists, File Manager
  633.         will NOT delete the file.
  634.  
  635.  
  636.         Report To File
  637.         ~~~~~~~~~~~~~~
  638.         When  File  Manager is run in AUTO mode, you may opt to  get  an
  639.         ASCII  text  file report.  The report will appear  in  the  same
  640.         directory as FILEMAN.EXE and will be named FILEMAN.RPT.
  641.  
  642.         See also     ^Report To Printer^
  643.  
  644.  
  645.         Report To Printer
  646.         ~~~~~~~~~~~~~~~~~
  647.         When  File  Manager is run in AUTO mode, you may opt  to  get  a
  648.         printed  report.   MAKE SURE your printer is ON  before  running
  649.         File Manager!
  650.  
  651.         See also:    ^Report To File^
  652.                        Telegard File Manager 2.4 -- Page 13
  653.  
  654.  
  655.         Write Data File
  656.         ~~~~~~~~~~~~~~~
  657.         After  you figure out which "Services" you would like  performed
  658.         for  you, select this option to write a data file to  your  disk
  659.         containing all this information.  The file is named FILEMAN.DAT,
  660.         and  will  be  referred to each time  File  Manager  runs,  thus
  661.         allowing  you to customize the services performed for you  on  a
  662.         daily basis.
  663.  
  664.         See also:    ^Command Line Help^
  665.  
  666.  
  667.         No Help Needed!
  668.         ~~~~~~~~~~~~~~~
  669.         Aw, c'mon... you can figure this out if you really try!
  670.  
  671.  
  672.         Commandline Arguments
  673.         ~~~~~~~~~~~~~~~~~~~~~
  674.         File Manager accepts the following commandline arguments:
  675.  
  676.  
  677.         FILEMAN AUTO
  678.         ~~~~~~~~~~~~
  679.         File Manager loads each DIR and Executes according to the  Serv-
  680.         ices  you have specified in FILEMAN.DAT.  IF FILEMAN.DAT is  not
  681.         present  on the drive, File Manager executes according  to  it's
  682.         built-in defaults.
  683.  
  684.         Commandline Screen
  685.         ~~~~~~~~~~~~~~~~~~
  686.         The  following  commandline  arguments  are  used  to  set  File
  687.         Manager's  Screen characteristics.  You must "Write  Data  File"
  688.         FILEMAN.DAT to preserve these settings for future use.
  689.  
  690.  
  691.         FILEMAN 25
  692.         ~~~~~~~~~~
  693.         Sets normal 25 Line mode (default).
  694.  
  695.  
  696.         FILEMAN 43
  697.         ~~~~~~~~~~
  698.         Sets EGA 43 Line mode.
  699.  
  700.  
  701.         FILEMAN 50
  702.         ~~~~~~~~~~
  703.         Sets VGA 50 Line mode.
  704.  
  705.  
  706.         FILEMAN BIOS
  707.         ~~~~~~~~~~~~
  708.         Sets BIOS Screen Writing mode.
  709.                        Telegard File Manager 2.4 -- Page 14
  710.  
  711.  
  712.         FILEMAN MONO
  713.         ~~~~~~~~~~~~
  714.         Sets File Manager to MonoChrome (black-and-white) mode.
  715.  
  716.  
  717.         FILEMAN COLOR
  718.         ~~~~~~~~~~~~~
  719.         Sets File Manager to Color mode (default).
  720.  
  721.  
  722.         FILEMAN SNOW
  723.         ~~~~~~~~~~~~
  724.         Sets CGA Direct Screen Write mode with snow checking.
  725.  
  726.  
  727.         FILEMAN CGA/EGACARD
  728.         ~~~~~~~~~~~~~~~~~~~
  729.         If  you  are  using  a CGA Monitor with an  EGA  card,  you  will
  730.         probably  need  to trip this switch.  Don't forget to  SAVE  your
  731.         settings!
  732.  
  733.  
  734.         FILEMAN NORM
  735.         ~~~~~~~~~~~~
  736.         Used  to  reset  File Manager's screen  characteristics  to  the
  737.         original  25 line, color direct screen write mode.  If you  have
  738.         not saved a FILEMAN.DAT file, you will never need this  command.
  739.         You may achieve the same goal by simply deleting FILEMAN.DAT.
  740.