home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / RBTCH242.ZIP / DOCS.ZIP / RBATCH.DOC < prev    next >
Text File  |  1994-03-13  |  64KB  |  1,761 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                       ------------------------------------
  22.                         RBatch - RBBS-PC Batch Uploading
  23.                                HS/Link, & BiModem
  24.                                     Interface
  25.                       ------------------------------------
  26.  
  27.  
  28.  
  29.  
  30.                               RBatch Version 2.42
  31.                                  March 13, 1994
  32.                         (C) by Dan Shore - 1991,92,93,94
  33.                               By: Dan Shore - SYSOP
  34.                                 THE SHORELINE BBS
  35.                                  (301-946-2771)
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.                                 TABLE OF CONTENTS
  46.                                 -----------------
  47.  
  48.  
  49.      A. INTRODUCTION
  50.           1.  What is RBatch ....................................  3
  51.           2.  What it does ......................................  3
  52.  
  53.      B. INTERFACING RBATCH WITH RBBS-PC
  54.           1.  The RBatch Configuration File .....................  4
  55.           2.  Line-by-line analysis of the configuration file ...  4
  56.           3.  Additional notes on the configuration file ........ 17
  57.           4.  The RBBS-PC Proto.Def Setup ....................... 18
  58.           5.  Batch Files used in Proto.Def ..................... 19
  59.           6.  The RBatch Command Line ........................... 20
  60.           7.  SysOp Designed Batch Files ........................ 21
  61.           8.  Batch File Passed Parameters ...................... 21
  62.           9.  Calling other testers from the batch files ........ 21
  63.           10. Batch File Examples ............................... 22
  64.           11. Colorized Batch Files ............................. 22
  65.           12. Alternate Batch File Names ........................ 24
  66.           13. Flexibility in RBatch File Processing ............. 25
  67.  
  68.      C. MISCELLANEOUS INFORMATION
  69.           1.  Use of Recovery with Protocols and RBatch ......... 25
  70.           2.  User Time-Outs and Dropped Carriers ............... 25
  71.           3.  RBatch Error Logging .............................. 26
  72.           4.  What Do The Included Merges Do .................... 27
  73.           5.  Why Is RBatch An External Program ................. 27
  74.           6.  Companion Program For RBatch ...................... 28
  75.           7.  Warranty And Disclaimer ........................... 28
  76.           8.  Registration ...................................... 28
  77.           9.  Acknowledgments ................................... 29
  78.           10. Last Minute Notes ................................. 30
  79.           11. Support ........................................... 31
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.                                 - 2 -
  97.  
  98.  
  99. A.                             INTRODUCTION:
  100.  
  101. A-1.     What is RBatch?
  102.          ---------------
  103.  
  104. RBatch is an upload interface utility for RBBS-PC Bulletin Board Systems.
  105. RBatch enables RBBS-PC (versions 12.x-17.4) to receive and process BATCH
  106. uploads.  It is an EXTERNAL program (NO code modification is necessary)
  107. that is called by RBBS after file transfers. It reads a standard, "true"
  108. DSZ log file (XFER-?.DEF) generated by most of today's better file transfer
  109. protocols, and reports the uploaded information to RBBS's system files
  110. in ways that make the SysOp's job much easier and less time-consuming.
  111. RBatch is fossil-aware, but does NOT require a fossil to run.
  112.  
  113. RBatch also is the interface for the new and extremely popular protocol,
  114. HSLINK, by Sam Smith--and the BiModem bi-directional protocol.
  115.  
  116.  
  117. A-2.     What it does?
  118.          -------------
  119. RBatch is called after file transfers are completed, and will:
  120.  
  121.      - check each file uploaded to see if it is a DUPLICATE of
  122.         a file already on the BBS.   This is accomplished by RBatch
  123.         checking the FFS (FIDX.DEF & FIDXT.DEF) and/or the SysOp
  124.         designated directories that are listed in the RBatch
  125.         configuration file.
  126.  
  127.      - check uploaded file INTEGRITY with SysOp designed batch files.
  128.         Files may be scanned for viruses, unwanted uploads, files too
  129.         old, etc.  Comments and logos may be stripped or added in these
  130.         BATCH FILES.
  131.  
  132.      - ask the user for an upload CATEGORY (if security level allows),
  133.         and a DESCRIPTION of the file.  Or, optionally, process
  134.         FILE_ID.DIZ, DESC.SDI or .DOZ files AUTOMATICALLY and post
  135.         the file descriptions in them to the FMS.  No TYPING!
  136.         (See WHATISA.DOZ for details on RBatch's new and revolutionary
  137.         .DOZ File Descriptions Process).
  138.  
  139.      - post all necessary information to the FMS directory, USERS,
  140.         & CALLERS files.
  141.  
  142.      - Award time credits for the upload based on the user's security level.
  143.  
  144.      - Works for regurlar uploads as well as Personal Uploads
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.                                 - 3 -
  156.  
  157.  
  158.  
  159.   ***********************************************************************
  160.   * NOTE:  RBatch is responsible for the logging and processing of ALL  *
  161.   *        uploaded files, while RBBS is responsible for ALL downloaded *
  162.   *        files.                                                       *
  163.   ***********************************************************************
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170. B.                      INTERFACING RBATCH WITH RBBS:
  171.  
  172. Three things are crucial to the proper "marriage" between RBatch and
  173. RBBS-PC:
  174.  
  175.         1.  The RBatch configuration file.  (Which you must create.)
  176.         2.  The RBBS PROTO.DEF file. (Which you must modify.)
  177.         3.  The Batch Files that are in the Proto.Def.  Example are
  178.             included, just change them to match your system.
  179.  
  180. B-1.     The RBatch configuration file:
  181.          ------------------------------
  182.  
  183. Here is the layout and description of each line in the RBatch
  184. configuration file.  (Note that the configuration file CANNOT
  185. have comments like those in the example below!):
  186.  
  187. D:\Uploads;YES                                       <-- 1  Path to upload directory;Pause Prompt
  188. No;C:\Rbbs\Dorinfo[NODE].Def                         <-- 2  Create;Path to DORINFOx.DEF
  189. ZIP;LZH;ARJ;ZOO;EXE                                  <-- 3  Archive types to check for
  190. 5,50;10,100;15,150;20,200                            <-- 4  Security level,credit parameters
  191. C:\Rbbs\Master.Dir;NONE;YES                          <-- 5  FMS;2nd place to write;Strip periods from Filenames
  192. BLANK                                                <-- 6  Path to NON-FMS dirs
  193. C:\Rbbs\Messages                                     <-- 7  Path to RBBS MSG file
  194. C:\Rbbs\Users                                        <-- 8  Path to RBBS USERS file
  195. C:\Rbbs\Caller[NODE]                                 <-- 9  Path to RBBS CALLERS file
  196. C:\Rbbs\Dir.Cat                                      <-- 10 Path to RBBS directory categories
  197. C:\Rbbs\Xfer-[NODE].Def;C:\Rbbs\Menu0-[node].Def     <-- 11 Path to DSZ transfer log;Path to MENU0 information file
  198. SECRET NAME                                          <-- 12 SYSOP'S secret name
  199. 5;C:\Rbbs\Upcat.Hlp                                  <-- 13 SEC for cat.;Hlp file for upcat
  200. FMS                                                  <-- 14 Using FMS or .DIR
  201. UNC                                                  <-- 15 Default category code
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.                                 - 4 -
  212.  
  213.  
  214. ZIP                                                  <-- 16 Extension to convert to
  215. YES;YES                                              <-- 17 Save files on timeouts/errors?;Delete partial uploads?
  216. NO                                                   <-- 18 Using FOSSIL?
  217. 46                                                   <-- 19 # characters in first description line
  218. 5;YES;YES                                            <-- 20 # of ext. description lines;BamaWho Support;Post SysOp for Bama Who
  219. YES;C:\Fidx.Def;C:\Lidx.def;200                      <-- 21 Use FFS system?;location of FIDX;location of LIDX;Sec Level for Overwrite
  220. C:\Rbbs\Dupelist.Lst                                 <-- 22 Additional DIRs to look for dupes
  221. DV                                                   <-- 23 Environment running
  222. THE SHORELINE BBS                                    <-- 24 BBS Name
  223. 00000000000000000000                                 <-- 25 Registration # (or all 0's)
  224. YES;D:\WORK;F:\TC\ARC.LST;DOZ                        <-- 26 Use Desc. Files;Work Dir.;Archive list;DOZ Priority
  225. YES;10;F:\PRIVATE\PRIV.DIR;YES                       <-- 27 Use Personal;Sec. Level;Path/Name of personal file;Post username who upld.
  226. YES;10;F:\DAN\;DIST.HLP                              <-- 28 Use Dist. Lists;Security to use Dist. List;Path to lists;Dist. Help filename
  227. YES;5;20;1;31                                        <-- 29 Use Ext. Desc;# of lines;Sec Level for sec Uploading;start pos;length
  228. 100;BATCH.BAT;BATCH1.BAT                             <-- 30 Sec Level to bypass batch files;batch file names
  229. YES;5,25;10,35;25,50;50,100                          <-- 31 Use Upload Byte Credits;Security Level,Percentage
  230. YES;NO                               ###             <-- 32 Use LARGE FMS (BusiMods);Use RFM
  231.  
  232.            < ### = Denotes New Parameters for RBatch 2.42 >
  233.  
  234. This is the heart of the RBatch process.  This text file tells RBatch
  235. the name and location of all the files that it needs or uses on your
  236. system.  It sets security levels, upload credits, paths, duplication
  237. checking methods, designates batch files to call scanning programs and
  238. archive checkers, and much more.
  239.  
  240. This file may be created with your favorite editor, like QEdit or QDos
  241. editor, and may be named anything you wish, or stored anywhere on the
  242. system.  All you need to do is tell RBatch the name and location of
  243. its configuration file on the RBatch command line.  THERE IS NO
  244. DEFAULT FILENAME THAT RBATCH LOOKS FOR.
  245.  
  246.  
  247.  
  248.  
  249. B-2.    Line-by-line analysis of the RBatch configuration file:
  250.         -------------------------------------------------------
  251.  
  252. 1.  Path to Upload Directory;Pause Prompt
  253.  
  254.       - This is the full path to your Upload Directory.
  255.         (Path/Dir - NO TRAILING BACKSLASH)
  256.  
  257.       - 20 Second Pause Prompt - enter YES after semi-colon.  If you
  258.         just have your path to the Upload Directory and NO SEMI-COLON
  259.         then the feature is DISABLED.  The pause prompt stays for 20
  260.         seconds or until user hit ENTER Key.
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.                                 - 5 -
  271.  
  272.  
  273.  
  274.         Pause prompt looks like this:   Press [ENTER] to continue: . . .
  275.         Dots will go back and forth until user hits enter or 20 Secs.
  276.         passes
  277.  
  278. 2.  Shall RBatch create a DORINFOx.DEF;Path/name of the DORINFOx.DEF file:
  279.  
  280.         First parameter MUST be either YES or NO.  If you are
  281.         running RBBS-17.4, you would specify "NO." (RBBS v.17.4
  282.         is the first version to create its own DORINFOx.DEF file
  283.         for DOORING protocols) for the first parameter, and the
  284.         location of the DORINFOx.DEF file for the second parameter.
  285.         All earlier versions of RBBS prior to 17.4 specify "YES"
  286.         and RBatch will create a "working" copy of the DEF file in
  287.         this specified location.  (Note semicolon...)
  288.  
  289.         If you examine this file when RBatch creates it,
  290.         you will notice that it does not have the "normal"
  291. ====    DORINFO information in it.  Do not be concerned, I only   ====
  292.         write the information I need to run RBatch.
  293.  
  294.             NO  = RBatch DOES NOT create ; path to RBBS's (17.4) own file
  295.             YES = RBatch DOES create ; where you want us to put it
  296.  
  297. 3.  Extensions to check for duplicates -- or NONE:
  298.  
  299.         This parameter allows the SysOp to specify which
  300.         extensions to check when RBatch checks for duplicates
  301.         of uploaded files.  If SysOp only wants the uploaded file
  302.         checked just input the word NONE here instead.
  303.  
  304.             ARC;ZIP;LZH;ZOO
  305.             NOTE: ALL THE EXTENSIONS MUST BE SEPARATED BY A SEMI-COLON!!!
  306.             MAXIMUM NUMBER OF EXTENSIONS = 15
  307.  
  308. 4.  Security Level,Time CREDIT percentage given for UPLOADS:
  309.  
  310.  
  311.         Time credits may now be assigned by security level(s).
  312.         The format for the Time Credit line in the configuration file is:
  313.  
  314.         SECURITY LEVEL1,PERCENTAGE1;SECURITY LEVEL2,PERCENTAGE2
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                 - 6 -
  329.  
  330.  
  331.  
  332.  
  333.  
  334.         Here is an example:    5,125;10,150;15,175;25,200
  335.  
  336.             Users with security levels LESS THAN OR EQUAL TO 5
  337.               would get 125%,
  338.             Users with security levels between 6 and 10 would get 150%,
  339.             Users with security levels between 11 and 15 would get 175%,
  340.             Users with security levels between 16 and 25 would get 200%.
  341.         ~(Note the way commas and semicolons are used on this line.)
  342.  
  343.  
  344.         You must have the HIGHEST value security level at the minimum
  345.         if just using one time credit percentage.  In other words, if
  346.         the highest security level of a user on your BBS is 100, and you
  347.         want ALL your users to have 100% time credits, then your
  348.         configuration line would be:
  349.  
  350.                        100,100
  351.  
  352.         Remember that RBatch checks to see if the user's security
  353.         level is LESS THAN OR EQUAL TO the security level(s) on this
  354.         line and then uses the associated percentage.
  355.  
  356.         Note also, that if you use multiple security levels, this line
  357.         should read (left to right) from lowest security level to the
  358.         highest, just like the examples.
  359.  
  360.         Currently you may define up to twenty security levels.
  361.  
  362.         The amount of time credit received (based on the percentage) is
  363.         calculated as shown in these examples:
  364.  
  365.             Ex. # 1  -  File upload time = 5:00 Minutes
  366.                         Time Credit%    = 150% (7:30 Minutes)
  367.                         5:00 + 7:30      = 12:30 of Time Credits
  368.             Ex. # 2  -  File Upload Time = 5:00 Minutes
  369.                         Time Credit%     = 50% (2:30 Minutes)
  370.                         5:00 + 2:30      = 7:30 of Time Credits
  371.             Ex. # 3  -  File Upload Time = 5:00 Minutes
  372.                         Time Credit%     = 0%
  373.                         5:00 + 0         = 5:00 of Time Credits
  374.  
  375.         The User always gets the time back it took to upload the file,
  376.         plus the percentage that you assign in the configuration file.
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.                                 - 7 -
  387.  
  388.  
  389.  
  390.  
  391. 5.  Path/Name primary FMS/.DIR;Path/Name secondary FMS/.DIR;Remove period
  392.  
  393.         This is the text directory where the uploaded filenames and their
  394.         descriptions are WRITTEN.  If you wish to post this information
  395.         to more than one file, list the path/name of the second file AFTER
  396.         the Semi-Colon.  If you do not wish to post to more than one file,
  397.         then you must enter "NONE" as the second parameter.  The last
  398.         parameter will post the filenames without the period.  RBatch will
  399.         pad with spaces and line up the extensions.  DO NOT USE ANY
  400.         PARAMETER PAST THE SECONDARY FILENAME IF YOU WANT PERIODS!
  401.  
  402. 6.  Path to the .DIRs - Enter the word "BLANK" if using FMS:
  403.  
  404.         This is the path to where your .DIR's are.  An example of
  405.         this is:
  406.  
  407.                         C:\FILES\
  408.  
  409.  
  410.  
  411. 7.  Path/Name to MESSAGES File: (Self Explanatory)
  412.  
  413. 8.  Path/Name to USERS File:    (Self Explanatory)
  414.  
  415. 9.  Path/Name to CALLERS File:  (Self Explanatory)
  416.  
  417. 10. Path/Name to DIR.CAT File:  (Self Explanatory)
  418.  
  419.  
  420. 11. Path/Name to XFER-?.DEF File;Path/Name of MENU0 information Files
  421.  
  422.     A.  Protocols ALWAYS write the Xfer-?.Def file in the CURRENT directory
  423.         when the protocol is invoked.  Make sure that you have your
  424.         SET DSZLOG=XFER-?.DEF (? = Node #) in your AUTOEXEC.BAT or your
  425.         DESQVIEW startup window batch file.  Do not use a path in
  426.         your SET DSZLOG statement.  For example, if you are in the
  427.         RBBS directory when you execute DSZ, the XFER-?.DEF file
  428.         will reside in the  RBBS Directory. If you change to your
  429.         upload directory when you invoke DSZ, the XFER-?.DEF file
  430.         will reside in your upload directory.  Note that RBatch
  431.         will DELETE the XFER-?.DEF file, when there are just uploads.
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.                                 - 8 -
  445.  
  446.  
  447.         If you are doing bidirectional transfers, the XFER will have
  448.         to be located in the current directory as the user when doing
  449.         a transfer (the Main RBBS directory or the Node Directory).
  450.         RBatch will not delete the XFER due to RBBS needing to "see"
  451.         the XFER file to report a successful transfer.
  452.  
  453.     B.  The second part of this entry is the path/filename of the
  454.         information file that is used in the MENU0 merges.  If you
  455.         do not use the MENU0 merges, you do not need the 2nd part
  456.         of this entry.
  457.  
  458. 12. SysOp's secret name :
  459.  
  460.         Enter "BLANK" if you do not wish the USERS file to be updated
  461.         with file count information for SysOp file transfers.
  462.  
  463.         Also if you wish to be notified of a personal upload you MUST
  464.         use your Secret Name, otherwise RBatch does not know who you
  465.         are and cannot set the personal upload flag.
  466.  
  467. 13. Min Security Level to Categorize;Path/Name of UPCAT.HLP File:
  468.  
  469.         The First Parameter is the MINIMUM security level a user must have
  470.         in order to categorize a file that he/she uploaded.  If their level
  471.         is LOWER than this value, the uploaded file will have the default
  472.         category code for FMS (line #15), and in the .DIR system, will be
  473.         posted to the file listed on line #5 in this configuration file.
  474.         The Second Parameter is the path/filename of the UPCAT.HLP file.
  475.  
  476.             < A useful feature for SYSOPS is that you do not have
  477.               to use the SAME UPCAT.HLP file you specify in RBBS's
  478.               CONFIG parameter #!  The file you specify here may
  479.               display entirely different categories, or you may
  480.               create a special one for local/SYSOP only uploads! >
  481.  
  482.  
  483.  
  484.  
  485.         RBatch now supports colorized UPCAT.HLP files for users that
  486.         have color chosen as their graphics type.  The program will look
  487.  
  488.  
  489.         for the following:
  490.  
  491.         Non-Color Graphics Choice         Color Graphics Choice
  492.         -------------------------         ---------------------
  493.  
  494.             UPCAT.HLP                         UPCATC.HLP
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.                                 - 9 -
  505.  
  506.  
  507.  
  508.     You will note that the program looks for the filename with a "C"
  509.     appended to the filename.  If the "C" file does not exist then
  510.     the non-color file is used.  Also, remember that you can call
  511.     RBatch's UPCAT.HLP file whatever you wish, as long as it is specified
  512.     in the configuration file.
  513.  
  514. 14. Are you using FMS or .DIR?
  515.  
  516.             Enter:  FMS or DIR
  517.  
  518. 15. Default Category or Path/Name of SysOp-only uploads file (.DIR):
  519.  
  520.     This is the category given to uploads:
  521.             1. that are saved by the SysOp after a user times out
  522.                (falls asleep, too busy getting a beer, etc.) during or
  523.                after the upload WITHOUT entering the category.
  524.             2. if a user drops carrier during the upload process.
  525.             3. where the user does not have a high enough security level
  526.                to categorize uploads.
  527.  
  528.     If the SysOp is using the .DIR file system, then this entry will be
  529.     the path/name of the file that the SysOp wants the personal (/) uploads
  530.     posted to.  This file is only for the .DIR file system and not the FMS.
  531.  
  532. 16. Compression type all files are converted to:
  533.  
  534.     Enter "NONE" if you perform no conversions in your Batch File
  535.  
  536.     If you have batch files (PHASE?.BAT, CARCZIP.BAT, etc.) which convert
  537.     all uploaded files to a common format, enter the extension converted
  538.     TO here, otherwise, enter "NONE."
  539.  
  540. 17. Save files on User Timed Out or Dropped Carrier Uploads?;Delete Partial Files?
  541.             Enter:  YES or NO
  542.     ==== See section below on "User Time-Outs and Dropped Carriers"    ====
  543.  
  544.     If you just have YES on this line and nothing else, then RBatch will not
  545.     delete partial file uploads (uploads with "E" or "L" in the DSZLOG file).
  546.     If you wish to delete partial files, have this line entered as "YES;YES"
  547.     or "NO;YES".
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.                                 - 10 -
  560.  
  561. 18. Use Fossil Driver?
  562.  
  563.             Enter:  YES or NO
  564.  
  565.         RBatch has support for the fossil drivers X00 or BNU.
  566.         Enter either "YES" or "NO" on this line in the configuration file.
  567.  
  568.         (We also support 16550AFN UARTS.)
  569.  
  570.  
  571.  
  572. ==== If you run with a special type of COM Port setup (non-standard ====
  573.         IRQ's, etc.) you will be required to utilize a FOSSIL driver,
  574.         or RBatch will not function properly!
  575.  
  576. 19. Size of first FMS/.DIR File Description Line:
  577.  
  578.             Enter:  a number from 40 to 46
  579.  
  580. 20. Number of Lines for Extended Descriptions;Use BAMA support;Show SysOp on BamaWho
  581.  
  582.             Enter:  # of lines;YES or NO;YES or NO
  583.  
  584.      Place the value of the maximum number of lines you will allow in
  585.      your FMS/.DIR's for extended FMS descriptions as the FIRST parameter
  586.      on this line.  As a second parameter, enter either "YES" or "NO"
  587.      --"YES if you use the BAMA WHO mod for posting the name of the
  588.      uploader to the FMS, "NO" to disable this feature.
  589.      To suppres "Uploaded by SysOp", enter "NO" as the third parameter.  If
  590.      you want this statement posted, then enter "YES as the third param.
  591.  
  592. 21. Use FFS System;Path/Name of Fidx.Def file;Path/Name of Lidx.Def;Sec Level
  593.  
  594.     YES or NO - for using FFS System.
  595.  
  596.  
  597.     It is assumed that if the SysOp uses the TAB file of the FFS system,
  598.     that the filename is the same as the FIDX.DEF file, except that it
  599.     has a "T" in it & resides in the same directory as FIDX.  The security
  600.     level is who can overwrite an existing file if RBatch detects a
  601.     duplicate file.  RBatch will prompt the user to overwrite the existing
  602.     file and if user says "Y", RBatch copies the upload to the same directory
  603.     as the duplicate file and then deletes the file from the upload directory.
  604.  
  605. 22. Path/Name of file listing Directories to check for duplicate Uploads:
  606.  
  607.     This is a FILE that contains PATHS to file directories
  608.     to be checked for duplicate files in ADDITION to the ones that the
  609.     FFS already indexes. Here is an example of a listing:
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.                                 - 11 -
  620.  
  621.  
  622.  
  623.     Do not enter each of these paths in the configuration file!!
  624.     The filename you specify on the configuration line contains
  625.     these paths.
  626.  
  627.                     c:\temp\
  628.                     c:\testing\
  629.                     d:\other\
  630.  
  631. ==== (One directory per line, and each line MUST END WITH A BACKSLASH!) ====
  632.  
  633.     If you specify "NO" for using a FFS system in line #22, then this
  634.     list of directories is what is used by RBatch to check for duplicate
  635.     uploads.   ***   MAXIMUM NUMBER OF DIRECTORIES SUPPORTED = 80 ***
  636.  
  637. 23. Environment Running under (choose one):
  638.  
  639.             Enter:  DOS - Running RBBS-PC\RBatch in DOS
  640.                     DV  - Running RBBS-PC\RBatch in DV
  641.                     NET - Running RBBS-PC\Rbatch in a Network Environment
  642.                             that REQUIRES running DOS's SHARE.EXE
  643.  
  644.  
  645.  
  646. 24. BBS Name to appear on Registered Versions:
  647.  
  648.             Enter:  50 characters Maximum
  649.  
  650. 25. Registration Number:
  651.  
  652.             Enter:  20 Alpha-Numeric Registration Code
  653.  
  654.             (Input all "0"s if unregistered)
  655.  
  656. 26. Process .DIZ/.SDI/.DOZ files?;Work Directory;File with archive commands;DOZ Priority
  657.                  1                      2                 3                  4
  658.  
  659.             Enter:  1. YES or NO - This tells RBatch to process FILE_ID.DIZ,
  660.                                    DESC.SDI, or .DOZ files.
  661.                     2. Path to the work directory we will use to decompress
  662.                        the DIZ, DOZ*, or SDI file into.  NOTE: This directory
  663.                        must actually exist in order to process these files!
  664.                        RBatch creates, then deletes, NODE# directories under
  665.                        this specified directory.
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.                                 - 12 -
  676.  
  677.  
  678.                     3. The THIRD parameter is the filename that contains
  679.                        a list of archive extensions and their associated
  680.                        command lines for DEcompressing (unZIPping, unARCing,
  681.                        etc.) for the decompressors that you wish to support.
  682.                     4. DOZ files take priority over .DIZ/.SDI files if the
  683.                        word DOZ is the last parameter.  If no parameter is
  684.                        used .DIZ/.SDI files take precedence for file
  685.                        descriptions.
  686.  
  687.            Ex.:     ARC.LST (or whatever name you choose) is a text file
  688.                     like this:
  689.  
  690.                      ARJ;C:\RBBS\ARJ E
  691.                      ZIP;C:\PKZIP\PKUNZIP -O
  692.                         ^          ^
  693.                         1          2
  694.  
  695.            The FIRST part is the extension to process
  696.            The SECOND parameter is the path/command line
  697.            to use for that particular extension.
  698.  
  699. ==== NOTE: If a file is uploaded and its extension does not match an
  700.            entry in this file, the upload will not be checked for an
  701.            embedded description file (FILE_ID.DIZ or DESC.SDI).
  702.  
  703. *    For more information on .DOZ files, see the
  704.      WHATISA.DOZ file included in this archive.
  705.  
  706.      SysOp's now have the ability for the .DOZ file to OVERRIDE the
  707.      .DIZ/.SDI files.  If you wish to OVERRIDE, put ";DOZ" as the last
  708.      parameter on this line.  If you do not add anything to the end
  709.      of this line, the program will read a .DIZ/.SDI file before it
  710.      reads a .DOZ file for the file description.
  711.  
  712.      Here is an example of .DIZ/.SDI having priority:
  713.  
  714.              YES;D:\WORK;F:\TC\ARC.LST
  715.  
  716.  
  717.  
  718. 27.  Allow Personal Files;Sec Level;Path/Filename of Personal File;Upld UserName
  719.  
  720.  
  721.      This consists of 4 parts (each seperated by a SEMI-COLON) :
  722.  
  723.      a. Allow Personal Uploads - YES or NO
  724.      b. Security Level ( Greater than or equal to) to use Personal Uploads
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.                                 - 13 -
  736.  
  737.  
  738.      c. Path/Filename of the Personal Upload File (Priv.Def)
  739.         [This is the same directory as where your personal files are]
  740.      d. YES if you wish to have the Username of the person uploading the file
  741.         as part of the file description.
  742.  
  743.      IF YOU DO NOT WANT THE USERNAME AS PART OF THE DESCRIPTION, DO NOT
  744.      ADD ANYTHING AFTER THE PATH/FILENAME OF THE PERSONAL FILE!!
  745.  
  746. 28.  Allow Dist. Lists;Security Level to use List;Path to Distribution Lists;Name of Dist Help File
  747.  
  748.  
  749.      This consists of 4 parts (each seperated by a SEMI-COLON) :
  750.  
  751.      a. Allow distribution lists for Personal Uploads - YES or NO
  752.      b. Security Level to be allowed to use distribution lists.  This
  753.         security level must be equal to or greater than the .cfg level
  754.         in order to use the distribution list feature.
  755.      c. Path to directory that contains the distribution lists
  756.         [ NOTE:  THIS MUST END WITH A TRAILING BACKSLASH !! ]
  757.         Also, all distribution list MUST end with a .LST, as
  758.         per RBBS rules.
  759. ***> d. Distribution list help filename. - Please see what WHATSNEW file
  760.         for the format of this file.
  761.  
  762. 29.  Ext Descriptions;# of lines;Sec Level for Sec Level Pers Uploads;Start Pos.;Length
  763.  
  764.      This consists of 5 parts (each seperated by a SEMI-COLON) :
  765.  
  766.      a. Allow extended descriptions in persoal uploads - YES or NO
  767.      b. Number of extended description lines allowed
  768.      c. Security Level (greater than or equal to this) for a user to
  769.         be able to post a personal upload to a security level
  770.      d. Starting point in user record for identifying field
  771.      e. Length of identifying field from starting point in user record
  772.  
  773.      Note:  The most common way to use the Identifying field is to
  774.             start at 1 and have 31 characters (The persons Name).
  775.             Check your RBBS configuration file to see what you have
  776.             set up as your identifying field.  The default for RBBS
  777.             is the username (start = 1, length = 31).
  778.  
  779. 30.  Sec Level;Batch file;Batch file;Batch file
  780.  
  781.       --- This is new in RBatch version 2.00 ---
  782.      This consists of 1 to 4 parts  (each seperated by a SEMI-COLON) :
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.                                 - 14 -
  794.  
  795.  
  796.  
  797.  
  798.     - Part 1 is mandatory while parts 2-4 are optional -
  799.                  ^^^^^^^^^                     ^^^^^^^^
  800.      a. Security Level (greater than or equal to) to bypass the batch
  801.         files to check uploads.
  802.      b. Name of the first batch file to check uploads
  803.      c. Name of the second batch file to check uploads
  804.      d. Name of the third batch file to check uploads
  805.  
  806.      If no batch files are named, the program defaults to using
  807.      PHASE1.BAT, PHASE2.BAT & PHASE3.BAT IF THEY EXIST.  Note that
  808.      the batch file(s) MUST RESIDE in the SAME directory as the
  809.      RBatch.CFG file.
  810.  
  811. ***> One important point to remember is that RBatch looks for the batch
  812.      file in the SAME DIRECTORY as the Configuration File.
  813.  
  814.              Here are some examples of LINE #30:
  815.              -----------------------------------
  816.  
  817.      YES;C:\RBBS\WORK;C:\RBBS\ARC.LST     - Currently the last line in config.
  818.      100;LOCAL.BAT;LOCAL1.BAT;LOCAL2.BAT  - New line is entered with the
  819.                                             names of the batch files to use.
  820.  
  821.      In this example LOCAL.BAT is called first, LOCAL1.BAT is called next,
  822.      and LOCAL2.BAT is called last.
  823.  
  824.              Here is another example:
  825.              ------------------------
  826.      YES;C:\RBBS\WORK;C:\RBBS\ARC.LST - Currently the last line in config.
  827.      100;LOCAL.BAT;LOCAL1.BAT         - New line is entered with the names of
  828.                                         the batch files to use.
  829.  
  830.      In this example LOCAL.BAT is called first, then LOCAL1.BAT, then
  831.      PHASE3.BAT is called last.
  832.  
  833.             And yet another:
  834.             ---------------
  835.      YES;C:\RBBS\WORK;C:\RBBS\ARC.LST - Currently the last line in config.
  836.      100;LOCAL.BAT                    - New line is entered with the name of
  837.                                         the batch file to use.
  838.  
  839.      In this example LOCAL.BAT is called first, then PHASE2.BAT is called next,
  840.      then PHASE3.BAT is called last.
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.                                 - 15 -
  851.  
  852.  
  853.  
  854.             Duh!:
  855.             -----
  856.      YES;C:\RBBS\WORK;C:\RBBS\ARC.LST - Currently the last line in config.
  857.      100;                             - No additional line is entered in
  858.                                         this configuration file example.
  859.                                         NOT EVEN A BLANK LINE!!!!
  860.  
  861.      In this example PHASE1.BAT is called first, then PHASE2.BAT is called
  862.      next, then PHASE3.BAT is called last.
  863.  
  864.         Note from the examples, that you may specify from one to
  865.         three new batch files for RBatch to use.  When using more
  866.         than one batch filename you MUST separate each name with a
  867.         SEMI-COLON! RBatch will only execute the Batch Files
  868.         THAT IS CAN FIND.
  869.  
  870. 31.  Byte Credits given for Uploads;Security Level,Percentage Value
  871.  
  872.      This feature consists of 2 parts.  The first part is MANDATORY
  873.      will the second part is used only if the first parameter is
  874.      a "YES".
  875.  
  876.      a.  YES or NO to give byte credits back to user for files
  877.          uploaded.
  878.      b.  Byte Credits may now be assigned by security level(s).
  879.          The format for the Byte Credit line in the configuration
  880.          file is:
  881.  
  882.          SECURITY LEVEL1,PERCENTAGE1;SECURITY LEVEL2,PERCENTAGE2
  883.  
  884.          Remember that RBatch checks to see if the user's security
  885.          level is LESS THAN OR EQUAL TO the security level(s) on this
  886.          line and then uses the associated percentage.
  887.  
  888.          Note also, that if you use multiple security levels, this line
  889.          should read (left to right) from lowest security level to the
  890.          highest, just like the examples.
  891.  
  892.          Currently you may define up to twenty security levels.
  893.  
  894. 32.  Use LARGE FFS (BusiMods) System;Use RFM Mods
  895.  
  896.      Make the additional entry to your configuration file(s).
  897.      This entry will be the last entry in your configuration
  898.      file unless you use the feature that will add a file
  899.      to your uploads.  (If you use this feature, then the new
  900.      configuration entry is the 2nd to the last line).
  901.  
  902.      The entry is as follows:
  903.  
  904.      Syntax:   LARGE FFS;RFM     (Enter in YES or NO as values)
  905.  
  906.      Example:  YES;NO    - Use Large FFS;Don't use RFM
  907.                YES;YES   - Use Large FFS;Use RFM
  908.                NO;NO     - Don't use Large FFS;Don't use RFM
  909.                NO;YES    - Don't use Large FFS;Use RFM
  910.  
  911.                                 - 16 -
  912.  
  913.  
  914. **** SPECIAL NOTE ****
  915.  
  916.          I have included a merge in version 2.30 for stock RBBS that
  917.          corrects a problem with RBBS and systems that use ratios.
  918.  
  919.          These ratios can either be byte or file ratios.  See the
  920.          file RSB2BYTE.ZIP for the merge.  YOU DO NOT NEED TO USE
  921.          THIS MERGE FOR RBATCH TO WORK PROPERLY ON YOUR SYSTEM!!
  922.          This is an optional merge that you can include to improve
  923.          how your system performs.
  924.  
  925.  
  926.  
  927. B-3.    Additional notes for the RBatch Configuration file:
  928.         --------------------------------------------------
  929.      As of v.1.70, the variable [NODE] may be placed into the
  930.      configuration file anywhere you use a path/filename option.
  931.      When [NODE] is found, RBatch will substitute the node number
  932.      from the RBatch Command line in place of [NODE].  This new
  933.      feature should allow the SysOp, if they wish, to be able to
  934.      use ONE configuration file for all their nodes on the Main
  935.      board and one for each Sub-Board.
  936.  
  937.             Here is an example usage:
  938.             -------------------------
  939.           .
  940.           NO;c:\rbbs\node[node]\dorinfo[NODE].def
  941.           .
  942.           .
  943.           c:\rbbs\node[node]\callers[NODE]
  944.           .
  945.           .
  946.           c:\rbbs\xfer\xfer-[NODE].def
  947.           .
  948.           .
  949.                 (NOTE:  [NODE] is not case sensitive)
  950.  
  951.  
  952. ==== Once again I must stress that all the NAMES used in the above
  953.      configuration example are optional and SYSOP-configurable.
  954.      The only names that RBatch REQUIRES be used are PHASE.BAT,
  955.      PHASE2.BAT and PHASE3.BAT, and THEN only IF you do not
  956.      specify alternate BAT file names for configuration line #27.
  957.  
  958. ==== Also, make sure that all the lines in the configuration file end with
  959.      a carriage return.  THERE SHOULD BE NO SPACES AFTER THE LAST ENTRY
  960.      ON EACH LINE.  IF YOU HAVE SPACES, YOU WILL GET ERRORS AND RBATCH
  961.      WILL NOT RUN.
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.                                 - 17 -
  972.  
  973.  
  974.  
  975. ==== A Note about Sub-Boards:
  976.  
  977.      In your RBatch configuration file, you should point to the MAIN
  978.      MESSAGE BASE.  If your Sub-Board uses aliases the user's REAL NAME
  979.      will be in the Main Message base and when RBatch goes to find the
  980.      user name in the Users file, it will find a match.  You should still
  981.      specify the Main Message Base even if you do not use aliases, due to
  982.      RBBS reading the Main Message base first upon return from the protocol,
  983.      hence time credits have to be written here in order for users to get
  984.      credit.
  985.  
  986. ==== Additional Feature of RBatch
  987.  
  988.      A file has been included in this archive called ADDIN.DOC and describes
  989.      how you can have RBatch add a file to each file uploaded.  Those of you
  990.      that take the time to read this documentation now know about this
  991.      additional feature if you want to use it!
  992.  
  993.  
  994.  
  995. B-4.    The RBBS-PC PROTO.DEF Setup:
  996.         ----------------------------
  997.  
  998. Equally important to proper operation of RBatch is the structure
  999. of the RBBS PROTO.DEF protocol handling file.  This file designates
  1000. the way RBBS loads the external protocols, and what information passes
  1001. between the two (the system and the protocol) during a file transfer.
  1002. Included in this archive are examples of PROTO.DEF setups.  Please
  1003. refer to these files for assistance in setting up DSZ, HS/Link &
  1004. BiModem.  Also, if you are not familiar with the structure of the
  1005. RBBS PROTO.DEF file, we suggest you familiarize yourself with that
  1006. section of the RBBS DOCuments.
  1007.  
  1008. Files included here are for EXAMPLE purposes only and all param-
  1009. eters and criteria (security levels, paths, etc.) that are unique to
  1010. your system need to be changed to match your BBS setup.
  1011.  
  1012. Note in the Proto.Def example, that XModem and 1K-Xmodem are shelled
  1013. to and do not use RBatch.  This was done to show you that all protocols
  1014. do not have to use RBatch.  If you wish all protocols to use RBatch for
  1015. processing, just change the XModem entries to match the Xmodem sample
  1016. entries in the Proto.def and refer to the batch files that are included
  1017. in the BATCH.ZIP file.
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.                                 - 18 -
  1029.  
  1030.  
  1031. There is also an example of how to use Xmodem and 1K-Xmodem (DSZ) with
  1032. RBatch.  Thanks to Don Silva for assisting in the proper commands needed
  1033. to use RBatch and XModem.
  1034.  
  1035. Remember for RBBS to recognize an entry in the Proto.Def it has to be
  1036. able to "find" the batch file or program.  If you have your Proto.Def
  1037. in a directory called C:\RBBS\XFER and all your batch files and protocols
  1038. are also there, then your entries in the Proto.Def should have paths.
  1039. Here is an example:
  1040.  
  1041. ....."C:\RBBS\XFER\BATCHDN.BAT [PORT#] [BAUD] [PROTO] [NODE]",".....
  1042.  
  1043. Note that this example only shows the "download side" of the Proto.Def
  1044. entry, but I hope you get the idea.
  1045.  
  1046.  
  1047. The only major REQUIREMENT for RBatch is that it requires DOORING to
  1048. the protocol.  DO NOT SHELL!!!  This is an easy modification--requiring
  1049. typing one letter in each line of your PROTO.DEF file.  (Change the "S"
  1050. to a "D.")
  1051.  
  1052. If you wish to shell to your protocols, RBBS & RBatch has been tested
  1053. and works with SHROOM
  1054.  
  1055.  
  1056. B-5.    Batch Files used in PROTO.DEF:
  1057.         -----------------------------
  1058.  
  1059. Also included in this archive are examples of the batch files that are
  1060. used in our PROTO.DEF examples.
  1061.  
  1062. The file BATCH.ZIP contains:
  1063.  
  1064. BATCHUP.BAT   BATCHUPY.BAT   BATCHUPG.BAT   BATCHUPX.BAT   B1UPX.BAT
  1065. BATCHDN.BAT   BATCHDNY.BAT   BATCHDNG.BAT   BATCHDNX.BAT   B1DNX.BAT
  1066.  
  1067.  (Zmodem)      (YModem)       (Ymodem-G)      (Xmodem)     (1K-Xmodem)
  1068.  
  1069.  
  1070.  
  1071. The file HSLNKBAT.ZIP contains the two batch files:
  1072.  
  1073.      HS1UP.BAT     HS1DN.BAT
  1074.      (These are for use with HS/Link)
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.                                 - 19 -
  1087.  
  1088. The file BIMODEM.ZIP contains the:
  1089.      - A sample PROTO.DEF setup for Bimodem/RBatch.
  1090.      - Sample BAT files used in PROTO.DEF (BI1UPA.BAT & BI1DNA.BAT).
  1091.      - An example of an RBatch/BiModem configuration file.
  1092.  
  1093. (Again, note that these are examples and are to be used only as guidelines
  1094. and should be modified to match your BBS setup.)
  1095.  
  1096.  
  1097. SPECIAL NOTE on BATCHUPx.BAT:
  1098.  
  1099. For uploads with the DSZ protocols, these sample batch files first
  1100. change to the upload drive & directory and then invoke the DSZ protocol.
  1101. I have done it this way to show how SysOps who do not have a registered
  1102. version of DSZ can designate an "Upload Directory."   With a registered
  1103. version of DSZ, you may specify the path on the DSZ command line.
  1104.  
  1105. Check the DSZ documentation (sort of like suicide, huh?) for the proper
  1106. command line for registered versions.
  1107.  
  1108. B-6.    The RBatch COMMAND line:
  1109.         -----------------------
  1110. The RBatch command line syntax is as follows:
  1111.  
  1112.    RBatch <Path/Config Filename> <Port #> <Proto Letter> <Node #> <Special>
  1113.  
  1114.            The config filename may have a path to it and the
  1115.            other parameters can be passed from your PROTO.DEF
  1116.            command lines with:
  1117.  
  1118.            <Port #>       = [PORT#]   NOTE: Use [PORT#]-not [PORT]!
  1119.            <Proto Letter> = [PROTO]
  1120.            <Node #>       = [NODE]
  1121.            <SPECIAL>      = If RBatch is processing an upload using PCZ
  1122.                             OR ZSX Protocol this is MANDATORY.  Do not include
  1123.                             on command line if not using PCZ or ZSX.
  1124. ### NEW IN RBATCH 2.25 ---> If processing .TIC file use TIC here
  1125. ### NEW IN RBATCH 2.35 ---> NODOTS
  1126.  
  1127. --> If your proto.def looked like this:
  1128.       "C:\RBBS\XFER\BATCHDN.BAT [PORT#] [BAUD] [PROTO] [NODE] PCZ"
  1129.       "C:\RBBS\XFER\BATCHDN.BAT [PORT#] [BAUD] [PROTO] [NODE] ZSX"
  1130.  
  1131.        Your RBatch command line would look like this:
  1132.              RBatch Rbatch.cfg %1 %3 %4 %5
  1133.  
  1134. --> If a file contains a FILE_ID.DIZ or DESC.SDI file an ALT-250
  1135.     character will appear as the first character of the file
  1136.     description.  This makes the file visible to those that only
  1137.     will download files that contain internal (DIZ/SDI) description
  1138.     files.  To DISABLE this feature, all you have to do is add a
  1139.     parameter to your RBatch command line.  Here is an example:
  1140.  
  1141.           Use Dots Command Line:  RBatch Rbatch.Cfg %1 %4 %3
  1142.     Don't use Dots Command Line:  RBatch RBatch.Cfg %1 %4 %3 NODOTS
  1143.  
  1144.     If you are using PCZ or ZSX your command line might look like this:
  1145.  
  1146.     -   RBatch RBatch.Cfg %1 %4 %3 ZSX NODOTS   (Not Dots in Desc.)
  1147.     -   RBatch RBatch.Cfg %1 %4 %3 ZSX          (Dots in Desc.)
  1148.                                 - 20 -
  1149.  
  1150. B-7.  SysOp Designed Batch Files (Phase1.Bat, Phase2.Bat, Phase3.Bat,
  1151.                                   Phase1c.Bat, Phase2c.Bat, Phase3c.Bat,
  1152.                                   or whatever name(s) you specify on line
  1153.                                   #30 of the configuration file):
  1154.  
  1155. These are the BATCH files (called in numerical order--PHASE1.BAT,
  1156. PHASE2.BAT, PHASE3.BAT) that the SysOp creates or customizes for
  1157.  
  1158.  
  1159.  
  1160. testing each uploaded file.  The ONLY REQUIREMENT we have is that
  1161. if your batch file locates an error (corrupted ZIP, virus, unacceptable
  1162. date range, etc.), it MUST delete the uploaded file!
  1163.  
  1164. Why?  It's simple.
  1165.  
  1166. If, upon return from the batch file, RBatch finds the uploaded file,
  1167. it assumes the file tested OK during the batch file test (remember,
  1168. RBatch itself tests nothing but the EXISTENCE of the file), and IF
  1169. the file is still there, RBatch proceeds to get a description and
  1170. category, then posts it to the FMS/.DIR, CALLERS, and USERS files.
  1171.  
  1172.  
  1173. B-8.    PHASE?.BAT passed parameters:
  1174.         -----------------------------
  1175.  
  1176. In the batch file command line, we send five parameters along with
  1177. the batch filename:
  1178.  
  1179. %1 The first is the path & name of the uploaded file.
  1180. %2 The second is the extension of the file (No Period)
  1181. %3 The third is the node number.
  1182. %4 The fourth is the filename with no period or extension.
  1183. %5 The fifth parameter is the path to the upload directory.
  1184.    (No trailing backslash)
  1185.  
  1186.  
  1187. B-9.    Calling other testers from PHASE?.BAT:
  1188.         -------------------------------------
  1189.  
  1190. If your system is already set up with an upload tester like ZIPLAB,
  1191. RBatch will work right along with it, letting ZIPLAB handle all the
  1192. upload testing.  Or, you could use the old RBBS standard upload
  1193. testers. For example, PHASE1.BAT might read:
  1194.  
  1195.           @ECHO OFF
  1196.           CLS
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.                                 - 21 -
  1207.  
  1208.  
  1209.           if %2 == ZIP GOTO ZIP
  1210.           if %2 == ARJ GOTO ARJ
  1211.           :ZIP
  1212.              tzip.bat %1 %2 %3 %4 %5
  1213.           :ARJ
  1214.              tarj.bat %1 %2 %3 %4 %5
  1215.  
  1216. As you see, RBatch lets you use your existing batch files for checking
  1217. uploads from RBBS, or you can create some new ones.
  1218.  
  1219.  
  1220. B-10.   Examples of PHASE?.BAT:
  1221.         ----------------------
  1222.  
  1223. Example--PHASE1.BAT:
  1224.  
  1225. @echo off
  1226. cls
  1227. if %2 == ARJ goto :ARJ
  1228. if %2 == ZIP goto :ZIP
  1229. goto :END
  1230. :ZIP
  1231. echo  "Checking File Integrity"  > COM1
  1232. pkunzip -t %1 > NUL
  1233. if errorlevel 1 goto :DEL
  1234. goto :END
  1235. :ARJ
  1236. echo  "Checking File Integrity"  > COM1
  1237. arj t %1 > NUL
  1238. if errorlevel 1 goto :DEL
  1239. goto :END
  1240. :DEL
  1241. del %1 > NUL
  1242. echo          The file %4.%2 failed the Integrity          > COM1
  1243. echo          Test and has been deleted from this BBS...   > COM1
  1244. :END
  1245. seterror 0
  1246.  
  1247.  
  1248. B-11.   Colorized (ANSI/High Ascii) BAT files:
  1249.         --------------------------------------
  1250.  
  1251. If the user has graphics turned on, then RBatch will call the batch
  1252. files PHASE1C.BAT, PHASE2C.BAT & PHASE3C.BAT so you can use colorized or
  1253. graphic batch files.  If the "C" version batch files do not exist,
  1254. then the normal ones (without the "C") are used.
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.                                 - 22 -
  1265.  
  1266.  
  1267.  
  1268. Example--PHASE1C.BAT:
  1269.  
  1270. @echo off
  1271. if %2 == ARJ GOTO :ARJ
  1272. if %2 == ZIP GOTO :ZIP
  1273. if %2 == GIF GOTO :GIF
  1274. GOTO :END
  1275. :ZIP
  1276. if not exist %1 GOTO :END
  1277. echo @[2J                                                             > gate1
  1278. echo @[1;37m                                                          > gate1
  1279. echo.                                                                 > gate1
  1280. echo.                                                                 > gate1
  1281. echo       IMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM; > gate1
  1282. echo       :            Checking ZIP Integrity of Upload            : > gate1
  1283. echo       HMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM< > gate1
  1284. echo.                                                                 > gate1
  1285. echo.                                                                 > gate1
  1286. pkunzip -t %1 > NUL
  1287. if errorlevel 1 GOTO :DEL
  1288. GOTO :END
  1289. :ARJ
  1290. if not exist %1 GOTO :END
  1291. echo @[1;36m                                                          > gate1
  1292. echo.                                                                 > gate1
  1293. echo.                                                                 > gate1
  1294. echo       IMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM; > gate1
  1295. echo       :            Checking ARJ Integrity of Upload            : > gate1
  1296. echo       HMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM< > gate1
  1297. echo.                                                                 > gate1
  1298. echo.                                                                 > gate1
  1299. arj t %1 > NUL
  1300. if errorlevel 1 GOTO :DEL
  1301. GOTO :END
  1302. :DEL
  1303. del %1 > NUL
  1304. :GIF
  1305. echo @[2J                                                             > gate1
  1306. echo @[1;33m                                                          > gate1
  1307. echo.                                                                 > gate1
  1308. echo.                                                                 > gate1
  1309. echo.                                                                 > gate1
  1310. echo.                                                                 > gate1
  1311. echo.                                                                 > gate1
  1312. echo.                                                                 > gate1
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.                                 - 23 -
  1323.  
  1324.  
  1325. echo.                                                                 > gate1
  1326. echo       IMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM; > gate1
  1327. echo       :                        ****                            : > gate1
  1328. echo       :          The Policies of this BBS state that           : > gate1
  1329. echo       :              GIF's are UNWANTED FILES!                 : > gate1
  1330. echo       :       THE UPLOADED .GIF FILE HAS BEEN DELETED!!!!      : > gate1
  1331. echo       :                        ****                            : > gate1
  1332. echo       :            You agreed to these Policies when           : > gate1
  1333. echo       :              you first logged onto this BBS            : > gate1
  1334. echo       :                    as a New User                       : > gate1
  1335. echo       HMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM< > gate1
  1336. echo @[0m                                                             > gate1
  1337. del %1 > NUL
  1338. :END
  1339. seterror 0
  1340.  
  1341. This example will show to the user that the batch file is checking file
  1342. integrity by echoing out the gate#.  The line "echo." is for echoing a
  1343. blank line (thanks to Fred Busteed for this command).  Note that the
  1344. gate# is from using GATEWAY as your replacement for DOS's CTTY command.
  1345. If you decide to use GATEWAY, be sure to make the appropriate change
  1346. in your RBBS configuration file.  You can also use gate%node% if you set
  1347. the node in your autoexec.bat or your DV startup bat (SET NODE=1).
  1348.  
  1349.   ----------------------------------------------------------------
  1350.   There are more examples included in the file called EXAMPLES.BAT
  1351.   ----------------------------------------------------------------
  1352.  
  1353. B-12.   Alternate Batch filenames:
  1354.         --------------------------
  1355.  
  1356. If you wish to use batch files with names other than PHASE?.BAT, then
  1357. specify on line #30 of the configuration file, the name(s) of the other
  1358. batch files to use.  You may, for example, choose a different filename
  1359. to call for LOCAL uploads, or for SYSOP FMS postings.
  1360.  
  1361. Special Batch Files - A special batch file/upload checking system designed
  1362. -------------------   by Fred "Buzz" Busteed, is included in this archive.
  1363.                       The NEW-PHZ.ARJ contains the batch file and all the
  1364.  **********>>>>>>>    necessary files to create a PHASE1C.BAT file that is
  1365.                       specific for your system.  This is quite a batch file
  1366.                       and should be checked out!!!  Many thanks to Buzz for
  1367.                       contributing this to the RBatch System.
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.                                 - 24 -
  1380.  
  1381. B-13.   Flexibility in RBatch file processing:
  1382.         --------------------------------------
  1383.  
  1384. These batch files and their parameters will help RBBS SysOps process
  1385. many different types of compressed files.  Personally, I prefer the
  1386. ZIP format, but in order to allow the flexibility all RBBS SysOps have
  1387. learned to love, I feel that you should have the ability to accept
  1388. all types of files, convert to whatever format you prefer, and still
  1389. be able to check the file for the protection of your system and your
  1390. users.
  1391.  
  1392.  
  1393. C.                   MISCELLANEOUS INFORMATION:
  1394.  
  1395.  
  1396. C-1.    Use of "Recovery" with Protocols & RBatch:
  1397.         ------------------------------------------
  1398.  
  1399. Most of the protocols that work with RBatch, support file recovery.
  1400. There are two things to consider with recovery, however.  One concerns
  1401. your BBS and the other concerns how RBatch treats the file.  With
  1402. recovery, you take the chance of introducing a virus into your system
  1403. unless you have proper file checking procedures.  With RBatch, file
  1404. recovery presents a different kind of problem.  If you allow recovery
  1405. on your system, and a user uploads a file, and your system already HAS
  1406. that file, the protocol will report a good upload in its XFER-?.DEF!
  1407. RBatch, being very loyal, and trusting his little buddy, XFER, will
  1408. process the file as if it were being uploaded for the first time.
  1409. This means that you will get this file posted twice in your FMS or
  1410. .DIR, but you will only have one copy of the file.  It is up to
  1411. the SysOp to decide if he/she wants recovery or not.
  1412.  
  1413. C-2.    User Time-Outs and Dropped Carriers:
  1414.         ------------------------------------
  1415.  
  1416. The program also contains a "time-out" feature that will go into
  1417. effect in no keyboard input is received within three minutes.  The
  1418. timer starts each time a user is prompted for a category code and
  1419. file description.  When a user reaches a time-out, the uploaded file
  1420. RBatch is currently working on is either saved or deleted per the
  1421. configuration setup (Line #17).  Subsequent uploads that have not
  1422. been processed are also either saved or deleted as per line 17.
  1423. (NOTE:  Files saved in this manner are posted to the FMS or .DIR
  1424. with the default category code for FMS or go in the designated
  1425. upload directory for .DIR)
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.                                 - 25 -
  1437.  
  1438.      - All files that are uploaded are logged to the CALLERS file,
  1439.        and are also posted to the FMS/.DIR if the SysOp is saving
  1440.        files (Line #17 of the configuration file).
  1441.  
  1442.      - Entries in the CALLERS file will end with a ### if a
  1443.        time-out has occured
  1444.  
  1445.      - Uploaded files processed after a timeout, are not
  1446.        credited to the user, but all downloads are.  This
  1447.        is due to RBBS handling the downloads.
  1448.  
  1449. The program also monitors carrier, and a dropped carrier is
  1450. treated the same way as a timeout (see above).
  1451.  
  1452.  
  1453.  
  1454. C-3.    RBatch Error Logging:
  1455.         ---------------------
  1456.  
  1457. When RBatch detects an error, it will write to its own error log. This
  1458. file which is called RBATERR.LOG, will reside in the current directory
  1459. where RBatch is executed from.  The format for this file is as follows:
  1460.  
  1461.    <Error Message> <Node #> <Date> <Time> <File>
  1462.  
  1463. Here is an example:
  1464.  
  1465.    Cannot find XFER-?.DEF 1 01-05-92 22:34:01 c:\rbbs\xfer-1.def
  1466.  
  1467. This translates into.......RBatch could not find the XFER-?.DEF file
  1468. in the location you specified in your configuration file.  This
  1469. error occurred on Node 1 on 1/5/92 at 10:34pm.
  1470.  
  1471. Also note that the error for not finding the XFER?.DEF will be posted
  1472. in the RBATERR.LOG when a user aborts an upload,  since on an aborted
  1473. upload, the XFER-?.DEF file never gets created, hence never found by
  1474. RBatch.  One way to get around this is to put in your UPLOAD batch
  1475. file that is called from the Proto.Def statements like:
  1476.  
  1477.     cd\uploads
  1478.     c:\rbbs\dsz port %1 speed %2 rz -m
  1479.     if not exist c:\uploads\xfer-1.def goto :END      <-- Use this
  1480.     c:\rbbs\rbatch c:\rbbs\rbatch.cfg %1 %3 %4
  1481.     :END
  1482.  
  1483. With this example the batch file checks for the exitance of the
  1484. XFER-1.DEF file and if it is there, runs RBatch, otherwise it
  1485. just exits the batch file and returns to the BBS.
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.                                 - 26 -
  1496.  
  1497.  
  1498.  
  1499.  ###  Note also that the %# parameters and the pathnames are only
  1500.       FOR AN EXAMPLE and should be changed to match your setup.
  1501.  
  1502.  ###  DO NOT DO THIS for a Bi-Directional Protocol on the
  1503.       download side, only on the upload side due to bi-directional
  1504.       transfer being initiated by a download on the BBS.
  1505.  
  1506.  
  1507. C-4.    What do the included Merges do?
  1508.         -------------------------------
  1509.  
  1510. NOTE:  You do not need to use the merges to be able to run RBatch!
  1511.        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  1512.  
  1513. Included in this archive are two merges inside the filename
  1514. MRG1230.ZIP, one for RBBS-PC 17.3C & one for v.17.4.  These merges
  1515. will allow RBBS-PC to check a stacked list of filenames that a user
  1516. enters after the "Upload what file(s)" prompt.  Each filename will
  1517. then be checked to see if the file already exists, and if there are
  1518. any duplicates, a list of filenames will be shown to the user and
  1519. the upload process aborted.  These merges are in Bled 2.2 format.
  1520. A batch file is also included to aid in the bled process.
  1521.  
  1522. As noted in configuration parameter #31, there is also a merge for
  1523. fixing up a problem with systems that use byte or file ratios.  As
  1524. with the above merge, it is OPTIONAL and does not need to be used
  1525. in order to run RBatch on your system.
  1526.  
  1527.  
  1528. C-5.    Why is RBatch an external program?
  1529.         ----------------------------------
  1530.  
  1531. The main reason for designing RBatch as an external interface
  1532. instead of relying on internal merges was simple:  not all
  1533. individuals care to recompile RBBS code (only the REAL hard core!),
  1534. and merges for ALL versions of RBBS (12 through 17.4) would have
  1535. had to be written.  Also, PROPER execution of batch uploading inside
  1536. RBBS would require a major rewrite of the code, and considering the
  1537. number of versions out there, this alternative is unacceptable.
  1538. With an external interface like RBatch, everyone can offer batch
  1539. and Bi-Directional transfers now.
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.                                 - 27 -
  1552.  
  1553. C-6.    Companion Program for RBatch:
  1554.         -----------------------------
  1555.  
  1556. Tom Hansen of Church Chatters BBS has written a companion program for
  1557. use by the users of your BBS to aid them with Batch Uploading, called
  1558. TAG200B.ZIP (Check for future updates also, with more features and
  1559. enhancements!)
  1560.  
  1561. This program is designed to simplify the BATCH uploading process for
  1562. your users.  Your users can tag files for uploading and prepare their
  1563. batch uploading sessions in a few simple key strokes.  It supports
  1564. bidirectional protocols and the popular DSZ protocols and allows for
  1565. a user configurable protocol if one of their favorite protocols is not
  1566. an available option.   This program will assist you in training and
  1567. encouraging your users to utilize your BATCH uploading capabilities.
  1568.  
  1569.  
  1570. C-7.    Warranty & Disclaimer:
  1571.         ----------------------
  1572.  
  1573. THIS PRODUCT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  1574. INCLUDING ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
  1575. PURPOSE.  THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THE
  1576. PROGRAM IS ASSUMED BY YOU.  FURTHERMORE, I THE AUTHOR DO NOT WARRANT,
  1577. GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE OF OR THE
  1578. RESULTS OF THE USE OF THE PROGRAM, OR THAT THE PROGRAM WILL RUN WITHOUT
  1579. ERROR, AND YOU RELY ON THE PROGRAM AND RESULTS SOLELY AT YOUR OWN RISK.
  1580. I THE AUTHOR CANNOT ACCEPT RESPONSIBILITY FOR SYSTEM DAMAGE, LOSS OF
  1581. PROFIT, OR ANY OTHER SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
  1582. RESULTING FROM THE USE OR INABILITY TO USE THIS PRODUCT.
  1583.  
  1584.  
  1585.  
  1586. As always, with any new program, you should have backup copies of your
  1587. MESSAGES, USERS, FMS or .DIR, and CALLERS files when first installing and
  1588. using RBatch, since it uses these in its operation.
  1589.  
  1590. This program is ZIPPED with Authenticity Verification.  If you do not
  1591. see the registration number of "# MMJ131  THE SHORELINE BBS, there is
  1592. a possibility that it is not an official version or the BBS you
  1593. received it from re-zipped the file and stripped off the -AV.
  1594. You can always call my BBS and download the official version.
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.                                 - 28 -
  1606. C-8.    Registration:
  1607.         -------------
  1608. The program is not "Crippled" in any way, and what you get with a
  1609. registered version is your BBS name on the opening screen.
  1610.  
  1611. I have chosen not to "cripple" the program because I don't believe in
  1612. "crippleware".  I hope that when you use the program you find that it
  1613. is an excellent addition to your BBS, hopefully then registering it.
  1614.  
  1615. Registration lets me know that the program I worked very hard on is
  1616. appreciated.  It will also encourage me to write other useful
  1617. programs/enhancements for RBBS SysOps in the future.
  1618.  
  1619. Once you register RBatch, it is registered for any new version that may
  1620. come out in the future.
  1621.  
  1622.  
  1623. You can get your registered version one of two ways:
  1624. ----------------------------------------------------
  1625.  
  1626. First, for $20.00, mail in the registration form with all the questions
  1627. filled in.  You then call my BBS and get your registration number in a
  1628. private message to you along with a file in the personal files section.
  1629.  
  1630. Second, for $25.00, you can send me the registration form with all the
  1631. questions filled in along with the size of the diskette you wish to
  1632. receive (5 1/4 or 3 1/2).  I will then mail you the latest version of
  1633. the program along with your registration number.
  1634.  
  1635.  
  1636. C-9.    Acknowledgments:
  1637.         -----------------
  1638.  
  1639.  
  1640. I would like to thank a few individuals for their support and ideas
  1641. without whom this program would not have been possible.
  1642.  
  1643. First of all, to my wife Linda, my son David, and my daughter Linnea
  1644. for time and again putting up with me parking myself in front of my
  1645. computer for hours on end to work on the program.  (Hey David, we
  1646. probably would have gotten a lot farther in Super Mario Brothers 3
  1647. if I hadn't been working on this program!!! <G>)
  1648.  
  1649. Second, to my Beta Testers--Tom Hansen, Walter Ames, David Brodmann,
  1650. Gregg Snyder, Gary Slemp (for helping out with the tedious task
  1651. of writing this documentation), Don Silva, Tate Biersack & Mercurio Franco.
  1652. Their ideas and testing of the program for any sort of bug possible, made
  1653. it a far superior product than it would have ever been.
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.                                 - 29 -
  1664.  
  1665.  
  1666.  
  1667. Third, to all the people who work on RBBS, and make it the best BBS software
  1668. available.  And last, Borland International Inc., and Data-Comp Information
  1669. Systems, for their great software.
  1670.  
  1671. C-10.   Last Minute Notes:
  1672.         ------------------
  1673.  
  1674. Included in RBatch is a file called MSGFILE.00 - This file has the prompts
  1675. that are shown to the user as the program executes.  You can change these
  1676. prompts if you wish, but you MUST follow these guidelines:
  1677.  
  1678. 1.  Each line MUST start with a NUMBER, followed by an EQUAL sign, followed
  1679.     with text.
  1680.  
  1681.      Example:    23=Text
  1682.  
  1683. 2.  Comments are allowed in this file as long as the FIRST CHARACTER on the
  1684.     line start with a "#" sign (do not use quotes).
  1685.  
  1686. 3.  The file MSGFILE.00 MUST RESIDE IN THE SAME DIRECTORY AS YOUR
  1687.     RBATCH CONFIGURATION FILE or RBatch will not work.
  1688.  
  1689. 4.  Be careful what you make changes to as you could exceed the size of
  1690.     the screen display if you make some MAJOR changes.  Test locally
  1691.     before putting online to make sure.
  1692.  
  1693. 5.  Note that some of the lines may seem incomplete and split over
  1694.     multiple lines due to:
  1695.  
  1696.     a.  values that are specific to each BBS - extended desc. lines, etc.
  1697.         that are retrieved from the RBatch configuration file.
  1698.     b.  color changes within the line
  1699.  
  1700.  
  1701. C-11.   Support:
  1702.         --------
  1703.  
  1704. If you do encounter any problems with the program, or have suggestions
  1705. on improvements, you can call my BBS 24 hrs a day, and leave a message
  1706. for me, or leave a message on the RIME Network in the RBBS conference,
  1707. or in the RBBS-PC or RBBSSYS conference on the RBBS-NET Network (Another
  1708. SysOp friend of mine carries the RBBS-NET and will alert me if there are
  1709. messages for me).  I will consider the enhancements and of course try to
  1710. fix any problems encountered with the program.
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.                                 - 30 -
  1722.  
  1723.  
  1724. Note that I support both Registered and Non-Registered users of the
  1725. program.  Support is a NUMBER ONE priority for me and my programs,
  1726. and I think you will be impressed with the support that I give.  You
  1727. are welcome to call me voice if you have any problems between 7-10:00pm
  1728. weekdays and between 9am-10pm on the weekends.
  1729.  
  1730.  
  1731. My BBS name & number:
  1732.  
  1733.                               Dan Shore
  1734.                           "THE SHORELINE BBS"
  1735.                      Located in Silver Spring, MD
  1736.                       3/12/24/9600/14.4 (V.32bis)
  1737.                              301-946-2771
  1738.  
  1739.                           Proud Member of the
  1740.                     - DGS Systems Group (Wonder) -
  1741.  
  1742.                          RBBS-PC  Beta Test Site
  1743.  
  1744.                         Proudly Running RBBS-PC
  1745.                   "The Best BBS Software in the World"
  1746.  
  1747.                     Member of the RIME & FIDO Network
  1748.                         RelayNet ID = SHORELINE
  1749.                          FIDO Net#  = 1:109/458
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.                                 - 31 -
  1761.