home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / qbbsetc / remotlog.lzh / REMOTLOG.DOC < prev    next >
Text File  |  1990-03-12  |  12KB  |  300 lines
  1.                                     
  2.  
  3.  
  4.  
  5.                          R E M O T E   A C C E S S
  6.  
  7.  
  8.                   L O G  R E P O R T I N G  P R O G R A M
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                 REMOTLOG
  15.  
  16.    //////    /////  /      /  ///////  ///////   /        ///////  ///////
  17.    /     /   /      / /   //  /     /     /      /        /     /  /
  18.    //////    ///    /   /  /  /     /     /      /        /     /  /   ///
  19.    /     /   /      /      /  /     /     /      /        /     /  /     /
  20.    /      /  /////  /      /  ///////     /      ///////  ///////  ///////
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39. The Program  - Remotlog
  40.  
  41.  
  42.         I developed Remotlog because when the announcement of RA was made and I
  43.         endeavored to switch from QuickBBS.  There was something missing.  I
  44.         could no longer use all my QBBS utilities.  After exhaustive efforts of
  45.         trying to get the implementation of my old program by its author, I
  46.         decided that it was time to do some coding.
  47.  
  48.         Here we have the finished product.  A full fledged RA log reporting
  49.         program.  This program is in no way crippled.  And never will be.
  50.  
  51.  
  52.  
  53.         RA is the registered product of Continental Software.
  54.         QuickBBS is the registered product of The QuickBBS Support Group.
  55.  
  56.  
  57.         At present this program will function with RA version 0.02.  It should
  58.         have no problems with 0.03 but will have to wait till its release.
  59.  
  60.         Do not attempt to use this program with any other software except RA
  61.         because it uses the file MESSAGES.RA.  If it cannot find this file the
  62.         program will abort in error.
  63.  
  64.         The screens provided by this program are as the author thought you
  65.         the sysops would like to see.  If you feel the information is too much
  66.         or that there is not enough, or would even like to see some of the
  67.         information moved from one location to another part of the page or a
  68.         totaly different screen.  Please do not hesitate to let the author
  69.         know.
  70.  
  71.  
  72.  
  73.  
  74. Configuration of Remotlog
  75.  
  76.         A copy of exactly how the configuration file looks is included with the
  77.         zipped package.  Here is a line by line definition.  The configuration
  78.         file is called REMOTLOG.CFG.
  79.  
  80.  
  81. Line 1  : SYSTEM.LOG    [ This line defines you log file name.  If you want to
  82.                           run the program in a separate directory than where
  83.                           you log file is being stored then you may simply add
  84.                           the path to this line.  There is no caps requirement
  85.                           for this lines entries.]
  86.  
  87.                         { ie.  C:\RA\System.log  is also acceptable}
  88.  
  89. Line 2  : Fx-Chat.exe   [ This line is for you folks that use and external chat
  90.                           program.  The ones that I have seen so far do not
  91.                           talk to the BBS software to let them know exactly
  92.                           what happened during the page.  Ie.  No response,
  93.                           Chatted, Toomany pages etc.  So I went ahead and
  94.                           counted any page using the external chat program as a
  95.                           chatted type page.  Meaning as far as the program is
  96.                           concerned you and the user had a conversation during
  97.                           this page.]
  98.  
  99.                         {{ Note.  This line must be the same as the one in your
  100.                         menu that calls the chat program.  The reason is that
  101.                         Ra uses that line to log the chat in the log file.  If
  102.                         I had entered fx-chat.exe on line 2 Remotlog would
  103.                         never acknowledge any pages in the log. }}
  104.  
  105. Line 3  : C:\RA\TXT\     [ This line is for the output files.  The program
  106.                            creates two files.  The Remotlog.Asc/*.Ans.  This
  107.                            line tells the program where to send them.  Right
  108.                            now they are being sent to my text files directory.
  109.                            You are required to place the "\" at the end of the
  110.                            line.  The program will not check for this or
  111.                            automatically add it. ]
  112.  
  113. Line 4  : 40             [ Now we get into the colors.  Yes you can configure
  114.                            the color or the output screen.  This specific line
  115.                            is the color of the Background.  This most likely
  116.                            wont affect much if changed.  It is currently set to
  117.                            black.
  118.  
  119. Line 5  : 1;33           [ As you should have noticed by now.  The colors are
  120.                            not using the standard numbers.  These numbers are
  121.                            the actual Ansi color codes.  This allows for a
  122.                            greater freedom for individuality in the output.
  123.                            Any of the color lines will accept the ";" color
  124.                            separator.  These lines are inserted directly into
  125.                            the program as is.  Do not add the escape code
  126.                            sequences or the "m".  Those are already supplied by
  127.                            the program, internally.
  128.  
  129.                            This line is the color for all the numbers that are
  130.                            displayed.]
  131.  
  132.  
  133. Line 6  : 1;46;37        [ This line is the color for the Begin Date, Ending
  134.                            date, and any other currently highlighted items.]
  135.  
  136.  
  137. Line 7  : 0              [ This line reset the colors to normal.  Really
  138.                            shouldn't change this but, its all at your
  139.                            discretion. ]
  140.  
  141. Line 8  : 1;34           [ This is the color codes for the outline/Box.  Around
  142.                            the text. ]
  143.  
  144. Line 9  : 0;32           [ This is the color for the Text itself. ]
  145.  
  146. Line 10 : N              [ This is the good one.  If you are running RA in a
  147.                            multi-line environment and have one log file for all
  148.                            lines.  Or can merge the combined log files
  149.                            together.  This will tell the program to display a
  150.                            line usage screen.  It will display the amount of
  151.                            calls recieved on each line.  Up to line 99. To be
  152.                            complex you could have more than one configuration
  153.                            file active for this program.  Just rename them as
  154.                            necessary and the data file will keep track of all
  155.                            lines.  However all other information will be
  156.                            assembled together. Entries must be in caps.  This
  157.                            is a Y/N option.]
  158.  
  159. Line 11 : R              [ This line tells the program what type of log file
  160.                            you are using.  Whether you are using the Remote
  161.                            Access type log file or the Opus style log format.
  162.                            To indicate either   use R - for remote access and O
  163.                            - for the Opus style log format.  Entries must be in
  164.                            caps.]
  165.  
  166. Line 12-##: 8            [ These lines are optional.  The above are not.  These
  167.                            lines lets the program now Which specific message
  168.                            areas it should not include in the report listing.
  169.                            I have had problems with this in other log programs.
  170.                            They tend to show what they want without asking you
  171.                            whether you want it or not.  IF the message area is
  172.                            not in use then the program will not display it.
  173.                            There is a possible two hundred entries allowed
  174.                            here.  Don't think you will ever need them all.  But
  175.                            they are there. ]
  176.  
  177.  
  178.  
  179.  
  180.  
  181. Supplied ANSI Code sequences
  182.  
  183. Number  Represents
  184. ------  ----------
  185. 0       All attributes off  (Normal Display)
  186.  
  187. 1       High Intensity (Bold)
  188.  
  189. 5       Sets Blink on
  190.  
  191. 7       Reverse Video on
  192.  
  193. 8       Concealed on (makes display invisible)
  194.  
  195. 30      Foreground      Black
  196.  
  197. 31                      Red
  198.  
  199. 32                      Green
  200.  
  201. 33                      Yellow
  202.  
  203. 34                      Blue on Color Monitor
  204.                         Underline on MonoChrome
  205.  
  206. 35                      Magenta
  207.  
  208. 36                      Cyan
  209.  
  210. 37                      White
  211.  
  212. 40      BackGround      Black
  213.  
  214. 41                      Red
  215.  
  216. 42                      Green
  217.  
  218. 43                      Yellow
  219.  
  220. 44                      Blue
  221.  
  222. 45                      Magenta
  223.  
  224. 46                      Cyan
  225.  
  226. 47                      White
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233. Hints about operation of this program
  234.  
  235.   There are several different things that you can do to get certain results
  236.   from this program.
  237.  
  238.    For example if you want to change the beging date of the report without
  239.    erasing the remotlog.dat file.  All you have to do is to edit the .DAT file
  240.    find the string that has the date in it and make it a null string.  When the
  241.    program starts up it will notice the date is missing and get the date from
  242.    the current system.log file.
  243.  
  244.    When reading the log file the program will not attempt to reposition pointers
  245.    if the last item in the log is that REMOTLOG has checked the log.  Of course
  246.    the current session will be appended to the end of the logfile.
  247.  
  248.    By deleting the notation that REMOTLOG makes in the log file you can force
  249.    it to re-process the log file.
  250.  
  251.    Any bug reports, comments, or requested addition, deletions etc. may be sent
  252.    to Node 1:135/72.  or the address listed in the registration section.  I can
  253.    also be reached in the RA_SUPPORT echo.
  254.  
  255.  
  256.  
  257. Credits
  258.  
  259.    The author, Orland K. Carter, would like to thank my two beta testers of
  260.    this program that put up with the constant updates to the one program and
  261.    major overhaul of their configuration and data files.
  262.  
  263.    Daniel Johnston, and Robert Taylor thank you for your patience, and help in
  264.    beta testing this program.
  265.  
  266.  
  267. Registration
  268.  
  269.    This program should be registered with the author.  If anything at all just
  270.    drop me a line so I can determine the scope of this program.  This program
  271.    has a registration fee of $5.00.  If you wish you can donate more to the
  272.    author.
  273.  
  274.  
  275. ______________________________________________________________________________
  276. |Registration of REMOTLOG,                          Form 01, U.Date 11 Mar 90|
  277. |----------------------------------------------------------------------------|
  278. |                                                                            |
  279. |Name of Sysop ______________________________________________________________|
  280. |                                                                            |
  281. |Street Address______________________________________________________________|
  282. |                                                                            |
  283. |City/St/Zip   ______________________________________________________________|
  284. |                                                                            |
  285. |Name of BBS   ______________________________________________________________|
  286. |                                                                            |
  287. |Number of BBS ______________________________________________________________|
  288. |                                                                            |
  289. |Node #        ______________________________________________________________|
  290. |                                                                            |
  291. |Make all payments address to                                                |
  292. |  Orland K. Carter, REMOTLOG                                                |
  293. |  2850 N.W. 155 Terrace                                                     |
  294. |  Opa-Locka, FL  33054-2223                                                 |
  295. |____________________________________________________________________________|
  296.  
  297. Thank you for your support.
  298.  
  299.         Orland
  300.