home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / RBTCH220.ZIP / EXTRA.ZIP / FAKEXFER.ZIP / FAKEXFER.DOC next >
Text File  |  1992-12-15  |  17KB  |  410 lines
  1.  
  2.  
  3.  
  4.                           -----------------
  5.                           F A K E - X F E R
  6.                           -----------------
  7.  
  8.                    A File Posting Utility for SysOp's
  9.                       Running RBBS-PC and RBatch
  10.  
  11.  
  12.  
  13.  
  14.                       FAKEXFER.EXE - Version 1.05
  15.                           Dan Shore - SysOp
  16.                           December 18, 1992
  17.                           THE SHORELINE BBS
  18.                         301-946-2771 (v.32bis)
  19.                       DGS Systems Group (Wonder)
  20.  
  21.  
  22.  
  23.  
  24.  
  25. A.  What is FAKEXFER?
  26.     -----------------
  27.  
  28. Have you ever called another BBS to "suck files" and then have to
  29. go through the hassel of posting them manually to your FMS/.DIR
  30. file system?  Well this program was written to try to ease that
  31. burden of a SysOp's Life.
  32.  
  33. By using this program along with RBatch, you can now get
  34. assistance with your file posting.  Once you have created your
  35. "FakeXfer" file (see Section C - Running FakeXfer), you then
  36. run RBatch (see Section D - Using RBatch with your FakeXfer)
  37. and start to categorize your uploads.  If the file has a
  38. FILE_ID.DIZ or a DESC.SDI inside of it, then that description
  39. will be used for the file currently being processed.
  40.  
  41. See the .doc file in CAP2DOZ.ZIP for an easy way to prepare .DOZ
  42. files from captured file lists.
  43.  
  44. If the file does not have an internal description file, and if you
  45. have created a .DOZ (Description Outside of Zip - (C) 1992 Dan Shore)
  46. file, this description from the .DOZ will be used.  Also, if the .DOZ
  47. file contains a category code, then this category code is used and
  48. no intervention is needed by the SysOp when RBatch is processing files.
  49. In other words, AUTOMATIC FILE POSTING WITH MINIMAL WORK BY THE SYSOP!!!
  50.  
  51.  
  52. RBatch will always try to process a FILE_ID.DIZ or DESC.SDI file
  53. before using a .DOZ file, unless the configuration file is setup
  54. to have .DOZ's take priority.
  55.  
  56.  
  57. ******************* AUTOMATED UPLOADS **********************
  58.  
  59. If a file has a FILE_ID.DIZ or a DESC.SDI and a .DOZ file is also
  60. present, RBatch will use the description from the FILE_ID.DIZ or
  61. DESC.SDI and then use the category code from the .DOZ file.  This
  62. means that once a SysOp/user starts an upload from RBBS with this
  63. scenario, no intervention is needed as RBatch takes care of everything!!
  64.  
  65. If there is no FILE_ID.DIZ, DESC.SDI or .DOZ file, then RBatch
  66. will prompt you for the file description, and category code.
  67.  
  68.  
  69.  
  70. B.  What is a .DOZ file?
  71.     --------------------
  72.  
  73. The .DOZ file was created for the type of files that cannot
  74. accept a FILE_ID.DIZ or a DESC.SDI.  What types of files are these
  75. do you ask?  Well, any file that cannot accept another file "inside"
  76. of a file (.GIF's are an excellent example).  Remember that the
  77. .DIZ or .SDI are just text files that are added into compressed files.
  78.  
  79. Also, .DOZ files are very useful when you are posting files locally
  80. to your BBS with RBatch & FakeXfer.  As you decompress a file to read the
  81. doc's to figure out what you have just "sucked" for your BBS, you can
  82. cut and paste a section of the documentation that describes the
  83. file and put that in the .DOZ
  84.  
  85. The best way to create a .DOZ is to screen capture the file listing on
  86. the BBS that you are downloading the files from.  Then run the CAP2DOZ
  87. program which will read the captured file listing, prompt you for a
  88. filename to process and ask you what category that file should have.
  89. It then makes the .DOZ file for you with out having to re-type the file
  90. description or do any editing of the captured file list.
  91.  
  92. **************************************************************************
  93. * REMEMBER THAT THE .DOZ FILE CONTAINS "ALL" THE FILENAMES THAT YOUR ARE *
  94. * UPLOADING OR POSTING LOCALLY.  DO NOT USE MORE THAN ONE (1) .DOZ FILE  *
  95. * WITH RBATCH OR IT WILL NOT WORK.                                       *
  96. **************************************************************************
  97.  
  98. B-1.  The .DOZ File Structure
  99.       -----------------------
  100.  
  101. The .DOZ filename can be anything as long as it is a legal DOS filename.
  102. The internal structure of a .DOZ is as follows:
  103.  
  104.                 {FI dflat8.zip window x
  105.                 Description of file goes here with a maximum
  106.                 line length of 75 characters and a maximum
  107.                 of 10 lines
  108.                 {FI jiklan.zip window
  109.                 Description of file goes here with a maximum
  110.                 line length of 75 characters and a maximum
  111.                 of 10 lines
  112.                 {FI ved201.zip utils n dan shore
  113.                 Description of file goes here with a maximum
  114.                 line length of 75 characters and a maximum
  115.                 of 10 lines
  116.  
  117.  
  118. Line 1 :  ALWAYS STARTS WITH A {FI and then the filename.  Note
  119.           that there is a space between the {FI, filename, &
  120.           the category code.  Do not use a path for the file.
  121.           (The {FI is the  Smart Text variable for FileName in
  122.           RBBS, hence it seemed logical to use this as part of
  123.           the structure)
  124.  
  125.    #####  The text MUST START AT THE LEFT MARGIN.  (The example
  126.           above starts in the middle of the screen for ease of
  127.           reading).
  128.  
  129.           The category code is the code that a user would normally
  130.           type when prompted to categorize a file.  This is NOT
  131.           THE THREE DIGIT CODE in your FMS.  For example if your
  132.           DIR.CAT had this entry:
  133.  
  134.           "GAMES","GAM","All Games"
  135.  
  136.           The .DOZ entry would look like this:
  137.  
  138.           {FI WARRIORS.ZIP GAMES
  139.           This is a great graphical warrior game
  140.  
  141.  
  142.           The next field is if you are going to be uploading a
  143.           personal file to the BBS.  If you use a "X", this tells
  144.           RBatch to not prompt the user to see if the file is
  145.           a personal upload or not.  If you use the following
  146.           codes:
  147.  
  148.           N = UserName for personal file
  149.           S = Personal Upload to SysOp (No additional field needed)
  150.           L = Personal Upload to security level
  151.           D = Personal Upload to a distribution list
  152.  
  153.           If you use one of these codes, the RBatch EXPECTS to see
  154.           a value in the next field after this letter (except for
  155.           the SysOp personal upload).
  156.  
  157.  
  158. Line 2 thru 11 :  The description of the file to be posted, with
  159.                   a maximum line length of 80 chars and a maximum
  160.                   of 10 lines.
  161.  
  162.  
  163. --------------------------- IMPORTANT ------------------------------------
  164.  
  165. The .DOZ file is uploaded to a BBS as part of the Uploading process and
  166. can be sent first, in the middle, or last, it does not matter.
  167.  
  168. REMEMBER THAT THE .DOZ FILE CONTAINS "ALL" THE FILENAMES THAT YOUR ARE
  169. UPLOADING OR POSTING LOCALLY.  DO NOT USE MORE THAN ONE (1) .DOZ FILE
  170. WITH RBATCH OR IT WILL NOT WORK.
  171.  
  172. When using .DOZ files for local posting by the SysOp, you want your .DOZ
  173. file TO BE IN THE SAME DIRECTORY as the files that FAKEXFER is processing.
  174. After the fakexfer file is generated, the .DOZ file will be copied to the
  175. upload directory with all the other files.  If the .DOZ file is not in the
  176. upload directory, RBatch will not recognize the it, hence you will be
  177. prompted for descriptions/categories.
  178.  
  179. --------------------------------------------------------------------------
  180.  
  181.  
  182.  
  183. C.  Running FAKEXFER
  184.     ----------------
  185.  
  186. You can run FAKEXFER two ways.  First just type the program name
  187. and the opening menu will appear as shown below.  Or type the program
  188. name with the five command line parameters needed as follows:
  189.  
  190.  
  191.         FAKEXFER FAKEXFER.DEF C:\JUNK C:\DAN D:\NEW Y X
  192.                      ^           ^       ^      ^   ^ ^
  193.                      1           2       3      4   5 6
  194.  
  195.         Note that these numbers correspond with the descriptions
  196.         following the example below.
  197.  
  198.         Parameter #5 is optional.  If ommited or if the letter "X"
  199.         (no quotes) is used, the program deafults to "N" for this
  200.         parameter.
  201.  
  202.         Parameter #6 is if you wish the progrm prompt you to "
  203.         Strike any key to exit program" or not.  If you put the
  204.         letter "X" (no quotes) here, you will not be prompted.
  205.  
  206.         NOTE:  If you do not use parameter #5, you can put "X" (no quotes)
  207.                as parameter #5 and FAKEXFER will then:
  208.  
  209.                1.  NOT PROMPT YOU TO HIT ANY KEY
  210.                2.  NOT CHECK FOR DUPLICATE FILES
  211.  
  212.  
  213.  
  214. If you just type the program name itself a color menu will appear just
  215. like the example below:
  216.  
  217.  
  218.                            F A K E - X F E R
  219.                           By Dan Shore -- SysOp
  220.                             THE SHORELINE BBS
  221.                               (301)946-2771
  222.                        DGS Systems Group - (Wonder)
  223.  
  224.  
  225.    Enter Name of the XFER-?.DEF File to create (Filename Only, No Path)
  226.    : xferup.def
  227.    Enter Path/Directory where XFER File should be created
  228.    : c:\junk
  229.    Enter the Full Path to the directory of the files to be processed
  230.    : c:\files
  231.    Enter Path/Directory where Processed Files are copied to
  232.    : d:\uploads
  233.    Copy files if they exist in Destination Directory (Y/N/X)
  234.    :
  235.  
  236. Note that your repsonses are at the ":" prompt.  I will cover each item now.
  237.  
  238.  
  239. 1. This is the name of the Xfer file that you wish to create.  Do not
  240.    create a Xfer file that might conflict with your BBS, if you are
  241.    doing this while the BBS is up.  (Example:  XFER-1.DEF - Don't use)
  242.  
  243. 2. The program will create the xfer file that you specified in line 1
  244.    in this directory.  Do not use the same directory that you specify
  245.    in the 3rd or 4th response!
  246.  
  247. 3. This is the directory that contains the files that you wish to post
  248.    to your BBS.  The only files in this specified directory should be
  249.    the ones that are to be posted!!  The program will search this
  250.    directory to get the file size and the filename of EACH FILE for
  251.    preparation of the "FakeXfer" file.  Note that your .DOZ file
  252.    should also reside in this directory if you are using one.
  253.  
  254. 4. This is where the processed files will be COPIED to, once the program
  255.    has generated the "FakeXfer" file.
  256.  
  257. 5. If the files exist in the destination directory, should FAKEXFER
  258.    still copy/process the file.  If you put the letter "X" here,
  259.    this parameter defaults to "N" and FAKEXFER will not prompt you
  260.    to "Strike any key to exit program".
  261.  
  262.    NOTE: This parameter is optional and if omitted, the program will
  263.          DEFAULT to "N".
  264.  
  265.  
  266. Notes:  Make sure that the path given for the "Fake" Xfer file is the
  267.         same as the one in your special RBatch Configuration File.
  268.         (Line 11 of your RBatch Configuration File)
  269.  
  270.         Make sure that the path to copy the processed files to,
  271.         is the same as your Upload Path in your special RBatch
  272.         Configuration File. (This is the first line in your RBatch
  273.         Configuration File)
  274.  
  275.  
  276. D.  Using RBatch with the "Fake" Xfer File
  277.     --------------------------------------
  278.  
  279. I recommend that you copy one of your RBatch Configuration files to
  280. make a specific file for the "FakeXfer" program to work with.   Make
  281. sure that you have the correct "FakeXfer" filename listed in this new
  282. configuration file.
  283.  
  284. Now to be able to use the "Fake" Xfer with RBatch type the following
  285. command, which will allow RBatch to run in "Local" Mode.
  286.  
  287.                RBatch C:\Fake\Batchup.Cfg 0 Z 2
  288.                  ^            ^           ^ ^ ^
  289.                  1            2           3 4 5
  290.  
  291. 1.  RBatch program name
  292. 2.  Name of configuration file with path to it, if in a directory
  293.     other than the current directory.
  294. 3.  Port Number (0 = Local)
  295. 4.  Protocol Letter (Your Choice)
  296. 5.  Node Number (A "Local Node" Number is highly recommended)
  297.  
  298.  
  299. Notes:
  300.  
  301.      - If you use a Node Number other than a local one, the last person
  302.        who was on that node will be given upload file credits, so using
  303.        a local node will prevent this.  This way you the SysOp who uses
  304.        the local node will get the file credits!  This makes you look
  305.        very good in your BBS Statistics if you keep them for the SysOp!
  306.  
  307.      - Why if you don't use a local node number will someone else get
  308.        file credits?  Good Question....10 Points for you!  What happens
  309.        is that RBatch reads the Node Record for the username and then
  310.        gives that use the file credits.
  311.  
  312.      - In your RBatch Configuration file, for this "Fake" Xfer posting,
  313.        the callers file that you list will be the one that RBatch
  314.        also posts information to.  If you wish, you can create your own
  315.        callers file just for this program or again use the callers
  316.        file for the Local Node.
  317.  
  318. **** - If you are running RBBS 17.3C or below, RBatch will have to make
  319.        its own DORINFO?.DEF file.  To be able to tell who the user is,
  320.        RBatch reads the NODE RECORD of the message base (1st field - this
  321.        file format is described in Appendix A of the RBBS manual).  Why
  322.        is this important?  Well, if you are posting files locally and you
  323.        only have a single node system (no local node), the username that
  324.        was last on the BBS, (name in node record) will be used in the
  325.        dorinfo?.def file.  So, this means that user will get the file
  326.        credits for the files that you are posting.
  327.  
  328.        How do you get around this?  There are three ways:
  329.  
  330.        1.  Make a local node on your BBS, and sign on at least once.
  331.            Since the SysOp is the only one with access to the local
  332.            node, the SysOp name will always be used as the name in
  333.            the dorinfo?.def file.
  334.  
  335.        2.  Log onto your Node1 as the SysOp before posting files
  336.            using RBatch to your BBS.
  337.  
  338.   #### 3.  Get a copy of a dorinfo?.def file and rename it DORINFO0.DEF
  339.            Then in your configuration file, specify "NO" to  have
  340.            RBatch make a configuration file and list DORINFO0.DEF
  341.            as the file for RBatch to use.  Make sure that you edit
  342.            the dorinfo file so that it has COM0 as the port number,
  343.            and SYSOP as the first name and a blank line as the second
  344.            name.  I RECOMMEND THIS METHOD IF YOU DO NOT USE A LOCAL
  345.            NODE ON YOUR BBS!!
  346.  
  347.  
  348.  
  349. E.  FILE_ID.DIZ, DESC.SDI, or FILENAME.DOZ ?
  350.     ----------------------------------------
  351.  
  352. If the file that your are posting has a .DIZ or .SDI, that file
  353. will be used for the description.  If it does not and a .DOZ file
  354. exists in the upload directory, then the description will be used
  355. from the .DOZ file.  If none of these files exists, RBatch will
  356. prompt you for a description.
  357.  
  358. .DOZ files can take precedence over .DIZ/.SDI files by turning on
  359. this option in the configuration file. (See Sample.Cfg)
  360.  
  361.  
  362. F.  Upload Categorization
  363.     ---------------------
  364.  
  365. If you specify a category code in the .DOZ file, RBatch will compare
  366. this code to your DIR.CAT file, and if there is a match, you will not
  367. have to categorize the file.  If the file contains a .DIZ or .SDI and
  368. you also have a .DOZ file, the file description will be used from the
  369. .DIZ/.SDI file, and the category will be used from the .DOZ file.  This
  370. makes the local file posting totaly automated once you start RBatch.
  371.  
  372.  
  373.  
  374. G.  Screen Capture from another BBS System and posting the files
  375.     to your BBS with Minimal Editing!  -  Use the Progrm CAP2DOZ
  376.     ------------------------------------------------------------
  377.  
  378.  
  379.     ** READ THE .DOC FILE IN CAP2DOZ.ZIP for more information **
  380.            on using CAP2DOZ with captured file listings
  381.  
  382. Here is what a file listing might look like before editing:
  383.  
  384. FILENAME.ZIP  234556 08-18-92  Here is a file that you all should have
  385.                                in your file library.  It is slick, fast
  386.                                and the best thing since sliced bread.
  387.                                Download today and try it out for yourself.
  388.  
  389.                 - or -
  390.  
  391. FILENAME.ZIP  234556 08-18-92  Here is a file that you all should have
  392.   in your file library.  It is slick, fast and the best thing since sliced \
  393.   bread. Download today and try it out for yourself.
  394.  
  395.  
  396. Now here is the same file after editing it for a .DOZ file either
  397. editing by hand or using CAP2DOZ:
  398.  
  399. {FI FILENAME.ZIP MISC
  400. Here is a file that you all should have
  401.                                in your file library.  It is slick, fast
  402.                                and the best thing since sliced bread.
  403.                                Download today and try it out for yourself.
  404.  
  405. Note that the size and date are edited out which brings the first line
  406. to the left margin, but the rest of the text need not be touched at
  407. all!!  RBatch will read this file and "strip" out all the extra spaces
  408. and post this file to your FMS or .DIR system properly.
  409.  
  410.