home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / RP-110.ZIP / RP.DOC < prev    next >
Encoding:
Text File  |  1994-10-01  |  70.2 KB  |  2,242 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                         Prime Productions proudly presents:-
  30.  
  31.  
  32.  
  33.                     The Prime External Request Processor v1.10
  34.  
  35.                            For FrontDoor and InterMail!
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                                           By Hans Siemons, Prime Productions.
  42.  
  43.                                            Setup utility by Marco Miltenburg.
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.                                         Prime request processor documentation
  52.  
  53.       Table of contence:
  54.  
  55.  
  56.       1 Introduction  . . . . . . . . . . . . . . . . . . . . . . . . .     1
  57.         What are file and service requests  . . . . . . . . . . . . . .     1
  58.         System requirements . . . . . . . . . . . . . . . . . . . . . .     1
  59.         Small overview of features  . . . . . . . . . . . . . . . . . .     2
  60.         Ways of usage . . . . . . . . . . . . . . . . . . . . . . . . .     2
  61.         Files included  . . . . . . . . . . . . . . . . . . . . . . . .     4
  62.  
  63.       2 Installation  . . . . . . . . . . . . . . . . . . . . . . . . .     6
  64.         Setting up  . . . . . . . . . . . . . . . . . . . . . . . . . .     6
  65.         System parameters . . . . . . . . . . . . . . . . . . . . . . .     7
  66.         Default limits  . . . . . . . . . . . . . . . . . . . . . . . .     9
  67.         Group manager . . . . . . . . . . . . . . . . . . . . . . . . .    10
  68.         Node manager  . . . . . . . . . . . . . . . . . . . . . . . . .    13
  69.         Level Manager . . . . . . . . . . . . . . . . . . . . . . . . .    14
  70.         Password protecting files . . . . . . . . . . . . . . . . . . .    15
  71.         Individual marking of free files/directory's  . . . . . . . . .    15
  72.  
  73.       3 Template files  . . . . . . . . . . . . . . . . . . . . . . . .    16
  74.         Keywords  . . . . . . . . . . . . . . . . . . . . . . . . . . .    20
  75.         Template filenames  . . . . . . . . . . . . . . . . . . . . . .    23
  76.         Language specific templates . . . . . . . . . . . . . . . . . .    23
  77.  
  78.       4 Compilers . . . . . . . . . . . . . . . . . . . . . . . . . . .    24
  79.         RPcomp  . . . . . . . . . . . . . . . . . . . . . . . . . . . .    24
  80.         FBBSDESC  . . . . . . . . . . . . . . . . . . . . . . . . . . .    25
  81.         RAdesc  . . . . . . . . . . . . . . . . . . . . . . . . . . . .    26
  82.         MAXdesc . . . . . . . . . . . . . . . . . . . . . . . . . . . .    26
  83.         PCBdesc . . . . . . . . . . . . . . . . . . . . . . . . . . . .    26
  84.         4DOSdesc  . . . . . . . . . . . . . . . . . . . . . . . . . . .    26
  85.         EzyDesc . . . . . . . . . . . . . . . . . . . . . . . . . . . .    27
  86.         Other compilers . . . . . . . . . . . . . . . . . . . . . . . .    27
  87.  
  88.       5 RPpack  . . . . . . . . . . . . . . . . . . . . . . . . . . . .    28
  89.  
  90.       6 RP at work  . . . . . . . . . . . . . . . . . . . . . . . . . .    29
  91.         Frequently asked questions  . . . . . . . . . . . . . . . . . .    30
  92.  
  93.       7 Support . . . . . . . . . . . . . . . . . . . . . . . . . . . .    32
  94.         Thanks  . . . . . . . . . . . . . . . . . . . . . . . . . . . .    32
  95.  
  96.       8 Shareware . . . . . . . . . . . . . . . . . . . . . . . . . . .    33
  97.         Legal stuff / standard disclaimer . . . . . . . . . . . . . . .    33
  98.  
  99.       9 Future versions . . . . . . . . . . . . . . . . . . . . . . . .    34
  100.  
  101.       10 Technical notes  . . . . . . . . . . . . . . . . . . . . . . .    35
  102.  
  103.  
  104.       Page I
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.                                         Prime request processor documentation
  113.  
  114.       ╔════════════════════════════════════════════════════════════════╕
  115.       ║≡ 1 Introduction ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  116.       ╙────────────────────────────────────────────────────────────────┘
  117.  
  118.       Welcome to the Prime external request processor (from here on called
  119.       RP). This program is the one you need if you find FrontDoors or
  120.       InterMails capabilities of handling requests not sufficient.
  121.       RP takes over the handling of file requests and service requests, and
  122.       allows a better control on who requests which files, how much, on what
  123.       time and on what node then FrontDoor and InterMail do.
  124.  
  125.       ╔════════════════════════════════════════════════════════════════════╕
  126.       ║≡ What are file and service requests ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  127.       ╙────────────────────────────────────────────────────────────────────┘
  128.  
  129.       A file request is just what it says. If you request a file, the system
  130.       where you request the file will decide, depending on whether it is
  131.       available and several limits, if it will send that file for you. RP
  132.       handles those requests on the request handling side.
  133.  
  134.       A service request is similar to a file request, the difference is that
  135.       instead of just sending files, the service request executes a program,
  136.       and optionally sends files.
  137.  
  138.       ╔════════════════════════════════════════════════════════════════╕
  139.       ║≡ System requirements ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  140.       ╙────────────────────────────────────────────────────────────────┘
  141.  
  142.       RP needs DOS 3.30 or higher. RP has direct support implemented for
  143.       Frontdoor 2.12, Frontdoor 2.20b, Frontdoor 2.20c, InterMail 2.27 till
  144.       2.29. It is quite possible that newer version also work. When newer
  145.       versions are not listed here, it is simply because they where not
  146.       available yet when this package was released.
  147.  
  148.       RP does NOT work with Frontdoor 2.02, Frontdoor 2.11, InterMail 2.26,
  149.       Frontdoor 2.20 and Frontdoor 2.20a. Although they have a request
  150.       processor interface, it was improved and enhanced in future versions,
  151.       and therefore the old support which "kludged" around the shortcomings
  152.       of the request processor interface was removed. Since upgrades to
  153.       these newer versions are free of charge, I see no need in updating
  154.       that old compatibility code.
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.       Page 1
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.                                         Prime request processor documentation
  174.  
  175.       ╔════════════════════════════════════════════════════════════════╕
  176.       ║≡ Small overview of features ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  177.       ╙────────────────────────────────────────────────────────────────┘
  178.  
  179.       Following is a list of features found in RP: (features marked with {+}
  180.       are only available in the registered version)
  181.  
  182.        ■ Request limits per timeslot {+} and per session. ie, max 5 files in
  183.          one session, and 10 files in a day.
  184.        ■ Request limits depending the requesting system, time, baudrate, day
  185.          of the week and line.
  186.        ■ Variate the list of requestable files depending the requesting
  187.          system, time, line, baudrate, day of the week, secure/unsure
  188.          sessions and for unlisted nodes!
  189.        ■ Password protected files only for specific nodes, or during certain
  190.          time slots or on certain lines.
  191.        ■ Easy "about" requesting.
  192.        ■ Attach messages if people request certain files, or from certain
  193.          directory's.
  194.        ■ Very powerful template language. Templates can be chosen depending
  195.          the node number of the requesting system, allowing multi language
  196.          templates.
  197.        ■ Send file descriptions in response message from Files.BBS, Remote
  198.          Access 2.0x FDB, PCBoard 15.0, 4Dos/NDos, EzyCom and Maximus style
  199.          Files.BBS.
  200.        ■ Nice screen display during request.
  201.        ■ Special magic files which return a message instead of a file.
  202.        ■ Service requests with the same powerful security as file requests.
  203.  
  204.       ╔════════════════════════════════════════════════════════════════╕
  205.       ║≡ Ways of usage ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  206.       ╙────────────────────────────────────────────────────────────────┘
  207.  
  208.       Here are a few "examples" on how you could setup RP.
  209.  
  210.        ■ setup your points and personal friends so that they can request
  211.          without limitations, but only on line 1.
  212.  
  213.          How? By simply adding a special level with no request limits, and
  214.          give your points and personal friends that special level in the
  215.          node manager. You can limit it to line 1 by only making the special
  216.          node record only available on line 1.
  217.  
  218.        ■ let people request your magic names around the clock, but refusing
  219.          the other files to be requested on "busy" hours.
  220.  
  221.          How? By simply creating an extra group for "other files", and
  222.          disable that by timeslot.
  223.  
  224.  
  225.  
  226.       Page 2
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.                                         Prime request processor documentation
  235.  
  236.        ■ You can send a message if somebody requests RP, congratulating them
  237.          on their excellent choice.
  238.  
  239.          How? By simply adding a line to SENDWITH.RP telling RP with what
  240.          file, what template should be posted.
  241.  
  242.        ■ you can deny requests from 2:512/149 on node 1, but allow him to
  243.          request on node '2'.
  244.  
  245.          How? By adding a special node record 2:512/149 and put the "deny
  246.          request"-flag on, and only activate that record for node 1. For
  247.          node 1 this node will hit on this record, for node 2 this node will
  248.          not hit.
  249.  
  250.        ■ You can give special rights to node 2:512/149 only on line 2
  251.          between 10:00 and 18:00. On other nodes he would be treated like
  252.          any other node.
  253.  
  254.          How? By creating the extra level, and only make that special level
  255.          available between 10:00 and 18:00 on line two. You can also do it
  256.          by disabling the node record outside 10:00 and 18:00 and on all
  257.          other tasks except line two. It's your choice.
  258.  
  259.        ■ When people request a certain "magic" RP can post a template
  260.          instead of returning a file.
  261.  
  262.          Put both the "magic" name and the template to post in REQTPL.RP.
  263.  
  264.        ■ You can use it just like your old setup, with the added advantage
  265.          that request response messages are much more detailed, and the
  266.          request handling is done a lot faster.
  267.  
  268.       The number of ways to use it are endless.
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.       Page 3
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.                                         Prime request processor documentation
  296.  
  297.       ╔════════════════════════════════════════════════════════════════╕
  298.       ║≡ Files included ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  299.       ╙────────────────────────────────────────────────────────────────┘
  300.  
  301.       The following files are in the RP110.ARJ archive (may also be any
  302.       other archive format):
  303.  
  304.       RPCOMP.EXE   Filebase compiler. Compiles the filebase, so that the
  305.                    request processor can search files much faster. Speed is
  306.                    important, because searching for files is done while a
  307.                    session is going on.
  308.       RP.EXE       The request processor.
  309.       RPT.BAT      A little test batchfile for local testing.
  310.       RPSETUP.EXE  The setup utility
  311.       RPPACK.EXE   Small utility to pack REQUESTD.RP. When packing it keep
  312.                    the last 500 records.
  313.       RP.DOC       This documentation.
  314.       SUPPORT.DOC  List of worldwide support and registration sites.
  315.       FILE_ID.DIZ  Small description of RP.
  316.       TEMPLATE.ARJ Sample template files.
  317.       SAMPLE.ARJ   Sample SENDWITH.RP and TPLEXT.RP.
  318.       FREEREG.!!!  How to earn a free RP registration!
  319.       NEWKEYS.!!!  Note on updating "old style" keys.
  320.       MAXDESC.EXE  Description compiler for Maximus systems.
  321.       FBBSDESC.EXE Description compiler for Files.BBS systems.
  322.       RADESC.EXE   Description compiler for Remote Access v2.0x systems.
  323.       4DOSDESC.EXE Description compiler for NDos/4Dos.
  324.       EZYDESC.ARJ  Description compiler for EzyCom.
  325.       RAPWDLST.EXE Creates a list of password protected files from the RA
  326.                    2.0x file database.
  327.       RADCOUNT.EXE Updates download counters for the RA FDB.
  328.       RELEASE.NOT  Release notes.
  329.       MAKEINFO.EXE Executable by Marc Buffet to create a test remote info
  330.                    file.
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.       Page 4
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.                                         Prime request processor documentation
  357.  
  358.       ╔════════════════════════════════════════════════════════════════╕
  359.       ║≡ Files created ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  360.       ╙────────────────────────────────────────────────────────────────┘
  361.  
  362.       RP creates the following files:
  363.  
  364.       SETUP.RP     The main setup file.
  365.       FILEBASE.RP  The file database, created by RPcomp.
  366.       MAGIC.RP     The magic files database, created by RPcomp.
  367.       TEXTBASE.RP  A database shared by FILEBASE.RP and MAGIC.RP, containing
  368.                    actual directory's and filenames. Don't worry about any
  369.                    duplicate entries!
  370.       FILEBASE.RPS Static file database.
  371.       MAGIC.RPS    Static magic files database.
  372.       TEXTBASE.RPS Static text database.
  373.       LEVEL.RP     Level database.
  374.       NODEFILE.RP  Node database.
  375.       REQUESTD.RP  This file holds all info about previous requests.
  376.  
  377.       ╔════════════════════════════════════════════════════════════════╕
  378.       ║≡ Other files supported ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  379.       ╙────────────────────────────────────────────────────────────────┘
  380.  
  381.       RP supports the following "3rd party" database files.
  382.  
  383.       DESCRIPT.RP  A database containing the file descriptions.
  384.       DESCINFO.RP  A database containing information about the file
  385.                    descriptions.
  386.  
  387.       The description compilers themselves also use two static databases.
  388.  
  389.       DESCRIPT.RPS Static file descriptions database.
  390.       DESCINFO.RPS Static file descriptions information database.
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.       Page 5
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.                                         Prime request processor documentation
  418.  
  419.       ╔════════════════════════════════════════════════════════════════╕
  420.       ║≡ 2 Installation ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  421.       ╙────────────────────────────────────────────────────────────────┘
  422.  
  423.       Unpack the archive in any directory, and execute the setup utility
  424.       RPsetup. This setup utility will be explained later on in this
  425.       section. Be sure to execute the install menu option. It will adjust
  426.       your mailers setup file to install the request processor.
  427.  
  428.       If you do want to install RP manually in your mailer, here are the
  429.       command lines needed:
  430.  
  431.       For Frontdoor versions 2.12, 2.20b.Ml, 2.20c.Ml:
  432.                    RP.EXE =B =C =D =E =G =H =M =Q =X =W =Z
  433.  
  434.       For InterMail 2.27, 2.28, 2.29:
  435.                    RP.EXE /X%X /R%F /H%M /A%A /B%B /O"%O" /Z%Z
  436.  
  437.       THESE ARE *NOT* EXAMPLE COMMAND LINES. THEY ARE THE COMMAND LINES YOU
  438.       NEED.
  439.  
  440.       After setting up everything properly, you need to run RPcomp to create
  441.       RP's file database.
  442.       It is recommended that you run RPcomp at least daily in your
  443.       maintenance batchfile, but you are advised to run it after every file
  444.       import, or after you created your announce messages. (modern .TIC
  445.       processors like Allfix have fine ways of telling you that files have
  446.       been imported either using error levels or semaphore files).
  447.  
  448.       Further, install RPpack, RPcomp and optionally a description compiler
  449.       in your batch files. More about these utilities later on.
  450.  
  451.       It is also recommended to install a disk cache, to speed up
  452.       processing. Especially a write-behind cache helps.
  453.  
  454.       Following is a detailed explanation about the setup utility.
  455.  
  456.       ╔════════════════════════════════════════════════════════════════╕
  457.       ║≡ Setting up ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  458.       ╙────────────────────────────────────────────────────────────────┘
  459.  
  460.       RP includes a full screen setup utility, for your convenience.
  461.  
  462.       Later on, "recovertime" is mentioned. This is the time in minutes how
  463.       long RP will remember previous requests. It is used for the "request
  464.       limits per timeslot" Recovertime defines the length of the timeslot.
  465.       Ie, if you set it to 60 minutes, previous requests are forgotten after
  466.       60 minutes. This is only used in the registered version.
  467.  
  468.  
  469.  
  470.       Page 6
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.                                         Prime request processor documentation
  479.  
  480.       ╔════════════════════════════════════════════════════════════════╕
  481.       ║≡ System parameters ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  482.       ╙────────────────────────────────────────────────────────────────┘
  483.  
  484.       The system parameters menu lets you setup the following things:
  485.  
  486.       Systempath          : By default RP uses the location of the
  487.                             executable as system path. If you set this path
  488.                             however, RP uses this one as a systempath.
  489.  
  490.       Temporary directory : If filled in, all temporary files are created
  491.                             there. This includes the PKT file with the
  492.                             request response message, and any files in CD-
  493.                             Rom groups. It is important in a multiline
  494.                             environment to use the $TASK$ macro in the path
  495.                             name, to have unique directory's for each line.
  496.                             (to prevent your mailer from deleting files,
  497.                             another task still has to sent).
  498.  
  499.       CC directory        : If filled in, all messages posted to users will
  500.                             also be written in *.MSG format in this
  501.                             directory. Please remember to clean this
  502.                             directory up regularly since posting messages in
  503.                             such areas when there are lot of messages in it
  504.                             takes quite a long time.
  505.  
  506.       Template path       : If filled in, RP will look for template files
  507.                             first in this directory. If not defined, RP will
  508.                             look in the system directory.
  509.  
  510.       Listfile path       : If filled in, RP will look for list files
  511.                             (requestable directory's, magic filenames etc)
  512.                             first in this directory. If not defined RP will
  513.                             look first in the system directory.
  514.  
  515.       Logfile name        : By default, RP logs to Frontdoor's logfile. If
  516.                             you set this field, RP's own logfile will be
  517.                             used. You may use also the $TASK$ macro in this
  518.                             logfile name. RP does not take the logfile from
  519.                             InterMail's setup. You have to fill it in here
  520.                             if you want logging.
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.       Page 7
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.                                         Prime request processor documentation
  540.  
  541.       RPcomp logfile name : By default RPcomp will use RP's logfile. If this
  542.                             field is set, RPcomp's own logfile will be used.
  543.                             If both the RPcomp logfile name and RP logfile
  544.                             name are empty, RPcomp will do *NO* logging. (so
  545.                             it will not use your mailers logfile). The
  546.                             RPcomp logfile does *NOT* support the $TASK$
  547.                             macro, since it is not supposed to run in
  548.                             multiple tasks.
  549.  
  550.       Mailer type         : Set the mailer in use. Currently supported are
  551.                             FrontDoor and InterMail.
  552.  
  553.       Max. wildcards      : This value sets the maximum number of wildcards
  554.                             a request may have. Please note that asterixes
  555.                             (*'s) are expanded to jokers (?'s), ie RP*.*
  556.                             expands to RP??????.??). Wildcards in the
  557.                             extension are not counted. A good value for this
  558.                             is 6.
  559.  
  560.       Screen mode         : If set to verbose, RP will show all found and
  561.                             send files on screen.
  562.  
  563.       TPL requestfile     : Edit REQTPL.RP. More about this file later.
  564.  
  565.       Edit TPLEXT.RP      : Edit the TPLEXT.RP file. More about this file in
  566.                             the chapter about templates.
  567.  
  568.       Send with file      : Edit the SENDWITH.RP file. SENDWITH.RP is build
  569.                             up as follows: (ASCII text)
  570.                             <part of path/filename> <message file>
  571.  
  572.                             ie, k:\prime\ prime.tpl
  573.                                 k:\pdn\ pdn.tpl
  574.                                 rp-101 rp.tpl
  575.  
  576.                             Now if part of a filename which is send to the
  577.                             remote system is for instance k:\pdn\, pdn.tpl
  578.                             is send to the requesting system as a message,
  579.                             with for instance, a notify of the fact that you
  580.                             can also connect the file distribution areas
  581.                             automaticly. The <part-of> may appear anywhere
  582.                             in the complete path and filename of the file
  583.                             that is being send.
  584.  
  585.       External editor     : The editor you want to use for editing your text
  586.                             files from within the setup utility.
  587.  
  588.  
  589.  
  590.  
  591.  
  592.       Page 8
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.                                         Prime request processor documentation
  601.  
  602.       ╔════════════════════════════════════════════════════════════════╕
  603.       ║≡ Default limits ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  604.       ╙────────────────────────────────────────────────────────────────┘
  605.  
  606.       The default limits menu lets you set up limits for nodes, not found in
  607.       your node database, there are 3 groups:
  608.  
  609.       Unlisted systems, for people not found in de the nodelist
  610.       Unsecure session, for unsecure sessions, and secure session for secure
  611.       sessions. You can setup the groups the requesting system may request
  612.       from, the level (which defines the request limits themselves), and the
  613.       recovertime, which is explained in the "setting up" chapter.
  614.  
  615.       IF YOU SET ANY LIMIT TO ZERO, IT MEANS THAT THERE IS NO LIMIT ON THE
  616.       SPECIFIC ITEM.
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.       Page 9
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.                                         Prime request processor documentation
  662.  
  663.       ╔════════════════════════════════════════════════════════════════╕
  664.       ║≡ Group manager ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  665.       ╙────────────────────────────────────────────────────────────────┘
  666.  
  667.       In the group manager, you setup the different groups for RP. You can
  668.       give nodes access to groups only at certain times and days, or no
  669.       access at all.
  670.  
  671.       The following fields are available:
  672.  
  673.       Name                : The name of the group.
  674.  
  675.       Limited hours       : If this field is set to yes, time slots are
  676.                             checked. If a node calls outside a timeslot, the
  677.                             group is disabled.
  678.  
  679.       Available time      : When limited hours is true, you can define with
  680.                             a resolution of 10 minutes whether this group is
  681.                             available.
  682.  
  683.       Nodes               : You can set here on which nodes this group is
  684.                             active.
  685.  
  686.       Minimum baudrate    : If a requesting node's baudrate is lower then
  687.                             the one listed here, the group is disabled.
  688.  
  689.       Free KBytes         : If set to yes, Kilobytes in this group are not
  690.                             taken in consideration when checking request
  691.                             limits.
  692.  
  693.       Free Time           : If set to yes, transfer times in this group are
  694.                             not taken in consideration when checking request
  695.                             limits.
  696.  
  697.       Free Match          : If set to yes, the number of files requested
  698.                             from this group are not taken in consideration
  699.                             when checking request limits.
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.       Page 10
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.                                         Prime request processor documentation
  723.  
  724.       Stop match          : RP's search engine will stop searching in this
  725.                             group, if there was already a "hit" on the
  726.                             requested file.
  727.  
  728.       Show PW failure     : Should the user be notified if a user requests
  729.                             something from this group with the wrong or no
  730.                             password.
  731.  
  732.       Show no Access      : Should the user be notified if a user requests
  733.                             something from this group, and he has no access
  734.                             to that group. Handy if disable groups during
  735.                             mail slot hours.
  736.  
  737.       CD-Rom              : If set to true, all files in this group will be
  738.                             copied into the temporary directory before your
  739.                             mailer will send them.
  740.  
  741.       Compile once        : If set to true, files in this group will only be
  742.                             compiled when forced, or when the setup file has
  743.                             been updated.
  744.  
  745.       List                : Full path and filename of plain ascii text
  746.                             containing a list of directory's, a request is
  747.                             possible from. You can put a "!<passwords>"
  748.                             behind a directory name to indicate a password
  749.                             protected directory.
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.       Page 11
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.                                         Prime request processor documentation
  784.  
  785.       Magic list          : Full path and filename of a plain ascii text
  786.                             containing a list of magic files. RP reads the
  787.                             standard magic filename layout, which Frontdoor
  788.                             also uses. The magic list can also contain
  789.                             service and template requests:
  790.  
  791.                             for magic file names:
  792.                             MAGIC Filespecification <parameters>
  793.  
  794.                             for template requests:
  795.  
  796.                             MAGIC <Template.TPL
  797.  
  798.                             for service requests:
  799.  
  800.                             MAGIC >PROGRAM.EXE PARAMETERS <^*filespec>
  801.  
  802.                             When using a double ^ before the filespec, the
  803.                             files matching filespec will not be included in
  804.                             the request response message. Please note that
  805.                             they are still counted for the limits.
  806.  
  807.                             All entries can be protected with a password by
  808.                             specifying a !PASSWORD anywhere behind the
  809.                             MAGIC.
  810.  
  811.       Password list       : A list of password protected files, directory's
  812.                             or a unique portions of it. No wildcards are
  813.                             supported in this file.
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.       Page 12
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.                                         Prime request processor documentation
  845.  
  846.       ╔════════════════════════════════════════════════════════════════╕
  847.       ║≡ Node manager ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  848.       ╙────────────────────────────────────────────────────────────────┘
  849.  
  850.       In the node manager you set up different request limits for different
  851.       nodes.
  852.       The following fields can be set:
  853.  
  854.       Sysop name          : The name of the sysop. This is only a reminder
  855.                             for you, and not actually being used by RP.
  856.  
  857.       Aka                 : Aka of the node. You can use wildcards here, ie
  858.                             2:512/*.
  859.  
  860.       Limited hours       : If this field is set to yes, time slots are
  861.                             checked. If a node calls outside this timeslot
  862.                             this node record is not available.
  863.  
  864.       Available time      : When limited hours is true, you can define with
  865.                             a resolution of 10 minutes whether this node
  866.                             record is available.
  867.  
  868.       Nodes               : You can set here on which nodes this node record
  869.                             is available.
  870.  
  871.       Level               : The level defines the actual request limits.
  872.  
  873.       Groups              : The groups the node has request access to, with
  874.                             respect to time slots.
  875.  
  876.       Recovertime         : Time to "forget" requests in minutes. {+}
  877.  
  878.       Deny requests       : If this field is set to yes, no requests are
  879.                             accepted from this node. He will receive a
  880.                             message stating that requests by him are denied.
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.       Page 13
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.                                         Prime request processor documentation
  906.  
  907.       ╔════════════════════════════════════════════════════════════════╕
  908.       ║≡ Level Manager ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  909.       ╙────────────────────────────────────────────────────────────────┘
  910.  
  911.       The level defines the actual request limits.
  912.  
  913.       The following fields can be set:
  914.  
  915.       Level               : RP will only use this record if the level of the
  916.                             user is higher or equal to this level. The best
  917.                             match will be used.
  918.  
  919.       Baudrate            : RP will only use this record if the baudrate of
  920.                             the user is higher or equal to this baudrate.
  921.                             The best match will be used.
  922.  
  923.       Limited hours       : If this field is set to yes, time slots are
  924.                             checked. A level record can only be used, if the
  925.                             times in the timeslot are ok, or disabled.
  926.                             This will allow you to set different request
  927.                             limits, depending the time of the day.
  928.  
  929.       Available time      : When limited hours is true, you can define with
  930.                             a resolution of 10 minutes whether this limit
  931.                             record is available.
  932.  
  933.       Nodes               : You can set here on which nodes this limit
  934.                             record is active.
  935.  
  936.       Per timeslot {+}
  937.  
  938.       Max. KBytes {+}     : The maximum number of kilobytes that will be
  939.                             send during a timeslot.
  940.  
  941.       Max. Time {+}       : The maximum transfer time during a timeslot.
  942.  
  943.       Max. Match {+}      : The maximum number of files send during a
  944.                             timeslot.
  945.  
  946.       Per session
  947.  
  948.       Max. KBytes         : The maximum number of kilobytes that will be
  949.                             send during a session.
  950.  
  951.       Max. Time           : The maximum transfer time during a session.
  952.  
  953.       Max. Match          : The maximum number of files send during a
  954.                             session.
  955.  
  956.  
  957.  
  958.       Page 14
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.                                         Prime request processor documentation
  967.  
  968.       ╔════════════════════════════════════════════════════════════════╕
  969.       ║≡ Password protecting files ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  970.       ╙────────────────────────────────────────────────────────────────┘
  971.  
  972.       There are a number of ways to password protect your files. First of
  973.       all you can password protect your magic names. To do that, put a
  974.       !<password> between the magic name and the filename to send. Ie:
  975.  
  976.       rp !password k:\support\rp.arj
  977.  
  978.       The second way of password protecting files is the password list, you
  979.       can enter in the group setup. The format is as follows:
  980.  
  981.       <match string> !<password>
  982.  
  983.       If the filename to send, contains <match string> (no wildcards), the
  984.       requester needs the given password.
  985.  
  986.       The third (non-standard) way of password protecting your files, is to
  987.       add the password to the list of requestable directory's as follows:
  988.  
  989.       <path to requestable directory> !password
  990.  
  991.       Please note that this is not checked for the magic file names.
  992.  
  993.       ╔════════════════════════════════════════════════════════════════╕
  994.       ║≡ Individual marking of free files/directory's ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  995.       ╙────────────────────────────────────────────────────────────────┘
  996.  
  997.       RP can flag individual files/directory's and magic names free. It has
  998.       three switches for that:
  999.  
  1000.       /FK (free kilobyte)
  1001.       /FT (free time)
  1002.       /FM (free match)
  1003.  
  1004.       These parameters should be separated by spaces.
  1005.  
  1006.       To flag magic names, edit your magic names file. In that case, put one
  1007.       or more switches at the end of a line describing a certain magic name.
  1008.  
  1009.       For other situations, take the password list file. Instead of typing a
  1010.       password behind a file, type one or more of above switches after a
  1011.       <match string>. You can of course also combine the switches and the
  1012.       password.
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.       Page 15
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.                                         Prime request processor documentation
  1028.  
  1029.       ╔════════════════════════════════════════════════════════════════╕
  1030.       ║≡ 3 Template files ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1031.       ╙────────────────────────────────────────────────────────────────┘
  1032.  
  1033.       RP uses a template system for its response messages. The ones not used
  1034.       for the actual request response are pretty much your every day average
  1035.       template files, but the request response template file. Well... I am
  1036.       very much aware of the fact that they look mighty strange, but they
  1037.       work.
  1038.  
  1039.       It is best not to setup a template file from scratch, but to edit the
  1040.       existing example templates.
  1041.  
  1042.       Depending on the result of the request, RP needs to give different
  1043.       response messages. Ie, it is quite useless to add a paragraph about
  1044.       files that were found, if no files were found. Therefore RP's template
  1045.       language has special keywords, which tell RP whether or not to include
  1046.       the line. RP's template language also contains keywords to change the
  1047.       subject line, or the "from name" of the message {+}.
  1048.       Here is a list of them, with an explanation when they are included:
  1049.  
  1050.       @INCLUDE@           Includes the file after this keyword, ie:
  1051.  
  1052.                           @INCLUDE@FAILED.TPL
  1053.  
  1054.                           This would include FAILED.TPL into the current
  1055.                           message.
  1056.  
  1057.       @SUBJECT@           The line after this keywords will be the subject
  1058.                           of the message. This defaults to "Request response
  1059.                           message".
  1060.  
  1061.       @WHOFROM@           Changes the Who From name {+}. This defaults to
  1062.                           "Request Processor".
  1063.  
  1064.       @SETMARG@           Sets the margin for descriptions. This defaults to
  1065.                           55. Words will be wrapped automaticly.
  1066.  
  1067.       @COMMENT@           This line will never be included. Just meant as
  1068.                           comment to you.
  1069.  
  1070.       @FAILEDR@           This line is included if the request somehow
  1071.                           failed. (ie, files not found, or request limits).
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.       Page 16
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.                                         Prime request processor documentation
  1089.  
  1090.       @DATEFRM@           Sets the date format used in the messages. The
  1091.                           value can be between 0 and 17, and means:
  1092.  
  1093.                            0 dd-mm-yy (with leading zero)
  1094.                            1 mm-dd-yy (with leading zero)
  1095.                            2 yy-mm-dd (with leading zero)
  1096.                            3 dd-mm-yy (without leading zero)
  1097.                            4 mm-dd-yy (without leading zero)
  1098.                            5 yy-mm-dd (without leading zero)
  1099.                            6 dd/mm/yy (with leading zero)
  1100.                            7 mm/dd/yy (with leading zero)
  1101.                            8 yy/mm/dd (with leading zero)
  1102.                            9 dd/mm/yy (without leading zero)
  1103.                           10 mm/dd/yy (without leading zero)
  1104.                           11 yy/mm/dd (without leading zero)
  1105.                           12 dd.mm.yy (with leading zero)
  1106.                           13 mm.dd.yy (with leading zero)
  1107.                           14 yy.mm.dd (with leading zero)
  1108.                           15 dd.mm.yy (without leading zero)
  1109.                           16 mm.dd.yy (without leading zero)
  1110.                           17 yy.mm.dd (without leading zero)
  1111.  
  1112.       @COUNTER@           Sets the download counter style:
  1113.  
  1114.                            0  [ 5]
  1115.                            1  [05]
  1116.                            2  ( 5)
  1117.                            3  (05)
  1118.                            4 [  5]
  1119.                            5 [005]
  1120.                            6 (  5)
  1121.                            7 (005)
  1122.  
  1123.       @LIMITKB@           Sets the "kilobyte limit" text, used in the
  1124.                           %REASON% keyword. This defaults to "kilobyte
  1125.                           limit".
  1126.  
  1127.       @LIMITTM@           Sets the "time limit" text, used in the %REASON%
  1128.                           keyword. This defaults to "time limit".
  1129.  
  1130.       @LIMITMT@           Sets the "match limit" text, used in the %REASON%
  1131.                           keyword. This defaults to "match limit".
  1132.  
  1133.       @LIMITNE@           Sets the "next event in the way" text, used in the
  1134.                           %REASON% keyword. This defaults to "next event in
  1135.                           the way".
  1136.  
  1137.       @NODESCR@           Sets the "no description available" text, used in
  1138.                           the %DESCRIPTIONS% keyword. This defaults to "no
  1139.                           description available".
  1140.  
  1141.       Page 17
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.                                         Prime request processor documentation
  1150.  
  1151.       @SENDFLS@           Only if files are actually sent, this line will be
  1152.                           included. The %FILES% keyword can be used in this
  1153.                           line, and will be replaced by the filename being
  1154.                           sent. (a line with the %FILES% keywords is
  1155.                           repeated for every file that is being sent).
  1156.                           If the keyword %FILES% is used, can use the
  1157.                           %FSIZE%, %FDATE%, %DOWNLOADS% and %DESCRIPTION%
  1158.                           keywords which expand to the filesize, filedate,
  1159.                           download counter and file description of the
  1160.                           current file. Please mind that if no description
  1161.                           database was created, the %DESCRIPTION% keyword
  1162.                           and the %DOWNLOADS% keyword will not be replaced.
  1163.  
  1164.       @NSNDFLS@           If no files were send, this line will be included.
  1165.  
  1166.       @LIMITED@           Only if files are not sent because of request
  1167.                           limits, this line will be included. The %FILES%
  1168.                           and %REASON% keywords can be used in this line,
  1169.                           and will be replaced by respectively the filename
  1170.                           and the reason why it could not be sent. (a line
  1171.                           with the %FILES% keywords is repeated for every
  1172.                           file that could not be send).
  1173.  
  1174.       @NMTCHTM@           Sets the "no update available" text, used in the
  1175.                           %REASON% keyword. This defaults to "no description
  1176.                           available". This is done when people do an update
  1177.                           request, and no update has been found.
  1178.  
  1179.       @NMTCHPE@           Sets the "password error" text, used in the
  1180.                           %REASON% keyword. This defaults to "password
  1181.                           error". This is done when people give the wrong or
  1182.                           no password when requesting a file. 
  1183.  
  1184.       @NMTCHWC@           Sets the "Too many wildcards in filename" text,
  1185.                           used in the %REASON% keyword. This defaults to
  1186.                           "Too many wildcards in filename". This is done
  1187.                           when people request a file, and include to many
  1188.                           wildcards.
  1189.  
  1190.       @NMTCHGR@           Sets the "No access to group %GROUP%" text, used
  1191.                           in the %REASON% keyword. This defaults to "No
  1192.                           access to group %GROUP%". This is done when people
  1193.                           request a file, and there was no access for them
  1194.                           to that group. %GROUP% is expanded to the actual
  1195.                           group.
  1196.  
  1197.       @NMTCHNF@           Sets the "No match found" text, used in the
  1198.                           %REASON% keyword. This defaults to "No match
  1199.                           found". This is done when people request a file,
  1200.                           and simply no match was found.
  1201.  
  1202.       Page 18
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.                                         Prime request processor documentation
  1211.  
  1212.       @NOMATCH@           Only if requests were made with no matching file
  1213.                           or magic name, this line will be added. The
  1214.                           %REQUESTS% macro can be used in this line, and
  1215.                           will be replaced by the filespecification the user
  1216.                           requested. (a line with the %REQUESTS% macro will
  1217.                           be repeated for every filespecification that is
  1218.                           not found). In this line you can also include the
  1219.                           %REASON% keyword, which will be expanded to the
  1220.                           reason why a file could not be found.
  1221.  
  1222.       @DGROUPS@           Only if groups are disabled, and certain requests
  1223.                           did not have a matching file or magic name, this
  1224.                           line will be included. The %DGROUPS% and
  1225.                           %DGROUPSNAME% can be used in this line (one or
  1226.                           both), and are replaced by respectively the group
  1227.                           tag, and the group name. (a line with either the
  1228.                           %DGROUPS% and/or the %DGROUPSNAME% keyword will be
  1229.                           repeated for every disabled group).
  1230.  
  1231.       @NOLIMIT@           Only if the remote site has no request limits at
  1232.                           all, this line is included.
  1233.  
  1234.       @YSLIMIT@           If the remote site has one or more request limits,
  1235.                           this line is included.
  1236.  
  1237.       @KSLIMIT@           If the remote site has a kilobyte request limit
  1238.                           per session, this line is included.
  1239.  
  1240.       @KTLIMIT@           If the remote site has a kilobyte request limit
  1241.                           per timeslot, this line is included.
  1242.  
  1243.       @TSLIMIT@           If the remote site has a time request limit per
  1244.                           session, this line is included.
  1245.  
  1246.       @TTLIMIT@           If the remote site has a time request limit per
  1247.                           timeslot, this line is included.
  1248.  
  1249.       @MSLIMIT@           If the remote site has a match request limit per
  1250.                           session, this line is included.
  1251.  
  1252.       @MTLIMIT@           If the remote site has a match request limit per
  1253.                           timeslot, this line is included.
  1254.  
  1255.       @YNLIMIT@           This line is included if the remote site has
  1256.                           request limits set, but not all.
  1257.  
  1258.       @YTLIMIT@           This line is included if the remote site has
  1259.                           timeslot limits set. The %TIMESLOT% macro can be
  1260.                           used here, which expands to the time in minutes a
  1261.                           timeslot lasts.
  1262.  
  1263.       Page 19
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.                                         Prime request processor documentation
  1272.  
  1273.       ╔════════════════════════════════════════════════════════════════╕
  1274.       ║≡ Keywords ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1275.       ╙────────────────────────────────────────────────────────────────┘
  1276.  
  1277.       RP also supports the "standard" set of keywords. Here is a list of
  1278.       them:
  1279.  
  1280.       %MYAKA%             Replaced with the AKA used to send a message (RP
  1281.                           uses your mailers aka matching table to decide
  1282.                           which aka to use)
  1283.  
  1284.       %YOURAKA%           The main AKA used by the Remote System.
  1285.  
  1286.       %FULLNAME%          The name of the sysop of the remote system.
  1287.  
  1288.       %FIRSTNAME%         The first name of the sysop of the Remote system.
  1289.  
  1290.       %LASTNAME%          The last name of the sysop of the remote system.
  1291.  
  1292.       %DATE%              Current date.
  1293.  
  1294.       %TIME%              Current time.
  1295.  
  1296.       %PROGRAM%           Program name and version. In unregistered mode,
  1297.                           this keyword is mandatory. If not used, RP will
  1298.                           attach a line at the bottom of the message.
  1299.  
  1300.       %KBREQTOTAL%        Total kilobytes requested (in this and other
  1301.                           sessions during the current timeslot).
  1302.  
  1303.       %NRREQTOTAL%        Total files requested (in this and other sessions
  1304.                           during the current timeslot).
  1305.  
  1306.       %KBREQSES%          Total kilobytes requested in this session.
  1307.  
  1308.       %NRREQSES%          Total number of files requested in this session.
  1309.  
  1310.       %KBREQTSL%          Total kilobytes requested in previous sessions.
  1311.                           (during the current timeslot).
  1312.  
  1313.       %NRREQTSL%          Total number of files requested in previous
  1314.                           sessions. (during the current timeslot)
  1315.  
  1316.       %KSLIMIT%           The kilobytes per session limit.
  1317.  
  1318.       %KTLIMIT%           The kilobytes per timeslot limit.
  1319.  
  1320.       %TSLIMIT%           The time per session limit.
  1321.  
  1322.       %TTLIMIT%           The time per timeslot limit.
  1323.  
  1324.       Page 20
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.                                         Prime request processor documentation
  1333.  
  1334.       %MSLIMIT%           The match per session limit.
  1335.  
  1336.       %MTLIMIT%           The match per timeslot limit.
  1337.  
  1338.       $[name]             This will be replaced by the environment variable
  1339.                           'name'. If the environment variable could not be
  1340.                           found, the $[name] will be left alone. You can
  1341.                           nest these macro's.
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.       Page 21
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.                                         Prime request processor documentation
  1394.  
  1395.       RP also supports the macro's you can use on the commandline for a
  1396.       service request. The ones important for the templates are:
  1397.  
  1398.       =A                  Main aka of the remote system.
  1399.  
  1400.       =B                  The current DCE speed.
  1401.  
  1402.       =C                  Cost per minute to call the remote system. This
  1403.                           "0" for inbound sessions.
  1404.  
  1405.       =D                  The string INBOUND when the remote system
  1406.                           initiated the session, or OUTBOUND when your
  1407.                           system initiated the session.
  1408.  
  1409.       =L                  Remote system's location.
  1410.  
  1411.       =N                  Remote system's site name.
  1412.  
  1413.       =O                  Name of remote sysop.
  1414.  
  1415.       =X                  The string "SECURE" or "UNSECURE" depending on
  1416.                           whether the session is protected by a session
  1417.                           level password.
  1418.  
  1419.       =Z                  Type of session. Expands to "WAZOO", "EMSI" or
  1420.                           "OTHER".
  1421.  
  1422.       =G                  The number of minutes until the next event that
  1423.                           does not allow human callers.
  1424.  
  1425.       =H                  The number of minutes until the next event that
  1426.                           doesn't allow file requests.
  1427.  
  1428.       =J                  Telephone number of the remote system.
  1429.  
  1430.       =K                  Remote system's nodelist flags.
  1431.  
  1432.       =W                  Translates to "LISTED" or "UNLISTED" depending on
  1433.                           whether or not the remote system was found in the
  1434.                           local nodelist database.
  1435.  
  1436.       =Y                  Current task= setting.
  1437.  
  1438.       This is not a complete list, but the other macro's are not interesting
  1439.       for templates.
  1440.  
  1441.       Further, if the last character of a line is a backslash (\), no
  1442.       carriage return will be placed in the message after this line. (ie,
  1443.       use this in paragraphs)
  1444.  
  1445.  
  1446.       Page 22
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.                                         Prime request processor documentation
  1455.  
  1456.       ╔════════════════════════════════════════════════════════════════╕
  1457.       ║≡ Template filenames ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1458.       ╙────────────────────────────────────────────────────────────────┘
  1459.  
  1460.       Templates can be placed anywhere on your HD, but if you do not specify
  1461.       a path, RP will look for them in your template directory, or if not
  1462.       defined, the system directory.
  1463.       A few template names are hard coded, reqresp.tpl (the request response
  1464.       message), and noreq.tpl, send if a node may not request.
  1465.  
  1466.       Please note that templates do not have a default extension!
  1467.  
  1468.       ╔════════════════════════════════════════════════════════════════╕
  1469.       ║≡ Language specific templates ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1470.       ╙────────────────────────────────────────────────────────────────┘
  1471.  
  1472.       RP can send a template, depending on (part of) the nodenumber of the
  1473.       system requesting. It uses the file TPLEXT.RP for that, with the
  1474.       following format:
  1475.  
  1476.       <part-of-nodenumber> <extension>
  1477.       <part-of-nodenumber> <extension>
  1478.  
  1479.       For instance:
  1480.  
  1481.       2:512/149 MYP
  1482.       2:512/ DUT
  1483.       2:500/ DUT
  1484.       2:28   DUT
  1485.       2:24   GER
  1486.  
  1487.       If a line matches, RP will first look for a template with the original
  1488.       filename, but with the new extension. If not found, RP will try to
  1489.       open the original filename.
  1490.       The first match goes, so 2:512/149 goes before 2:512/.
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.       Page 23
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.                                         Prime request processor documentation
  1516.  
  1517.       ╔════════════════════════════════════════════════════════════════╕
  1518.       ║≡ 4 Compilers ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1519.       ╙────────────────────────────────────────────────────────────────┘
  1520.  
  1521.       RP includes several compilers, to compile your file database and
  1522.       several external description compilers.
  1523.  
  1524.       ╔════════════════════════════════════════════════════════════════╕
  1525.       ║≡ RPcomp ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1526.       ╙────────────────────────────────────────────────────────────────┘
  1527.  
  1528.       RPcomp is the file database compiler of RP. The reasons for RP using a
  1529.       file database are quite simple. It is faster, and easier to search in.
  1530.       (with speed being the most important reason).
  1531.       The database RPcomp creates is described in the RPSTRUCT.INC document.
  1532.  
  1533.       The reason for speed being so important is obvious, the searching of
  1534.       files is done during the session, which could be an expensive long
  1535.       distance call.
  1536.  
  1537.       RPcomp will compile areas marked as "CompileOnce" (mainly used for cd-
  1538.       rom areas, but it can be used also for non-changing harddisk areas)
  1539.       only when they have never been compiled before, the setup has changed
  1540.       or when you force RPcomp to do so by using the /C parameter.
  1541.       This static filebase is written to FILEBASE.RPS, MAGIC.RPS and
  1542.       TEXTBASE.RPS. These three files will be the basis for every other
  1543.       compilation.
  1544.  
  1545.       RPcomp can be run while your mailer is online, but not when RP is
  1546.       processing a request. When RP is using the filebase, RPcomp will wait
  1547.       until it's done and the other way around.
  1548.       Please note that only one copy of RPcomp may run at a time.
  1549.  
  1550.       RPcomp lays no static link to the description database. Ie, the order
  1551.       of compiling is not important.
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.       Page 24
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.                                         Prime request processor documentation
  1577.  
  1578.       ╔════════════════════════════════════════════════════════════════╕
  1579.       ║≡ Description compiler standard parameters ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1580.       ╙────────────────────────────────────────────────────────────────┘
  1581.  
  1582.       All description compilers have two standard parameters, namely /A to
  1583.       append the current information to the new database, and /C to only
  1584.       compile Compile Once areas.
  1585.  
  1586.       The /A switch can be used if you have more then one source for the
  1587.       descriptions. For instance, you use Remote Access, but also have a few
  1588.       extra areas for request that you describe using Files.BBS. You can use
  1589.       the following:
  1590.  
  1591.       RADESC              : Compiles all requestable non-"compile once"
  1592.                             Remote Access file areas.
  1593.       FBBSDESC <FILE> /a  : Compiles all paths in <FILE> and appends them to
  1594.                             the previous database.
  1595.  
  1596.       PLEASE NOTE THAT THE DESCRIPTION COMPILERS DO NOT UPDATE WHEN USING
  1597.       THE /A SWITCH, THEY JUST STICK THE NEW INFORMATION AT THE END OF
  1598.       EXISTING DATABASE.
  1599.  
  1600.       The Compile Once support (the /C parameter) for description compilers
  1601.       is different from the RPcomp way because of the append possibility.
  1602.  
  1603.       To compile your CD-Rom areas use:
  1604.  
  1605.       RADESC /CD          : Compiles all requestable "compile once" Remote
  1606.                             Access File areas.
  1607.  
  1608.       You can also do appending here.
  1609.  
  1610.       ╔════════════════════════════════════════════════════════════════╕
  1611.       ║≡ FBBSDESC ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1612.       ╙────────────────────────────────────────────────────────────────┘
  1613.  
  1614.       FBBSdesc is a description compiler for RP. It takes the file
  1615.       descriptions out of Files.BBS. It supports multiline descriptions, and
  1616.       wildcards in Files.BBS.
  1617.  
  1618.       Fire it up with either RP, or a filename containing directory's to
  1619.       include, ie:
  1620.  
  1621.       FBBSDESC RP or
  1622.       FBBSDESC dirlist.txt
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.       Page 25
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.                                         Prime request processor documentation
  1638.  
  1639.       ╔════════════════════════════════════════════════════════════════╕
  1640.       ║≡ RAdesc ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1641.       ╙────────────────────────────────────────────────────────────────┘
  1642.  
  1643.       This program converts the file descriptions in the Remote Access File
  1644.       Database to RP format.
  1645.  
  1646.       For Remote Access, there is also a tool included, named RADCOUNT,
  1647.       which updates the download counters in the RA FDB.
  1648.  
  1649.       Usage:
  1650.  
  1651.       RADCOUNT <RP logfile>
  1652.  
  1653.       I run it after every mailcall.
  1654.  
  1655.       ╔════════════════════════════════════════════════════════════════╕
  1656.       ║≡ MAXdesc ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1657.       ╙────────────────────────────────────────────────────────────────┘
  1658.  
  1659.       This program compiles the file descriptions from Maximus. (standard
  1660.       Files.BBS with parameters). On the commandline, enter full path and
  1661.       name of your FileArea.CTL or simply RP.
  1662.  
  1663.       ╔════════════════════════════════════════════════════════════════╕
  1664.       ║≡ PCBdesc ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1665.       ╙────────────────────────────────────────────────────────────────┘
  1666.  
  1667.       This program compiles your PCboard 15.0 descriptions. On the
  1668.       commandline, enter full path and name of your PCBoard.DAT.
  1669.  
  1670.       This PCBoard compiler was largely written by Dik Bots.
  1671.  
  1672.       ╔════════════════════════════════════════════════════════════════╕
  1673.       ║≡ 4DOSdesc ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1674.       ╙────────────────────────────────────────────────────────────────┘
  1675.  
  1676.       This description compiler takes the file descriptions out of a
  1677.       4Dos/NDos DESCRIPT.ION file.
  1678.  
  1679.       Fire it up with either RP, or a filename containing directory's to
  1680.       include, ie:
  1681.  
  1682.       4DOSDESC RP or
  1683.       4DOSDESC dirlist.txt
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.       Page 26
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.                                         Prime request processor documentation
  1700.  
  1701.       ╔════════════════════════════════════════════════════════════════╕
  1702.       ║≡ EzyDesc ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1703.       ╙────────────────────────────────────────────────────────────────┘
  1704.  
  1705.       This description compiler takes the descriptions from your EzyCom
  1706.       filebase. It has been written by Heinz-Josef Bomanns. Please look at
  1707.       the archive EZYDESC.ARJ for full information about this.
  1708.  
  1709.       ╔════════════════════════════════════════════════════════════════╕
  1710.       ║≡ Other compilers ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1711.       ╙────────────────────────────────────────────────────────────────┘
  1712.  
  1713.       Other description compilers are in the making. If your BBS supports
  1714.       Files.BBS, FBBSDESC can be used, if your BBS package uses a specific
  1715.       database format, you can request a compiler for it.
  1716.  
  1717.       Please send as much information as possible about the database format
  1718.       being used. If you are a programmer, you can also program one
  1719.       yourselves, and earn a free RP key (look at freereg.!!!).
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.       Page 27
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.                                         Prime request processor documentation
  1761.  
  1762.       ╔════════════════════════════════════════════════════════════════╕
  1763.       ║≡ 5 RPpack ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1764.       ╙────────────────────────────────────────────────────────────────┘
  1765.  
  1766.       RPpack packs the requested files database from RP. This file
  1767.       (requestd.rp) contains information for RP to handle request limits per
  1768.       timeslot, and remembering requests.
  1769.       RPpack only keeps the last 500 records of this file. It needs no
  1770.       additional parameters.
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.       Page 28
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.                                         Prime request processor documentation
  1822.  
  1823.       ╔════════════════════════════════════════════════════════════════╕
  1824.       ║≡ 6 RP at work ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1825.       ╙────────────────────────────────────────────────────────────────┘
  1826.  
  1827.       When your mailer encounters a file request message, it will create a
  1828.       file with all requested files. RP will read this file, and search the
  1829.       database for all matching filenames. (filtering out any duplicate
  1830.       names).
  1831.       After all checking, a list of files to send to the user is created,
  1832.       descriptions are gathered, response messages are created and control
  1833.       is given back to your mailer, which on his turn sends the files, and
  1834.       the response message(s) to the requesting system.
  1835.  
  1836.       RP can not really check if a request came through all the way. Ie, the
  1837.       connection could be lost during a file transfer. Therefore, RP will
  1838.       store each file send, per system. Now if a system requests the same
  1839.       file again, it is probably because of a request failure, the files are
  1840.       not counted again!
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.       Page 29
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.                                         Prime request processor documentation
  1883.  
  1884.       ╔════════════════════════════════════════════════════════════════╕
  1885.       ║≡ Frequently asked questions ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  1886.       ╙────────────────────────────────────────────────────────────────┘
  1887.  
  1888.       Question:           Why does RP not read my bulletin boards file
  1889.                           database. It would save a lot of compiling time.
  1890.  
  1891.       Answer:             RP's database can be looked in ultra-fast. It only
  1892.                           contains 3 files, and that is all RP needs. If you
  1893.                           take the RA FDB for instance, RP would need to
  1894.                           open atleast one file per area, and two more if a
  1895.                           file was actually found in the area. Further RA
  1896.                           supports wildcards in the FDB, so RP would also
  1897.                           have to look on disk.
  1898.  
  1899.       Question:           Why is that RP does not update my download
  1900.                           counters.
  1901.  
  1902.       Answer:             That would slow down the processing of the request
  1903.                           handling, since RP would have to locate the exact
  1904.                           position of the file in your bulletin boards file
  1905.                           database. It is better done by an offline program,
  1906.                           that updates your download counters based on your
  1907.                           mailers logfile. For Files.BBS style there are
  1908.                           such programs available and for the Remote Access
  1909.                           FDB there is a program called RADCOUNT included in
  1910.                           the RP package.
  1911.  
  1912.       Question:           What is that with all the level and groups stuff.
  1913.  
  1914.       Answer:             The group stuff defines requestable areas. Ie, if
  1915.                           you give access to a certain group, people can
  1916.                           request from file areas defined in that group.
  1917.                           Because you can disable a group with time slots,
  1918.                           baudrate etc, and give specific access to a group
  1919.                           to certain nodes or types of sessions you can
  1920.                           control who requests stuff, and when.
  1921.                           The level stuff define the actual request limits.
  1922.  
  1923.       Question:           How can I locally test RP?
  1924.  
  1925.                           Two batchfiles are included, named RPFD.BAT and
  1926.                           RPIM.BAT which can be used for local testing. Just
  1927.                           play around with the parameters, and in the case
  1928.                           of a Frontdoor environment, just create a test
  1929.                           remote info file using MAKEINFO.EXE which is
  1930.                           included with this package.
  1931.  
  1932.  
  1933.  
  1934.  
  1935.       Page 30
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.                                         Prime request processor documentation
  1944.  
  1945.       Question:           Why choose RP instead of other request processors.
  1946.  
  1947.       Answer:             RP uses a totally different approach then most
  1948.                           other request processors out there.
  1949.                           With RP you can both get the advantage of a fast
  1950.                           file database, and sending descriptions from
  1951.                           various bulletin board file databases.
  1952.                           Further RP allows you to control your request a
  1953.                           lot better.
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.       Page 31
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.                                         Prime request processor documentation
  2005.  
  2006.       ╔════════════════════════════════════════════════════════════════╕
  2007.       ║≡ 7 Support ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  2008.       ╙────────────────────────────────────────────────────────────────┘
  2009.  
  2010.       For a list of international support and registration sites, please
  2011.       look in Support.DOC.
  2012.  
  2013.       If you have any problem when running or installing RP, we appreciate a
  2014.       call or message from you. Don't just delete it!
  2015.  
  2016.       For commercial inquiries please contact:
  2017.  
  2018.       TISAS
  2019.       P.O.Box 6599
  2020.       4802 HN  Breda
  2021.       The Netherlands
  2022.  
  2023.       ╔════════════════════════════════════════════════════════════════╕
  2024.       ║≡ Thanks ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  2025.       ╙────────────────────────────────────────────────────────────────┘
  2026.  
  2027.       Many persons contributed in the development of RP, here are some of
  2028.       them in alphabetic order:
  2029.  
  2030.       Thanks to Andreas Reinicke, Carsten Schroeder, Cor Gloudie, David
  2031.       Casey, Detlef Nick, Donald Heering, Eckhardt von dem Berge, Eduardo
  2032.       Jacob, Erik Coolen, Evert Bruinsma, Felix Mueller, Frank Koehler,
  2033.       Gerrit Mak, Gunnar Winkelmann, Hans de Vor, Heinz-Josef Bomanns, Horst
  2034.       Hackenbruch, Jan R. Koopmans, Marc Buffet, Matthijs in 't Anker,
  2035.       Michael Boettger, Peter Hampf, Peter Stewart, Raymond Dijkxhoorn,
  2036.       Reinier de Groot, Ron Huiskes, Terence Milbourn, Tonny Lin, Wilfried
  2037.       Rutjes and many more suggesting nice features.
  2038.  
  2039.       Of course a special thanks to Marco Miltenburg for producing the setup
  2040.       utility, and also a special thanks to Peter Hampf for various things.
  2041.  
  2042.       A special thank you to the people that have send bugreports with their
  2043.       registration form attached to it. Thanks for the thrust.
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.       Page 32
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.                                         Prime request processor documentation
  2066.  
  2067.       ╔════════════════════════════════════════════════════════════════╕
  2068.       ║≡ 8 Shareware ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  2069.       ╙────────────────────────────────────────────────────────────────┘
  2070.  
  2071.       RP is distributed under the shareware concept. You may evaluate RP for
  2072.       a period of one (1) month, after which you must either stop using the
  2073.       software, or register it. The unregistered version will not bleep,
  2074.       delay or other annoying stuff. It only lacks the "request limits per
  2075.       timeslot".
  2076.  
  2077.       Current price is about Hfl 35,- or US$ 25,-. For the exact and current
  2078.       prices request PRIMEREG at your nearest registration site.
  2079.  
  2080.       Group discount is available on request, and starts with 5 copies or
  2081.       more.
  2082.  
  2083.       For commercial inquiries please contact:
  2084.  
  2085.       TISAS
  2086.       P.O. Box 6599,
  2087.       4802 HN  Breda.
  2088.       The Netherlands.
  2089.  
  2090.       ╔════════════════════════════════════════════════════════════════╕
  2091.       ║≡ Legal stuff / standard disclaimer ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  2092.       ╙────────────────────────────────────────────────────────────────┘
  2093.  
  2094.        ■ In no event shall TISAS, Prime Productions, Hans Siemons, Marco
  2095.          Miltenburg nor any of their support sites be liable to you or
  2096.          anyone else for any damage directly or indirectly caused by RP or
  2097.          it's accompanying products. TISAS, Prime Productions, Hans Siemons
  2098.          and Marco Miltenburg guarantee that no code is made to deliberately
  2099.          damage yours or anyone else his system, and that there are no
  2100.          intentional flaws in the security system.
  2101.        ■ All executables, documents and example files are copyrighted (c)
  2102.          1993,94 by Hans Siemons, Marco Miltenburg, Prime Productions and
  2103.          TISAS. You may however share UNMODIFIED copies of this product, as
  2104.          long as no money is charged or accepted, other then cost of the
  2105.          material.
  2106.        ■ RP is distributed under the shareware concept. This means that
  2107.          after one (1) month, you must either register, or stop using the
  2108.          software.
  2109.        ■ All brands and product names named in this documentation are
  2110.          trademarks or registered trademarks of there respective holders.
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.       Page 33
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.                                         Prime request processor documentation
  2127.  
  2128.       ╔════════════════════════════════════════════════════════════════╕
  2129.       ║≡ 9 Future versions ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  2130.       ╙────────────────────────────────────────────────────────────────┘
  2131.  
  2132.       There are some small things on the current to-do list, but what's
  2133.       coming in the next version is mainly up to you, so just send in your
  2134.       suggestions.
  2135.  
  2136.       Definitely planned is some heavy work on this documentation!
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.       Page 34
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.                                         Prime request processor documentation
  2188.  
  2189.       ╔════════════════════════════════════════════════════════════════╕
  2190.       ║≡ 10 Technical notes ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  2191.       ╙────────────────────────────────────────────────────────────────┘
  2192.  
  2193.       RP does *NOT*, I repeat *NOT* take any request limits from
  2194.       Setup.FD/FD.Sys. All request limits should be defined in RPsetup, if
  2195.       they are not defined in RPsetup, there are no request limits!
  2196.  
  2197.       Errors in magic filenames and stuff are not seen as errors. RPcomp
  2198.       just reads the stuff, and stores valid information.
  2199.  
  2200.       RP will never send the same file more then once in a session. RP's
  2201.       search engine first makes a full list of all matching files. This list
  2202.       later on goes trough a "limit checker", producing a list of files to
  2203.       send.
  2204.  
  2205.       Also mind the following, if a file could be found in group A, and in
  2206.       group B (and the node had access to both), and the file in Group A is
  2207.       only free KB, and the file in Group B only free time, the file will be
  2208.       both free KB, and free time!
  2209.  
  2210.       RP creates fts-0001 and fsc-0039 compatible packets. It uses ftsc
  2211.       productcode 0xffh, since there no codes available anymore. You can
  2212.       identify a packet created by RP by the productcode 0xffh, and the
  2213.       longdata field contains 0x00525052h <RPR#0>.
  2214.  
  2215.       RP fully supports the WaZoo file and update requests, described in
  2216.       FTS-0006.
  2217.  
  2218.       RP's service requests are 99% compatible with FrontDoor, the only
  2219.       difference is that the =I parameter will always return 'N/A'.
  2220.  
  2221.       During EMSI sessions RP will send heartbeat signals via the fossil
  2222.       driver if things take a bit longer. For instance, when many files have
  2223.       been requested, or there is a lot of copying from CD-Rom to be done.
  2224.  
  2225.       RP was programmed using Borland Pascal with Objects 7.0, including the
  2226.       tools that came with it (Turbo Profiler, debugger and assembler). RP
  2227.       makes use of Object Professional.
  2228.       Source files were edited using Semware's QEdit advanced.
  2229.       The documentation was created using WordPerfect 5.1 for Dos.
  2230.  
  2231.       RPsetup was developed by Marco Miltenburg. Thanks a lot!
  2232.       The original visual interface concept of RPsetup is designed by
  2233.       Joaquim Homrighausen. Used with permission.
  2234.  
  2235.       Structures used by RP are included as RPSTRUCT.INC.
  2236.  
  2237.  
  2238.  
  2239.  
  2240.       Page 35
  2241.  
  2242.