home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / CL15S1G.ZIP / LASTON13.ZIP / LASTON.DOC < prev    next >
Text File  |  1994-02-03  |  10KB  |  216 lines
  1.   *****************************************************************
  2.   *                                                               *
  3.   *                         LASTON V 1.30                         *
  4.   *                                                               *
  5.   *                    Written in PPL for PCBoard                 *
  6.   *                                                               *
  7.   *                    Designed By:  Gary Meeker                  *
  8.   *                                                               *
  9.   *                    Began development: 04-01-93                *
  10.   *                                                               *
  11.   *****************************************************************
  12.  
  13. 1.00 (05-01-93) - Initial Release.
  14. 1.10 (05-27-93) - 2nd Release, added Log PCBTEXT switch to .CFG file.
  15. 1.20 (01-10-94) - 3rd Release, added AutoJoin feature.
  16. 1.30 (02-03-94) - 4th Release, added lower case switch to disable Modem/CID
  17.  
  18. The purpose of LASTON.PPE is to write the line:
  19.  
  20.       Last on: MM-DD-YY (HH:MM) for n Minute(s) - #nnnn
  21.  
  22. This replaces the need for running CL-PRINT in $$LOGON.BAT like:
  23.  
  24. CL-Print MAIN\CALLER%PCBNODE% /Q,/Z,/S,"Last on: @D (@T) for @M Minute(s) - #@#"
  25.  
  26. This writes the following to the CALLER file:
  27.  
  28.       Last on: MM-DD-YY (HH:MM) for nn Minute(s) - #nnnn
  29.  
  30. That has worked quite nicely for sometime except in the case of a 'closed'
  31. board call on a private node or a PASSWORD FAILURE call as in both cases
  32. $$LOGON.BAT never gets run.
  33.  
  34. Now with PPL and this PPE entry you can let PCBoard write the line.
  35.  
  36. Install as follows:
  37.  
  38.    Name/Loc of Logon  Script Quest.  : C:\PCB\PPE\LASTON.PPE
  39.  
  40. If you have a script for this already then add this line to the script itself
  41. instead. If you already have a .PPE script then create a text script file
  42. listing LASTON.PPE then the origional.
  43.  
  44. That takes care of most callers but just like the above cases, LASTON.PPE
  45. won't get run. To fix that place a call to LASTON.PPE in your 'closed' file:
  46.  
  47.    Name/Loc of CLOSED File           : C:\PCB\GEN\CLOSED
  48.  
  49. and in a text file that replaces prompt 595 such as follows:
  50. ╒══════════════════════════════════════════════════════════════════════════════╕
  51. │   Record No.:  595          Record Length:  40        Justification:  Left   │
  52. ├──────────────────────────────────────────────────────────────────────────────┤
  53. │Did you forget your password?                                                 │
  54. │%C:\PCB\PR\FORGOTPW                                                           │
  55. ╘══════════════════════════════════════════════════════════════════════════════╛
  56.  
  57. The first line in my FORGOTPW file reads:
  58.  
  59. !C:\PCB\PPE\LASTON.PPE F
  60.  
  61. the 'F' is used to cause LASTON.PPE to print the line 'Did you forget your
  62. password?' to the User (provided an entry in the LASTON.CFG file exists with
  63. that text). If you don't want it to print anything, just make the character
  64. anything you want and don't place a line in the LASTON.CFG file starting
  65. with that character.
  66.  
  67. The first line in my CLOSED file reads:
  68.  
  69. !C:\PCB\PPE\LASTON.PPE -
  70.  
  71. Note: I have no line starting with '-' in my LASTON.CFG so LASTON.PPE does
  72. not print anything to the User for this.
  73.  
  74. Unfortunately at this time LASTON.PPE does not quite write the same line that
  75. CL-PRINT used to due to not having access to a variable containing the minutes
  76. spent on the last call, so it instead creates the line:
  77.  
  78.       Last on: MM-DD-YY (HH:MM) for 0 Minute(s) - #nnnn
  79.  
  80.       or
  81.  
  82.       Last on (l): MM-DD-YY (HH:MM) for 0 Minute(s) - #nnnn
  83.  
  84. which is close enough for me (for now anyways 8-). The 0 above will actually
  85. be a value if the User has called the same day and will represent the amount
  86. of accumulated time he has used for the day. For the Sysop it will always show
  87. 0 on all calls.
  88.  
  89. To get it to print the Language number the user chose at logon, as in the
  90. second format shown, create a configuration file named LASTON.CFG in the
  91. same directory as LASTON.PPE containing a line with the extensions of all
  92. your language choices seperated by ";" characters. ie.
  93.  
  94. .CUS;.STD;.NOV;.SOU;.MOE;.WHO;
  95.  
  96. This contains my 7 language choices. Note the "." must be included in each
  97. extension (except the blank one) and my 7th choice is blank. If your 1st
  98. choice is PCBTEXT with no extension your list may look like this (assuming
  99. 5 languages as follows):
  100.  
  101. ;.FRE;.GER;.SPA;.DUT
  102.  
  103. If the first line in LASTON.CFG is blank the the language number will not be
  104. included in the Log entry and will take the first syntax shown above.
  105.  
  106. The second line of LASTON.CFG contains three flags to control the printing of
  107. lines in the log (seperated by ";") where a 1 means print the line and a
  108. 0 means don't print the line. The flags are as follows:
  109.  
  110. Log Last On; Log Modem/CID info; Log Caller Security; Log PCBTEXT Line; AutoJoin
  111.  
  112. Example:
  113.  
  114. 1;1;1;1;27
  115.  
  116. Log Last On controls whether the 'Last On:' information gets written to the
  117. log when called with any command line parameter.
  118.  
  119. Log Modem/CID info controls whether 'Modem:' and 'CID:' lines get written to
  120. the log.
  121.  
  122. Log Caller Security controls whether a 'Caller Security:' line gets written
  123. to the log.
  124.  
  125. Log PCBTEXT Line controls whether the Line replaced in a PCBTEXT file and now
  126. contained in the .CFG file should also be written to the log. PCBoard will be
  127. writing the line in the PCBTEXT. (system) file out to the log also, but it
  128. will be the name of the .PPE file if you also replace the PCBTEXT. file entry.
  129. If you wish to allow your User to choose the language that corresponds to your
  130. 'System' PCBTEXT file then you have to put up with it, but setting this flag
  131. to on will at least let you now what line was meant to be logged. In my case,
  132. I didn't change the PCBTEXT. (system) file but only the PCBTEXT.XXX files. I
  133. added an addtional language with no descriptive text in the 'LANGUAGE' column
  134. to be the system file and as a result the Users sees an extra line feed but
  135. unless they guess at it, they don't realize there is an 'un-numbered' language
  136. choice they could make. It would be nice if PCBoard didn't have to have the
  137. system file listed in the PCBML.DAT file but I understand that it is needed,
  138. and this works for me.
  139.  
  140. AutoJoin is the position of the confernece number in the User Comment field
  141. that contains the conference the User wishes to join on each log on. Valid
  142. numbers are 1 to 27 and the field is 4 characters long. If left blank or
  143. set to zero then the feature will not be used. If used the the User will be
  144. placed in the conference unless he is not registered.
  145.  
  146. Caller Number: is not needed since if a user does not get logged on for any
  147. of the reasons that we want to write the lines to the log, the Caller Number
  148. would be Zero anyways (a 'feature' we can use to our advantage).
  149.  
  150. I have run into a couple of situations where I still fail to get the entry in
  151. the caller log, like when a caller drops carrier after entering their name
  152. and before entering their password (correctly). And the use of LASTON.PPE can
  153. NOT correct all those situations.
  154.  
  155. All lines in LASTON.CFG starting with line 3 are PCBTEXT replacements preceeded
  156. by a control character. The control character will be compared with the command
  157. line used to execute LASTON.PPE and when a match is found the Text on the line
  158. (starting with the character after the control character) will be displayed to
  159. the User. IF the control character is lower case then the MODEM/CID lines will
  160. not be written to the log.
  161.  
  162. Example Config File:
  163. -------------------------------------------------------------------------------
  164. .CUS;.STD;.NOV;.SOU;.MOE;.WHO;
  165. 1;1;1;1;27
  166. fDid you forget your password?
  167. TTime Limit Exceeded.
  168. EAccess Denied - Upcoming Event Pending ...
  169. UAccess Denied - Unauthorized name match on @USER@!
  170. LAccess Denied - You are Locked Out of this System!
  171. RAccess Denied - Refused to Complete Registration!
  172. AAccess Denied - @USER@ is in use on another Node!
  173. -------------------------------------------------------------------------------
  174.  
  175. You would then replace the PCBTEXT entries (3,4,5,6,8 & 10) with
  176.  
  177. !C:\PCB\PPE\LASTON.PPE E
  178. !C:\PCB\PPE\LASTON.PPE T
  179. !C:\PCB\PPE\LASTON.PPE U
  180. !C:\PCB\PPE\LASTON.PPE L
  181. !C:\PCB\PPE\LASTON.PPE R
  182. !C:\PCB\PPE\LASTON.PPE A
  183.  
  184. This takes care of many of the cases that occur where information does not
  185. get logged by PCBoard normally. Since 'Time Limit Exceeded.' can get displayed
  186. to a User who is currently logged on (and PCBoard has already written all the
  187. entries to the log) and we don't want to print the lines again, The caller
  188. number is checked and if it's zero we log the lines, and if it's not zero we
  189. assume the lines should not be logged. If LASTON.PPE is executed with no
  190. command line parameter then the Last On line is logged regardless of the
  191. control flag in the Config file.
  192.  
  193. -------------------------------------------------------------------------------
  194. As mentioned,the only problem I could not fix was when a 'Carrier Lost ...'
  195. occurs. I tried installing the PPE in prompt #215, but since the caller is
  196. now gone, PCBoard only sends that to the local screen and .PPE's don't run
  197. (you actually see the name of the PPE on the screen).  I don't see anyway
  198. around this so unless something changes in the future in PCBoard itself,
  199. I won't be able to get my lines to print in this case. The two occurances of
  200. this that I would like to be able to address would be:
  201.  
  202. 1) A CONNECT is established but is lost before the User is able to enter their
  203.    name. All that shows up is 'Carrier lost ...' (unless like me you've added
  204.    (@SYSTIME@) to the end of the prompt in which case you also get (hh:mm)
  205.    added to the line. I'd like to see the Modem: and CID: lines printed, as
  206.    in the case of NO CONNECT / CAUSE messages which do include the CID: info)
  207.  
  208. 2) A User does log on, but looses carrier before the logon script runs (or
  209.    $$LOGON.BAT gets run). I would like to see the Modem:, CID:, Caller
  210.    Security: (and my Last On:) lines printed.
  211.  
  212.    If I can think of way to accomplish this, a new version will be released.
  213. -------------------------------------------------------------------------------
  214. Gary Meeker
  215. SHARP Technical Support Line BBS (404) 962-1788
  216.