home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / FTLRA129.RAR / FATAL!RA.DOC < prev    next >
Encoding:
Text File  |  1996-06-22  |  22.5 KB  |  513 lines

  1.  
  2.  
  3.  
  4.  
  5.        █████     ███   ████████     ███   ██         ██     ███       ███
  6.       ▓██████   █████ ██████████   █████ ███        ▐▓█▌   ▓████     █████
  7.       ▓▓█  ██  ▓██ ██ ▓▓  ██  ██  ▓██ ██ ▓▓█        ▓▓▓▓   ▓▓ ███   ▓██ ██
  8.       ▒▓▓   █ ▒▓▓  ██  ▓▓ ██ ██  ▒▓▓  ██  ▓▓        ▒▒▓▓   ▒▓  ███ ▒▓▓  ██
  9.       ▒▒▓     ▒▒   ██     ██     ▒▒   ██  ▒▓        ░▒▒    ▒▒   ██ ▒▒   ██
  10.       ░▒▒▓▓   ░▒   ██     ▓█     ░▒   ██  ▒▒  ██     ░▒    ░▒▒▓▓██ ░▒   ██
  11.       ░░▒     ░░▒▄ ██     ▓▓     ░░▒▄ ██  ░▒   ██          ░░▒▒▓   ░░▒▄ ██
  12.       ░░░     ░░▀▒▓▓█    ▒▒▓     ░░▀▒▓▓█  ░░▒ ▓▓█    ░░    ░░ ▒▒▓  ░░▀▒▓▓█
  13.       ░░░     ░░   ▓▓    ░▒▒     ░░   ▓▓   ░░▒▒▓     ░░    ░░  ▒▓▓ ░░   ▓▓
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                               Fatal!RA v1.29r
  22.  
  23.  
  24.  
  25.  
  26.  
  27. >>>  CONTENTS  <<<
  28. ------------------------------------------------------------------------------
  29.   1. Introduction
  30.   3. Installation
  31.   4. User-Editor
  32.   5. Lastcallers
  33.   6. Statistics
  34.   7. Automatic level updater
  35.   8. Messages
  36.   9. Registration
  37.  10. Copyrights
  38.  
  39.  
  40. ------------------------------------------------------------------------------
  41. 1. Introduction
  42. ------------------------------------------------------------------------------
  43. FATAL!RA is an utility with several features in one program.
  44. The functions at one glance:
  45. - Lastcaller with flags
  46. - User statistics
  47. - File statistics
  48. - Editor to make the layout of each statistic
  49. - Automatic maintenance for the user levels
  50. - Sort the userbase
  51. - Usereditor with sorting and searching functions (up to now max 1023 user)
  52. - Global user editor, for example to move user flags
  53. - Messages for birthday and up- or downgrade of the security level
  54. - Usage graph
  55.  
  56. Some New few features are:
  57. - The extent of configurability
  58. - Statistics of the last 3-30 days
  59. - Level upgrade for wort in the last 3-30 days (in physics: power)
  60. - Display what the users have done in the lastcallers.
  61. - Realtime sorting user editor
  62.  
  63. The following parameters activate the different options
  64.     : Configuration menu (with user editor)
  65. -u  : Only user editor
  66. -d  : Default color settings (look lame :) )
  67. -l  : Generate lastcaller list
  68. -e  : Event: Activate functions defined in the menu Main Menu|Event
  69. -s  : Only generate statistics
  70. -nx : Node
  71.  
  72.  
  73.  
  74. ------------------------------------------------------------------------------
  75. 3.Installation
  76. ------------------------------------------------------------------------------
  77. These files have to be in the archive:
  78. -fatal!ra.exe   : The program
  79. -fatal!ra.cf1/2 : Configuration files
  80. -update.msg     : User gets a new level
  81. -d_update.msg   : User gets a new level for a limited time
  82. -downgra.msg    : User loses his level
  83. -birthday.msg   : Geburtstagsnachricht
  84. -newuser.msg    : Newuser welcome message
  85. -fatal!ra.doc   : This file
  86. -fatal!ra.dok   : German documentation
  87. -ra_mnu.zip     : Packet do generate a statistics menu for RA
  88. -door_ctl.zip   : Packet do generate a statistics menu for Fatal!Doors
  89.  
  90. Unpack the archive for example into the directory c:\ra\utils\FATALRA\.
  91. You can start fatal!ra.exe immediately. At first you should set the
  92. paths. If the RA - environmentvariable is set, simply chose autoconfig.
  93. Else you can set the paths manually in the menu directories.
  94. Now chose in the menu user sorter your sorting method for the userbase
  95. (ex: primary: level, secondary: handle).
  96. If you delete the userbase in trying everything out ( :) ) don't panic:
  97. there is a backup (users.bak, usersxi.bak, lastread.bak and 30_days.bak).
  98.  
  99. Now insert into your batch file an entry fatal!ra -L to generate the
  100. lastcaller list when the user has logged out.
  101. Insert fatal!ra -e into the event batch file. Activate for example the
  102. statistics and the user sorter in the menu Main Menu|Event and remove
  103. the RAUSER entry to get the statistics of the last 3-30 days. To make
  104. all functions concerning the last 3-30 days work properly you have to
  105. maintain the userbase _only_ with fatal!ra.
  106.  
  107.  
  108.  
  109. ------------------------------------------------------------------------------
  110. 4. The user editor
  111. ------------------------------------------------------------------------------
  112. The user editor is like the original, but you can quick sort the users
  113. in using the cursor keys. To remove an user press delete. To insert an
  114. user press insert :).
  115. To search for an user, a location or numbers just enter these. You get
  116. the required users or these who come closest.
  117. You can define the layout of the user editor:
  118.  
  119. The layout could look like this:
  120.  
  121.  Pos  │ Name                  │ Handle                │ Level │ Age │ Del
  122. ──────┼───────────────────────┼───────────────────────┼───────┼─────┼────
  123.  %P   │ %N                    │ %H                    │ %L    │ %A  │ %E
  124.  
  125. In this case you can select the column with the age and enter a "18" -
  126. imideately you see the users who are allowed to access nice pictures :)
  127.  
  128. The hotkeys are like these at the statistics:
  129. F1 - F11    : Insert a character of the character set (ex: ╚ )
  130. 0 - 9 and + : Insert a character with the number block
  131. alt-F1-F5   : Chose the character set
  132. alt-1-8     : Set a pre-defined color pattern
  133. alt-u       : Get color attribute
  134. alt-a       : Set color attribute
  135. alt-f       : Set foreground color
  136. alt-b       : Set background color
  137. ctrl-arrow  : Change color attribute
  138.  
  139.  
  140. With the global user editor you can define a group of users who have to
  141. be changed.
  142.  
  143. Example 1:
  144. Move the A1 flag to the B1 flag:
  145.  
  146.                ┼─┤Global Usereditor├────────────────────────┼
  147.                │                                            │
  148.                │  from level 0          to level 65535      │
  149.                │  A X-------                                │
  150.                │  B --------                                │
  151.                │  C --------                                │
  152.                │  D --------                                │
  153.                │                        - Deleted           │
  154.                │  new level -           - Clear Screen      │
  155.                │  A O-------            - More Prompt       │
  156.                │  B X-------            - Ansi Graphic      │
  157.                │  C --------            - Avatar Graphic    │
  158.                │  D --------            - No Kill           │
  159.                │                        - Free Leech        │
  160.                │                        - Full Screen Edit  │
  161.                │                        - Quiet Mode        │
  162.                │                        - Hot Keys          │
  163.                │                        - Full Screen View  │
  164.                │                        - Hidden            │
  165.                │  change user globally  - Page Priority     │
  166.                ┼────────────────────────────────────────────┼
  167.  
  168. Select these settings and then change user globally.
  169.  
  170. Example 2:
  171. Give all users with level 20 to 40 the new level 50,
  172. hot keys and no avatar:
  173.  
  174.                ┌─┤Global Usereditor├────────────────────────┐
  175.                │                                            │
  176.                │  from level 20         to level 40         │
  177.                │  A --------                                │
  178.                │  B --------                                │
  179.                │  C --------                                │
  180.                │  D --------                                │
  181.                │                        - Deleted           │
  182.                │  new level 50          - Clear Screen      │
  183.                │  A --------            - More Prompt       │
  184.                │  B --------            - Ansi Graphic      │
  185.                │  C --------            O Avatar Graphic    │
  186.                │  D --------            - No Kill           │
  187.                │                        - Free Leech        │
  188.                │                        - Full Screen Edit  │
  189.                │                        - Quiet Mode        │
  190.                │                        X Hot Keys          │
  191.                │                        - Full Screen View  │
  192.                │                        - Hidden            │
  193.                │  change user globally  - Page Priority     │
  194.                └────────────────────────────────────────────┘
  195.  
  196. All flags can be changed with the space bar.
  197.  
  198.  
  199.  
  200. ------------------------------------------------------------------------------
  201. 5. Lastcallers
  202. ------------------------------------------------------------------------------
  203. In the menu Main Menu|Lastcallers you can chose wether the sysop,
  204. hidden users or local calls have to be displayed in the list.
  205. You can also substitute the local bps rate (ex: Local : L0cαl ).
  206. To make the lastcallers of all lines appear, you have to execute
  207. fatal!ra in each batch file like this: fatal!ra -l -nx.
  208. For node 3 this is fatal!ra -l -n3.
  209. To see what the users have done in their online time there are flags
  210. in the lastcaller list. You can either display all nine of them or
  211. if this is too much you can disable some of them. A bit more difficult
  212. is to configure the flags "paged","chatted" and "online-games".
  213. For that you look into your log-file and see what RA or your chatter
  214. is entering if an user pages you:
  215.  
  216. > 29-Apr 16:00:07 RA01 Sysop paged (chatted with user)
  217.  
  218. You see that a program can detect the paging with the word "paged"
  219. and that you have chattet with the user with "chatted".
  220.  
  221. > 29-Apr 16:01:37 RA01 DOS shell : *C /C M:\RA\ONLINE\MOG\GORR.BAT *N *M
  222. > 29-Apr 16:04:12 RA01 DOS shell : *C /C M:\RA\ONLINE\SLOTS\SLOTS.BAT *N *M
  223.  
  224. If all your online-games are in the same directory (ex: ONLINE\ ),
  225. you can detect it with the name of the path. Take care that no
  226. filebase files are in this directory and that none of your filebase
  227. directories has that name.
  228. Make the following entries in the lastcallers menu:
  229.  
  230.   .
  231.   .
  232.   .
  233.   √ Paged          Log: PAGED
  234.   √ Chatted        Log: CHATTED
  235.   √ Online-Games   Log: ONLINE\
  236.   √ Lost Carrier
  237.  
  238. In the menu Main Menu|Lastcallers|Layout you can make your own layout
  239. of your lastcaller list (see statistics). If you define several lines
  240. with %-parameters (maximum of 4) you can get an optical distinction of
  241. groups of users. Usually all users belong to group 1. In the menu
  242. Main Menu|Lastcallers you can define at which level an user belongs
  243. to group 2,3 and 4.
  244. A "0" is added to the name for the lastcaller today, a "1" and "2" for
  245. yesterday and before yesterday, a "b" for the best day.
  246.  
  247. Example (in the batch file):
  248. ...
  249. cd \ra\node3
  250. fatal!ra -l -n3
  251. ...
  252.  
  253. The lastcaller of FATAL!RA supports multi line and does not need any
  254. changes in your existing menu system. All data is read from the RA
  255. log file. The lastcall.bbs file is not used. If there are any bugs
  256. in the lastcaller, please send me a copy of your log file. Many
  257. utilities insert unusual entries into the log file that may lead to
  258. problems. But with a log I can fix such bugs easily. In this case
  259. switch off the log-function in the menu Main Menu|Lastcaller.
  260. The first run time may be a bit long if many user have already called.
  261. Usually the run rime is about one or two seconds (on a 486), even if
  262. the log file is larger than 1 MB (our log file is now about 5 MB).
  263.  
  264. All who use chat utilities which do not tell the line number should use
  265. one log file for each line.
  266. (ex: ICE-CHAT)
  267.  
  268.  
  269. ------------------------------------------------------------------------------
  270. 6. Statistics
  271. ------------------------------------------------------------------------------
  272. Edit the layout of the statistics:
  273.  
  274. F1 - F11    : Insert a character of the character set (ex: ╚ )
  275. 0 - 9 and + : Insert a character with the number block
  276. alt-F1-F5   : Chose the character set
  277. alt-1-8     : Set a pre-defined color pattern
  278. alt-u       : Get color attribute
  279. alt-a       : Set color attribute
  280. alt-f       : Set foreground color
  281. alt-b       : Set background color
  282. ctrl-arrow  : Change color attribute
  283.  
  284. Copy and delete lines:
  285. a) Move the lightbar to the wanted line
  286. b) Do one of the following actons (without pressing <Enter> )
  287.     ctrl-Insert    : Copy highlighted line
  288.     shift-Insert   : Insert line
  289.     shift-Delete   : Cut line
  290.  
  291. You also can copy lines from one statistic to another.
  292.  
  293. Copy a whole layout:
  294. --------------------
  295. a) Select the statistic (show layout) which you want to duplicate
  296. b) press <esc> (the layout stays in memory)
  297. c) Move the lightbar to the destination statistic (do not press <enter>)
  298. d) press ctrl-<enter>
  299.  
  300. Define the name of the statistic without extension
  301.  
  302. Pre-defined color patterns:
  303. ---------------------------
  304.  
  305. With alt - 1-8 you can give a line a color pattern. Just try all out,
  306. perhaps you like some of them.
  307.  
  308. Cheats:
  309. -------
  310.  
  311. If the 12 lines are not enough, you can insert empty lines (ex: between
  312. title and list) in inserting a alt-13 (note) and a alt-10 (circle).
  313. With this method you can insert ANSI codes into the layout (alt-27 [
  314. and then the code). But such ANSI codes will appear in the Ascii.
  315. With this method you also can display the calls/uploads etc. of the user
  316. who views the statistics:
  317. just insert alt-6 (on the number block) and then
  318.  P : Calls
  319.  Q : Uploads
  320.  R : Uploads [KB]
  321.  S : Downloads
  322.  M : Messages
  323. Alt-6 is a pik charakter, see further information in the ra.doc file.
  324.  
  325.  
  326. Seperate the 1st user in the list:
  327. ----------------------------------
  328. You get a homogeneous list if you define the parameters %N for name
  329. and/or %H for handle only in one line.
  330. Example:
  331.                            >>> The best uploaders <<<
  332.  
  333.       ┌─Name───────────────────────────── Age ─────────────── Uploads ──┐
  334.       │ %P  %H                            %A                  %u        │
  335.       └─────────────────────────────────────────────────────────────────┘
  336. And what you get (for the length 5):
  337.  
  338.                            >>> The best uploaders <<<
  339.  
  340.       ┌─Name───────────────────────────── Age ─────────────── Uploads ──┐
  341.       │  1  Nappel                        15                    176     │
  342.       │  2  Dödel                         18                    132     │
  343.       │  3  Dummel                        17                    122     │
  344.       │  4  Emil                          17                    113     │
  345.       │  5  Göppel                        17                    106     │
  346.       └─────────────────────────────────────────────────────────────────┘
  347.  
  348. The first user will be seperated, if you define two lines with the
  349. parameters %N and/or %H:
  350.                            >>> The best uploaders <<<
  351.  
  352.       ┌─Name───────────────────────────── Age ─────────────── Uploads ──┐
  353.       │ %P  %H                            %A                  %u        │
  354.       ├─────────────────────────────────────────────────────────────────┤
  355.       │ %P  %H                            %A                  %u        │
  356.       └─────────────────────────────────────────────────────────────────┘
  357.  
  358. And what you will get:
  359.                            >>> The best uploaders <<<
  360.  
  361.       ┌─Name───────────────────────────── Age ─────────────── Uploads ──┐
  362.       │  1  Nappel                        15                    176     │
  363.       ├─────────────────────────────────────────────────────────────────┤
  364.       │  2  Dödel                         18                    132     │
  365.       │  3  Dummel                        17                    122     │
  366.       │  4  Emil                          17                    113     │
  367.       │  5  Göppel                        17                    106     │
  368.       └─────────────────────────────────────────────────────────────────┘
  369.  
  370. The menu generator
  371. ------------------
  372. Just execute the program ra_menu.exe in the Fatal!ra directory after
  373. you have changed the layouts of the statistics. You get a statz.mnu
  374. and a statz.q-a, that you do not have to enter the names of the ansis
  375. for yourself. Copy these files into the corresponding directories
  376. and edit them if needed.
  377.  
  378. ------------------------------------------------------------------------------
  379. 7. Automatic level updater
  380. ------------------------------------------------------------------------------
  381. With the automatic level updater you can reward your users corresponding
  382. to their work. For that purpose you chose the menu Main Menu|Level Manager.
  383. Now you see all levels, which are already defined. If there is nothing
  384. defined yet, there will appear a Menu, in which you can define a
  385. security level with its demands:
  386.  
  387.  ┌──Level Verwaltung──────────────────────────────────────────────────────┐
  388.  │                                                                        │
  389.  │Level : 50     Level Update              Downgrade          User löschen│
  390.  │                                                                        │
  391.  │              Alter Level : -           Auf Level : -       Tage : -    │
  392.  │                   Kosten : 1           Hysterese : 0 %                 │
  393.  │                                                                        │
  394.  │           In 14 Tagen      Absolut                                     │
  395.  │                                                                        │
  396.  │            Calls : -      Credits : -                                  │
  397.  │           Messis : -        Calls : -                                  │
  398.  │            Files : -       Messis : -                                  │
  399.  │               KB : -        Files : 30                                 │
  400.  │                                KB : 2000                               │
  401.  └────────────────────────────────────────────────────────────────────────┘
  402.  
  403. In this case a user gets the level 50, if he uploads 30 files or 2000 KB.
  404. The level cost him one credit and he gets it only if the user can pay
  405. the credit.
  406. If everythin is OK then press <esc>. To define more level press insert,
  407. to delete press delete. Deleted levels will be deleted if you leave the
  408. menu.
  409. The list of levels is always sorted. 32 level can be defined. On the left
  410. side there should apper an arrow (  ), which indicates that the level
  411. exists in your BBS. If the arrow does not appear you have to look your
  412. levels up again.
  413. If all levels are defined, activate in the Menu Main Menu|Event the Level
  414. updater.
  415.  
  416. That your user base does not get stuffed with users who do not call any
  417. more you can define a time after which the user will be deleted:
  418.  
  419.  ┌──Level Verwaltung──────────────────────────────────────────────────────┐
  420.  │                                                                        │
  421.  │Level : 50     Level Update              Downgrade          User löschen│
  422.  │                                                                        │
  423.  │              Alter Level : -           Auf Level : -       Tage : 100  │
  424.  │                   Kosten : 1           Hysterese : 0 %                 │
  425.  │                                                                        │
  426.  │           In 14 Tagen      Absolut                                     │
  427.  │                                                                        │
  428.  │            Calls : -      Credits : -                                  │
  429.  │           Messis : -        Calls : -                                  │
  430.  │            Files : -       Messis : -                                  │
  431.  │               KB : -        Files : 30                                 │
  432.  │                                KB : 2000                               │
  433.  └────────────────────────────────────────────────────────────────────────┘
  434.  
  435. User with level 50 will be deleted after 100 days, i.e. the deleted-flag
  436. will be set. One day later the user will finally be deleted.
  437.  
  438.  ┌──Level Verwaltung──────────────────────────────────────────────────────┐
  439.  │                                                                        │
  440.  │Level : 50     Level Update              Downgrade          User löschen│
  441.  │                                                                        │
  442.  │              Alter Level : 40          Auf Level : 40      Tage : 100  │
  443.  │                   Kosten : -           Hysterese : 80%                 │
  444.  │                                                                        │
  445.  │           In 14 Tagen      Absolut                                     │
  446.  │                                                                        │
  447.  │            Calls : 8      Credits : -                                  │
  448.  │           Messis : -        Calls : -                                  │
  449.  │            Files : 8       Messis : -                                  │
  450.  │               KB : 500      Files : -                                  │
  451.  │                                KB : -                                  │
  452.  └────────────────────────────────────────────────────────────────────────┘
  453.  
  454. A new feature is the level updater for achievement, i.e. for the work
  455. which an user has done in x days. In this example an user with level
  456. 40 gets level 50, if he has 8 calls, 8 files and 500 KB in the last
  457. 14 days. Because these values can decrease again if the user does not
  458. do so well any more, you can define the level on which an user can
  459. be downgraded. The hysteresis of 80% says, that the user loses his
  460. level if his achievements have decreased on a level of 80%. In this
  461. case this is less than 6.4 calls and messis and less than 400 KB in
  462. the last 14 days.
  463.  
  464.  
  465. ------------------------------------------------------------------------------
  466. 8. Messages
  467. ------------------------------------------------------------------------------
  468. Finally FATAL!RA supports the JAM message base. All messages are posted
  469. with the stati private and local into the corresponding board. Messages
  470. can be posted into the netmail main board. They get as origin and
  471. destination address the main aka, which you can define in raconfig.
  472.  
  473. The following parameters can be used in a message:
  474. %SYSOP
  475. %BOX
  476. %NAME
  477. %HANDLE
  478. %LEVEL
  479. %UPLOADSK
  480. %UPLOADS
  481. %AGE
  482. %CALLS
  483. %TCALLS   (Total Calls)
  484. %Sx:      (Size of hard disk x in MB)
  485. %Fx:      (Free space on disk x)
  486. %Px:      (Used space in per cent)
  487.  
  488. ex: %SC: is substitudet by the size of disk C:.
  489.  
  490. You can attach files to messages to new users.
  491.  
  492.  
  493.  
  494. ------------------------------------------------------------------------------
  495. 9. Registration
  496. ------------------------------------------------------------------------------
  497. If you like FATAL!RA : just buy it :)
  498. If you don't need it : just kick it
  499. If you find it too difficult to install : keep tryin' !
  500.  
  501.  
  502.  
  503. ------------------------------------------------------------------------------
  504. 10. Copyrights
  505. ------------------------------------------------------------------------------
  506.  
  507.  
  508. Remote Access : Wantree Development
  509. Turbo Pascal  : Borland International, Inc.
  510. JAM(mbp)      : Copyright 1993 Joaquim Homrighausen, Andrew Milner,
  511.                  Mats Birch, Mats Wallin. All rights reserved.
  512.  
  513. <end>