home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / PBF_101.ZIP / PBBSFREQ.DOC < prev    next >
Encoding:
Text File  |  1995-08-01  |  36.2 KB  |  871 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                /▀▀▀▀▀▀   /▀▀▀▀▀  /▀▀▀  /▀▀ /▀▀▀▀▀▀    /▀▀▀▀▀
  7.                /▀▀  /▀▀ /▀▀  /▀▀ /▀▀▀▀ /▀▀ /▀▀  /▀▀  /▀▀  /▀▀
  8.                /▀▀▀▀▀▀  /▀▀▀▀▀▀▀ /▀▀/▀▀/▀▀ /▀▀  /▀▀▀ /▀▀▀▀▀▀▀
  9.                /▀▀      /▀▀  /▀▀ /▀▀ /▀▀▀▀ /▀▀  /▀▀  /▀▀  /▀▀
  10.                /▀▀      /▀▀  /▀▀ /▀▀  /▀▀▀ /▀▀▀▀▀▀   /▀▀  /▀▀  (tm)
  11.  
  12.                          /▀▀▀▀▀▀  /▀▀▀▀▀▀   /▀▀▀▀▀
  13.                          /▀▀  /▀▀ /▀▀  /▀▀ /▀▀
  14.                          /▀▀▀▀▀▀  /▀▀▀▀▀▀   /▀▀▀▀▀
  15.                          /▀▀  /▀▀ /▀▀  /▀▀      /▀▀
  16.                          /▀▀▀▀▀▀  /▀▀▀▀▀▀  /▀▀▀▀▀▀
  17.  
  18.                      /▀▀▀▀▀▀▀ /▀▀▀▀▀▀  /▀▀▀▀▀▀▀   /▀▀▀▀▀
  19.                      /▀▀      /▀▀  /▀▀ /▀▀       /▀▀  /▀▀
  20.                      /▀▀▀▀▀   /▀▀▀▀▀▀  /▀▀▀▀▀   /▀▀▀  /▀▀▀
  21.                      /▀▀      /▀▀ /▀▀  /▀▀       /▀▀/▀/▀▀
  22.                      /▀▀      /▀▀  /▀▀ /▀▀▀▀▀▀▀   /▀▀▀▀/▀
  23.  
  24.  
  25.                      PBBSFreq(tm) ─ File Request Door V1.01
  26.  
  27.        Copyright (C) 1995 Bing Wu & International Meridian Company (IMC).
  28.                               All Rights Reserved
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.    ┌──────────────────────────────────────────────────────────────────┐
  36.    │ ▓▓▓ Features ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  37.    └──────────────────────────────────────────────────────────────────┘
  38.  
  39.  
  40.      ■  Easy to setup. Takes less than 15 minutes
  41.      ■  Reads your configuration file from InterMail and FrontDoor
  42.      ■  Full screen Setup program using Pulldown menus
  43.      ■  Multi-Line aware
  44.      ■  Major multi-taskers supported
  45.      ■  Co-SysOp with SysOp access
  46.      ■  Built in User Editor {+}
  47.      ■  Support of upto 50 definable File Request Systems {+}
  48.      ■  File password protection {+}
  49.      ■  Sends an online message in a RemoteAccess environment when the file
  50.         request has been received if the user is still online. {+}
  51.      ■  Sends the users a message when there file request has arrived
  52.         supporting Hudson, Squish, Fido (*.MSG), EzyCom, and JAM
  53.      ■  Uses it's own database file for speed searches
  54.      ■  Direct support for RemoteAccess's File Data Base (FDB)
  55.      ■  The ability to set message attributes of CRASH and HOLD so your
  56.         routing file will only the call when you want it to
  57.      ■  Non-Fossil BBS Supported
  58.      ■  Internal carrier detection
  59.      ■  Optional customized Main Menu {+}
  60.      ■  Full detailed logging
  61.      ■  Plus much more
  62.  
  63.      {+} Registered Only Features
  64.  
  65.    ┌──────────────────────────────────────────────────────────────────┐
  66.    │▓▓ OverView & System Requirements ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  67.    └──────────────────────────────────────────────────────────────────┘
  68.     From the Features Listed above you can see that this program has all
  69.     the features of a regular Online BBS Lister door but with much much
  70.     more. Features marked with {+} or + is registered only feature.
  71.  
  72.     To run this program online on your BBS, you need to run either one
  73.     of the following BBS systems or one of the compatible systems.
  74.  
  75.         ■ RemoteAccess 1.xx & 2.xx
  76.         ■ WildCat                         ■ QuickBBS
  77.         ■ PCBoard                         ■ SpitFire
  78.         ■ RBBS─PC                         ■ Telegard
  79.         ■ WWIV                            ■ SuperBBS
  80.         ■ ProBoard
  81.         ■ Any software supports either door.sys or dirinfo#.def drop file.
  82.  
  83.         This program fully supports and has been tested under DV, Windows,
  84.         DOS, Win95 beta, OS/2.
  85.  
  86.    ┌──────────────────────────────────────────────────────────────────┐
  87.    │ ▓▓▓ Licensing Information ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  88.    └──────────────────────────────────────────────────────────────────┘
  89.  
  90.     PBBSFreq refers to all executables and text files contained in the
  91. PBBSFreq archive released by Bing Wu and International Meridian Company
  92. of Minneapolis, MN (IMC).
  93.  
  94.     PBBSFreq is the copyrighted material of Bing Wu and IMC. It may only be
  95. used in accordance with the following licensing conditions.
  96.  
  97.   1. You may use PBBSFreq for period of three (3) weeks on a trial basis in
  98. order to determine its suitability for your system. After this period, you
  99. must register PBBSFreq or discontinue its use.
  100.  
  101.   2. Commercial sites (Schools, business, or any site that conducts commercial
  102. activities) must register this program first before it can be used.
  103.  
  104.   3. Registration entitles you to use PBBSFreq and any future versions of it
  105. without any future registration.
  106.  
  107.   4. The products are provided as is. Neither the author nor any representative
  108. distributing this software is responsible for any damage incurred during the
  109. operation of the program. All that is promised is that it will utilize some
  110. disk space.
  111.  
  112.   5. The Author (Bing Wu) and/or IMC can discontinue support and development
  113. of PBBSFreq without notice and at anytime.
  114.  
  115.   6. You may not modify or otherwise reverse─engineer PBBSFreq.
  116.  
  117.   7. You may not use PBBSFreq in any unlawful and/or illegal manner.
  118.  
  119.   8. You are welcome to distribute PBBSFreq as long as you don't charge more
  120. than $5 for it, modify the program in anyway, or delete or add files from the
  121. original distribution archives. Distributing on CD-ROMs is welcome.
  122.  
  123.   9. A Registered Version of PBBSFreq MUST not be distributed with or without
  124. the authors and/or IMC's Permission.
  125.  
  126.  10. File Networks are FORBIDDEN from adding any files to the archive or
  127. change the archive type. The file must remain in ZIP format.
  128.  
  129.    ┌──────────────────────────────────────────────────────────────────┐
  130.    │ ▓▓▓ Registration & Support ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  131.    └──────────────────────────────────────────────────────────────────┘
  132.  
  133.   This program is distributed as shareware. You are granted 21 days a three (3)
  134. week trail period, after that you must either send in $25.00 registration fee
  135. or discontinue using it. All Commercial sites MUST register this program first
  136. before it can be used. Otherwise legal action may be brought against you.
  137.  
  138.   The $25.00 registration fee grants you to use to all future versions of this
  139. program without any additional registration fees. Your registration will be
  140. either sent to you via crash netmail or conventional mail at no extra charge
  141. within CANADA and USA. $5 charge applies for orders outside the USA and
  142. CANADA. See REGISTER.REG for more registration information.
  143.  
  144.    -=[ Support ]=-
  145. Echo Areas:
  146. FidoNet: RA_UTIL, SYSOP, PROBOARD, PCBOARD
  147. Official Echo: PS_SUPPORT (Available on all Panda Software support sites)
  148.  
  149.  
  150. Support/Distribution Site:
  151.  
  152.    ■ When Sending request/help to following support sites, specify how that
  153.      support site should reply to your message. (ROUTE/HOLD)
  154.  
  155.  
  156.   Author/Support:                     Registrations:
  157.   Bing Wu @ Panda BBS!                Mike Brusletten
  158.   Data: 1-612-378-7783 (28,800 V34)   Data    : 1-612-938-3206 (28,800 V.FC)
  159.   FidoNet : 1:282/1027.1                        1-612-938-0558 (14,400)
  160.   InterNet: wuxx0037@gold.tc.umn.edu  FidoNet : 1:282/1027
  161.                                       InterNet: mike.brusletten@scifi.mmbbs.com
  162.                                       Snail:
  163.                                       Scientifica/IMC
  164.                                       342 18th Ave N.
  165.                                       Hopkins, MN 55343-6909
  166.  
  167.   Support Site/Beta Site:
  168.   Mike McGrane
  169.   Data: 1-612-537-0449 (28,800 V34)
  170.         1-612-536-9218 (14,400)
  171.   FidoNet: 1:282/1024
  172.  
  173.    ┌──────────────────────────────────────────────────────────────────┐
  174.    │ ▓▓▓ Files In The Package ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  175.    └──────────────────────────────────────────────────────────────────┘
  176.  
  177.  
  178.      PBBSFREQ.EXE  The main program
  179.      PBFSETUP.EXE  The setup program for PBBSFreq
  180.      PBFMAINT.EXE  The Maintenance Utility program for PBBSFreq
  181.      PBFSCAN .EXE  Program used to read and move inbound file(s) requests
  182.      PBFIMPRT.EXE  A support program to import messages.
  183.      PBBSFREQ.DOC  You're reading it
  184.      PBFMENU.A??   Customizable menus in ASCII, ANS, AVATAR {+}
  185.      PBBSFREQ.A??  PBBSFreq logon screen
  186.      BADFILE.PBF   Definable filelist of files you DON'T want imported {+}
  187.      PBFHELP.A??   PBBSFREQ help file
  188.      BETATEST.APP  Application form for joining Panda Software BETA test team
  189.      REGISTRA.REG  Registration Form
  190.      REGSITE.ZIP   Non-North American Registration site application packet
  191.      TABSREG.INF   Information on how to use TABS to register doors
  192.      HISTORY.DOC   Development history of PBBSFreq
  193.  
  194.  
  195.    ┌──────────────────────────────────────────────────────────────────┐
  196.    │ ▓▓▓ Configuring PBBSFreq ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  197.    └──────────────────────────────────────────────────────────────────┘
  198.  
  199.  
  200.     The door will run in local mode with as little as 128k of memory. However
  201.     when using the door within a BBS environment it is recommended that you
  202.     have atleast 384k of free memory for door execution.
  203.  
  204.     You need to create a sub-directory to put the program files in. This can
  205.     be accomplished by doing the following.
  206.  
  207.      C:
  208.      CD\BBS
  209.      MD\BBS\FREQ
  210.  
  211.     Substitute your actual directory name in place of the BBS. Many systems
  212.     differ and no 2 are alike. Once that is done, UnZip the archive into the
  213.     directory that you just created by doing the following.
  214.  
  215.      pkunzip pbbsfreq c:\bbs\freq
  216.  
  217.     Now it is best to set the ENVIRONMENT variable to where the door files
  218.     are to be located. Place the following command in your autoexec.bat file.
  219.  
  220.     SET PBBSF=C:\<BBS DIR>\<Door Path>\
  221.  
  222.     Substitute your actual bbs directory for the <BBS DIR> and your actual
  223.     directory to the door <Door Path>. You will have to reboot your system
  224.     for the new environment to take effect.
  225.  
  226.     Once that is completed you're ready to start the configuration of the File
  227.     Request Door (PBBSFREQ). You will need a copy of the filelists you wish
  228.     to allow FREQ's from. So make sure you have them before you start. You
  229.     should be able to get a file list from most systems by FREQing FILES from
  230.     the system(s) you wish to FREQ to.
  231.  
  232.   Note 1: You need a copy of POLYXARC.EXE to be able to extract the file_id.diz
  233.           from inside the archive to import into your FDB or FILES.BBS. Which
  234.           is found on most reputable BBS systems.
  235.  
  236.   Note 2: Do to the built in overlay files within the door you need to make
  237.           the PBBSFREQ.EXE a read-only file. This can be accomplished using
  238.           DOS's ATTRIB.EXE program. Change to your PBBSFREQ directory and
  239.           type " attrib +r pbbsfreq.exe".  This will mark the file as
  240.           read-only. If you have any troubles with this please refer to your
  241.           DOS documentation.
  242.  
  243.   PBFSetup: Configuring the door to your needs.
  244.  
  245.  
  246.         SYSTEM SETUP:
  247.  
  248.         Paths:
  249.  
  250.     Here is where you setup all the paths that PBBSFreq will use during
  251.     door runtime. It should be noted that PBFSETUP will search for an
  252.     existing configuration file for both InterMail and FrontDoor and set
  253.     most of the vital paths automatically for you.
  254.  
  255.           Hudson:   The full path to your Hudson Message base.
  256.  
  257.           JAM   :   The full path and name of your JAM base you wish to use
  258.                     without any extension.
  259.  
  260.         Net-Mail:   The full path to your Net-Mail directory.
  261.  
  262.             Door:   The full path to the DOORs working directory.
  263.  
  264.         Swapping:   The full path where to door should place it's swap file
  265.                     if needed during runtime.
  266.  
  267.          Logfile:   Full path and logfile name with extension. If you use the
  268.                     percent sign " % " this will be translated the the node
  269.                     number for the node during runtime.
  270.  
  271.          Inbound:   The full path to your Un-Secure mail directory.
  272.  
  273.        Sec. Inbd:   The full path to your Secured mail directory.
  274.  
  275.        Freq File:   The full path where the incoming file(s) should be moved
  276.                     to.
  277.  
  278.        Semephore:   The full path and filename of your mailers semephore
  279.                     directory for rescaning the net-mail directory.
  280.  
  281.        Local Dir:   The full path and filename of your dupe database. This
  282.                     must be in PBBSFREQ format. Note: DO NOT use PBBSFREQ.DAT
  283.                     as the file name. It is reserved for the request file
  284.                     database. It is suggested you use your node number for
  285.                     this. ie.. 282_1024. No extension needed. Using your own
  286.                     filelisting for this.
  287.  
  288.      *** NOTE ***   In a RemoteAccess v2.xx environment this should point to
  289.                      the <Drive>:<Directory> of your FDB.
  290.  
  291.     RA Semaphore:   The Semaphore path for RemoteAccess. This is used to send
  292.                     an online message to the user if s/he is still online
  293.                     when the requested file is received.
  294.  
  295.         Site Information:
  296.  
  297.     This is the basic information that the door needs. When a File Request
  298.     (FREQ) is generated it will get the HOST system information for here. It
  299.     should noted again that some of this vital information will be taken
  300.     from your mailers configuration.
  301.  
  302.  
  303.      System Name:   Your BBS system NAME.
  304.  
  305.      SysOp Name :   Your NAME goes here.
  306.  
  307.     Phone Number:   Your PHONE number.
  308.  
  309.      Net Address:   Your Network address in Z:XXX/NNNN.PP
  310.                     Z : is your Zone number
  311.                     X : is your Network number
  312.                     N : is your Node number.
  313.                     P : is your Point number
  314.         Security:
  315.  
  316.                  Reserved for future expansion.
  317.  
  318.  
  319.         OPTIONS:
  320.  
  321.      System options is where you can fine tune the door to your system.
  322.  
  323.  
  324.      Message Base Type:  Valid message base types are Hudson, JAM, EzyCom and
  325.                          Fido (*.MSG)
  326.  
  327.            System Type:  This is what type of file system you are using. You
  328.                          can choose from either RemoteAccess, ProBoard or
  329.                          Others.
  330.  
  331.  Maximum File Requests:  The MAX file requests a user is allowed to make
  332.                          within a 24 hour period.
  333.  
  334.           Message Area:  Area number you wish to have PBBSFREQ post a message
  335.                          to your user letting them know when a file has been
  336.                          received.  (HUDSON/EyzCom)
  337.  
  338.              File Area:  Area # in the RemoteAccess FDB you wish the
  339.                          description to be imported.  (RA v2.xx Only)
  340.  
  341.           Allow Logoff:  You may disallow users to logoff from within the
  342.                          door.
  343.  
  344.           Allow Paging:  If you wish to chat with people in the door you
  345.                          may.
  346.  
  347.               Co-SysOp:  The security of your Co-SysOp if you wish for
  348.                          Her/Him to override any of the setup options.
  349.  
  350.            Uses Fossil:  If you use a Fossil driver.   (Recommended)
  351.  
  352.            Locked Rate:  The locked rate at which your fossil is locked.
  353.                          Valid settings are. 19200, 38400, 57600, and 115200
  354.  
  355.   Time Allowed in Door:  You can limit how long a person can be in the door.
  356.                          If you only want people allowed in the door for say
  357.                          20 minutes enter 20 here.
  358.  
  359.       Inactivity Timer:  How long a user can wait at a prompt before they are
  360.                          dis-connected from the system for inactivity.
  361.  
  362.               Days Old:  How many days before PBBFMaint will delete any
  363.                          unsent requests. (Default = 2)  {+}
  364.  
  365.        Cost of Request:  You can charge users in kilobytes (K) how much it
  366.                          will cost them to request a file. Just enter the
  367.                          proper amount in K for this.
  368.  
  369.                          Whenever a credit option is in use and under RA
  370.                          a password is generated to protect that file from
  371.                          being download by someone else other than the one
  372.                          who requested the file and paid for with his/her
  373.                          credits. For a Proboard system, however, the file
  374.                          is simply updated in PVTFILES.PRO, as for other file
  375.                          base (FILES.BBS) systems.
  376.  
  377.                          If credit option is in use, a hidden feature of
  378.                          PBBSFreq should appear by pressing 't' key at the
  379.                          main menu. This will allow the user to transfer
  380.                          credits from his/her BBS account to the door
  381.                          account.
  382.  
  383.        Protect FREQs  : The author really believes that the password and
  384.                         private file protection of the requested file is a
  385.                         fair play situation to the requester who paid with
  386.                         his/her credits. However you may disable this by
  387.                         toggling this option. {+}
  388.  
  389.  
  390.  
  391.         Colors:
  392.  
  393.     Here is where you can customize the colors that you and your users will
  394.     see when the door is running. Choose colors that are easy to read during
  395.     both day/night time hours.
  396.  
  397.  
  398.         Paging:
  399.  
  400.     This is where you can define how the paging hours can be utilized. You
  401.     choose the hours you wish to use.
  402.  
  403.               Duration:  How long you wish the page bell to sound when you
  404.                          are paged.
  405.  
  406.  
  407.           Paging Times:  Here is where the timing can be confusing to alot of
  408.                          people. So we'll take a little time to show you some
  409.                          simple steps on using this feature to it's fullest
  410.                          extent.
  411.  
  412.  
  413.     Note that the day starts at MIDNIGHT. For example: to allow paging all
  414.     day on Weekends until 6am on Monday Morning, and between 8pm and 6am
  415.     Monday through Friday would require the following settings :
  416.  
  417.                                 Start    End
  418.                   Sunday      : 00:00   00:00
  419.                   Monday      : 20:00   06:00
  420.                   Tuesday     : 20:00   06:00
  421.                   Wednesday   : 20:00   06:00
  422.                   Thursday    : 20:00   06:00
  423.                   Friday      : 20:00   06:00
  424.                   Saturday    : 00:00   00:00
  425.  
  426.     Notice Monday, we Start at 8pm, but also notice that we
  427.     had to Stop at 6am, this Stop is to stop the paging we had
  428.     enabled Sunday. It's important that you understand this!
  429.  
  430.  
  431.  
  432.         MANAGER:
  433.  
  434.         Freq SYSTEMS:
  435.  
  436.     This is where we will define what system(s) we wish to make a File
  437.     Request(s) from. In the unregistered version you may only have 2 systems
  438.     listed as FREQable. The registered version allows upto 50 systems to be
  439.     configured as FREQable.
  440.  
  441.          System Name:  The name of the System you will allow File Requests
  442.                        (FREQs) to.
  443.  
  444.          Net Address:  This system network address.
  445.  
  446.           List Files:  The master file listing that is used to search for
  447.                        files.  Without any extension.
  448.  
  449.            Hold Mail:  If you wish to hold the file request until a certain
  450.                        time of the day or night use this option to hold the
  451.                        request until you wish it to go out.
  452.  
  453.                        Valid options are Y or N.
  454.  
  455.           Crash Mail:  If you wish to have the FREQ sent out as soon as
  456.                        possible set this option to yes.
  457.  
  458.                        Valid options are Y or N.
  459.  
  460.                        NOTE: Most mailers use a routing file and it'll be
  461.                        most cost advantageous to use that routing scheme
  462.                        instead of changing message attributes here. Hence your
  463.                        routing file will know what to do.
  464.  
  465.        Freq Filelist:  The name of this systems filelist. This will allow you
  466.                        to FREQ an updated filelist weekly if needed. This is
  467.                        used in conjunction with Freq Days noted below.
  468.  
  469.             Security:  The security level a user must have to access this
  470.                        systems filelist.
  471.  
  472.            Freq Days:  The day of the week you wish to get an updated file
  473.                        list for this system. If the system is local every day
  474.                        would be a logical option. However if the system is
  475.                        Long Distance call once a week, bi-weekly or monthly
  476.                        may be enough to suit your systems needs. {+}
  477.  
  478.  
  479.           FREQ FILES:
  480.  
  481.     Here is where you can do maintenance on the door queue if you haven't run
  482.     PBFMAINT.EXE yet to pack the request queue. So we'll take a look at how
  483.     the system works.
  484.  
  485.                   ╔═══════════════════════════[ FREQ File Queue ]╗
  486.                   ║ FILENAME.EXT  SYSTEM NODE         STATS  DAY ║
  487.                   ║ RA_202.ARJ    1:282/1024          [NEW]  045 ║
  488.                   ║ PBBSFREQ.ZIP  1:282/1027.1        [REC]  045 ║
  489.                   ║ FE141G1.ZIP   1:282/1027          [NEW]  048 ║
  490.                   ║ SMENUS.ZIP    1:282/1024          [SEN]  045 ║
  491.                   ║ MC_CBV30.ZIP  1:360/1024          [DEL]  050 ║
  492.                   ╚══════════════════════════════════════════════╝
  493.  
  494.     The above is a sample of FREQs pending or that have been sent, or
  495.     deleted. If you need to make any changes to any of the FREQs in the queue
  496.     you just move the highlight bar to that entry. From there you can press
  497.     the ENTER key and toggle the status of that particular request. Valid
  498.     status messages are SEN(SENT), NEW, DEL (DELETED), and REC (RECEIVED).
  499.  
  500.     The DAY is actually the day of the year using the Julian calander to
  501.     calculate the day that the request was made.
  502.  
  503.  
  504.           USER LIMITS:
  505.  
  506.     If you need to make any adjustments to the user accounts that have been
  507.     using the door. In this setup portion you can make some advanced
  508.     adjustments to there profile.
  509.  
  510.  
  511.        Security  :  The security level for which you're going to allow users
  512.                     from your host program.
  513.  
  514.      A - D Flags :  The proper flags that are used from your host program
  515.                     that ensures the user has access to the systems you allow
  516.                     File Requests to.
  517.  
  518.        # Freqs   :  The number of requests that can be made by this level.
  519.                     This overrides the setting used under OPTIONS>>SYSTEM
  520.  
  521.        Chk Flags :  Check flags to make certain the user using the door has
  522.                     the proper access to the system you are allowing her/him
  523.                     to FREQ to.
  524.  
  525.        Cost      :  The cost of requesting the files for this access level.
  526.                     This overrides the cost setting under OPTIONS>>SYSTEM.
  527.  
  528.  
  529.     Below is a cross reference chart on how the flags from RA convert to
  530.     ProBoard and vise-versa.
  531.  
  532.    ┌──────────────────────────────────────────────────────────────────┐
  533.    │ ▓▓▓ Flag Cross-Reference Chart ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  534.    └──────────────────────────────────────────────────────────────────┘
  535.  
  536.    The following cross-reference chart will help you to easily determine which
  537.    flags to use for your user records and menus using the ProBoard style
  538.    (A-Z and 1-6) of flags.
  539.  
  540.    Note:  The flag structures in ProBoard are actually no different than those
  541.    in QuickBBS or RA, they are just expressed in a more "user friendly" format.
  542.  
  543.                ╔═══╦═══╤═══╤═══╤═══╤═══╤═══╤═══╤═══╕
  544.                ║   ║ 1 │ 2 │ 3 │ 4 │ 5 │ 6 │ 7 │ 8 │
  545.                ╠═══╬═══╧═══╧═══╧═══╧═══╧═══╧═══╧═══╛
  546.                ║ A ║ A   B   C   D   E   F   G   H
  547.                ╟───╢
  548.                ║ B ║ I   J   K   L   M   N   O   P
  549.                ╟───╢
  550.                ║ C ║ Q   R   S   T   U   V   W   X
  551.                ╟───╢
  552.                ║ D ║ Y   Z   1   2   3   4   5   6
  553.                ╙───╜
  554.  
  555.          A few flag examples follow:
  556.  
  557.                QuickBBS/RA                ProBoard
  558.                ───────────                ────────
  559.                    A1                        A
  560.                    C3                        S
  561.                    D7                        5
  562.                    C8                        X
  563.  
  564.  
  565.           USER EDITOR:  {+}
  566.  
  567.    If you need to make some adjustments to a users account, you can make some
  568.    minor changes here.
  569.  
  570.            Name  :  The name of the user.
  571.  
  572.          Freqed  :  How many files the user has requested.
  573.  
  574.           On Day :  What day of the year the last request was made. The
  575.                     format used here is using the Julian calander so the day
  576.                     can be converted using the following formula.
  577.  
  578.                      day 97 would be April 7th 1995
  579.                      day 200 would be July 19th 1995
  580.                      day 359 would be December 25th 1995
  581.  
  582.  
  583.           Credit :  Number of credits required for 100kb of file requests.
  584.  
  585.  
  586.   PBBSFREQ: Installing the File Request Door.
  587.  
  588.    You need to set the environment variable so the door will know where it
  589.    will be able to find its data files. This is accomplished by doing the
  590.    following to your autoexec.bat file that was shown at the begining of this
  591.    document. We will accommodate those that skipped it earlier.
  592.  
  593.        SET PBBSF=<drive>:\<path>
  594.  
  595.    If you wish to invoke the door via a type 7 batch file you should use the
  596.    following as a general guideline.
  597.  
  598.     For RemoteAccess:
  599.  
  600.     Display  : ;
  601.     Action   : Execute sub-program (Type 7)
  602.     OptData  : *c /c c:\bbs\freq.bat *N *M *UFreq_Door
  603.     HotKey   : F
  604.     AutoExec : No
  605.  
  606.     For ProBoard:
  607.  
  608.                      1         2         3         4         5
  609.             1234567890123456789012345678901234567890123456789012345
  610.             ;
  611.  
  612.     Color    :     Your option
  613.     HotKey   : F   Or your choice
  614.     Function : 7 - Shell
  615.     Data     : *Z c:\bbs\freq.bat *# *Q *X
  616.  
  617.  
  618.    The batch file should look similar to this for both of the above systems.
  619.  
  620.    D:
  621.    SET PBBSF=<DRIVE>:\<PATH>     ; If not set in your autoexec.bat
  622.    CD\BBS\FREQ                   ; Change to your proper directory.
  623.    PBBSFREQ /SD:\BBS\LINE%1      ; Call the door with appropriate command line.
  624.    CD\BBS\LINE%1                 ; Change back to the proper directory.
  625.  
  626.  
  627.    NOTE:  Do NOT put EXIT in your batch file if your using DESQView. You may
  628.    close the window down and your system will end up sitting at the DOS
  629.    prompt.
  630.  
  631.    If you wish to run from a command line type 7 you should use the
  632.    following as a general rule. Make sure you have the environment variable
  633.    set else the door will not know where it's files are.
  634.  
  635.     For RemoteAccess:
  636.  
  637.     Display  : ;
  638.     Action   : Execute sub-program (Type 7)
  639.     OptData  : c:\bbs\freq\pbbsfreq.exe /NOOFF /sc:\bbs\node*N *M *UFreq_Door
  640.     HotKey   : F
  641.     AutoExec : No
  642.  
  643.     For ProBoard:
  644.  
  645.                     1         2         3         4         5
  646.           01234567890123456789012345678901234567890123456789012345
  647.           ;
  648.  
  649.     Color    :     Your option
  650.     HotKey   : F   Or your choice
  651.     Function : 7 - Shell
  652.     Data     : c:\bbs\freq\pbbsfreq.exe /NOOFF /sc:\bbs\node*# *Q *X
  653.  
  654.  
  655.    These are all of the command line options that can be used when loading up
  656.    PBBSFreq for runtime execution.
  657.  
  658.     /NOOFF       -  No Logoff
  659.     /NOPAGE      -  No Paging
  660.     /NODATE      -  Do not display the compilation date of the database.
  661.     /C[#]        -  Co-SysOp access
  662.     /U[#]        -  Number of Credits User have in hand when entering the
  663.                     door.
  664.     /LOCAL       -  Local Mode
  665.     /S[PathName] -  Points to the directory where the door drop file is
  666.                     created (i.e. /SC:\BBS\LINE1)
  667.     /D[PathName] - Where PBBSFreq.EXE and its files are located. Overrides
  668.                    the PBBSF environment parameter if set.(i.e. /DC:\BBS\FREQ)
  669.  
  670.   Note: The /U parameter is used for BBS software that can pass the daily
  671.         download credit via control codes. Hence using %2 in your command
  672.         line configuration you should be able to pass the credits to the
  673.         door. However the System Operator must make any adjustments to the
  674.         users account by hand.
  675.  
  676.  
  677.   PBFMAINT:  Maintenance of the door and configuring your database.
  678.  
  679.  
  680.    Here we need to make our databases of the systems we will allow File
  681.    Requesting (FREQs) to. It should be noted here that when using the
  682.    door that you try to let each System Operator (SysOp) know that
  683.    you'll be allowing file requests by your users to his or her system.
  684.    It's not mandatory but a courtesy.
  685.  
  686.  
  687.     PBFMAINT CONVERT LISTNAME.EXT OUTNAME [switches]
  688.  
  689.  
  690.         CONVERT:    This will convert your file listing in ASCII format to
  691.                     the database format used within the door. All file
  692.                     listings MUST be in this format. It is a quick scan
  693.                     format and takes less time for the door to verify if the
  694.                     file is available. Here are the following command line
  695.                     parameters for it.
  696.  
  697.  
  698.            LISTNAME.EXT   - FULL Name of the input TEXT all file listing
  699.            OUTFNAME       - Name of the output file without extension
  700.            /APPEND        - Append current covert list to existing one
  701.            /SHOW          - Show file description of the converted filelist
  702.            /NOHIGH        - Omit High ASCII characters
  703.            /C[#]          - Column # of Description, 0 for 2nd line
  704.            /L[#]          - Line # to start importing file list
  705.            /K[#]          - Exclude file with size over #kb
  706.            /B[#]          - Read file list until line #
  707.            /F[#]          - Start reading file name on column #
  708.            /12            - Read full 12 characters of Filename.Ext
  709.            /D[+]          - Treat the line starting with the character +
  710.                             as part of the description.
  711.  
  712.  
  713.     The following 4 types are example formats can be used to read your file
  714.     listing.
  715.  
  716.                     PBFMAINT CONVERT PANDA.LST PANDA
  717.  
  718.    The above format should work with most systems. As it's pretty much a
  719.    default for RA and files.bbs type systems.
  720.  
  721.                     PBFMAINT CONVERT PANDA.LST PANDA /C31
  722.  
  723.    The format above tells PBFMAINT that the description starts on column
  724.    31 of the  file listing. You can tell PBFMAINT what column your
  725.    listing starts on for any file list that you have.
  726.  
  727.                     PBFMAINT COVERT PANDA.LST PANDA /L13
  728.  
  729.    This format is of concern to filelist that have a header in them. It
  730.    tells the program how many lines to look down before finding the
  731.    first file. It starts importing from that line number in the list.
  732.  
  733.                     PBFMAINT CONVERT PANDA.LST PANDA /C0
  734.  
  735.    The last format used here says that our description starts on the 2nd
  736.    line of our file list. This is due to the way PBFMAINT parses out any
  737.    erroneous characters that may be used in your list format.
  738.  
  739.    Also, the /SHOW switch which will show you the descriptions as
  740.    they are being imported into the database. It should be noted that
  741.    only the first 4 lines of a description will be imported into the
  742.    database. All high ASCII characters will be removed from the
  743.    descriptions.
  744.  
  745.    You can also append one file list to another using the /APPEND
  746.    switch. This will merge 2 file lists into one. Do NOT mix file lists
  747.    of 2 different systems as your file requests will more then likely
  748.    fail.
  749.  
  750.         Freq:
  751.  
  752.     PBFMAINT FREQ
  753.  
  754.  
  755.    Running PBFMAINT FREQ will FORCE send filelist requests to the systems
  756.    you have defined. This will ensure that you have an updated list
  757.    weekly if you allow FREQs to a vary active system. It will create a
  758.    file request to that system for you. If you wish to send out a file
  759.    request on a defined day of week and you're registered user, you may
  760.    want to define it the setup, and run PBFMAINT PACK instead.
  761.  
  762.  
  763.         Pack:
  764.  
  765.     PBFMAINT PACK
  766.  
  767.    This option is usually used when you do your nightly maintenance on
  768.    your system.  It will delete all old file request that meets the
  769.    criteria of DAYS OLD. It will also remove file request that have been
  770.    sent and received. When registered, it will also create Filelist
  771.    Requests to the systems you have defined on the day of the week or month
  772.    you have defined. Also, it'll post any messages to your users whose
  773.    request have not been honored letting them know that the request has
  774.    failed, letting them know that they may try again.
  775.  
  776.  
  777.   PBFIMPRT:
  778.  
  779.    This is the utility used by PBFSCAN and PBFMAINT to write the
  780.    messages into the appropriate message base type. ie.. JAM, Hudson, EZYCom,
  781.    Squish, and Fido (*.MSG).
  782.  
  783.  
  784.   PBFSCAN:
  785.  
  786.    Scans your inbound directories for any received FREQs moving these file(s)
  787.    to the defined directory that you will allow the user to download this
  788.    file from. Place this command somewhere in the batch either before or
  789.    after you process your incoming mail.
  790.  
  791.    It creates FILES.BBS if it doesn't exist so, then it updates the
  792.    RemoteAccess FDB if using RA. In order to use the correct description for
  793.    the file PBFSCAN will spawn POLYXARC and extract file_id.diz or desc.sdi
  794.    and use the contents from one of these files for the file description.
  795.    POLYXARC can be found on most reputable BBS systems.
  796.  
  797.    Notifies the user if her/his file request (FREQs) have been received
  798.    by sending them a message.
  799.  
  800.    In RA an online message will be sent to the user notifying them that
  801.    they have mail waiting, and that the file has been received. {+}
  802.  
  803.    ┌──────────────────────────────────────────────────────────────────┐
  804.    │ ▓▓▓ Support Files ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  805.    └──────────────────────────────────────────────────────────────────┘
  806.  
  807.      PBBSFREQ.???:  The main title screen that is displayed when entering
  808.                     the door.
  809.  
  810.      PBFMENU.??? :  With these you can create customizable screens that you
  811.                     can taylor to your system. Valid screens are .ASC, ANS,
  812.                     AVT.  {+}
  813.  
  814.      BADFILE.PBF :  If you wish to disallow certain files from being imported
  815.      into your database just place them inside this file. It is read when you
  816.      start PBFMAINT.EXE COVERT.  You can use wildcards to cover a wider area
  817.      also. Here is a sample
  818.  
  819.   ------- SNIP ------
  820.     *.GIF
  821.     *.JPG
  822.     *.A??
  823.     money.txt
  824.   ------- SNIP ------
  825.  
  826.      PBFHELP.??? :  Information on how to use the door to it's fullest. Valid
  827.                     screens are ASC, ANS, AVT.
  828.  
  829.  
  830.  
  831.    ┌──────────────────────────────────────────────────────────────────┐
  832.    │ ▓▓▓ Credits ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  833.    └──────────────────────────────────────────────────────────────────┘
  834.  
  835.  RemoteAccess                   Wantree Development & Andrew Milner
  836.  ProBoard                       Philippe Leybaert
  837.  InterMail Copyright 1988-199   Scandinavian PC Systems AB
  838.                                 & InterZone Software, Inc.
  839.  Borland International          Borland International, Inc.
  840.  OpenDoors v5.00                Brian Pirie
  841.  Borland C++, Turbo C++         Borland International, Inc.
  842.  DESQview, QEMM                 Quarterdeck Office Systems
  843.  FidoNet                        Tom Jennings
  844.  IBM PC/XT/AT                   International Business Machines, Inc.
  845.  MS-DOS , Microsoft C           Microsoft, Inc.
  846.  Squish                         Scott J. Dudley
  847.  Turbo Assembler/Debugger       Borland International, Inc.
  848.  FrontDoor                      Joaquim H. Homrighausen
  849.  
  850.    "JAM(mbp)"  Copyright 1993   Joaquim Homrighausen, Andrew Milner,
  851.                                 Mats Birch, Mats Wallin. "ALL RIGHTS RESERVED."
  852.  
  853.    Flag conversion documentation used with permission from the ProBoard
  854.    documentation.
  855.  
  856.  
  857.    ┌──────────────────────────────────────────────────────────────────┐
  858.    │ ▓▓▓ The Beta Testers ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  859.    └──────────────────────────────────────────────────────────────────┘
  860.  
  861.    The following people deserve the credit for running this program to the
  862.    ground on making sure all the bugs are out of it, and asking for additions
  863.    when I thought there was nothing else that could be crammed into the code.
  864.    In no particular order they are:
  865.  
  866.  
  867.    Mike Brusletten, Mike McCabe, Mike Chamberlain, Kim Kha, Greg Schlagel
  868.    Chris Reicks, Wade Martin, Paul Butler, Ric Schwandt, Tom Stoltz
  869.    Mike McGrane, Rico Randle, Dave Ammerman
  870.  
  871.