home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / ra / ffra02wb.zip / INSTALL.DOC < prev    next >
Text File  |  1994-02-25  |  14KB  |  620 lines
  1.        Installation
  2.        ──────────────────────────────────────────────────────────────────
  3.  
  4.        To use FastFile  you need an IBM 286 or  above compatible computer 
  5.        and DOS 3.3 or later.  FastFile can  also be used with OS/2 2.x or
  6.        Desqview.
  7.  
  8.        In addition  to DOS you  need to  have installed a copy of Remote-
  9.        Access 2.0x together with a FOSSIL driver.
  10.  
  11.        A FOSSIL driver is a memory resident program that FastFile uses to
  12.        communicate  with the  modem. FastFile  has been  tested with  two
  13.        FOSSIL  drivers,  Ray Gwinn's X00 and David Nugent's  BNU. Remote-
  14.        Access,  BNU,  X00, GSZ and DSZ can be downloaded  from most BBSs.
  15.  
  16.        Follow these  instructions to install  FastFile  assuming that you
  17.        have  previously  installed  the  BBS system  and a Fossil driver.
  18.        Steps with  the  number within  parentheses, (), are not essential
  19.        but recommended.
  20.  
  21.        1. Create a new  directory for  FastFile  on your hard disk.  That
  22.           directory is  referred to as the FastFile  system directory  in
  23.           what follows. Example: C:\FASTFILE.
  24.  
  25.        2. Copy  all files  in the  FastFile  archive to  that  directory.
  26.        
  27.        3. Create a new directory for GSZ or DSZ on your hard disk. GSZ is
  28.           recommended  for its  graphic  capabilities.   Example: C:\GSZ.
  29.  
  30.        4. Copy all files pertaining to GSZ to that directory.
  31.       
  32.      (5). Include the  FastFile system directory in the PATH directive in
  33.           AUTOEXEC.BAT. Example: PATH C:\DOS;C:\FASTFILE
  34.  
  35.        6. Add the line "SET FASTFILE=[FASTFILE SYSTEM DIRECTORY]" to your
  36.           AUTOEXEC.BAT. Example: SET FASTFILE=C:\FASTFILE
  37.  
  38.       ---------------------------------------------------------------
  39.       Note: Skip the  instruction #6 if your BBS uses several nodes !
  40.       ---------------------------------------------------------------
  41.  
  42.        7. Add the line SET DSZLOG=\path\GSZLOG.TXT to AUTOEXEC.BAT.
  43.           Example:  SET DSZLOG=C:\GSZ\GSZLOG.TXT.
  44.  
  45.       ---------------------------------------------------------------
  46.       Note: !!!!!!! "SET DSZLOG=" applies even if you use GSZ !!!!!!!
  47.       ---------------------------------------------------------------
  48.        
  49.        8. Place  the archive programs  PKUNZIP, ARJ, ZIP, LHA  etc. in a
  50.           directory named on the PATH command in AUTOEXEC.BAT.
  51.           Ex. C:\DOS
  52.  
  53.  
  54.        If you wish to use  HSLINK and/or BIModem then create  directories
  55.        for  those  on your hard disk  and copy  the  corresponding  files
  56.        to these directories.       
  57.  
  58.  
  59.  
  60.  
  61.                                       1
  62.  
  63.        Configuration
  64.        ──────────────────────────────────────────────────────────────────
  65.  
  66.        The ASCII file FF.CTL is used to configure FastFile. FF.CTL may be
  67.        edited using a standard text editor or FFCONFIG.EXE. The following
  68.        codes can  be used in  FF.CTL within  chat sequences and  protocol
  69.        commands.
  70.        
  71.        ------------------------------------------------------------------
  72.        *B - Baud Rate                   *P - Com Port              
  73.        *N - File Name UL/DL (Not Batch) *C - TMPFile (FileList for Batch)
  74.        *A - User's Name                 *L - User's Location
  75.        *S - SysOp's Name                *F - SysOp's Christian Name.
  76.        *T - User's Time Remaining       *D - User's DownLoad Limit
  77.        *I - Date (Todays date)          *K - Time
  78.        *E - Enter                       *U - UpLoad Path
  79.        ------------------------------------------------------------------
  80.  
  81.        ----------------------------- FF.CTL -----------------------------
  82.  
  83.        FFPath =
  84.  
  85.        Path to FastFile directory on the hard disk.
  86.        
  87.        Ex. FFPath = C:\FASTFILE\
  88.  
  89.        -----
  90.  
  91.        BBSPath =
  92.  
  93.        Path to FILES.RA (RemoteAccess path)
  94.  
  95.        Ex. BBSPath = C:\RA\
  96.  
  97.        -----
  98.  
  99.        NodePath =
  100.  
  101.        Used  in  systems  with  several  nodes.  This path  points to the
  102.        directory  where  EXITINFO.BBS  and  DORINFO1.DEF  reside  for the
  103.        actual node and "BBSPath =" points to the directory where the file
  104.        area file, FILES.RA resides.
  105.  
  106.        Since EXITINFO.BBS  and DORINFO1.DEF reside in  different  direct-
  107.        ories for each node, an FF.CTL file must be  created for each node
  108.        and  described by a node path.  The only difference  between these
  109.        FF.CTL files is the  "NodePath=" information.
  110.        
  111.        FastFile  has to be started from the  NodePath directory  in order
  112.        to determine the FF.CTL file to use.
  113.  
  114.        ------------------------------------------------------------------
  115.        "SET FASTFILE=" must NOT be present in systems with several nodes!
  116.        ------------------------------------------------------------------
  117.  
  118.        Ex. NodePath = C:\RA\LINE2\
  119.  
  120.  
  121.  
  122.  
  123.                                       2
  124.  
  125.        TempPath =
  126.  
  127.        Temporary path used by FastFile to unpack archives.
  128.  
  129.        Ex. TempPath = C:\UNPACK\
  130.  
  131.        -----
  132.  
  133.        UploadArea =
  134.  
  135.        Number  of  area  where  all  uploaded  files  are  to  be  saved.
  136.        If  upload  path is  not  used, FastFile  checks  in  FILES.RA for
  137.        upload  security.
  138.  
  139.        Ex. UploadArea = 1
  140.       %UploadArea = 1
  141.  
  142.        -----
  143.  
  144.        LogFile =
  145.  
  146.        Path and  name of the file  where events  in FastFile  are logged.
  147.        
  148.        Ex. C:\LOG\FASTFILE.LOG or C:\RA\RA.LOG
  149.  
  150.        -----
  151.  
  152.        LogPrint =
  153.  
  154.        {+} The  device  name for  the  printer log.  Operational  only if
  155.        FastFile has been registered.
  156.        
  157.        Ex. LogPrint = LPT1:
  158.       %LogPrint = LPT1: To turn off printer logging.
  159.  
  160.        -----
  161.  
  162.        LogLevel =
  163.  
  164.        Determines the amount of information logged to the log file and on
  165.        the log printer.
  166.        
  167.        0 - Only errors, 1 - Normal, 2 - Full.
  168.        
  169.        Ex. LogLevel = 2
  170.  
  171.        -----
  172.  
  173.        SysOpSec =
  174.  
  175.        The  security  level required  in order  to be able  to use  SysOp
  176.        features in FastFile.
  177.  
  178.        Ex. SysOpSec = 100
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.                                       3
  186.  
  187.        MonoBaud =
  188.  
  189.        In order to maintain an acceptable display updaterate in FastFile,
  190.        a  minimum data  transfer rate  can be specified.  If FastFile  is
  191.        used  at this  transfer  rate  or slower then  the screen  will be
  192.        accessed in monochrome mode.
  193.  
  194.        Ex. MonoBaud = 1200
  195.  
  196.            FastFile  will produce a  black/white display if  the user has
  197.            a modem  with maximum  Baud rate 1200. The user can  change to
  198.            a color display if he so wishes by pressing W. 
  199.        
  200.            Note: This applies  only for remote  use, local use  is always
  201.                  with color display.
  202.  
  203.        -----
  204.        
  205.        LockBaud =
  206.        
  207.        Locks FastFile  to use  the  specified baud rate.  Must be used if
  208.        the FOSSIL driver is locked.
  209.        
  210.        Ex. LockBaud = 19200
  211.        
  212.        -----
  213.  
  214.        RegKey =
  215.  
  216.        Specifies the personal  registration code received  on registering
  217.        FastFile.
  218.  
  219.        Ex. RegKey = 12345-A2341694FF44G12274MQ3
  220.       %RegKey = 
  221.  
  222.        -----
  223.  
  224.        F1 = , F2 =, F3 =, F4 =
  225.  
  226.        Specify  the text  to be  output when  the corresponding  function
  227.        key is pressed during chats.
  228.  
  229.        Ex. F1 = Bye *A, see you later...
  230.            F2 = Hi *A, I can see that you are from *L.
  231.            F3 = The time is now *K and the date is *I.
  232.  
  233.        -----
  234.  
  235.        CTL-Enter =
  236.  
  237.        Specifies  the text  to be output  when Ctrl-Enter  is pressed  in
  238.        chat mode.
  239.  
  240.        Ex. CTL-Enter = :-)
  241.            CTL-Enter = :-) *E
  242.  
  243.  
  244.  
  245.  
  246.  
  247.                                       4
  248.  
  249.        ALT-Enter =
  250.  
  251.        Specifies the text to be output when Alt-Enter is  pressed in chat
  252.        mode. (Does not usually work under Windows.)
  253.  
  254.        Ex. ALT-Enter = :-(
  255.            ALT-Enter = :-( *E
  256.  
  257.        -----
  258.  
  259.        ChatLine = 
  260.  
  261.        Specifies the text to be  output in the SysOp window when entering
  262.        chat mode.
  263.  
  264.        Ex. ChatLine = Hi *A !!
  265.  
  266.        -----
  267.  
  268.        ChatESC = 
  269.  
  270.        Specifies  whether the  user can  terminate a chat  by using  ESC.
  271.        Default = NO.
  272.  
  273.        Ex. ChatESC = YES
  274.  
  275.        -----
  276.  
  277.        ChatName =
  278.  
  279.        Determines if  the user's and SysOp's names  will be  displayed in
  280.        the respective window frames  instead of  "User Window" and "SysOp 
  281.        Window". 
  282.  
  283.        Ex. ChatName = YES
  284.            Display SysOp's and user's names in chat mode.
  285.  
  286.        -----
  287.  
  288.        Scroll =
  289.  
  290.        Specifies  how many lines will  remain in the chat window  after a
  291.        scroll.
  292.  
  293.        Ex. Scroll = 3
  294.  
  295.        -----
  296.  
  297.        GroupMenu =
  298.  
  299.        Specifies if FastFile should use a group menu or not.
  300.  
  301.        Ex. GroupMenu = NO
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.                                       5
  310.  
  311.        DLBatMsg =
  312.  
  313.        Specifies  the  text  displayed  to  the  user  while  FastFile is
  314.        performing the DOWNLOAD.BAT file after downloading files.
  315.  
  316.        Ex. DLBatMsg = Running Bat file, wait ...
  317.  
  318.        -----
  319.  
  320.        ULBatMsg =
  321.  
  322.        Specifies  the  text  displayed  to  the  user  while  FastFile is
  323.        performing the UPLOAD.BAT file after uploading files.
  324.  
  325.        Ex. ULBatMsg = Scanning for virus, wait ...
  326.  
  327.        -----
  328.  
  329.        JumpDos = 
  330.  
  331.        Specifies  the text displayed  to the user when SysOp exits to DOS
  332.        via ALT-J.
  333.        
  334.        Ex. JumpDos = SysOp to DOS, wait ...
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.        
  370.  
  371.                                       6
  372.  
  373.        Missing =
  374.  
  375.        Specifies the text  displayed, instead of the file size, if a file
  376.        in RAs file database is not present in the corresponding directory.
  377.  
  378.        Ex. Missing = Deleted
  379.  
  380.        -----
  381.  
  382.        NotHome =
  383.  
  384.        Specifies  the text displayed  when the SysOp  doesn't reply  to a
  385.        chat request.
  386.  
  387.        Ex. NotHome = SysOp is not home now !!
  388.  
  389.        -----
  390.  
  391.        CheckCarrier =
  392.  
  393.        Turns on  or off  control of  Carrier Detect.  Specify OFF if  you
  394.        run FastFile via modemless cable between two systems.
  395.  
  396.        CheckCarrier = NO
  397.  
  398.        -----
  399.  
  400.        TMPFile =
  401.  
  402.        Specifies the  name of the  TMP file that FastFile  uses to record
  403.        the names of the files  to be fetched using a  batch protocol such
  404.        as ZMODEM or HS/LINK.
  405.        
  406.        Ex. TMPFile = FASTFILE.TMP
  407.  
  408.        -----
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.        
  431.  
  432.  
  433.                                       7
  434.  
  435.        ********************* File transfer protocol *********************
  436.  
  437.        FastFile's external transfer protocols are configured as follows - 
  438.  
  439.  
  440.        PROTOCOL = 
  441.  
  442.        Specifies the name of the  protocol that will be  displayed in the
  443.        download window in FastFile. An asterisk before the name specifies
  444.        that FastFile is to show the download time in the information line
  445.        
  446.        Ex. PROTOCOL = *ZModem
  447.            PROTOCOL = YModem
  448.  
  449.        --
  450.  
  451.        Key
  452.  
  453.        Specifies  the key  to be  used to  start  a download  using  this
  454.        protocol.
  455.  
  456.        Ex. Key Z
  457.  
  458.        --
  459.  
  460.        Batch
  461.  
  462.        Determines whether this is a batch protocol.
  463.  
  464.        Ex. Batch YES
  465.  
  466.        --
  467.  
  468.        DnLoad
  469.  
  470.        Specifies the command that FastFile sends to the protocol in order
  471.        to start the download.
  472.  
  473.        Ex. DnLoad C:\GSZ\GSZ speed *B port *P sz @*C
  474.  
  475.            If the COM  port is locked  to a fixed  speed then  'speed *B'
  476.            should be replaced by, for example, 'speed 19200'. 
  477.        
  478.        --
  479.  
  480.        UpLoad
  481.  
  482.        Specifies the command that FastFile sends to the protocol in order
  483.        to start the upload.
  484.  
  485.        Ex. UpLoad C:\GSZ\GSZ speed *B port *P pd0 rx *N
  486.  
  487.            If the COM  port is locked  to a fixed  speed then  'speed *B'
  488.            should be replaced by, for example. 'speed 19200'.
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.                                       8
  496.  
  497.        DnL-Log
  498.  
  499.        Specifies for FastFile the character in the DSZ log which is to be
  500.        interpreted as meaning successful download.
  501.        
  502.        Ex. DnL-Log z
  503.  
  504.            "z" is the  first character  written to the  DSZ/GSZ log  when
  505.            ZMODEM is used for downloads.
  506.        
  507.        --
  508.  
  509.        UpL-Log
  510.  
  511.        Specifies for FastFile the character in the DSZ log which is to be
  512.        interpreted as meaning successful upload.
  513.  
  514.        Ex. UpL-Log Z
  515.  
  516.            "Z" is the  first character  written to the  DSZ/GSZ log  when
  517.            ZMODEM is used for uploads.
  518.  
  519.        --
  520.  
  521.        CPS2400
  522.  
  523.        Specifies  the  characters  per  second  rate  that  the  protocol
  524.        achieves at 2400 Baud.
  525.  
  526.        Ex. CPS2400 230
  527.  
  528.        --
  529.  
  530.        END PROTOCOL
  531.  
  532.        Terminates  each  protocol  configuration.  Must  be  present !!!!
  533.  
  534.        Ex. END PROTOCOL
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.                                       9
  558.  
  559.        Starting FastFile from the BBS program
  560.        ──────────────────────────────────────────────────────────────────
  561.  
  562.        In  order to  start FastFile from  RemoteAccess a new  menu alter-
  563.        native should be added.
  564.  
  565.        1. Start RACONFIG.
  566.  
  567.        2. Add a new alternative to the menu from which FastFile should be
  568.           invoked thus:
  569.  
  570.           ---------------------------------------------------------------
  571.        
  572.           User display   = FastFile
  573.  
  574.           Action         = Execute sub-program (Type 7)
  575.  
  576.           Data           = C:\FASTFILE\FASTFILE.EXE *M
  577.  
  578.           Hot-Key        = F
  579.  
  580.           ---------------------------------------------------------------
  581.  
  582.        The user  can now start  FastFile by  pressing "F" from that menu.
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.        
  615.  
  616.  
  617.  
  618.  
  619.                                       10
  620.