home *** CD-ROM | disk | FTP | other *** search
/ Carsten's PPE Collection / Carstens_PPE_Collection_2007.zip / F / FN_SCBC.ZIP / SCANNER.DOC < prev    next >
Text File  |  1995-09-02  |  18KB  |  401 lines
  1.  
  2.  
  3.         ╓─────────────────────────────────────────────────────────────╖
  4.         ║       ▄▄──▄▄ ▄▄──▄▄ ────▄▄ ▄▄──▄  ▄▄──▄  ▄▄──▄▄ ───▄▄       ║
  5.         ║       ██     ██  ▀▀ ██──██ ██  ██ ██  ██ ▀█─ ▀▀ ██─▀█▄      ║
  6.         ║       ▀▀──▄▄ ██     ██  ██ ██  ██ ██  ██ ██  ▄▄ ██  ██      ║
  7.         ║       ▄▄  ██ ██  ▄▄ ██  ██ ██  ██ ██  ██ ██   █ ██  ██      ║
  8.         ║       ▀▀▀▀▀▀ ▀▀▀▀▀▀ ▀▀  ▀▀ ▀▀  ▀▀ ▀▀  ▀▀ ▀▀▀▀▀▀ ▀▀  ▀▀      ║
  9.         ║        Frontnet Scanner v1.0 (c) 1995 Dront/Frontnet        ║
  10.         ║                     All Rights Reserved                     ║
  11.         ║                                                             ║
  12.         ╙─────────────────────────────────────────────────────────────╜
  13.  
  14.  
  15.      ┌──────────────────────────────┐
  16.      │ ▓▓ 01: INTRODUCTION ▓▓▓▓▓▓▓▓ │
  17.      └──────────────────────────────┘
  18.  
  19.         Statistics has  always interested people, comparing things to each
  20.      other and  finding out more about the system's  activity.  It is like
  21.      looking at a game of soccer, when they show the screen with number of
  22.      corner  kicks, number of saves  by goal  keeper etc. This information
  23.      is not  important, but it is  interesting and  tells us a little more
  24.      about the game  itself.  If a team  wins by 1 - 0,  the  winning team
  25.      does not  always have to be  the best team.  The number of off-sides,
  26.      red/yellow cards and  possession of ball even shows us more.
  27.  
  28.         Welcome to  Scanner, the  complete statistics  package for PCBoard
  29.      bulletin board system. The Scanner offers you pascal structured user-
  30.      friendly files  filled with statistics  from  PCBoards  output files,
  31.      such as the caller logs, download.txt file, PCBoard.dat and the user-
  32.      datas. You can use these structured files as you  wish in any of your
  33.      own applications providing your programs with lot's of new statistics
  34.  
  35.      ┌───────────────────────────────────┐
  36.      │ ▓▓ 02: SOME FEATURES ▓▓▓▓▓▓▓▓▓▓▓▓ │
  37.      └───────────────────────────────────┘
  38.  
  39.      ■ Scanner creates/updates 11 datafiles with information from the log-
  40.        files. More detailed information can be found in [STRUCT.100].
  41.  
  42.        Here is a brief list of files created by the Scanner:
  43.  
  44.        Userdata.all ............................... Enhanced userdatafile.
  45.        Lastcall.all ..................... Last users and their activities.
  46.        Lastcall.{node} ......................... Node specific lastcaller.
  47.        Total.all ................................... Summary of all datas.
  48.        Total.{node} ...................... Node specific total statistics.
  49.        Record.all ............... System records, names and date when set.
  50.        Record.{node} ....................... Node specific system records.
  51.        {date}.all ..................................... Todays statistics.
  52.        {date}.{node} .................... Node specific todays statistics.
  53.        Week.dat .......................................... Week Summaries.
  54.        Transfer.dat ................................ Latest filetransfers.
  55.  
  56.        If you have made an utility for PCExpress, Evolution, System X,
  57.        SuperBBS or Remote Access you will find these files as easy to
  58.        work with as those before. You can actually use your old code
  59.        and just change the structure file to use it with the Scanner.
  60.        (with a few name modifications).
  61.  
  62.      ■ The Scanner  eliminates the  2.100.000.000 bytes limit  in PCBoard.
  63.        Now your users can upload/download more than 2,1 giga bytes without
  64.        having their upload/download showing a negative value. All programs
  65.        using Scanners database have direct access to the 2,1 gig limit fix
  66.  
  67.      ■ Utility Package has been included to show you some examples of how
  68.        the Scanner datafiles can be used. This package include the files
  69.        I used while beta testing the Scanner. However the screens have
  70.        been drawn to fit in to any system and the downup has been drawn
  71.        by d-vibe - check it out!
  72.  
  73.      ■ Tested it successfully with Windows'95, DESQView, OS/2 Warp and
  74.        DOS. It uses EMS memory and handles up to 99 nodes. Scanner is
  75.        based on .EXE files to keep the speed up, but PPE's are used in
  76.        some of the utilities in the package to display screens.
  77.  
  78.      ┌───────────────────────────────────┐
  79.      │ ▓▓ 03: UTILITIES ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  80.      └───────────────────────────────────┘
  81.  
  82.      These are the utils I've used while developing the Scanner:
  83.  
  84.        Short.    Vers.    Description.            Code.      Ansi.
  85.      ■ Lastcall  Current  Lastcaller Utility .... Dront .... Dront/Frontnet
  86.      ■ Frn_Up .. Current  Top Uploader .......... Dront .... Dront/Frontnet
  87.      ■ Frn_Dn .. Current  Top Downloads ......... Dront .... Dront/Frontnet
  88.      ■ Pswfail . Current  Last Password Hacks ... Dront .... Dront/Frontnet
  89.      ■ DownUp .. Current  Top Upl/Your Position . Dront .... D-Vibe/Rbs
  90.      ■ View .... Current  Scanner Dataviewer .... Dront .... Ascii
  91.      ■ Weektop . Current  Week Top Transfers .... Dront .... Dront/Frontnet
  92.      ■ WTotal .. Current  Week Summaries ........ Dront .... Dront/Frontnet
  93.  
  94.      Remember! When creating utils for the Scanner please respect the
  95.                sharing.tmp lock check. If the file fails to access, this
  96.                means that Scanner or any other util is currently working/
  97.                writing to the datafiles. This usually doesn't take more
  98.                than a few seconds, but never read/write a file if
  99.                sharing.tmp is locked. It's not healthy for your datas!
  100.  
  101.      Here's an example locking routine:
  102.  
  103.      ─────────────────────────────────────────────────────────────────────
  104.      Program Sharing;
  105.  
  106.      Uses Crt;
  107.  
  108.      Var Lockfile : Text;
  109.          Counter  : Shortint;
  110.  
  111.      Begin
  112.         Assign(Lockfile,'SHARING.TMP');
  113.  
  114.         {$I-}
  115.         Rewrite(Lockfile);
  116.         {$I+}
  117.  
  118.         While (IOResult<>0) and (Counter<50) and (Keypressed=False) do
  119.         Begin
  120.               Inc(Counter);
  121.               {$I-}
  122.               Rewrite(Lockfile);
  123.               {$I+}
  124.               Delay(2000);
  125.         End;
  126.  
  127.         If (Not Keypressed) and (Counter<50) then begin
  128.  
  129.               {Your Program Here}
  130.  
  131.         End Else Begin
  132.               Writeln('Program Aborted or Sharing Time-Out');
  133.         End;
  134.  
  135.         {$I-}
  136.         Reset(Lockfile);
  137.         {$I+}
  138.         If IOResult=0 then Close(Lockfile);
  139.  
  140.      End.
  141.      ─────────────────────────────────────────────────────────────────────
  142.  
  143.      ┌───────────────────────────────────┐
  144.      │ ▓▓ 04: INSTALLATION ▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  145.      └───────────────────────────────────┘
  146.  
  147.      Installing Scanner is easy - only 5 steps to follow -
  148.  
  149.      ■ 01 ■  Create a subdirectory and unzip all files to it.
  150.              Example: MD C:\PCB\SCAN
  151.                       PKUNZIP FRN-SC10.ZIP C:\PCB\SCAN
  152.  
  153.      ■ 02 ■  Add all your PCBOARD.DAT files to the SCANNER.DIR file.
  154.              Example: EDIT C:\PCB\PPL\SCAN\SCANNER.DIR
  155.  
  156.              Ln  Scanner dir
  157.                  ---------------------------------------------
  158.              1:  C:\PCB\NODE1\PCBOARD.DAT
  159.              2:  C:\PCB\NODE2\PCBOARD.DAT
  160.                  ---------------------------------------------
  161.  
  162.              Line #1 is the full path and filename of Node #1's datafile.
  163.              Line #2 is the full path and filename of Node #2's datafile.
  164.              etc etc.
  165.  
  166.      ■ 03 ■  Edit SCANNER.CFG, the configuration file.
  167.              Example: EDIT C:\PCB\SCAN\SCANNER.CFG
  168.  
  169.              Ln  Scanner.cfg
  170.                  ---------------------------------------------
  171.               1:  YES
  172.               2:  YES
  173.               3:  2000
  174.               4:  2
  175.                a  MINDBENDER
  176.                a  PHREAKSMITH
  177.               5:  2
  178.                a  ROYCE
  179.                b  +2100000000
  180.                c  0
  181.                a  MADCAP
  182.                b  0
  183.                c  +2100000000
  184.               6:  USERNET.XXX) is missing!
  185.               7:  No Security Level Match
  186.               8:  Carrier Lost
  187.               9:  NO CONNECT
  188.              10:  exceed your byte
  189.              11:  exceed your file
  190.              12:  Excessive Password Failures
  191.              13:  Directory Scan for
  192.              14:  Left:
  193.              15:  Node CHAT entered
  194.              16:  Node CHAT ended
  195.              17:  Sysop CHAT active
  196.              18:  Sysop CHAT ended
  197.              19:  Modem:
  198.              20:  Batch Dnld:
  199.              21:  Batch Upld:
  200.              22:  Operator Paged
  201.                   ---------------------------------------------
  202.  
  203.              Line #01 Set 'YES' to enable logfile.
  204.              Line #02 Set 'YES' to enable enhanced logfile.
  205.              Line #03 Number of users to reserve place for in EMS.
  206.              Line #04 Number of users to exclude from being scanned.
  207.  
  208.                   a Username to be excluded. (check line #4)
  209.                   b Username to be excluded. (check line #4)
  210.  
  211.              Line #05 Number of users to modify.
  212.  
  213.                   a Username to modify.
  214.                   b How to modify users upload bytes.
  215.                   c How to modify users download bytes.
  216.  
  217.              The following lines are keyword searched for in the log file.
  218.              If you have changed them in PCBText then you must change them
  219.              here as well for Scanner to find them. (The reason for not
  220.              letting Scanner search the PCBTEXT. by itself is that you might
  221.              run a PPE or something instead of the actual text.)
  222.  
  223.              Line #06  USERNET.XXX) is missing!          (record:    )
  224.              Line #07  No Security Level Match           (record: 457)
  225.              Line #08  Carrier Lost                      (record: 215)
  226.              Line #09  NO CONNECT                        (record:  34)
  227.              Line #10  exceed your byte                  (record: 670)
  228.              Line #11  exceed your file                  (record: 669)
  229.              Line #12  Excessive Password Failures       (record:   7)
  230.              Line #13  Directory Scan for                (record: 430)
  231.              Line #14  Left:                             (record: 336,337)
  232.              Line #15  Node CHAT entered                 (record: 231)
  233.              Line #16  Node CHAT ended                   (record: 230)
  234.              Line #17  Sysop CHAT active                 (record: 175)
  235.              Line #18  Sysop CHAT ended                  (record: 219)
  236.              Line #19  Modem:                            (record: 590)
  237.              Line #20  Batch Dnld:                       (record: 619)
  238.              Line #21  Batch Upld:                       (record: 618)
  239.              Line #22  Operator Paged                    (record: 409)
  240.  
  241.      ■ 04 ■  Load PCBSetup, set PCBoard to log the connect string.
  242.  
  243.              If you don't know how or where to do it then:
  244.  
  245.              a/ Start PCBSetup from one of your node directories.
  246.              b/ Choose Configuration Options (G)
  247.              c/ Choose Logging Options (E)
  248.              d/ Make sure 'LOG CONNECT STRING TO DISK' is set to Yes.
  249.  
  250.      ■ 05 ■  Add the Scanner and all utils to all $$LOGOFF.BAT's.
  251.              Example: Check the $$LOGOFF.BAT included in this package.
  252.  
  253.      Scanner installation now complete!
  254.      And now some instructions on how to install external utilities:
  255.  
  256.      ■ 01 ■ If you wish to run downup then edit the downup.cfg file
  257.  
  258.            Ln  Downup.cfg
  259.                ---------------------------------------------
  260.             1:  C:\PCB\PPL\UPLOAD.PPE
  261.             2:  C:\PCB\PPL\D.PPE
  262.             3:  Y
  263.             4:  Y
  264.                ---------------------------------------------
  265.  
  266.             Line #01 is the full path + filename of the PPE to be run
  267.                      after a user seen the downup upload PPE.  Leave
  268.                      blank if you don't want a PPE to start after downup.
  269.  
  270.             Line #02 is the full path + filename of the PPE to be run
  271.                      after a user has seen the downup download PPE. Leave
  272.                      blank if you don't want a PPE to start after downup.
  273.  
  274.             Line #03 should be 'Y' if you want a PRESS ENTER TO CONTINUE
  275.                      after the ansi has been displayed.
  276.  
  277.             Line #04 if set to 'Y' and line #01 or line #02 is NOT used
  278.                      (blank) then downup will stuff the characters 'd'
  279.                      or 'u' after the ansi has been displayed to start
  280.                      a filetransfer.
  281.  
  282.                  Ex: User dront pressed 'U' to start a tranfer,
  283.                      the downup shows the best top 10 uploaders and
  284.                      then waits for the user to press enter (if Line #03
  285.                      is set to 'Y'). Now, if Line #01 (upload) is blank,
  286.                      no PPE is set to be run after downup and the user
  287.                      will be brought back to the main prompt. But if
  288.                      line #04 is set to 'Y' then downup will continue
  289.                      to start the transfer.
  290.  
  291.      ■ 02 ■  If you wish to run downup just before up/download then put
  292.              the UPLOAD.PPE and the DOWNLOAD.PPE in the CMD.LST found in
  293.              PCBoard Setup.
  294.  
  295.              Example:
  296.  
  297.              Command     Security   PPE/MNU file -or- Keystroke replacement
  298.              -------     --------   ---------------------------------------
  299.              D                30    C:\PCB\SCAN\DOWNLOAD.PPE
  300.              U                30    C:\PCB\SCAN\UPLOAD.PPE
  301.  
  302.              <Command>  Command to use in PcBoard.
  303.              <Security> Minimum security needed.
  304.              <PPE/MNU>  Full path and name of the PPE.
  305.  
  306.      ■ 01 ■  If you wish to run weektop then put the weektop.ppe somewhere
  307.              in your logoff processing. A nice place is the logoff script
  308.              questionnaire located in PCBSetup, File locations (B), Questio-
  309.              nnaires (D) and then the logoff script questionnaire. Press F2
  310.              and add:
  311.              !{full path}\weektop.ppe
  312.  
  313.              You can also put it in PCBText, Record #192.
  314.  
  315.      ■ 02 ■  Edit the weektop.cfg file
  316.  
  317.              Ln  Weektop.cfg
  318.              ---------------------------------------------
  319.              1:  1
  320.              2:  10
  321.              3:  ALL
  322.              ---------------------------------------------
  323.  
  324.              Line #01 is the conference number where to post the weektop
  325.                       message.
  326.              Line #02 How many users to list in the output message.
  327.              Line #03 The receiver of the message posted.
  328.  
  329.      Installation complete!
  330.  
  331.      ┌───────────────────────────────────┐
  332.      │ ▓▓ 05: NEW UPDATES ▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  333.      └───────────────────────────────────┘
  334.  
  335.      These are the people who automatically will get a copy of Scanner
  336.      by E-MAIL whenever a new release is out:
  337.  
  338.      ■ Anubis / Digital Empire .............. (Switzerland) ... ( 4 Nodes)
  339.      ■ Zyir / Zero Gravity ....................... (Canada) ... ( 1 Node)
  340.      ■ Morbid Angel / Quadrillion ............... (Denmark) ... ( x Nodes)
  341.  
  342.      These are the boards to which I upload the Scanner:
  343.  
  344.      ■ Fatal Future / Mindbender ................. (Sweden) ... ( 9 Nodes)
  345.      ■ Internal Affairs / Phreaksmith ............ (Sweden) ... ( 3 Nodes)
  346.  
  347.      You can also login to our ftp Server at:
  348.      194.16.66.99 /pub/frontnet/bbsutils/pcboard/scanner
  349.  
  350.      If you're on IRC also try XDCC LIST the following users:
  351.  
  352.      frontnet      the official frontnet bot always carrying the latest
  353.                    version as soon as I put it up to it.
  354.      dront         me!
  355.  
  356.      ┌───────────────────────────────────┐
  357.      │ ▓▓ 06: GREETINGS ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │
  358.      └───────────────────────────────────┘
  359.  
  360.      Just want to say hello to a few people:
  361.  
  362.        Accolon            Accolon                     Cell block H -2-4-6-
  363.      * Bad                m0l                         The m0l! {logo} Woah!
  364.        Brain              freefire                    sunglasses man
  365.        Chip
  366.        D-vibe             d-vibe
  367.      * Frontnet                                       /ctcp frontnet warez
  368.        Gem/Voyagers       _GEM                        bananahouse
  369.        Laric
  370.        Mindbender         mindbndr                    GLExpress Orange!
  371.        Morbid Angel
  372.      * Mr.Spock           spock_ / _spock / _spock_   gimme uplift now!
  373.        Phreaksmith        phreaky                     ring, new beta!
  374.        Seawolf
  375.      * Sponk              Sponk                       coming to the sun
  376.        Staal              staal                       frontnet the mob
  377.  
  378.        and ofcourse the beta testers:
  379.  
  380.        Phreaksmith - A big thanks for testing since I started this.
  381.        Zyir - One of the best testers there is.
  382.  
  383.      ┌───────────────────────────────────┐
  384.      │ ▓▓ 07: HOW TO CONTACT ME ▓▓▓▓▓▓▓▓ │
  385.      └───────────────────────────────────┘
  386.  
  387.      If you need to contact me, or if you have any questions about the
  388.      Scanner etc, you'll find me on any of the following places:
  389.  
  390.        Email:      dront@algonet.se   (checked everyday)
  391.        Irc:        #frontnet
  392.        Bbs:        fatal future       (checked everyday)
  393.                    internal affairs   (checked everyday)
  394.  
  395.      I hope you enjoy this product and I'd really appreciate if you send
  396.      me a copy of the utils you make.
  397.  
  398.      Signed
  399.      Dront/Frontnet
  400.  
  401.