home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / CL15S1G.ZIP / REPORTS.DOC < prev   
Text File  |  1994-06-12  |  5KB  |  100 lines
  1. There are a few requirements to making some of the new reports I added to
  2. CALLS.EXE work.
  3.  
  4. *---------------------------------------------------------------------------
  5. For Event timing to work properly, you will need to send the following
  6. line to your CALLER log file (you can use CL-PRINT.COM that I wrote to do
  7. this):
  8.  
  9.        Scheduled Event ended at MM-DD-YY HH:MM:SS
  10.  
  11. This will cause CALLS to stop timing the event, rather than to continue the
  12. timing until a caller finally logs on.
  13.  
  14. This is no longer needed with PCBoard 15.x
  15.  
  16. *---------------------------------------------------------------------------
  17. For the 'Average Event Program Times' report to contain anything to
  18. report on, you will need to send lines such as:
  19.  
  20.        Event: program name started at MM-DD-YY HH:MM:SS
  21.  
  22. where 'program name' is the name of any program or function you perform in
  23. your event. The keys here are the EVENT: at the front of the line which
  24. causes CALLS to recognize the line, the word STARTED which causes CALLS to
  25. first end the timing of any previous event and begin timing a new event
  26. which has a name of whatever text is between the 'EVENT: ' and ' STARTED'
  27. keywords, and finally the HH:MM portion of the line is picked up as the
  28. Time the previous event ended and the new event started. If any of these
  29. are not present, then CALLS will not function properly when generating this
  30. report
  31. .
  32. *---------------------------------------------------------------------------
  33. For the 'Languages Selected'  report to function, CALLS need to know
  34. which language was selected at logon. There is no provision in PCBoard to
  35. obtain this info but we can add it easy enough by placing Language Number
  36. in     Modem connect string
  37.         ie. Modem (1): CONNECT 2400
  38.     or Caller Number string
  39.         ie. Caller Number (1): 12345
  40.     or Security Level string
  41.         ie. Caller Security (1): 50
  42.  
  43.     This is accomplished by using MKTXT145 to modify the record for the
  44.     'Modem: @OPTEXT@' (rec no 590), 'Caller Number: @OPTEXT@' (rec no 591)
  45.     or 'Caller Security: @OPTEXT@' (rec no 592) and adding the text (n) to
  46.     the current text as shown above (where n is the language number, ie.
  47.     for your first language you add (1), for your second language PCBTEXT
  48.     file you add (2), etc...)
  49.  
  50. You must also setup PCBoard to include whichever entry you use in the CALLER
  51. log by using PCBSETUP and selecting the writing of the proper entry. If you
  52. use the Modem connect string, then local logons will not get counted which
  53. you may or may not desire. My preference would be the Caller Security since
  54. we need it anyways for other reports.
  55.  
  56. This no longer works with PCboard 15.x as all log entries come from the
  57. same PCBTEXT file regardless of language choice. You will need to add the
  58. (n) language number as the Last On (n): in the line described below.
  59.  
  60. *---------------------------------------------------------------------------
  61. For the 'Number of Calls by Security Level' or 'Hours Used by Security Level'
  62. reports to work, you MUST have the Caller Security entry written to the log
  63. by PCBoard.
  64. *---------------------------------------------------------------------------
  65. For the 'Last Called In' report to work, you must write entries in the form:
  66.  
  67.     Last On: MM-DD-YY (HH:MM)
  68.     or
  69.     Last On: MM-DD-YY (HH:MM) for nn Minute(s)
  70.     or
  71.     Last On: MM-DD-YY (HH:MM) for nn Minute(s) - #nnnn
  72.  
  73. to the CALLER log. CALLS recognizes the LAST ON: at the beginning of the line
  74. and then uses only the MM-DD-YY portion of the line so the rest is just filler.
  75. (I like to see the time, how long and how many calls have they made so I don't
  76. have to go view their USER file data to find out.
  77.  
  78. *---------------------------------------------------------------------------
  79. For the CALLER ID to work you will need to write that data to the CALLER log.
  80.  
  81. PCBoard 15.x takes care of this for you.
  82.  
  83. *---------------------------------------------------------------------------
  84. One special consideration is the timing of the Doors and recognizing what door
  85. the user is in. Normally this is no problem as PCBoard writes entries to the
  86. log when the User opens the door, and returns to the board. CALLS only scans
  87. for particular data on a few doors that is designed to generate a report for.
  88. It only scans for a specific door's data when it sees the Opened Door (name)
  89. entry, rather than to compare every line for the data (which would slow down
  90. the program). The only problem that shows up, is if you go from one Door to
  91. another Door without returning to PCBoard. You can, however, fix this problem
  92. by simply writing an entry to the log such as:
  93.  
  94.     Opened Door (VERIFY) at HH:MM Via InstaReg
  95.  
  96. This would cause CALLS to stop timing the InstaReg door and start timing
  97. PCBVerify. Also to start scanning the entries for PCBVerify specific data
  98. rather than to continue scanning for InstaReg specific data.
  99. *---------------------------------------------------------------------------
  100.