home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / RASND107.ZIP / RASENDIT.DOC < prev    next >
Encoding:
Text File  |  1996-02-17  |  10.9 KB  |  296 lines
  1.  
  2.   ██████╗   █████╗         ███████╗ ███████╗ ███╗   ██╗ ██████╗  ██╗ ████████╗
  3.   ██╔══██╗ ██╔══██╗        ██╔════╝ ██╔════╝ ████╗  ██║ ██╔══██╗ ██║ ╚══██╔══╝
  4.   ██████╔╝ ███████║ █████╗ ███████╗ █████╗   ██╔██╗ ██║ ██║  ██║ ██║    ██║
  5.   ██╔══██╗ ██╔══██║ ╚════╝ ╚════██║ ██╔══╝   ██║╚██╗██║ ██║  ██║ ██║    ██║
  6.   ██║  ██║ ██║  ██║        ███████║ ███████╗ ██║ ╚████║ ██████╔╝ ██║    ██║
  7.   ╚═╝  ╚═╝ ╚═╝  ╚═╝        ╚══════╝ ╚══════╝ ╚═╝  ╚═══╝ ╚═════╝  ╚═╝    ╚═╝
  8.  
  9.                               Version 1.06
  10.             Copyright (C) Dale K Maupin & Renegade Software
  11.                           All Rights Reserved
  12.           Remote Access 2.xx or 2.50.g1 File Tagger and Sender
  13.                Private File Transfers for Preferred Users
  14.                          RASENDIT.EXE Documents
  15.  
  16. INTRODUCTION
  17. ------------
  18.  
  19.              RASendit is a little utility program for tagging and sending
  20.         files to users as they log onto your BBS. This allows for quick
  21.         on-off operation of getting files. It will allow for group tagging
  22.         which is handy for programmers to send beta files out to beta testers
  23.         without the beta testers having to do the complete log on procress
  24.         and then go to files and so forth, sure a message can be left to get
  25.         this file or that file. RASendIt takes out the guess work and has
  26.         the file waiting for ther users as they log on.
  27.  
  28.              I got this idea from the Spitfire BBS system which I used to
  29.         run until switching to RA. I am friends with the Spitfire author
  30.         and so I have moved this idea on to RA.
  31.  
  32.  
  33. OVERVIEW
  34. ________
  35.  
  36.              The archive consists of two executable files: CfgSend.Exe and
  37.         RaSendit.Exe.  CfgSend is executed by the sysop and it allows him
  38.         to select a desired file and place it on hold for a particular user.
  39.         It also holds the configuration information used by the entire
  40.         program.  Upon exiting CfgSend, it will automatically set a user flag
  41.         in the appropriate user's account to allow the program to run
  42.         seamlessly.  Other BBS users will never know the program is there.
  43.  
  44.              RaSendit is run automatically from RA's top menu.  Beyond the
  45.         original installation in RACONFIG, the sysop never touches it again.
  46.         When the selected user logs on, he will see the RaSendit screen and be
  47.         asked if he wants to pick up his file(s).  He then selects the desired
  48.         transfer protocol and downloads the file(s).  He then is given the
  49.         option of continuing on to the bbs or logging off immediately.
  50.         RaSendit will then reset his flag so that he won't go through the door
  51.         again until the sysop desires.
  52.  
  53.  
  54. INSTALLATION
  55. ------------
  56.  
  57.              Unpack the archive into your RA home directory. RASendIt requires
  58.         the config.ra file to operate. RASendIt is completely multi-node and
  59.         uses file and record locking to accomplish this task. Two programs
  60.         are included in this archive. RASendIt.Exe which is the file sender
  61.         and CfgSend.Exe which is the config program to set up the file tags.
  62.         A data file named RASendit.dat will be created in the RA directory,
  63.         this file has all the data from CfgSend. A log is created with the
  64.         name you specify in the setup program. A copy of DSZ.Com must exist
  65.         in the directory where you place RASendit. The RASendit data files
  66.         must reside in the RA directory and also it's key file if you have
  67.         one must also reside in that directory.  The Door.Sys or Dorinfo1.Def
  68.         file needed to operate will be found in the directory you specify
  69.         on the command line.
  70.  
  71.              Two display files are provided for use with RASendIt and will be
  72.         displayed as the user logs on to RASendIt.  The names of these files
  73.         must be the same as the ones provided:
  74.  
  75.         RASENDIT.ANS --  ANSI FILE
  76.         RASENDIT.ASC --  ASCII FILE
  77.  
  78.         IMPORTANT NOTE: If these files are not found in the same directory
  79.         as RASendit (RA) then a default display will appear.  Do NOT place
  80.         the ansi and asci screens in the \txtfiles subdirectory.
  81.  
  82.  
  83. RACONFIG ENTRIES
  84. ----------------
  85.  
  86.              You can run RASendIt from anywhere within RA but I suggest you
  87.         run it from the TOP menu as that way it works as a log on-off program.
  88.         Set it up as a Type 7 Menu.
  89.  
  90.         RASendIt requires two parameters to run:
  91.  
  92.         Single Line
  93.         ------------------------------------
  94.         RASENDIT.EXE/PORT/PATH TO DOOR.SYS/DORINFO1.DEF /SWAP[optional]
  95.  
  96.         Example:
  97.  
  98.         C:\RA\RASENDIT.EXE *P C:\RA\NODE1 *M
  99.  
  100.  
  101.         MultiLine
  102.         ------------------------------------
  103.         *C /C  C:\RA\NODE*N\RASENDIT.BAT *M
  104.  
  105.         Example RASendit.Bat:
  106.         c:
  107.         cd \ra\node1
  108.         rasendit 1 c:\ra\node1   the 1 = the comport
  109.  
  110.         The *M is optional but will allow the program to run faster with
  111.         more memory. All the other parameters are required. For more info
  112.         on the parameters see your RA 2.xx documents.
  113.  
  114.         Failure to provide the parameters will cause the program to abort
  115.         back to RA.
  116.  
  117.  
  118.  Multi-line example using a bat file
  119. ╒══════════════════════════════════════════════════════════════ Edit Menu Item
  120. │
  121. │          1         2         3         4         5         6         7
  122. │ 123456789012345678901234567890123456789012345678901234567890123456789012345
  123. │ ;
  124. │
  125. │ *C /C d:\sf\ra\node*N\rasendit.bat *M
  126. │
  127. │ Action   Execute sub-program (Type 7)
  128. │ Display
  129. │ OptData
  130. │ HotKey
  131. │ AutoExec Yes
  132. │ Colour   Colour example
  133. │
  134. │ MinSec   25                 TimeUsed 0                  FlatCost 0
  135. │ MaxSec   0                  TimeLeft 0                  TimeCost 0
  136. │ A flags  X-------           Age      0                  Terminal Any
  137. │ B flags  --------           MinSpeed 0                  Nodes
  138. │ C flags  -------X           MaxSpeed 0                  Groups
  139. │ D flags  --------           Credit   0                  DayTimes
  140. │
  141. │
  142.  
  143.  Single-line example...
  144. ╒══════════════════════════════════════════════════════════════ Edit Menu Item
  145. │
  146. │          1         2         3         4         5         6         7
  147. │ 123456789012345678901234567890123456789012345678901234567890123456789012345
  148. │ ;
  149. │
  150. │  d:\sf\ra\rasendit.exe *P *M
  151. │
  152. │ Action   Execute sub-program (Type 7)
  153. │ Display
  154. │ OptData
  155. │ HotKey
  156. │ AutoExec Yes
  157. │ Colour   Colour example
  158. │
  159. │ MinSec   25                 TimeUsed 0                  FlatCost 0
  160. │ MaxSec   0                  TimeLeft 0                  TimeCost 0
  161. │ A flags  X-------           Age      0                  Terminal Any
  162. │ B flags  --------           MinSpeed 0                  Nodes
  163. │ C flags  -------X           MaxSpeed 0                  Groups
  164. │ D flags  --------           Credit   0                  DayTimes
  165. │
  166. │
  167.  
  168.  
  169.  
  170.  
  171. RUNNING THE PROGRAM
  172. -------------------
  173.  
  174.              To hold files for a particular user, you must run CfgSend first.
  175.         This will set up the parameters:  which file to send, and to whom, as
  176.         well as other configuration information.  See CFGSEND.DOC for further
  177.         information.
  178.  
  179.         RASENDIT.EXE
  180.  
  181.         Once the user logs on and moves into the Door he will be presented
  182.         with a screen displaying the ansi/ascii/default screens and then it
  183.         will move to check to see if the user has a file waiting. If the
  184.         user has a file waiting then he will be presented with a display
  185.         like this:
  186.  
  187.      ■ Retrieving user data ... Please wait...
  188.      ■ Hello Dale Maupin
  189.      ■ Following file waiting for Download
  190.      ■ Filename: RASND_14.ZIP
  191.      ■ Description: Remote Access Filetag and Send v 1.00
  192.  
  193.      If this is a group send then you see this:
  194.  
  195.      ■ This is a Group Send File...
  196.  
  197.      If the user has already received the file then they see:
  198.  
  199.      ■ Sorry..., You have already received this file...
  200.      ■ Proceeding to next file if any...
  201.  
  202.      After all of the above is decided then if you can D/l it you see:
  203.      ■ Do you wish to D/L it now Y/N?
  204.  
  205.      If you pick Y then you see:
  206.  
  207.      ■ Pick the number of the preferred transfer protocol:
  208.         <1> Zmodem
  209.         <2> Ymodem
  210.         <3> Xmodem
  211.         <4> Quit
  212.      NOTE: All the file transfers are accomplished using DSZ.COM,
  213.            as such, this file must be in your path or in your RA
  214.            home directory.
  215.  
  216.      If Local you get:
  217.          <C>ontinue to copy
  218.          <Q>uit
  219.  
  220.      Once all the file transfer are completed the program will
  221.      end and require the user to press Return to move on.
  222.      After moving on the user can Hang-Up or move on to the BBS.
  223.  
  224.  
  225. REGISTRATION
  226. ------------
  227.  
  228.      Registration will remove some of the nag-ware delays and screens
  229.      and also allow you to receive free upgrades to the program. The
  230.      registration is accomplished via a key system, similar to other
  231.      systems. The Fee for registration is $ 20.00.
  232.      Make sure the RASendit.Key file is in your RA Directory !!!
  233.  
  234.      Please send all registrations to the following address:
  235.  
  236.      Dale K Maupin
  237.      11168 Wharf Cove
  238.      EL Paso, Texas 79936
  239.      USA
  240.  
  241.      Needed in the reg info are the following:  See RASendit.Reg
  242.  
  243.      Reg can be done by: Check, M/O & Credit Card
  244.  
  245.  
  246.      Also available for RA:
  247.  
  248.      RAWelc10.Zip  : Welcome screen rotater
  249.      RAGdby10.Zip  : Goodbye screen rotater
  250.      RAUSR210.Zip  : RA 2.xx user editor
  251.      RANEWS14.Zip  : RA News bulletin creator
  252.      plus much more
  253.  
  254.      Call the BBS:
  255.  
  256.            The Renegade BBS  (915)-592-9687 2400 - 28800 V.34
  257.            FidoNet: 1:381/149
  258.            Internet:  DMaupin435@AOL.Com or renegade@dzn.com
  259.  
  260.            Online registration is now available... :-)
  261.  
  262.      VISIT OUR INTERNET HOMEPAGE:
  263.  
  264.        http://www.dzn.com/renegade/renegade.htm
  265.  
  266.  
  267. CREDITS
  268. -------
  269.  
  270.      - Mike Woltz who wrote Spitfire BBS for the idea.
  271.  
  272.      - Jay Hanig who made corrections and wrote these docs for me. Thanks Jay.
  273.          Call Jay's Mean Machine (1:379/41) at: (704)-552-8801 V.34
  274.  
  275. BETA TEAM
  276. ---------
  277.    Jay Hanig -  Jay's Mean Machine (1:379/41) at (704)-552-8801 V.34  (RA)
  278.    Steve Watson - The Golden Saber BBS (1:128/235) at (719)-576-8227 V.34 (PB)
  279.    Robert Szarka - Sea of Noise (1:320/42) at (860)-886-1441 (RA)
  280.    David Hickey - The North Star (1:261/1108) at (410)-974-9305 (RA)
  281.    Mike Roark - The Beachcomber (2:2490/7009) at (49)-9827-4766
  282.    Arthur Stark - Tops Diamond Mine I & II (1:395/670) at (817)-542-8783
  283.    Tom Barstow - Little America (1:271/290) at (804)-564-9013
  284.  
  285.  
  286. SUPPORT / DIST SITES
  287. --------------------
  288.  
  289.      The Golden Saber          Jay's Mean Machine     The BeachComber
  290.      Steve Watson              Jay Hanig              Mike Roark
  291.      Colorado Springs, CO.     Charlotte, NC.         Langenloh, Germany
  292.      (719) 576-8227            (704) 552-8801         (49)-9827-4766
  293.      Fidonet: 1:128/235        Fidonet: 1:379/41      Fidonet: 2:2490/7009
  294.  
  295.  
  296.