home *** CD-ROM | disk | FTP | other *** search
/ CD Shareware Magazine 1996 December / CD_shareware_12-96.iso / DOS / Comunic / RATOM300.ZIP / RATOMIC.DOC < prev    next >
Encoding:
Text File  |  1996-08-29  |  14.1 KB  |  325 lines
  1.                                       1
  2.        ───────────────────────────────────────────────────────────────
  3.  
  4.        1 Intro
  5.  
  6.        ╒═══════╕ ╒═══════╕ ╒════════╕ ╒═══════╕ ╒════════════╕ ╒══╕ ╒═══════╕
  7.        │░░░░░░░│ │░░░░░░░│ │░░░░░░░░│ │░░░░░░░│ │░░░░░░░░░░░░│ │░░│ │░░░░░░░│
  8.        ╘════╕░░│ │░░╒════╛ ╘════════╛ │░░╒════╛ │░░╒═════════╛ ╘══╛ ╘═══════╛
  9.        ╒════╛▒╒╛ │▒▒│ ╒══╕    ╒══╕    │▒▒│ ╒══╕ │▒▒│ ╒══╕ ╒══╕ ╒══╕ ╒══╕
  10.        │▒▒▒▒▒▒╘╕ │▒▒╘═╛▒▒│    │░░│    │▒▒│ │▒▒│ │▒▒│ │░░│ │░░│ │░░│ │░░│
  11.        │▓▓╒═╕▓▓│ │▓▓▓▓▓▓▓│    │▒▒│    │▓▓│ │▓▓│ │▓▓│ │▒▒│ │▒▒│ │▒▒│ │▒▒│
  12.        │▓▓│ │▓▓│ │▓▓╒═╕▓▓│    │▓▓│    │▓▓╘═╛▓▓│ │▓▓│ │▓▓│ │▓▓│ │▓▓│ │▓▓╘════╕
  13.        │██│ │██│ │██│ │██│    │▓▓│    │███████│ │██│ │▓▓│ │▓▓│ │▓▓│ │▓▓▓▓▓▓▓│
  14.        │██│ │██│ │██│ │██│    │██│    │███████│ │██│ │██│ │██│ │██│ │███████│
  15.        ╘══╛ ╘══╛ ╘══╛ ╘══╛    ╘══╛    ╘═══════╛ ╘══╛ ╘══╛ ╘══╛ ╘══╛ ╘═══════╛
  16.        
  17.                    FileNuker / -Crediter for RemoteAccess 2.0/2.5
  18.              Copyright(C) 1993-96 by Grischa Brockhaus, SkullSoft Group
  19.        
  20.        
  21.        1.1 What is this all about?
  22.        
  23.        RATOMiC is a tool for RemoteAccess 2.+, giving you the  ability
  24.        to nuke uploads or to give an extra-credit for spezial files.
  25.  
  26.         =NUKE=
  27.        If you locate a file in your  filebase,  wich  is  too  old  or
  28.        uploaded in the wrong filearea again, you can  "nuke"  it  now.
  29.        This means, it will be deleted,  truncated  or  moved  and  the
  30.        upload-credit will be substracted from the  user's  ratio.  You
  31.        can decrease the ratio with a faktor up to 5. For  VERY  sinewy
  32.        users you can set the WHOLE ratio to zero. This might be a kind
  33.        of instructive in some situations.. ;) The Cosysop  can  choose
  34.        between 5 default reasons for nuking or may enter a new  reason
  35.        for the nuked file.
  36.        
  37.         =CREDIT=
  38.        This is exact the opposite of the  nuking-process.  If  a  user
  39.        uploaded a file, that you or your users were looking for for  a
  40.        long time, you can honor the uploader  with  an  extra  credit.
  41.        This can be done up to factor 5 again.
  42.        
  43.        Group- and  Filearea-Securities  and  Flags  will  be  watched.
  44.        Areas, the user can't see under RemoteAccess, he also won't see
  45.        in RATOMiC. Further minimal-levels are  definable  for  special
  46.        actions.
  47.        
  48.        RATOMiC will send local messages to your hudson-  or  JAM-style
  49.        messagebase, describing the uploader, what  has  happen  to  hi
  50.        uploads,  if  you  want.  Also  it  is  able  to  change    the
  51.        file-description for you with the  Credit/Nuke-factor  and  the
  52.        name of the user, who nuked/credited.
  53.        
  54.        RATOMiC can be used as a replacement of the  internal  wildcard
  55.        file-search. Just configure the nuke  and  credit  seclevel  as
  56.        high as needed. The user can seach for wildcards and  tag  them
  57.                                       2
  58.        ───────────────────────────────────────────────────────────────
  59.  
  60.        inside of RATOMiC
  61.        
  62.        RATOMiC can be used as a local sysop-tool, but it  is  designed
  63.        for using it online, for CoSysop's  maintenances  for  example.
  64.        Your Co' and some privileged users are able  now  to  nuke  and
  65.        credit.  RATOMiC  comes  with   a    fancy    easy    to    use
  66.        cursor-movement-online-interface....
  67.        
  68.        Added to all this, RATOMiC might be a handy tool for your  file
  69.        cosysop: You may edit descriptions of files or their  password,
  70.        move them to other  areas  or  delete  them  and  so  on.  Many
  71.        possibilities are included and they are very handy to use !
  72.        
  73.        1.2 ShareWare
  74.        
  75.        This program is developed under the shareware-concept.
  76.        
  77.        This means, the author of this  program  (me  :)  gives  you  a
  78.        test-version for a trial period of 30 days. You  can  test  the
  79.        program, if it fits your needings, runs  in  your  environment,
  80.        and so on. After the trial-time you have to buy it if you  want
  81.        to use it in the future or have to delete it.  Every  using  of
  82.        this test-version beyond the trial-phase is handled as piracy.
  83.        
  84.        Please remember: Authors of ShareWare-programs are so  fair  to
  85.        give you the chance to test the program. Please be  fair,  too:
  86.        Buy the program, if you use it.
  87.        
  88.        ShareWare is not the same  as  freeware.  It  is  a  commercial
  89.        software tried to be sold in a fair manner.
  90.        
  91.        Oh, by the way: If you pay for the  program,  ShareWare-screens
  92.        are disabled and extra-features are enabled, of course.
  93.        
  94.                                       3
  95.        ───────────────────────────────────────────────────────────────
  96.  
  97.        1.3 Registration
  98.        
  99.        If you want to register  RATOMiC,  please  fill  out  the  file
  100.        REGISTER.FRM *COMPLETELY* and send it together with  the  money
  101.        to me or one of my support sites.
  102.        
  103.        You can reach me via fidonet, too: 2:2410/1001.1
  104.        
  105.                                       4
  106.        ───────────────────────────────────────────────────────────────
  107.  
  108.        2 Installation
  109.        
  110.        2.1 Parameters
  111.        
  112.        If you specify any parameter on the  command  line,  they  will
  113.        overwride  according  configurations  in  the  configfile,   if
  114.        existing.
  115.        
  116.         /P<Port>
  117.        The Com-port, RATOMiC should use. If not  given,  RATOMiC  will
  118.        read it from dropfiles.
  119.        
  120.         /L
  121.        Local  mode,  RATOMiC  will  not  read  the  EXITINFO.BBS.  The
  122.        Seclevel will be maximal, the name will be the sysopname  found
  123.        in CONFIG.RA.
  124.        
  125.         /N
  126.        You may define  the  actual  nodenumber  with  this  parameter.
  127.        RATOMiC itself dosn't use it, it will be used to replace the *N
  128.        macro in the configurations.
  129.        
  130.         /F=<File with directory>
  131.        RATOMiC will only show this  file.  You  may  combine  it  with
  132.        /A=<AreaNr> if you like. RATOMiC will find the file much faster
  133.        but it is not neccessary. Withot /A= RATOMiC  will  search  the
  134.        Base for directory  matching  Areas.  /F=  is  nice  for  using
  135.        RATOMiC as external arcviewer inside  of  RA  or  a  filelister
  136.        door.
  137.        
  138.        Example: Put your normal viewer  definition  into  RATOMiC.CFG.
  139.        Then define
  140.         RATOMIC.EXE /F=@ /H=4 /N*N /*P
  141.        as your external viewer for RA. When you view the  file  inside
  142.        of RA you will be able to use the other RATOMiC features, too !
  143.        
  144.         /A
  145.        RATOMiC will only browse through the actual filearea. This will
  146.        make the working with this tool more hany for your CoSysop.
  147.        
  148.         /A=<AreaNr>
  149.        RATOMiC will only browse through the filearea,  specified  with
  150.        AreaNr
  151.        
  152.         /G
  153.        RATOMiC will only search in the actual group. Again, this makes
  154.        the working more handy. You can enter wider  wildcards  at  the
  155.        wildcard-prompt.
  156.        
  157.         /G=<GroupNr>
  158.        RATOMiC will only search in the Group, specified with GroupNr
  159.        
  160.         /TAG
  161.                                       5
  162.        ───────────────────────────────────────────────────────────────
  163.  
  164.        RATOMIC will work on tagged files only without  asking  before.
  165.        This is nice for CoSysops, tagging files before.
  166.        
  167.         /H=<HotKeyNr>
  168.        RATOMiC will use Hotkey Nr.<HotKeyNr> first. If  you  give  the
  169.        parameter /H=4, RATOMiC will highligth the VIEW button  instead
  170.        of the default NEXT button. See /F= for examples on it.
  171.        
  172.         WATCH OUT!
  173.        Don't specify the  parameters  /A  and  /G  together  with  the
  174.        /L-parameter. In local there is no actual filearea or group.
  175.        
  176.        2.2 Configuration file
  177.        
  178.        RATOMiC is easy configurable via a textfile. This file is named
  179.        RATOMiC.CFG and has to be found in the  same  directory,  where
  180.        RATOMiC itself is located.
  181.        
  182.        You'll find  some  sample-configurations  in  the  distrubition
  183.        archiv. Please read  the  details  of  configuration  in  these
  184.        sample-configs. They are well documentated.
  185.  
  186.        2.3 Installation in your BBS
  187.        
  188.        You may install RATOMiC via a type 7 (EXEC) menu or as external
  189.        arcviewer.
  190.        
  191.        2.3.1 Install as mene type 7
  192.        
  193.        Here comes the Menu 7 Installation:
  194.        
  195.        Paramter : RATOMIC.EXE /P*P /N*N [/F /G] *X
  196.        
  197.        Specifying the parameters /F or /G will reduce  the  number  of
  198.        area-numbers bowsed by RATOMiC. This  will  make  working  more
  199.        handy for your CoSys and you. Youre wildcards can be choosed in
  200.        a wider range then. If you specify the /F  switch,  a  wildcard
  201.        *.* would browse through the actual filearea as another kind of
  202.        filelister... :-)
  203.        
  204.        RATOMiC will watch the security and flags of the user and  will
  205.        show only areas with matching goup-/security-configurations. If
  206.        you  want,  you  can    disable    this    feature    in    the
  207.        configuration-file.
  208.        
  209.        Privat files will be shown  only  to  users  with  a  definable
  210.        minimal-level.
  211.        
  212.        The *X option will tell RemoteAccess of Version 2.02 or higher,
  213.        that it should create an external tagfile and reread  it  after
  214.        the exit of RATOMiC. Now users can tag files inside RATOMiC!
  215.        
  216.        In the local mode, all  areas  and  files  will  be  shown,  of
  217.                                       6
  218.        ───────────────────────────────────────────────────────────────
  219.  
  220.        course.
  221.        
  222.        
  223.        2.3.2 Install as ext. arcviewer
  224.        
  225.        The other (better) choice is, to install  RATOMiC  as  external
  226.        arcviewer. If you want to  do  this,  please  first  write  the
  227.        former arcviewer into RATOMiC.CFG. After that  install  RATOMiC
  228.        as arcviewer:
  229.        
  230.        RATOMiC.EXE /F=@ /H=4 /P*P /N*N *X
  231.        
  232.        If you view a file now, RATOMiC will be calles. The VIEW button
  233.        will be highlighted. Normal users only have to press ENTER  now
  234.        to view the file, you and your cosysop  have  all  the  RATOMiC
  235.        features for the actual file available now !
  236.        
  237.        2.4 Turbo Nuking
  238.        
  239.        RATOMiC has a Turbo Nuking mode.  The  cosysop  may  tag  files
  240.        before he enters RATOMiC. If RATOMiC found some  tagged  files,
  241.        it will ask, if it should  process  only  this  files.  If  the
  242.        parameter /TAG was given, RATOMiC won't ask.
  243.        
  244.        If you are in Turbo Nuking mode, parameters like /F and /G will
  245.        be disabled, because we are searching over the whole filebase.
  246.        
  247.        2.5 Messages
  248.        
  249.        RATOMiC is able to send messages to the the user  concerned  by
  250.        the action. You can inform this user about his  credit-changing
  251.        and so on.
  252.        
  253.        Please edit the following files, or use the files found in  the
  254.        distribution-archive.
  255.        
  256.         NUKE.MSG
  257.         CREDIT.MSG
  258.        
  259.        In these message-files you can use some  makros  that  will  be
  260.        replaced by RATOMiC with actual values:
  261.        
  262.         $F   The name of the handled file
  263.         $U   The uploader of the file
  264.         $UA  Handle of uploader
  265.         $S   The "sysop", who acted
  266.         $SA  Handle of sysop
  267.         $N   Factor of credit-changing
  268.         $NR  The nuke reason
  269.        
  270.        These macros ARE CASESENSITIVE... Perhaps I will  use  more  in
  271.        the future.
  272.        
  273.                                       7
  274.        ───────────────────────────────────────────────────────────────
  275.  
  276.        More configurations about the  message-writing  are  found  and
  277.        documentated in the configuration-file.
  278.        
  279.        2.6 File comments
  280.        
  281.        RATOMiC will change the comments of nuked / credited files,  if
  282.        you want it to. This is configurable in RATOMiC.CFG.
  283.        
  284.        How RATOMiC changes the comments for the files is definable  in
  285.        a macro file. RATOMiC will use the macro file  NUKECOMM.MAK  if
  286.        in nuking mode and CREDCOMM.MAK if in crediting  mode.  I  have
  287.        added example files to the distribution archive.
  288.        
  289.        Inside this macro files some macros will be replaced:
  290.        
  291.         @NAME     by the name of the user actually nuking/crediting
  292.         @ALIAS    ba the handle of the user actually nuking/crediting
  293.         @UPLOADER by the user who uploaded the file
  294.         @UPALIAS  by the handle of the uploader
  295.         @COUNT    the nuking/crediting multiplier
  296.         @REASON   the reason for nuking. Will be undefined in credit
  297.                   mode, so *DON'T* use it in CREDCOMM.MAK
  298.        
  299.        3 Finally
  300.        
  301.        Well. That's all folks. :-) I hope, the documentation was clear
  302.        enough (englisch is not my native language!). All  ther  is  to
  303.        sys now: Have fun with RATOMiC !
  304.        
  305.        Grischa Brockhaus, July '96
  306.        
  307.                              Tabel of contents
  308.        ───────────────────────────────────────────────────────────────
  309.  
  310.        1  Intro .................................................    1
  311.          1.1  What is this all about? ...........................    1
  312.          1.2  ShareWare .........................................    2
  313.          1.3  Registration ......................................    3
  314.        2  Installation ..........................................    4
  315.          2.1  Parameters ........................................    4
  316.          2.2  Configuration file ................................    5
  317.          2.3  Installation in your BBS ..........................    5
  318.            2.3.1  Install as mene type 7 ........................    5
  319.            2.3.2  Install as ext. arcviewer .....................    6
  320.          2.4  Turbo Nuking ......................................    6
  321.          2.5  Messages ..........................................    6
  322.          2.6  File comments .....................................    7
  323.        3  Finally ...............................................    7
  324.  
  325.