home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / BBSDOOR2.ARJ / RAVIP102.ZIP / RAVIP.DOC < prev    next >
Text File  |  1995-01-11  |  44KB  |  916 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.              ──██████╗─────█████╗───██╗───██╗───██╗───██████╗───
  10.            ────██╔══██╗───██╔══██╗──██║───██║───██║───██╔══██╗────
  11.          ──────██████╔╝───███████║──██║───██║───██║───██████╔╝──────
  12.        ────────██╔══██╗───██╔══██║──╚██╗ ██╔╝───██║───██╔═══╝─────────
  13.      ──────────██║──██║───██║──██║───╚████╔╝────██║───██║───────────────
  14.   ─────────────╚═╝──╚═╝───╚═╝──╚═╝────╚═══╝─────╚═╝───╚═╝──────────────────
  15.                        RemoteAccess VIP Caller Detector
  16.                                - Version 1.02 -
  17.  
  18.                      (c)Copyright 1994,1995 - Rand Nowell
  19.                           RaLin Enterprises Software
  20.  
  21.                          "Putting Bits Together" (tm)
  22.  
  23.                   Coding and Documentation by: Rand Nowell
  24.  
  25.                          ┌─────────────────────────┐
  26.                          │ Sysop Operations Manual │
  27.                          └─────────────────────────┘
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                            - Table Of Contents -
  34.  
  35.                  Legal Stuff...........................1,2
  36.                     Copyright
  37.                     Distribution
  38.                     Disclaimer
  39.                     Addendum
  40.                  System Requirements.....................2
  41.                  What's it do?.........................2,3
  42.                  Start-Up Commands.....................3,4
  43.                  Multi-Node Systems....................4,5
  44.                  Configuration...................5,6,7,8,9
  45.                  Door Hangup Configuration............7,10
  46.                  Double Checking Drops..................10
  47.                  User Name Validation................10,11
  48.                  The Message File.......................11
  49.                  Message Macros......................11,12
  50.                  Testing RAVIP..........................12
  51.                  Registration...........................12
  52.                  Alternate control files................13
  53.                     /F Switch   /D Switch
  54.                  Alternate Configuration Files..........13
  55.                  Credits................................14
  56.                  Support................................14
  57.                  Author Contact......................14,15
  58.  
  59.   
  60. RAVIP 1.02          Sysop's Operations Manual - (FreeWare)          Page   1
  61.  
  62. ┌─────────────────────────────────────────────────────────────────────────────┐
  63. │≡≡≡ COPYRIGHT ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  64. └─────────────────────────────────────────────────────────────────────────────┘
  65.         RaVip,   the   program   and   documentation,   are   Copyrighted 
  66.         (C)1994,1995  work  of  Rand Nowell dba  Ralin  Enterprises.  All 
  67.         rights  are reserved. Copying, duplicating, selling or  otherwise   
  68.         distributing  this  product except as noted in  the  Distribution 
  69.         Policy below is a violation of Federal Copyright Law.
  70.  
  71. ┌─────────────────────────────────────────────────────────────────────────────┐
  72. │≡≡≡ DISTRIBUTION ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  73. └─────────────────────────────────────────────────────────────────────────────┘
  74.         
  75.         1. Feel free to distribute the Shareware version of this                 
  76.            program as often as you like to any interested parties. 
  77.            Distribution to  Electronic Bulletin Boards is encouraged.
  78.            
  79.         2.  Please  do  not  distribute  this  program  without  all  the          
  80.         original related files such as documentation, readme files, 
  81.         registration forms etc.
  82.         
  83.         3. Please distribute ONLY the original authenticated ZIP
  84.            format file.
  85.            
  86.         4.  Please  obtain our written permission  before  including  the 
  87.         program with any "bundled" software packages.
  88.            
  89.         5. Please do not accept payment for the program; a copying fee of 
  90.         $5.00 per diskette may be charged by a non-profit user-group.
  91.            
  92.         6. Please do not alter the program or documentation in any way.
  93.         
  94.         7. Individuals, groups, vendors or other software distribution
  95.         companies which market diskettes containing shareware or                
  96.         test-drive   evaluation   programs,  for  profit,   must   obtain                
  97.         written permission from RaLin Enterprises prior to  distribution. 
  98.         This will insure that you have the most current copy.
  99.  
  100.  
  101. ┌─────────────────────────────────────────────────────────────────────────────┐
  102. │≡≡≡ *** DISCLAIMER *** ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  103. └─────────────────────────────────────────────────────────────────────────────┘
  104.             This  program  is supplied "as is" without  warranty  of  any 
  105.         kind.  The entire risk of using, and results from the use of,  is 
  106.         assumed  by  you  the  user.  You assume  all  costs  of  repair, 
  107.         servicing and corrections stemming from the use of this program.
  108.         Rand Nowell and/or RaLin Enterprises, or any other associated
  109.         company of the program author will not be held liable for any
  110.         damages from the use of this program. No warranties are expressed 
  111.         or implied.
  112.         ********************************************************************
  113.         To  the  original  licensee  of the  REGISTERED  version  of  the      
  114.         program, RaLin Enterprises DOES warrant that the program  disk(s) 
  115.         on  which  the  program  is recorded, be  free  from  defects  in 
  116.         material  and  workmanship  under normal use and  service  for  a 
  117.  
  118.                                                     
  119.  
  120.  
  121. RAVIP 1.02          Sysop's Operations Manual - (FreeWare)          Page  2
  122.  
  123.         period of (90) ninety days from date of delivery as evidenced  by 
  124.         your  receipt.  Our entire liability and  your  exclusive  remedy 
  125.         shall  be  replacement  of the defective  disk  not  meeting  the 
  126.         standards of this limited warranty.
  127.         And  in no case shall exceed the cost of reimbursement of  monies 
  128.         paid for program registration.
  129.          
  130.         The  Author is not obligated to produce further versions of  this 
  131.         program.  The  Author  also reserves the  right  to  convert  any 
  132.         SHAREWARE  program,  to that of COMMERCIAL status  without  prior 
  133.         notice.
  134.  
  135. ┌─────────────────────────────────────────────────────────────────────────────┐
  136. │≡≡≡ Legal Addendum ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  137. └─────────────────────────────────────────────────────────────────────────────┘
  138.         Though no registration fee is required for RaVip, and you may use 
  139.         it   and    distribute  it  to  whom  you  will,   the   program, 
  140.         documentation  and  any supporting files are copyrighted  by  the 
  141.         author.  You do not OWN the program, you own the right to use  it 
  142.         as  you  see  fit. "Except", that your  right  does  NOT  include 
  143.         modifications,  de-compiling,  reverse engineering of   the  code 
  144.         etc.
  145.           Please read FREEWARE.DOC
  146.  
  147. ┌─────────────────────────────────────────────────────────────────────────────┐
  148. │≡≡≡ System Requirements ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  149. └─────────────────────────────────────────────────────────────────────────────┘
  150.         
  151.              o  DOS Version 3.3 or greater
  152.              o  RemoteAccess BBS System
  153.              o  Hudson or JAM message base
  154.              o  150k Available memory at runtime
  155.              o  If you want a Netmail message, requires a Frontend Mailer
  156.  
  157.  
  158. ┌─────────────────────────────────────────────────────────────────────────────┐
  159. │≡≡≡ What's It Do? ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  160. └─────────────────────────────────────────────────────────────────────────────┘
  161.            RaVip  will read your defined RA.LOG, and scans for  the  user
  162.         name. This user name is compared against those listed in VIP.CTL.
  163.         If  the  name is a match, a message is generated  to  the  Sysop, 
  164.         telling  you  the  caller logged on. Other  information  is  also 
  165.         retrieved in this case,  the following is checked, and noted:
  166.              Did upload(s)
  167.              Did download(s)
  168.              Posted Local message
  169.              Posted Echo message
  170.              Dropped carrier
  171.              Browsed files
  172.              Read messages
  173.              DOS external, Doors etc.
  174.              EMSI connection established
  175.              Log Off time
  176.         
  177.            The above information is rather generic, ie: it does not  list 
  178.  
  179.                                                     
  180.  
  181.  
  182. RAVIP 1.02          Sysop's Operations Manual - (FreeWare)          Page  3
  183.  
  184.         each  door  run,  file area browsed etc.  It  just  gives  you  a 
  185.         general idea of what the user did during their visit.
  186.         
  187.            But the number of times the action was done is listed.
  188.         
  189.            When   a  VIP  caller  is  detected,  RaVip   writes   certain 
  190.         information  to its logfile, RAVIP.LOG, in the same directory  as 
  191.         RAVIP.EXE, or a directory+filename you define in RAVIP.CFG
  192.         
  193.            Some  DOOR's allow hangup from within, this will cause  RA  to 
  194.         report  Carrier lost....  RAVIP allows you to configure up to  10 
  195.         strings that your Door(s) write to the log, if they do, and  will 
  196.         ignore  the  dropped  carrier if one is found,  in  the  last  RA 
  197.         session entries.
  198.            This  is a carry over from RADCD, its only value in  RaVip  is 
  199.         that  the  Dropped Carrier notations will not be  made.   Just  a 
  200.         feature I left active.
  201.         
  202.            Instructions for configuring doors that do NOT write to the RA 
  203.         log are included.  More is explained later.
  204.         
  205.            The  log file is read "backwards", so even if it is HUGE,  the 
  206.         minimum  number of lines is read, stopping at the the first  line 
  207.         entered for the callers session.  Goes very quick!
  208.  
  209.            RAVIP would normally be called from the "After BBS" section of 
  210.         your batch file.
  211.         
  212.            The  message is posted in the message area you specify in  the 
  213.         config file.  Both JAM and HUDSON bases are supported.
  214.         
  215.            If  you run a mailer, you can optionally have RaVip send you  a 
  216.         local Netmail message, rather than to the message base.
  217.         
  218.            The  program also obtains the user name, the log  entry  date, 
  219.         and the time of the session, from the RA.LOG
  220.         
  221.            The User Name is displayed on the screen at run time, the time 
  222.         and date, along with the name are used when posting a message  to 
  223.         the user.
  224.            These, along with other strings may be included in the message 
  225.         you create by way of "Macro Characters", more on that later....
  226.         
  227.            If  you  have  used my  program  RADCD,  RemoteAccess  Dropped 
  228.         Carrier  Detector,  you will see many similarities  between  that 
  229.         program and RaVip.
  230.         Much  of  the same code has been used, with  some  modifications.  
  231.         Also, this doc file is a modified version of the RADCD.DOC.
  232.         
  233.            Yeah..... I'm lazy.... <grin>
  234.  
  235. ┌─────────────────────────────────────────────────────────────────────────────┐
  236. │≡≡≡ Start Up Commands ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  237. └─────────────────────────────────────────────────────────────────────────────┘
  238.         
  239.  
  240.                                                     
  241.  
  242.  
  243. RAVIP 1.02          Sysop's Operations Manual - (FreeWare)          Page  4
  244.  
  245.           The program requires a minimum of 120k available.
  246.           150k free memory is recommended.
  247.         
  248.         There  are  7  startup switches/commands that may  be  used  with 
  249.         RaVip.
  250.         
  251.         Switches  must  be preceded by either the  minus(-)  or  slash(/) 
  252.         character, and must be separated by at least one space.
  253.         
  254.         -?  Will display a short start up command help screen.
  255.         
  256.         -P   Will invoke a 10 second pause at programs end, allowing  you 
  257.         to read the screen display.  ANY key press during the pause, will 
  258.         clear the pause and terminate the program.
  259.         
  260.         -L  Will disable all logging of errors to RAVIP.LOG
  261.         This  has  been  included  as a startup  switch,  rather  than  a        
  262.         config  item, so you may TEST the program without creating a  log 
  263.         file.
  264.         
  265.         -T   Run  RaVip  in  full  use mode,  but  do NOT generate  any
  266.         message.
  267.         
  268.         -C    Tell RaVip to use a different Config file.  Full  path  and 
  269.         filename  must be supplied.  If none given then RaVip  looks  for 
  270.         RAVIP.CFG in the same directory as RAVIP.EXE   
  271.         
  272.         -F  Specify alternate control file to be read, instead of VIP.CTL 
  273.         This allows you to check specific users activities, without  them 
  274.         being in your VIP file.
  275.         The full path\filename should directly follow the "F" without any 
  276.         spaces. EXAMPLE: /FC:\TEMP\USER.CHK
  277.         
  278.         -D  Essentially the same as /F, but puts RaVip in "Dual Mode".
  279.         You can specify an alternate file, just as above, and RaVip  will 
  280.         scan it right after checking the VIP.CTL file.
  281.         You should NOT give the VIP.CTL name, it is ALWAYS scanned.
  282.  
  283. ┌─────────────────────────────────────────────────────────────────────────────┐
  284. │≡≡≡ Multi-Node Systems ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  285. └─────────────────────────────────────────────────────────────────────────────┘
  286.         
  287.            RaVip supports RA running in a multi-node setup, pertaining to 
  288.         the LOG file it scans, and also for the RAVIP.LOG.
  289.         
  290.            RaVip  will  read the CONFIG.RA file to get the log  name.  It 
  291.         first searches the current directory for CONFIG.RA, if not  found 
  292.         it  looks  in  the directory specified with  the  RA  environment 
  293.         variable.
  294.         
  295.            So  lets say you run a 3 line system, and for each load up  of 
  296.         RA  you set the TASK environment variable, we'll use  set  TASK=2 
  297.         for our example.
  298.            When  you have the TASK variable set, you can use RA's  "node" 
  299.         macro (*N) in the log name, ie: F:\RA\NODE*N\RA*N.LOG
  300.  
  301.                                                     
  302.  
  303.  
  304. RAVIP 1.02          Sysop's Operations Manual - (FreeWare)          Page  5
  305.  
  306.            RaVip  will  scan the log name, and insert  the  current  task 
  307.         number  into the log name.  Given our example TASK=2,  the  above 
  308.         would parse out to:  F:\RA\NODE2\RA2.LOG - make sense??
  309.         
  310.            This also applies to the RaVip logfile, in the config, you can 
  311.         insert  the  *N anywhere in the logfile name/location,  and  RaVip 
  312.         will substitute the current TASK number.
  313.         
  314.            The  TASK  variable is usually associated with  those  systems 
  315.         that  run a Frontend Mailer. As RaVip does not require a  mailer, 
  316.         and  some Sysops use  the NODE variable, support has  been  added 
  317.         for this also.
  318.            RaVip  will first look for the environment variable  TASK,  if 
  319.         not found it will try NODE, if neither is found, then the  system 
  320.         is  not running Multi-Node.  If both happen to be set,  the  TASK 
  321.         variable WILL be used, NOT the NODE one.
  322.         
  323.            Remember, RaVip looks for a CONFIG.RA in the current directory 
  324.         FIRST,  then looks at the environment specified directory. So  if 
  325.         you  use multiple CONFIG.RA files for different nodes, make  sure 
  326.         you are in the proper NODE directory before RaVip is called!
  327.         
  328.            RaVip  not  only  obtains your configured  RA  log  file  from 
  329.         CONFIG.RA, it also gets the location of your Message Base,  which 
  330.         holds  the  User file. If you store your  USERS.BBS  and  related 
  331.         Index files elsewhere, then we have a problem!!  Doing this  does 
  332.         not  mean  you  should  NOT configure  the  MsgBase  location  in 
  333.         RAVIP.CFG!!   The  location of the MsgBAse in CONFIG.RA  is  ONLY 
  334.         used to determine the location of the USERS.BBS file!!
  335.         
  336. ┌─────────────────────────────────────────────────────────────────────────────┐
  337. │≡≡≡ Configuration ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  338. └─────────────────────────────────────────────────────────────────────────────┘
  339.         
  340.         The configuration file is a simple text file named RAVIP.CFG.
  341.         It MUST reside in the same directory as RAVIP.EXE.
  342.         A sample file has been included, you can edit it to reflect  your 
  343.         system and preferred message base info etc., and use it.
  344.         
  345.         Comment lines may be included, by having the FIRST character,  in 
  346.         column ONE be a semi-colon (;). These lines are ignored by RaVip.
  347.         
  348.         Currently, there are seven (17) items that can be configured for
  349.         RaVip. The configuration is done with "keywords", and the format is
  350.  
  351.            KEYWORD=VALUE
  352.         
  353.            The equals sign (=) is the separator, and is used by RaVip  to 
  354.         determine  just where the VALUE starts, the VALUE being what  you 
  355.         want used as the configuration item.
  356.         
  357.            There may be spaces between the KEYWORD, EQUALS, and VALUE  if 
  358.         you  need  them  for  readability, myself,  I  always  keep  them 
  359.         together.
  360.         
  361.            Keywords  may be in any or mixed case.
  362.  
  363.                                                     
  364.  
  365.  
  366. RAVIP 1.02          Sysop's Operations Manual - (FreeWare)          Page  6
  367.  
  368.            Values,  for  the  most part can be any case,  but  Sysop  and 
  369.         System will be displayed AS THEY ARE LISTED.
  370.         
  371.            The  "VALUES"   for each NoDrop keyword, MUST be in  the  same 
  372.         case they will be found in the log, for them to work.
  373.         
  374.         KEYWORDS:
  375.         MsgBase -
  376.               If you want the message posted to the HUDSON message  base, 
  377.         then this  would be the full path to the Hudson Message Base,  ie 
  378.         F:\RA\MSGBASE
  379.         
  380.               If you want it posted to a JAM message file, this should be 
  381.         the full path to the JAM message file: ie F:\JAM\GENERAL 
  382.         NO  extension to the JAM filename, it is  automatically  handled.  
  383.         This  document will not go  into details about the JAM  messaging 
  384.         system.
  385.         
  386.         BaseType-
  387.         If the message is going to the HUDSON base, this should be "H",
  388.         without the quotes.
  389.         If going to JAM, it should be "J", again, no quotes.
  390.         
  391.         Board-
  392.         Only  required if posting to the HUDSON base, this should be  the 
  393.         NUMBER  of  the  message area, and it MUST be ZERO  padded  to  3 
  394.         digits.
  395.               Ex: Message Area #4 would be 004
  396.         
  397.         Echo-
  398.         If the message board you want the Sysop Notification written  to, 
  399.         is  an  EchoMail area, make sure this KeyWord is  defined.   This 
  400.         will  tell  RaVip to handle the message  properly,  for  possible 
  401.         EchoMail exporting by your tosser. 
  402.         
  403.         Sysop-
  404.         This  is your Sysop Name. It does NOT need to match RA's,  it  is 
  405.         only  used in conjunction with the message macros, so it  can  be 
  406.         anything  you wish.  BUT!!! Be advised,  the name  as  configured 
  407.         here,  is  used  in the message header TO:  so if  you  use  a  a 
  408.         different  name than is configured in your BBS/Reader  etc.  make 
  409.         sure that they will recognize this name.
  410.         
  411.         System-
  412.         The  name  of  your  BBS.   Again, it  need  not  match  that  in 
  413.         CONFIG.RA.
  414.         
  415.         LogFile-
  416.         You may specify, with this keyword, where RaVip will write the
  417.         logged   information.   If   not  defined,  the   log   will   be 
  418.         written/maintained in the same directory as RaVip.EXE.
  419.         The RA variable *N may be used anywhere in the log path\name,  it 
  420.         will be substituted with the current TASK/NODE value.
  421.         
  422.  
  423.                                                     
  424.  
  425.  
  426. RAVIP 1.02          Sysop's Operations Manual - (FreeWare)          Page  7
  427.  
  428.         CopyCol-
  429.         RaVip is hard-coded to start scanning for the user name in column 
  430.         #13  of the logfile. This is correct for the COMPACT  log  format 
  431.         specified in RACONFIG.  If you use a different format, you should 
  432.         load  a copy of the log into a Text Editor, and count over,  from 
  433.         column one, to the FIRST character of the user name.  This column 
  434.         number is what you will specify as the CopyCol value.
  435.         
  436.         ExpandedLog-
  437.         If you are using the EXPANDED log format, you should include  the 
  438.         line: ExpandedLog
  439.         This will tell RaVip to scan for the Date and Time of a Drop
  440.         differently than for the default Compact log style.
  441.         
  442.         It  also determines how RaVip knows it has read all  the  current 
  443.         session  information,  as the line containing the dashes  is  not 
  444.         written to an expanded format log.
  445.         You  do NOT need any config keyword for Compact format, as it  is 
  446.         the  default, if ExpandedLog is not used.
  447.         
  448.         NoDrop-
  449.         This  config  item  is  supplied with  RADCD,  while  not  really 
  450.         required  in RAVIP, I have left it available. All it will  do  is 
  451.         keep RaVip from noting that your caller dropped carrier. No other 
  452.         dropped carrier action is taken at all.
  453.         
  454.         Specifies a string (case sensitive) that RaVip should watch  for, 
  455.         to reverse the Carrier lost action, if the carrier was  correctly 
  456.         dropped from within a Door Program.
  457.         
  458.         You  may  configure up to 10 strings, each one  preceded  by  the 
  459.         keyword NoDrop.  Each Keyword/Value on its own line.
  460.         
  461.         The  string may be up to 25 characters in length. Any  more  will 
  462.         not  be stored. The 25 character length allows you  to  configure 
  463.         sec levels to ignore Dropped Carrier for, ie: 
  464.         NoDrop=Security level 50
  465.         
  466.         NOTE!!
  467.         
  468.         RaVip now fully supports InterZone Netmail.  If you need to  have 
  469.         the Sysop Notification sent to another Node/Zone etc, it may  now 
  470.         be done accurately.
  471.         
  472.         
  473.         Net- 
  474.         This  tells RaVip to generate a Netmail message  in  the  defined 
  475.         Mail Directory.  If you do NOT want netmail, then do not activate
  476.         this item.
  477.         Example:  Net
  478.  
  479.         Crash/Kill -
  480.         For Netmail, when sending OUT of your system.
  481.         CRASH sets Crash priority on the message.
  482.         KILL  sets the Kill/Sent flag.
  483.         By default, if not defined, messages are NOT Crash and
  484.  
  485.                                                     
  486.  
  487.  
  488. RAVIP 1.02          Sysop's Operations Manual - (FreeWare)          Page  8
  489.  
  490.         NOT Kill/Sent
  491.               Do not use these if you are having the netmail message
  492.               sent to YOU on YOUR system, ie: Locally.
  493.  
  494.  
  495.         Semaphore-
  496.         If you run a multi-node system  and RaVip might  be  called  from
  497.         another  node, while  your   mailer  is  running  on  another,
  498.         you  can give  a path+filename here,  and RaVip will  modify  the
  499.         time/date (re-write) it, so your mailer  will scan  for  new mail.
  500.         This is mainly for Netmail support.
  501.         For FrontDoor, this might be  C:\FD\FDRESCAN.NOW
  502.  
  503.         FromNode-
  504.         Here  you  give your Fidonet (or other) Netmail address.  If  you 
  505.         have specified "Net", then be sure this, and MailPath are defined
  506.         correctly.   Points are supported.
  507.               Example:  FromNode=1:161/710
  508.  
  509.         NOTE:
  510.         Actually, you should ALWAYS define your own Node Address here, as
  511.         it is ALSO used for EchoMail.
  512.         
  513.         ToNode-
  514.         If  you  are having the message generated only for  use  on  your 
  515.         system, then this should be the same as that for FromNode.
  516.         But if you need the message sent to another system, you can  give 
  517.         its address here.
  518.         
  519.         MsgTo-
  520.         When sending this message, you may want it addressed to a 
  521.         Co-Sysop, whether he be on your system, or at another address.
  522.         If  so, supply their name here.  If MsgTo is not supplied with  a 
  523.         name, the message is addressed to the Sysop name given earlier.
  524.          
  525.         MailPath-
  526.         Where  the  *.MSG should be written, ie: where your  mailer  will 
  527.         look  for  these messages. Currently the TASK/NODE variables  are 
  528.         NOT supported.
  529.               Example:  MailPath=E:\FD\MAIL
  530.         
  531.         
  532.         Some NOTES on configuration:
  533.         
  534.         1) You may NOT set Echo and Net together. If both are set,  RaVip 
  535.         aborts with an error message.
  536.         
  537.         2)  You can, and should define ALL message options,  ie:  Message 
  538.         Board,  Board  Number,  To/From Nodes etc.  Which  are  used,  is 
  539.         determined by the NET and ECHO keywords.
  540.         Having  both  setups defined, makes it a simple QUICK  matter  to 
  541.         instantly   change   from  having  the  message  going   to    the 
  542.         messagebase, or to a Netmail .MSG.  All you have to do is comment 
  543.         out one keyword, and un-comment the other.
  544.         
  545.  
  546.                                                     
  547.  
  548.  
  549. RAVIP 1.02          Sysop's Operations Manual - (FreeWare)          Page  9
  550.  
  551.         3) The generated message is ALWAYS from the Program, ie: 
  552.         From: RaVip 1.02
  553.         
  554.         
  555.         4)  Comments may be inserted in the config file, any line with  a 
  556.         semi-colon  (;) in column ONE, of the line is ignored.   You  can 
  557.         use the ; to comment  out a keyword also.   
  558.         
  559.         5)  You  can have multiple configurations.  An alternate  can  be 
  560.         used  via the -C switch.  But you should configure  a  "STANDARD" 
  561.         format, and save it as RAVIP.CFG in the EXE's directory.
  562.         
  563. ┌─────────────────────────────────────────────────────────────────────────────┐
  564. │≡≡≡ Door Hangup Configuration ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  565. └─────────────────────────────────────────────────────────────────────────────┘
  566.         NOTE on NoDrop.  (READ THIS.....)
  567.         
  568.         Some  doors  that allow Hanging up, or Quitting the BBS,  do  NOT 
  569.         write to the RA.LOG, in fact probably most, do not.
  570.         You  can  still work with these, all you need to do,  is  in  the 
  571.         batch file that runs the door, after the command to run the door, 
  572.         insert a line that will ECHO a line of text to the RA.LOG
  573.         
  574.         Example:
  575.         Suppose  you run a door called FileVu.  In your batch  file,  you 
  576.         might have, FILEVU C:\RA\DORINFO1.DEF  as the command to run  the 
  577.         program. All you need to do is insert a line such as:
  578.          echo User ran FileVu >> C:\RA\RA.LOG
  579.         right after the program call, when the program exits, it  returns 
  580.         to the batch file, and this line is processed.
  581.         
  582.         Then in RAVIP.CFG, include a line that looks like: NoDrop=FileVu
  583.         Now, when RaVip sees the Carrier lost line in RA.LOG, it sets the 
  584.         Dropped Carrier flag, but as soon as it finds your created value, 
  585.         "FileVu" it turns OFF the flag.
  586.         
  587.         Another use for the NoDrop, is if you want callers with a certain 
  588.         security level to not receive messages for dropping  carrier..... 
  589.         RA writes a line "Security level #####,"  to the log file,  where 
  590.         ##### can be any defined sec level up to the maximum allowed.
  591.         So  if  you  want  to allow callers with sec  level  50  to  drop 
  592.         carrier,  simply  add  a line such as  NoDrop=Security  level  50   
  593.         to the RaVip.CFG
  594.         
  595.         You  can,  if you wish, insert a username here  also,  it  should 
  596.         work, but has NOT been tested.
  597.         
  598.         Of course, an even simpler method is to use the RA Menu Command,
  599.         Type 47 to generate a log entry, either just before or after  the 
  600.         Door  Command is given. It involves a little more menu work,  but 
  601.         may be more desirable for some. 
  602.         
  603.         
  604.         Two important things to remember, the search for a value is  done 
  605.         case SENSITIVE, it MUST match exactly what is written to the log, 
  606.  
  607.                                                     
  608.  
  609.  
  610. RAVIP 1.02          Sysop's Operations Manual - (FreeWare)          Page 10
  611.  
  612.         and listed in the config file.
  613.         The other is, when you create your own, as in our example,
  614.         you  use  the DOUBLE > character ">>" after the string  to  Echo.  
  615.         This  is the command to DOS, to APPEND the line to the log  file.  
  616.         If you forget, you will OVER-WRITE your RA.LOG
  617.         
  618.         Also,  some doors do not allow a caller to hangup, but  DO  allow 
  619.         the Sysop to hangup on the user. These should also be configured, 
  620.         if you think you may hangup on the user in the door.
  621.         
  622.         Another  note, when RaVip detects dropped carrier, it  writes  to 
  623.         the screen,
  624.         !  User dropped carrier
  625.         If  it  finds  an "Authorized Door hangup string"  it  will  then 
  626.         display  ~  Authorized Door Hangup : "value",
  627.         where value is the NoDrop string you supplied, and RaVip found.
  628.         
  629.         If it all sounds confusing, that's because it can be so!! <smile>
  630.         Some  experimentation  on your part will get you up  and  running 
  631.         smoothly in no
  632.         time.
  633.  
  634. ┌─────────────────────────────────────────────────────────────────────────────┐
  635. │≡≡≡ Double Checking Drops ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  636. └─────────────────────────────────────────────────────────────────────────────┘
  637.         
  638.         RaVip  insures that the User Name in the logfile is not  garbage, 
  639.         as  can  happen  with bad EMSI calls or  a  user  sending  escape 
  640.         sequences  trying to crash the system.  If carrier is  lost,  but 
  641.         the  user name does not contain an Alpha character  starting  the 
  642.         name,  its  considered  an incomplete call,  and  no  message  is 
  643.         posted.
  644.         
  645.         When  you run a frontend mailer, the connection can sometimes  be 
  646.         broken  during  the time the mailer is loading RA. In  this  case 
  647.         there  is no name for RaVip to check, usually there will only  be 
  648.         two  lines in the log, the first line RA writes, and the  second, 
  649.         Lost carrier.
  650.         
  651.         So  RaVip  counts the important lines read from the log,  and  if 
  652.         this  count  is  NOT  greater than 3,  then  RaVip  displays  the 
  653.         message:  "BLAM!!  Never even got started..." and  also  logs  an 
  654.         appropriate  line  to  its  log  file.   This  is  considered   a 
  655.         connection that never got established.
  656.         
  657.  
  658. ┌─────────────────────────────────────────────────────────────────────────────┐
  659. │≡≡≡ User Name Validation ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  660. └─────────────────────────────────────────────────────────────────────────────┘
  661.  
  662.         Along  with checking for garbage strings, and empty names,  RaVip 
  663.         will    actually "validate" the username against the  user  index 
  664.         file.
  665.         Say  a  user does not enter a complete name the first  time,  but 
  666.         does  on the   second attempt.  The first name will  be  invalid, 
  667.  
  668.                                                     
  669.  
  670.  
  671. RAVIP 1.02          Sysop's Operations Manual - (FreeWare)          Page 11
  672.  
  673.         and  so not used. Once  the name has been validated  against  the 
  674.         User index file, it is the one used.
  675.         
  676.         While the program is running, all names found are displayed, even 
  677.         the   ones not found in index file, misspellings etc.....  If  the 
  678.         name  does  not   exist, it has the message "NOT  IN  USER  FILE" 
  679.         displayed after the name.
  680.         
  681.            The next release may do a bit towards eliminating the  display 
  682.         of names if they are not validated.
  683.         
  684. ┌─────────────────────────────────────────────────────────────────────────────┐
  685. │≡≡≡ The Message File ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  686. └─────────────────────────────────────────────────────────────────────────────┘
  687.         
  688.         Using your favorite Ascii Text Editor, you can create the message 
  689.         that will be sent to the user who has dropped carrier.
  690.         
  691.         It MUST be named RAVIP.MSG, and MUST reside in the same directory 
  692.         as RAVIP.EXE
  693.         
  694.         NOTE:   What  =you= create, is the text that is  written  at  the 
  695.         beginning  of the message to you.  The callers activity is  added 
  696.         to your message.
  697.         
  698.         See  the  sample RAVIP.MSG included to give you an  idea  of  the 
  699.         suggested format.
  700.         
  701.         You  can  make  use of several macros to  insert  text  into  the 
  702.         message when it is posted.  A sample RAVIP.MSG has been provided.
  703.  
  704. ┌─────────────────────────────────────────────────────────────────────────────┐
  705. │≡≡≡ Message Macros ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  706. └─────────────────────────────────────────────────────────────────────────────┘
  707.  
  708.         The  most important thing to remember about using the macros,  is 
  709.         that each one MUST be preceded by the at character (@).
  710.         
  711.         If  you  wish to use a literal @ in the message  text,  you  must 
  712.         precede it with another @.  So the line "Call me @ 223-4455" must 
  713.         be written as  "Call me @@ 223-4455"
  714.         
  715.         If  you use an incorrect macro, or use the @ alone,  the  "macro" 
  716.         will  be   replaced with "<MACRO ERROR @??????>"  where  ????  is 
  717.         replaced with the problem character(s).
  718.         
  719.         If  you use our RASIS program, then you should be  familiar  with 
  720.         how  the   message macros work, they are done in the  exact  same 
  721.         manner.
  722.         
  723.         There are currently eight (8) macros available for you to use:
  724.         
  725.              @F  - Users first name only
  726.              @L  - Users last name only
  727.              @N  - Users full name
  728.  
  729.                                                     
  730.  
  731.  
  732. RAVIP 1.02          Sysop's Operations Manual - (FreeWare)          Page 12
  733.  
  734.              @D  - Log entry date
  735.              @T  - Log entry time
  736.         
  737.         The values for the above 5 macros are taken from the RA log file.
  738.         
  739.              @B  - The BBS name
  740.              @S  - The Sysop name
  741.         
  742.             These 2 are taken from the RAVIP.CFG file.
  743.         
  744.              @C  - Name of control file used for user check
  745.         Supplied on the command line with the /D "Dual Mode" switch, or
  746.         /F Alternate File switch, or VIP.CTL if running in normal mode.
  747.  
  748. ┌─────────────────────────────────────────────────────────────────────────────┐
  749. │≡≡≡ Testing  RaVip ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  750. └─────────────────────────────────────────────────────────────────────────────┘
  751.  
  752.            You  can  add  your  name to the  VIP.CTL  file,  or  use  the 
  753.         Alternate  File switch /F, supplying a filename of the  alternate 
  754.         file, that contains your name in it.
  755.         
  756.            See Startup Commands -> /F above for syntax and info.
  757.         
  758.         Then  log  on locally and perform a few normal  user  activities.  
  759.         Then run RaVip and see what happens.
  760.         
  761.         Another option to a local logon, is to just edit the RA.LOG,  and 
  762.         insert your name in place of the last caller.
  763.         
  764. ┌─────────────────────────────────────────────────────────────────────────────┐
  765. │≡≡≡ Registration ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  766. └─────────────────────────────────────────────────────────────────────────────┘
  767.  
  768.           RaVip is fully functional as you have received it.  If you find 
  769.         it a useful tool, I would request that you send me $5.00 or  more 
  770.         though.   This  will  show me that the  program  is  being  found 
  771.         useful,  help  defray the cost of developing  utilities  such  as 
  772.         RaVip,  and induce me to continue development of RaVip and  other 
  773.         RA utilities.
  774.         
  775.           Please read FREEWARE.DOC
  776.         
  777.         If you simply cannot afford even $5.00, send me what you can,  if 
  778.         you can send any at all.  And if you're just plain destitute,  at 
  779.         least fill out the Reg Form included, and send it to me, just  so 
  780.         I know where the program is going etc.
  781.         
  782.           I think you will find RaVip worth a little donation to further
  783.           development.
  784.  
  785.                                                     
  786.  
  787. RAVIP 1.02          Sysop's Operations Manual - (FreeWare)          Page 13
  788.  
  789. ┌─────────────────────────────────────────────────────────────────────────────┐
  790. │≡≡≡ Alternate Control Files ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  791. └─────────────────────────────────────────────────────────────────────────────┘
  792.    By using the /F or /D switches, and supplying a path+filename, you
  793.    can have RaVip either use a file "other" than VIP.CTL, or, scan a file
  794.    in "addition" to VIP.CTL
  795.  
  796.    The /F gives a control file to scan INSTEAD of VIP.CTL
  797.    The /D gives a file to scan WITH VIP.CTL. This file is scanned AFTER
  798.    VIP.CTL
  799.  
  800. ┌─────────────────────────────────────────────────────────────────────────────┐
  801. │≡≡≡ Alternate Configurations ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  802. └─────────────────────────────────────────────────────────────────────────────┘
  803.    You can setup additional configuration files, for the purpose of
  804.    totally changing the way RaVip handles the message generation.
  805.  
  806.    You might have one setup to be sent to you, as local netmail. Another
  807.    to you as EchoMail, and yet another to go to a co-Sysop on another
  808.    system at another address.
  809.  
  810.    While modifying RAVIP.CFG is fairly easy, some may find it more
  811.    convinient to have different setups in different files, then by supplying
  812.    that filename with the proper command line switch, cause it to ne used.
  813.  
  814.    RAVIP -CF:\RA\VIPECHO.CFG  would cause RaVip to use the VIPECHO.CFG
  815.    file in the F:\RA directory, rather than the default RAVIP.CFG in the
  816.    RAVIP directory.
  817.  
  818.    You might have several, like:
  819.       VIPECHO.CFG
  820.       VIPNET.CFG
  821.       VIPCOSYS.CFG
  822.       VIP2PNT.CFG    etc. etc.
  823.  
  824.  
  825. RAVIP 1.02          Sysop's Operations Manual - (FreeWare)          Page 14
  826.  
  827. ┌─────────────────────────────────────────────────────────────────────────────┐
  828. │≡≡≡ Credits ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  829. └─────────────────────────────────────────────────────────────────────────────┘
  830.         Special  Thanks  to  Eric Staufer of The  Concession  Stand,  for 
  831.         initial testing of RaVip 1.0 - Big Help!
  832.         
  833.         RemoteAccess  - Andrew Milner, Wantree Development.
  834.         
  835.         JAM(mbp) - Copyright 1993 Joaquim Homrighausen, Andrew Milner,
  836.                               Mats Birch, Mats Wallin.
  837.                                 ALL RIGHTS RESERVED.
  838.         
  839.         RaVip  uses  modified message base code from Mark  May,  Mythical 
  840.         Kingdom Software.
  841.         
  842.         RaVip is programmed under TP 7.0, Borland International
  843.         
  844.         Any other products mentioned are Copyrighted by their  respective 
  845.         authors.
  846.         
  847.            Some of the key folks in Beta Bashing RaVip 1.01:
  848.            Donald Hinkle, Bob DaCastello, John Coleman.... Thank's Guys!!
  849.  
  850. ┌─────────────────────────────────────────────────────────────────────────────┐
  851. │≡≡≡ Support ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  852. └─────────────────────────────────────────────────────────────────────────────┘
  853.         
  854.         Though its Free, I fully support it.
  855.         Bug  reports  are  appreciated,  feature  requests  are   usually 
  856.         implemented.
  857.         
  858.         If  you send a netmail message with question/suggestion  or  bug, 
  859.         you  will  need to POLL for your reply.  It would  help,  if  you 
  860.         would TELL me if you  wish a reply.  If you do, it will be placed 
  861.         on HOLD for your call. If you   do not pick it up within a  week, 
  862.         it will be sent ROUTED.
  863.         
  864.         I  have been replying to many questions via CRASH mail, I  cannot 
  865.         afford  to  continue this practice, the program =IS=  free  after 
  866.         all, and does NOT pay for these LD return messages. <grin>
  867.         
  868.         Of  course,  I  could make registration  required,  then  I  will 
  869.         continue crash replies.... <chuckle>
  870.  
  871. ┌─────────────────────────────────────────────────────────────────────────────┐
  872. │≡≡≡ Author Contact ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  873. └─────────────────────────────────────────────────────────────────────────────┘
  874.  
  875.          I hope you find RaVip useful, and would appreciate hearing  from 
  876.         you if you do. I can be reached at the following:
  877.         
  878.          Echo Areas:
  879.          Fidonet  - RA_UTIL, RA_SUPPORT, SHAREWAR, DOORS, PASCAL
  880.          XeroNet  - XN-RALIN, XN-RA
  881.         
  882.          Netmail  - FIDO= 1:161/710, XERO= 131:5100/100;101 
  883.                       GASPNET= 8:86/260
  884.         
  885.  
  886.  
  887. RAVIP 1.02          Sysop's Operations Manual - (FreeWare)          Page 15
  888.  
  889.          BBS      - 1-510-226-7731
  890.          Voice    - 1-510-651-6177
  891.          Internet - rand.nowell@ralin.damar.com
  892.                     NOTE:  We may soon have our own DOMAIN for the
  893.                     internet, "RALIN.COM" when this happens, notification
  894.                     will be posted in the Echos.
  895.  
  896.                     You might also try the following:
  897.                     rand.nowell@ralin.intellisoft.com
  898.         This address is currently where we are setting up
  899.         and testing our local UUCP feed, and there are bugs 
  900.         to be worked out. So it may be late arriving....
  901.         
  902.          Mail     - Rand Nowell
  903.                     RaLin Enterprises
  904.                     40728 Sundale Dr. Fremont, Ca. 94538-3341
  905.                      =OR=
  906.                     4641 Wheeler Dr. Fremont, Ca. 94538-1937
  907.         
  908.         The system is located at the new Wheeler Dr. address, but I still 
  909.         receive mail at the Sundale Dr. address also.
  910.  
  911. ┌─────────────────────────────────────────────────────────────────────────────┐
  912. │≡≡≡ eof RAVIP.DOC  ≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡≡│
  913. └─────────────────────────────────────────────────────────────────────────────┘
  914.                                                                  
  915.  
  916.