home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / tsspager.zip / readme.1st < prev    next >
Text File  |  1995-06-30  |  7KB  |  156 lines
  1. The Super Sysop Pager, (c)(tm) 1995, Jon Hepburn.
  2. V1.03, 30 June 1995.  (all rights reserved)
  3.  
  4. The Super Sysop Pager is a fairly simple compiled REXX program which
  5. fully exploits Adept's powerful variables and packs in a host of other
  6. features which puts it well above other current offerings.  It uses the
  7. ERX format which means it can only be used on systems which have the
  8. Adeptsoft REXX module enhancement.
  9.  
  10. What can The Super Sysop Pager do?
  11.  
  12. 1.  Checks whether the sysop is available and, if not, refuses to page
  13.     and gives the user an option to leave a message rather than just
  14.     waiting for the paging sequence to end (even during normal paging
  15.     times).
  16.  
  17. 2.  Allows extended paging hours via a definable user security level.
  18.  
  19. 3.  Automatically displays the Sysops name.
  20.  
  21. 4.  Checks length of Sysops name and displays 1st name only, to avoid
  22.     character displacement, if necessary (see footnote).
  23.  
  24. 5.  Option to display Sysops first or full name (subject to no. 4).
  25.  
  26. 6.  Features a smart user interface with overlaid text prompts.
  27.  
  28. 7.  Allows page to be aborted with any keystroke.
  29.  
  30. 8.  Fully logs paging activity to both screen and independent text logs.
  31.  
  32. 9.  Has Sysop definable paging hours.
  33.  
  34. 10. Requires a chat reason or aborts page request.
  35.  
  36. 11. If message is requested, all message header details are completed
  37.     automatically for the user.
  38.  
  39. 12. Message area for feedback message is definable.
  40.  
  41. 13. Determines users graphic mode (ANSI/ASCII) and adjusts display
  42.     accordingly.
  43.  
  44. 14. Displays 'paging indicators' in real time mode (as against making
  45.     sound and then displaying paging indicators to users).
  46.  
  47. 15. And of course, has Sysop definable periods for page duration (in
  48.     seconds) for both standard and extended hours.
  49.  
  50. 16. Plus a few other things i've probably forgotten!
  51.  
  52. [Footnote]  The layout of the user prompts are such that if the Sysops
  53. name has more than 15 characters then some prompts/characters may be
  54. displaced. If the Sysops FULL name contains more than 15 characters then
  55. the program will automatically display his/her FIRST name only.
  56.  
  57. INSTALLATION AND USE:
  58. To install this utility just copy the TSSPAGER.ERX and TSSPAGER.SET files
  59. to your Adept directory and copy the following line to each of your menus
  60. from which you want to allow the user to page you.  Make sure the command
  61. letter used does not conflict with any others in use and that you modify
  62. the drive letter if needed.
  63.  
  64. Y ,10 ,tsspager,d:\adept\tsspager.erx,0
  65.  
  66. Open the tsspager.set file in an editor and edit the following entries to
  67. suit (defaults in brackets):-
  68.  
  69. Line 1  - (19.00) start time, in 24hr clock, for normal paging.
  70. Line 2  - (22.00) end time, in 24hr clock, for normal paging.
  71. Line 3  - (15) maximum # of seconds to page for during normal hours.
  72. Line 4  - (22.01) start time, in 24hr clock, for extended hours paging.
  73. Line 5  - (23.59) End time, in 24hr clock, for extended hours paging.
  74. Line 6  - (5) Maximum # of seconds to page for during extended hours.
  75. Line 7  - (50) Min security level to allow "no reason" paging at any time
  76. Line 8  - (20) Min security level to allow extended hours paging.
  77. Line 9  - (1) Message area number to place feedback messages
  78. Line 10 - (0) display full Sysop name, set to 1 to display 1st name only.
  79.  
  80. Most of the above is self explanatory but an explanation of lines 7 and 8
  81. may be beneficial.  I implemented these variables so that you can decide
  82. who has what paging privileges on your system.  Line 7 is the variable
  83. which allows paging at any time of the day.  It looks at the users
  84. security level 1 flag and allows anyone with an equal or higher security
  85. level to page.  The only time this is overidden is when the sysop is
  86. flagged as unavailable (no point paging then). I have this set to the
  87. same level as my co-sysops security level.
  88.  
  89. Line 8 is the variable which allows paging during extended hours and I
  90. have assigned this to my "donating" users.  It works as Line 7 does,
  91. albeit with a lower security level.
  92.  
  93. It is important that you maintain the TSSPAGER.SET file in the same
  94. format as above and do not add additional information.  The program
  95. checks the file and will report any errors but it's not infallible.
  96.  
  97. During use you will hear a brief warble once every second when the user
  98. is paging.  Simply press any key to stop the page and then use your mouse
  99. in the normal way to enter chat mode.  You can go straight to chat mode
  100. without pressing any key first but when chat mode is terminated a key
  101. must be pressed to stop the program continuing from where it left off.
  102.  
  103. A record of who has paged is recorded in two formats, and only after a
  104. reason has been entered.  This avoids logging users who activate the page
  105. function and then change their mind.  An entry is displayed in the recent
  106. events (screen) log and also in a TSSPAGER.LOG file.  The latter records
  107. the time, date, user and reason for paging.  This log is found in the
  108. adept directory and is automatically created if it doesn't exist.
  109.  
  110. KNOWN LIMITATIONS:
  111. At present, the definable paging times must be within the same 24 hour
  112. period (ie: not 22.00 to 02.00).  If either paging period crosses over
  113. midnight then the program will act strangely.  However, you can have
  114. normal paging hours set to stop at midnight and out of hours paging set
  115. to start at midnight.  I will be looking for ways to cure this problem in
  116. a future release.
  117.  
  118. The check sysop is available function is currently awaiting a bug fix by
  119. Steven. I have written the code but as of AdeptXBBS V0.97f, the bug had
  120. still not been fixed.
  121.  
  122. POSSIBLE FUTURE DEVELOPMENTS:
  123.         Midnight crossable (true 24 hour) selectable paging periods.
  124.         Maximum number of pages allowable.
  125.         Proper termination of program when chat mode called.
  126.  
  127. ACKNOWLEDGEMENTS:
  128. Julie Strietelmeier for her original pager script on which this program
  129. is (very) loosely based.
  130.  
  131. OWNERSHIP AND COPYRIGHT:
  132. This program belongs to me.  I am releasing it as shareware with a zero
  133. value, that is, I don't want nor expect payment.  If your feeling
  134. generous and want to send me some money then I won't stop you sending it.
  135. But what i'd really appreciate is comments and criticisms on a postcard
  136. and sent to...
  137.  
  138. Jon Hepburn
  139. P O Box 2485
  140. Maldon
  141. Essex
  142. CM9 7FZ
  143. United Kingdom.
  144.  
  145. or netmail to:  Galaxy-Ten BBS, +44 1621 850032, (2:257/88 Fidonet)
  146.  
  147. Galaxy10 - A leading source for AdeptXBBS files and resources in the UK
  148. and Europe.
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.