home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / RAFDLC17.ZIP / RA2FDLC.DOC < prev    next >
Text File  |  1995-05-31  |  6KB  |  180 lines
  1. RA2FDLC.EXE   Version 1.07
  2. (c)Copyright 1994,95 Rand Nowell - RaLin Enterprises
  3.  
  4. RemoteAccess To FrontDoor Last Caller.
  5.  
  6. Released as FreeWare, but retains Copyright protection.
  7. You are welcome to distribute as you wish.
  8.  
  9. PLEASE READ FREEWARE.DOC!
  10.  
  11. No warranties expressed or implied.
  12. The author will not be responsible for any damages incurred during use of
  13. this product. You use it at your own risk, and hold the author faultless.
  14. Your use of this program constitutes your acceptance of this.
  15.  
  16. Rule of Thumb: Back up files that will be modified, before running any
  17. program the first time.
  18.  
  19. Type RA2FDLC -?  for startup command summary.
  20.  
  21.  
  22. RA2FDLC.EXE "WILL" Modify the following Front Door files:
  23.                    LASTCALL.FD   (LASTC#.FD - MultiNode)
  24.                    INBOUND.HIS   (INB#.HIS  - MultiNode)
  25.                    FD.LOG        (FD#.LOG   - MultiNode)
  26.  
  27.               "WILL" Read the following files:
  28.                    RA.LOG,
  29.                    LASTCALL.BBS     as specified in CONFIG.RA
  30.  
  31.               "WILL" Create new compatible files, if missing:
  32.                    LASTCALL.BBS
  33.                    LASTCALL.FD  or LASTC*.FD   (MultiNode)
  34.                    INBOUND.HIS  or INB*.HIS    (MultiNode)
  35.                    FD.LOG       or FD#.LOG     (MultiNode)
  36.  
  37.  
  38.  
  39.        RA2FDLC reads the RA.LOG to determine if Carrier was lost, in
  40.        which case a message is displayed to the screen, and written to the
  41.        error log.  Even if carrier was lost, RA2FDLC will finish reading
  42.        the log, to gather information for the FLAGS added to the user name
  43.        in the FD files.
  44.  
  45.        It also tabulates the Upload and Download bytes from the user
  46.        session, and imports these to the INB*.HIS Bytes_Sent and Bytes_Recd
  47.  
  48.        While scanning the RA log, RA2FDLC looks for strings telling it that
  49.        messages were posted etc.  Following is a list of the FLAG groups
  50.        that might be added to the user name for FD's display:
  51.  
  52.         (LMSG) - Posted Local Message
  53.         (EMSG) - Posted Echo Message
  54.         (NMSG) - Posted Netmail Message
  55.         (NLE)  - Posted Netmail, Local, Echo message
  56.         (NE)   - Posted Netmail and Echo message
  57.         (NL)   - Posted Netmail and Local message
  58.         (LE)   - Posted Local and Echo message
  59.         (New)  - This is a New User
  60.                  This one is added after any of the above flags.
  61.  
  62.  
  63.  
  64.        ******************************************************************
  65.        If no log file has been configured in RACONFIG, then there is no
  66.        attempt to read the RA.LOG
  67.        ******************************************************************
  68.  
  69.          RA2FDLC reads CONFIG.RA to obtain the name
  70.          of the RA.LOG for reading.
  71.  
  72.          If the config file exists in the "current" directory, it is
  73.          used, else it is looked for in the directory pointed to by the
  74.          RA enviornment variable.
  75.          Thus, in a multi-node enviornment, you can have TASK/NODE set to
  76.          2, and use the *N variable in your RA logname, and RA2FDLC
  77.          will replace that with value of the TASK/NODE variable.
  78.  
  79.          The log is read BACKWARDS, so even if it is huge, the minimum
  80.          number of lines are read.  It stops when it sees the ---------
  81.          RA inserts for the first line of each new entry, unless you have
  82.          specified you use the EXPANDED log format, then another method is
  83.          used to determine "end of session".
  84.  
  85.  
  86.         RA2FDLC  writes major errors, such as missing enviornments,
  87.         Dropped Carrier to a Log File, "RA2FDLC.LOG" which is maintained
  88.         in the EXE directory.  If the file exists, it is added to,
  89.         if not, it is created. It can also log runtime info, if Debug mode
  90.         is set ON.
  91.  
  92.  
  93.           The errors reported:
  94.              RA/FD enviornment not set
  95.              Carrier Lost
  96.              Errors reading RA.LOG - FD configs - RA config etc.
  97.              Creation of new files
  98.  
  99.         Of course, if no errors occur, then no log is created or written
  100.         to.
  101.  
  102.  
  103.         If the DEBUG mode is on, via the /D startup command, other
  104.         information is written to the log file.
  105.  
  106.   STARTUP COMMANDS:
  107.  
  108.    Parameters must be proceeded by either a Minus(-) or a slash(/)
  109.  
  110.    Switches are: P - 10 second pause at program end
  111.                  D - Debug mode, list pathnames in log file
  112.                  X - Using EXPANDED log format
  113.                  ? - Display Help Screen
  114.  
  115.    Example:
  116.    RA2FDLC /P will invoke the 10 sec pause at program end.
  117.  
  118.  
  119. What it actually does.....
  120.  
  121. Inserts the Name, City, Date and Time of the last caller to the
  122. BBS, in FrontDoors LASTCALL.FD file. This is then displayed on
  123. the FrontDoor screen, and you will know just who was last on the BBS.
  124.  
  125. Also adds the info, plus Up/Dn bytes to INB.HIS and the FD Logfile.
  126.  
  127. Requires RemoteAccess and FrontDoor.
  128.  
  129. Developed under RA 2.02 and FD 2.20mL      (Registered)
  130.  
  131. Reads enviornment settings to obtain file location information, does
  132. its own configuration. All you have to do is run it from the command line,
  133. or include in your BBS batchfile, in the AfterBBS section.
  134.  
  135. The RA and FD enviornment variables MUST be set for RA2FDLC to work.
  136.  
  137. The program will create a NEW FD logfile if it does not exist.
  138. It will display a message to that effect if this be the case.
  139.  
  140. It will also create compatible History and Lastcall files for FD.
  141.  
  142. RA2FDLC obtains the name of the FD Logfile from SETUP.FD, as specified
  143. in the LogFile field in SETUP.FD
  144.  
  145. The location of the other files, INB*.HIS etc. are obtained from SETUP.FD
  146. in the "System Files Directory" as defined in FD.
  147.  
  148.  
  149. Released as FREEWARE, enjoy it!
  150. Read FREEWARE.DOC
  151.  
  152. Rand Nowell
  153. RaLin Enterprises Software
  154.  
  155. 40728 Sundale Dr.
  156. Fremont, Ca. 94538-3341 USA
  157. =OR=
  158. 4641 Wheeler Dr.
  159. Fremont, Ca. 94528-1937 USA
  160.  
  161.  
  162. BBS      : 1-510-226-7731
  163. Voice    : 1-510-651-6177
  164. Fido     : 1:215/710
  165. Internet : rand.nowell@ralin.damar.com
  166.  
  167. Freq:
  168.       FILES - All File Listing
  169.       RALIN - RaLin Software Only Listing
  170.       PASCAL- Pascal Source Listing
  171.  
  172. CREDITS:
  173.  
  174.   FrontDoor -     JoHo, Absolute Solutions
  175.   RemoteAccess  - Andrew Milner, Wantree Development
  176.  
  177.   Compiled under TP 7.0 - Borland International
  178.  
  179.  
  180.