home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / JLUT475.ZIP / HLP.LZH / MO.HLP < prev    next >
Text File  |  1991-07-25  |  7KB  |  164 lines
  1. ┌─────────────────────────────────────────────────────────────────────────────┐
  2. │ Option:  MO  MONITOR USERLEVELS.............................................│
  3. └─────────────────────────────────────────────────────────────────────────────┘
  4.  
  5. Syntax  
  6. ═══════════════════════════════════════════════════════════════════════════════
  7. JLUTIL /MO [Parameters] [-Switches]
  8. ═══════════════════════════════════════════════════════════════════════════════
  9.  
  10. Switch Description  
  11. ═══════════════════════════════════════════════════════════════════════════════
  12.  -A    Actual Caller only.
  13.  -C    Compile ANSWER*.* Files in GT Format to JLUTIL Format
  14.  -J    Use JLUTIL Format instead of GT Format
  15.  -E    Every User
  16.  -T    using a TagFile
  17. ═══════════════════════════════════════════════════════════════════════════════
  18.  
  19. Param       Description  
  20. ═══════════════════════════════════════════════════════════════════════════════
  21. TagFile     Name of a File, which contains the names of these users,
  22.             whose level should be monitored.
  23. ═══════════════════════════════════════════════════════════════════════════════
  24.  
  25. Explanation  
  26. ═══════════════════════════════════════════════════════════════════════════════
  27. IF YOU ARE RUNNING THIS MODULE THE FIRST TIME, PLEASE MAKE A BACKUP OF YOUR
  28. USER.CTL AND USER.IDX.
  29.  
  30. A File named LEVELS.@JL must be setup properly. Here is the format:
  31.                                              
  32. ; FORMAT-------------------------------------------------------------- 
  33. ; OldLevel[-Range],NewLevel,eXist|Not exist,Kind,AnswerFile, 
  34. ; MsgFile To User,Write Answers?, DL/UL(KB),DL-UL(KB),Logons, 
  35. ; Give Credits,Give Charges; Comment 
  36. ; -------------------------------------------------------------------- 
  37.  
  38. OldLevel   If a User has this Level, JLUTIL will change his level to
  39.            NewLevel, if the conditions, which are following, are true.
  40.            It is possible to specify a range, eg. T-Z. If the User's
  41.            Level is in this example IN ['T','U','V','W','X','Y','Z'] THEN
  42.            JLUTIL will prove the following conditions. It is also
  43.            possible to include all levels using a '?'.
  44.  
  45. NewLevel   The User's Level will be changed to this Level, if the follow-
  46.            conditions are true.
  47.  
  48. Then you can specify, if JLUTIL should search for the User's Name in
  49. a File. You have to setup three fields:
  50.  
  51. AnswerFile This is the FileName of the List, normally it is ANSWER1.BBS
  52.            or another ANSWER File from GT, but you can also ask JLUTIL
  53.            to search for the User's Name within the JLUTIL LVL_*.@JL
  54.            Files or you can specify ALL_USER.
  55.  
  56. Kind       Here you have to tell JLUTIL, of which Kind the AnswerFile
  57.            is:
  58.                        G   GT Format
  59.                        J   JL Format   (very fast:  Use /CO)
  60.                        A   ALL_USER
  61.                        N   only a single Name, which should be
  62.                            specified in the AnswerFile field.
  63.  
  64. Exist      With this field you specify, if this condition is true,
  65.            if JLUTIL finds the User's Name or not.
  66.  
  67.                                                      Exist    Not Exist
  68.                                                        X          N
  69.  
  70.            JLUTIL finds the UserName                 TRUE       FALSE
  71.  
  72.            JLUTIL finds not the UserName             FALSE      TRUE
  73.  
  74.  
  75.            So you can change the Level of a User, if he hasn't answered
  76.            ANSWER1.BBS (Kind = N). Or you change the Level of a User,
  77.            if he has answered the Questionaire #1 (Kind = X).
  78.  
  79. After these tree fields, you have to specify the Name of the MsgFile,
  80. JLUTIL sends to the User, if JLUTIL changes his level:
  81.  
  82. MsgFile    FileName of the Msg, which you want to be send to the User,
  83.            if his Level will be changed. If you specify [NO_MSG], JLUTIL
  84.            will not send a Msg to the User. The Sysop will get a summary.
  85.  
  86. Write?     In this field you can specify, if JLUTIL inserts the answers
  87.            from the AnswerFile (eg. ANSWER1.BBS) into the Summary Report
  88.            to the Sysop or Not. [Y/N]. This is useful, if a you don't
  89.            want to inspect ANSWER1.BBS manually, when ever a new user
  90.            has filled out ANSWER1.BBS.
  91.  
  92. Now are following three conditions, which must be all true, if JLUTIL should
  93. change the User's level:
  94.  
  95. DL/UL(KB)  This condition is true, if the ratio downloaded kilobytes
  96.            to uploaded kilobytes is bigger than the specified value.
  97.            If you enter zero, this condition is true irrespective of
  98.            the KiloBytes, which the User has downloaded or uploaded.  
  99.  
  100.            eg:  DL: 1500 KB   UL: 250 KB    
  101.  
  102.                 IF DL/UL(KB) <= 6 THEN FALSE
  103.                 IF DL/UL(KB) >  6 THEN TRUE
  104.     
  105.  
  106. DL-UL(KB)  This condition is true, if the difference downloaded kilobytes
  107.            to uploaded kilobytes is bigger than the specified value.
  108.            If you enter zero, this condition is true irrespective of
  109.            the KiloBytes, which the User has downloaded or uploaded. 
  110.  
  111.            eg:  DL: 1500 KB   UL: 250 KB    
  112.  
  113.                 IF DL/UL(KB) <= 1250 THEN FALSE
  114.                 IF DL/UL(KB) >  1250 THEN TRUE
  115.  
  116. Logons     This condition is true, if the User has logged on more times
  117.            than the specified value. If you enter zero, this condition
  118.            is true irrespective of number of Calls.
  119.  
  120.    
  121. With the last two fields you can specify the amount of Credits and Charges
  122. the User will get, if his Level will be changed:
  123.  
  124. Credits    If JLUTIL changes his level, the User will receive the
  125.            specified amount as credits. 
  126.  
  127. Charges    If JLUTIL changes his level, the User will have the
  128.            specified amount as charges. 
  129.  
  130. After these fields you can add a comment starting with a ';' after
  131. the last field:
  132.  
  133. ;Comment   Text
  134.  
  135.  
  136.  
  137. We at WAP-Box give the new callers a level of Z. If he answers the
  138. questionaire, his level will be changed from JLUTIL to T and he will
  139. receive a welcome-message. After 20 calls or a bad download to upload
  140. ratio his level will be decraded to W. Now he receives a msg, that
  141. he has to pay, if he wants to have level T or leave at level W with
  142. less time, no download possibilty and so on. Read LVL_Z_T.MSG and
  143. LVL_T_W.MSG to see, what i mean.
  144.  
  145.  
  146. IMPORTANT:   JLUTIL starts for every User with the first line
  147.              of LEVELS.@JL:
  148.  
  149. eg. Test User has Level A, is not in LVL_065.@JL and the Levels.@JL
  150. File contains:
  151.  
  152. A  ,Z,N,J,LVL_065.@JL,NO_MSG ,N,   0  ,   0,   0,   0,   0
  153. B-z,T,X,A,ALL_USER   ,NO_MSG ,N,   0  ,   0,   0,   0,   0
  154.  
  155. this will have the following Effect: Test User: A -> Z -> T
  156.  
  157. IF the Levels.@JL File contains:
  158.  
  159. B-z,T,X,A,ALL_USER   ,NO_MSG ,N,   0  ,   0,   0,   0,   0
  160. A  ,Z,N,J,LVL_065.@JL,NO_MSG ,N,   0  ,   0,   0,   0,   0
  161.  
  162. this will have the following Effect: Test User: A -> Z
  163. ═══════════════════════════════════════════════════════════════════════════════
  164.