home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / pcboard / pcbfv32.zip / FVMM.DOC < prev    next >
Text File  |  1993-01-09  |  16KB  |  329 lines

  1.  
  2.          
  3.  
  4.  
  5.  
  6.  
  7.          ------------------------------------------------------------------
  8.         |                                                                  |
  9.         |                                                                  |
  10.         |                                                                  |
  11.         |                         FVMM Version 1.3                         |
  12.         |                                                                  |
  13.         |               FVMM - File View Maintenance Manager               |
  14.         |                                                                  |
  15.         |                               For                                |
  16.         |                                                                  |
  17.         |                PCBFiler's ALT-V File View Process                |
  18.         |                                                                  |
  19.         |                                                                  |
  20.         |    FVMM   (C) Copyright 1991-1993   Yandell Computer Services    |
  21.         |    PCBFV  (C) Copyright 1990-1993   Yandell Computer Services    |
  22.         |                                                                  |
  23.         |             12121 Little Road - Bldg. 303 - Suite 212            |
  24.         |                        Hudson, FL 34667                          |
  25.         |                                                                  |
  26.         |                     DATA -- (813) 842-8099                       |
  27.         |                                                                  |
  28.         |                        January 9, 1993                           |
  29.         |                                                                  |
  30.         |                                                                  |
  31.          ------------------------------------------------------------------ 
  32.  
  33.  
  34.  
  35.  
  36.                                  TABLE OF CONTENTS                      Page
  37.                                  -----------------                      ----
  38.  
  39.               INTRODUCTION                                                
  40.               ------------
  41.               1.0  What Is FVMM                                            2
  42.               1.1  Disclaimer                                              2
  43.                
  44.               INSTALLING FVMM   
  45.               ---------------   
  46.               2.0  Editing FVMM.CNF                                        3
  47.               2.1  Installing FVMM in PCBFiler                             4
  48.               2.2  Editing FVMMGIF.BAT                                     4
  49.               2.3  Editing FVMMTEST.BAT                                    4
  50.               2.4  Editing FVMMADV.TXT                                     4
  51.                             
  52.               MISCELLANEOUS
  53.               ------------- 
  54.               3.0  Using FVMM at the DOS Prompt                            5
  55.               3.1  Notes Regarding PCBFV                                   5
  56.               3.2  Technical Notes                                         5
  57.               3.3  Registration                                            5
  58.  
  59.                
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.         --------------------------------------------------------------------
  70.         Page 2                         FVMM                           Page 2
  71.         --------------------------------------------------------------------
  72.  
  73.         1.0  What is FVMM
  74.         --------------------
  75.         Use  of  FVMM is completely optional and is in no way  required  for 
  76.         PCBFV to be used in PCBFiler's ALT-V process. 
  77.  
  78.         Please  note:  FVMM is distributed with PCBFV.  PCBFV's primary  use 
  79.         is  the on-line file viewer for callers.  PCBFV has the  ability  to 
  80.         run as a Sysop utility in PCBFiler's ALT-V process, either alone  or 
  81.         in conjunction with the FVMM utility.
  82.  
  83.         *  Allows manual maintenance on ALL file types while using PCBFiler.
  84.  
  85.         *  Calls  upon PCBFV to view the file in PCBFV's  local  maintenance 
  86.         mode.  File contents can checked using PCBFV's (R) command.  PCBFV's 
  87.         (D)elete command (ZIPs only) can also be used in this mode.
  88.          
  89.         *  A file transfer summary can be obtained from  DOWNLOAD.TXT.  This 
  90.         summary provides useful maintenance information such as the name  of 
  91.         the person that uploaded the file and the date of the upload,  along 
  92.         with  the number of downloads and the date of the last download.  If 
  93.         the Sysop detects a "bad" file during maintenance, this allows  them 
  94.         to  determine  who sent the file.  While performing  maintenance  on 
  95.         "non-upload"  directories, this allows the Sysop to determine  if  a 
  96.         file is worth keeping based on the download history.
  97.  
  98.         *  A picture  (GIF, etc.) viewer can be  installed  in  FVMMGIF.BAT. 
  99.         Picture files can then be viewed and tested before moving them to  a 
  100.         permanent location with PCBFiler.
  101.  
  102.         *  FVMM can invoke FVMMTEST.BAT to perform any type of test  process 
  103.         the Sysop wishes to install (in FVMMTEST.BAT).
  104.  
  105.         *  FVMM can display a ZIP file comment.
  106.  
  107.         *  FVMM can add a ZIP file comment - FVMMADV.TXT.
  108.  
  109.         *  FVMM can delete existing ZIP file comments.
  110.  
  111.         *  FVMM  can perform a regular  "drop to DOS"  shell,  allowing  the 
  112.         Sysop to do other tasks while in PCBFiler and FVMM.  This shell  may 
  113.         be password protected, if the Sysop has Co-Sysops using PCBFiler for
  114.         remote maintenance.
  115.  
  116.  
  117.         1.1  Disclaimer
  118.         ---------------
  119.         There are no warranties, expressed or implied, for FVMM.  Sysops who
  120.         install  FVMM  on their systems assume any and all  liabilities  for 
  121.         anything which may result as a consequence of running FVMM. Under no
  122.         circumstances shall Yandell Computer Services or the author of  FVMM 
  123.         be liable for any loss of profit or any other damages, including but 
  124.         not limited to special, incidental, consequential, or other damages, 
  125.         arising out of the use or inability to use FVMM.
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.         --------------------------------------------------------------------
  136.         Page 3                        FVMM                            Page 3
  137.         --------------------------------------------------------------------
  138.  
  139.         2.0  Editing FVMM.CNF
  140.         ---------------------
  141.         FVMM  calls upon a configuration file when it runs called  FVMM.CNF. 
  142.         This  file must be in the same location with FVMM.EXE.  YOU MUST USE 
  143.         A TEXT EDITOR TO EDIT THIS FILE as follows:
  144.  
  145.         D:\PCBFV\                     line #1    \ 
  146.         PCBFV.CNF                     line #2      \ Do NOT edit FVMM.CNF
  147.         Y                             line #3      / with FVSETUP.EXE.
  148.         D:\PCB\MAIN\DOWNLOAD.TXT      line #4     <
  149.         0                             line #5      \ Use a TEXT EDITOR to
  150.         NONE                          line #6      / edit this file.
  151.         PASSWORD                      line #7    / 
  152.          
  153.         LINE  #1  -  This  is the location where  PCBFV.EXE  is.   JUST  the 
  154.         location.
  155.  
  156.         LINE  #2 - This is the PCBFV configuration file for PCBFV to use  in 
  157.         its /L local mode.  NOTE: If your PCBFV.CNF file(s)  contain  @node@
  158.         macros in the "work location of extracted file" field in FVSETUP you 
  159.         must  create a special configuration file for use in the  FVMM  mode 
  160.         which  fully specifies the "work location"  (with no @macros@).  You 
  161.         could call this file FILER.CNF and install it in LINE #2 of FVMM.CNF 
  162.         (instead of PCBFV.CNF as shown above). ALL PCBFV configuration files 
  163.         must reside with PCBFV.EXE.
  164.  
  165.         LINE  #3 - Enter a Y (yes) to make FVMM swap itself to EMS  or  disk 
  166.         during  the PCBFV, FVMMGIF, FVMMTEST, and drop to DOS  shells.  FVMM 
  167.         will  first try to swap to EMS, then to disk if EMS is  unavailable. 
  168.         Swapping is highly recommended as FVMM is removed from memory  while 
  169.         performing the above shell functions.
  170.  
  171.         LINE  #4 - This is the location AND name of your  DOWNLOAD.TXT  file 
  172.         which is created by PCBoard. Some Sysops move or rename DOWNLOAD.TXT
  173.         on a daily basis for other maintenance purposes. In this case, place
  174.         the location and name of your "all-time" DOWNLOAD.TXT here.  This is
  175.         used by FVMM to obtain a file transfer history.
  176.  
  177.         LINE #5 - This is your PCBFV registration number. FVMM will  display 
  178.         an [unregistered copy] message along with a delay each time it exits
  179.         if PCBFV has not been registered.
  180.  
  181.         LINE  #6  -  This is the location (only)  of  PCBSM.CLR,  the  color 
  182.         definition  file  for PCBFiler, PCBSM, PCBSetup, etc.  If line #6 of 
  183.         FVMM.CNF  is  blank,  FVMM will look for PCBSM.CLR  in  the  current 
  184.         directory.  If line 6 of FVMM.CNF is NONE or PCBSM.CLR is not found, 
  185.         default  colors  are used.  If colors have not been  customized  for 
  186.         PCBSM,  PCBSetup,  PCBFiler, etc. with PCBSM, or you are  using  the 
  187.         "Default color set #1" from PCBSM, place NONE in line 6 of  FVMM.CNF 
  188.         as this will prevent the extra step of searching for PCBSM.CLR.
  189.  
  190.         Line #7 - Enter a PASSWORD (up to 12 characters) to use for the FVMM
  191.         shell to DOS function.  Leave this field blank if a password is  not 
  192.         desired.  This would usually only be used if PCBFiler is made avail-
  193.         able to remote Co-Sysops to prevent them from using this function.
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.         --------------------------------------------------------------------
  202.         Page 4                         FVMM                           Page 4
  203.         --------------------------------------------------------------------
  204.  
  205.         2.1  Installing FVMM in PCBFiler
  206.         --------------------------------
  207.         At PCBFiler's first screen, select "Edit PCBFILER defaults page  2".  
  208.         At the bottom of this screen, enter parameters as follow:
  209.  
  210.         File VIEWERS - filename extensions and commands for executing viewer
  211.         File Extension : ???      DOS Command : d:\pcb\fvmm.exe
  212.         File Extension :          DOS Command :
  213.         File Extension :          DOS Command :
  214.  
  215.         The  ???  tells  PCBFiler to shell to this  "viewer"  for  all  file 
  216.         extensions. If you wish to force certain types of files into another 
  217.         process, then place the extension for the other file type on a  line 
  218.         BEFORE  the line that ??? appears on.  Do not place anything in  the 
  219.         field for the DOS command except the pathname and filename as  shown 
  220.         above (for FVMM).
  221.  
  222.  
  223.         2.2  Editing FVMMGIF.BAT
  224.         ------------------------
  225.         Any  file  not having a ZIP, ARJ, LZH, ARC, PAK, SDN,  EXE,  or  COM 
  226.         extension  can be sent to the FVMMGIF.BAT batch file.  For  example, 
  227.         the FVMMGIF.BAT file should contain something like:
  228.  
  229.         d:\gif\viewer.exe %1
  230.  
  231.         where  viewer.exe  is your favorite picture (GIF,  etc.)  viewer  or 
  232.         tester. The %1 must be included, as it is the LOCATION AND  FILENAME 
  233.         of the GIF (picture) file sent to FVMMGIF.BAT from FVMM.
  234.  
  235.         Keep  in  mind that this is a "shell process" and there  is  limited 
  236.         memory,  depending on the size of the PCBoard DIR file being  edited 
  237.         in PCBFiler.  Using a small, limited feature picture viewer is best.
  238.  
  239.  
  240.         2.3  Editing FVMMTEST.BAT
  241.         -------------------------
  242.         Any  file  may be sent to this process for  testing.   The  enclosed 
  243.         FVMMTEST.BAT  demonstrates  how to test ZIP  file  integrity.  Other 
  244.         tests,  such  as  those  demonstrated  in  the  PCBoard  manual  for 
  245.         PCBTEST.BAT,  can also be performed, as well as any other  procedure 
  246.         which may be commonly used in PCBTEST.BAT.
  247.  
  248.         Keep  in  mind that this is a "shell process" and there  is  limited 
  249.         memory,  depending on the size of the PCBoard DIR file being edited.
  250.  
  251.         Depending on the type of tests and testers being used, you may  wish 
  252.         to  end the batch file with a pause instruction (as demonstrated  in 
  253.         the  enclosed FVMMTEST.BAT) so the results of the test will  not  be 
  254.         cleared from the screen before they can be viewed.
  255.  
  256.  
  257.         2.4  Editing FVMMADV.TXT
  258.         ------------------------
  259.         This  is the BBS advertisement file that FVMM will insert as  a  ZIP 
  260.         comment if desired.  This file should be kept as short as possible.
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.         --------------------------------------------------------------------
  268.         Page 5                         FVMM                           Page 5
  269.         --------------------------------------------------------------------
  270.  
  271.         3.0  Using FVMM at the DOS prompt
  272.         ---------------------------------
  273.         After  configuring  FVMM.CNF  and PCBFV.CNF  as  described  in  this 
  274.         documentation,  simply  enter FVMM D:\PATH\FILENAME.ZIP at  the  DOS 
  275.         prompt. D:\PATH\FILENAME.ZIP can be any file located in a  directory 
  276.         on  your system. The complete path, filename, and extension must  be 
  277.         entered.   FVMM works the same in this mode as it does in  PCBFiler, 
  278.         without the memory overhead of PCBFiler.
  279.  
  280.         3.1  Notes regarding PCBFV
  281.         --------------------------
  282.         PCBFV   should  be  configured  and  functioning   properly   before 
  283.         attempting to install it with FVMM. 
  284.  
  285.         When  FVMM calls PCBFV, it does so in PCBFV's /L local  mode.  Refer
  286.         to the PCBFV manual for details regarding PCBFV's use in this mode.
  287.  
  288.         3.2  Technical notes
  289.         --------------------
  290.         FVMM might not be practical for use on extremely large systems where 
  291.         individual  PCBoard DIR files exceed several hundred K in  size.  In 
  292.         these cases there may not be enough memory for the ALT-V process.
  293.  
  294.         If  temporarily shelling to DOS with FVMM, NEVER touch files with  a 
  295.         .$$$  extension residing in the default location.  These  files  are 
  296.         created and used by PCBFiler and FVMM during their operation.
  297.  
  298.         Up  to 4K ZIP comments can be handled by all of FVMM's  ZIP  comment 
  299.         functions. A 4K ZIP comment would be 2 full screen displays of text, 
  300.         which is rare.
  301.  
  302.         Only the first 23 lines of a ZIP comment will be displayed by FVMM's 
  303.         ZIP  comment viewer.  ZIP comments are rarely longer than 23 lines. 
  304.  
  305.         FVMM's  screen I/O is DESQview aware and time slices are given  back 
  306.         to other DESQview applications while FVMM is waiting for input. 
  307.  
  308.         FVMM  uses  about 46K of memory during operation, and  about  5K  of
  309.         memory when shelling if swapping is allowed.
  310.  
  311.         3.3  Registration
  312.         -----------------
  313.         FVMM  is  a no-charge enhancement utility for  Sysops  who  register 
  314.         PCBFV.  A PCBFV registration is required to remove the  unregistered 
  315.         notices  which appear when FVMM is run.  FVMM registrations are  not 
  316.         available separately.  FVMM is included in PCBFV distribution  files 
  317.         solely to facilitate ease of distribution.
  318.  
  319.         PCBFV is not free software. PCBFV should be registered no later than 
  320.         30 days after installation.  Registration is $15.00 and may be  paid 
  321.         by  check,  money order, VISA, Mastercard, or Discover, or  American
  322.         Express.  If  using  a charge card, you may receive  a  registration
  323.         number INSTANTLY!
  324.           
  325.         Refer to  the  enclosed file  ORDER.FRM  for  complete  registration 
  326.         instructions.
  327.  
  328.  
  329.