home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / s / swap21s.zip / SWAPFILE.DOC < prev    next >
Text File  |  1993-02-27  |  8KB  |  183 lines
  1.  
  2.  
  3.                           ██████████▌
  4.                           ███▌██▌███▌ILL
  5.                           ███▌██▌███▌
  6.                           ███▌███████████▌
  7.                           ███▌ ███▌██▌███▌AR
  8.                                ███▌██▌███▌██████▌
  9.                                ███▌██▌███▌███▌
  10.                                ███▌   ███▌██████▌ OFTWARE
  11.                                              ███▌
  12.                      ███████████████████████████▌
  13.                               PRESENTS
  14.  
  15.                             " SWAPFILE "
  16.                                        { Version 2.1s }
  17.                                             by
  18.                                           Millard Watson II
  19.                                           3205 Crestview Dr. #107
  20.                                           Dallas,Tx.  75235
  21.                                           Fidonet 1:124/1019.1903
  22.                                           Address Questions To Millard Watson
  23.  
  24. ==============================================================
  25.                          SWAPFILE MANUAL
  26. ==============================================================
  27.  
  28.      SwapFile 2.1s is a program that is designed to swap virtually
  29. any program within a BBS. It can be utilized to rotate any of your
  30. BBS screens, menu screens, and virtually any other series of
  31. screens or programs. With SwapFile, you as a Sysop, can customize
  32. your BBS as never before possible. SwapFile 2.1s is not
  33. crippleware. It's only limitation is the ability to rotate only
  34. three screens / menus / programs. With the registered version, you
  35. may rotate up to 99 screens / menus / programs. SwapFile will
  36. operate with any BBS software.
  37.  
  38.      I have tried to make this documentation as simple and easy to
  39. understand as possible. Not all of us are P.C. Gurus....*g*.
  40.  
  41. ==============================================================
  42. The following files should be in your copy of SwapFile:
  43.  
  44. * File_id.diz    This is the BBS info file
  45. * Order.frm      This is the order form for Swapfile
  46. * Swapcfg.Exe    This is the setup file
  47. * Swapfile.Exe   This is the main executable file
  48. * Swapfile.doc   This is this file
  49.      After initial setup is completed, a file named Swapfile.Cfg
  50. will automatically be created.
  51.  
  52.      You may edit Swapfile.cfg at any time after initial setup is
  53. completed. Now if you do edit the Swapfile.cfg when you are
  54. finished, the old Swapfile.cfg will be turned into a backup file.
  55. The name of the back up will be sf_cfg.bak.
  56.  
  57. ==============================================================
  58.                           INITIAL SETUP
  59. ==============================================================
  60.  
  61.      Take all two of the program files....(grin) and place them in
  62. a sub-directory off of your main BBS directory. Actually, you can
  63. place them anywhere as long as they are in your path statement.
  64. But, for the sake of simplicity, placing them in your main BBS
  65. directory works for me.
  66.      I am going to use RemoteAccess and Robo BBS in my examples.
  67. While I, myself do not operate a BBS, my association with many wild
  68. and crazy Sysops, have convinced me the need for such a program.
  69.  
  70.      Create a directory off of your main BBS directory:
  71.  
  72.       C:\RA\SWAP    PATH\BBS PROGRAM\SUB-DIRECTORY NAME
  73.  
  74.      After having placed both files belonging to SwapFile in a
  75. directory in your path, you are ready to configure your program.
  76.  
  77.      I will use examples defining how to rotate your ANSI log off
  78. screens. 
  79.  
  80.      Place the three ANSI(or three ASCII) screens, you have chosen
  81. to rotate in this sub directory. Rename the three screens:
  82.  
  83.           [FileName].01   [FileName].02   [FileName].03
  84.  
  85.      Please note that the extension is a two digit, not a three
  86. digit extension.
  87.  
  88.      Execute Swapcfg.Exe. You will see a screen prompting you for
  89. the following information:
  90.  
  91. BBS MASTER FILE PATH           The directory is where your screens 
  92.                                are normally found.
  93.                                Eg; C:\RA\TXTFILES
  94.  
  95. BBS MASTER FILENAME            The filename of your screen.       
  96.                                Eg;   Logoff.ans
  97.  
  98. BBS SWAP FILE PATH             The path to the directory where your 
  99.                                three screens...                   
  100.                                Logoff.01,Logoff.02, and           
  101.                                Logoff.03.... you wish to rotate are 
  102.                                housed.                            
  103.                                   C:\RA\SWAP
  104.  
  105. BBS SWAP FILE NAME             The filename of the screen you wish 
  106.                                to rotate... do not add any        
  107.                                extension.  Eg; Logoff
  108.  
  109. TIE CURRENT FILE TO LAST       Here is where RoboBBS comes into the 
  110.                                picture. Unlike all other BBS      
  111.                                software, Robo requires at least 2 
  112.                                files incorporated into each screen 
  113.                                to function properly.  Therefore, 
  114.                                here is where you tie Logoff.RBO and 
  115.                                Logoff.Txt together to make one    
  116.                                screen. However, RoboBBS Sysops are 
  117.                                limited to only one rotating screen, 
  118.                                for they are using 2 of the 3      
  119.                                screens available for rotation.    
  120.                                Don't fret Robo Syops....I will    
  121.                                figure something out for you.      
  122.  
  123.      If you register SwapFile, you will have the capabilities of
  124. rotating 99 screens/programs. You can use SwapFile to rotate any of
  125. your screens....welcome, logoff, logo, etc. You can also rotate
  126. your menus.....main menu, message menu, file menu, etc., by simply
  127. applying these instructions to which set of screens you wish to
  128. rotate. Your imagination is your only limit to how you can
  129. customize your BBS.
  130.  
  131.  
  132.  
  133. ==============================================================
  134.                         RUNNING SWAPFILE
  135. ==============================================================
  136.  
  137.      This will explain how to run SwapFile if you are not using a
  138. front end mailer. Directions for running SwapFile with a front end
  139. mailer follows.
  140.  
  141.      Since I started using RemoteAccess as an example, I will
  142. continue using it throughout these instructions.
  143.  
  144.      Edit the batch file that executes your BBS. Enter Swapfile.exe
  145. into the batch file, enabling Swap to rotate the screens.
  146.  
  147.      EG;  ECHO OFF
  148.           :START
  149.           CD\RA\SWAP
  150.           SWAPFILE.EXE
  151.           RA -D -E20
  152.           :CLEAN
  153.           RAMSG
  154.           RAUSER
  155.           RATOP
  156.           CD\RA
  157.           GO TO START
  158.      
  159.      Please take note this very simplified batch file is exampled
  160. to give you an idea of how to edit your existing batch file.
  161. You want Swap to execute as soon as a user exits your BBS. It
  162. should then rotate your screens, for the next caller.
  163. ==============================================================
  164.              RUNNING SWAPFILE WITH FRONT END MAILER
  165. ==============================================================    
  166.         
  167.      These instructions work with Front Door.    Simply add
  168. swapfile.exe to the end of your batch file that runs your front end
  169. mailer.  Again, you want Swap to run as soon as a user exits your
  170. BBS. It should then rotate your screens, for the next caller. Not
  171. knowing how all front end mailers operate, I leave it up to you to
  172. edit your batch file to include Swap.
  173.  
  174. ==============================================================
  175.      I hope you enjoy this program from Millmar Software. If you
  176. have any problems, and especially if you wish to heap praise upon
  177. the author....please write to me. And if you feel you would like
  178. the capability to keep your users from becoming bored with the same
  179. screens every time they visit...... send in your registration form.
  180. For only $15.00 you can rotate up to 99 screens, menus and
  181. programs.
  182.  
  183.