home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / audio / samples / pager1_0.lha / Pager.doc
Encoding:
Text File  |  1992-07-27  |  4.4 KB  |  123 lines
  1.                                 Pager v1.0
  2.  
  3.                                     by
  4.  
  5.                              Tom H. Warkentin
  6.                             Copyright (C) 1992
  7.  
  8.  
  9. DESCRIPTION
  10.  
  11.     Pager is a supplement to the chat module and batch files supplied by
  12. Telepro Technologies for DLG.  It is flexible in changing the chat feature
  13. available to your users.  Here's a list of features available:
  14.  
  15.     o    config file allows SysOp to place text files in any directory
  16.     o    displays the duration of a chat in minutes and seconds upon exit
  17.     o    logs chat attempts to the SysOp's Event.log file
  18.     o    asks the user for a reason for the chat
  19.     o    SysOp can force the user to be more specific in giving a reason for
  20.         the chat
  21.     o    allows SysOp to configure an availability schedule
  22.  
  23.  
  24. INSTALLATION
  25.  
  26.     As you've guessed by now, this module was written for DLG and has not
  27. been tested on any other system.  Uncompress the archive using the -x
  28. option to preserve the path names.  The files have been placed in their
  29. best suited directories according to my setup.  Before using the -c option,
  30. you will have to update the config file or the results could be
  31. unpredictable!  The config file ("Pager.cfg") *MUST* be placed in
  32. "DLGConfig:Misc/" for Pager to function properly.  All other files can be
  33. placed wherever you want as long as the config file reflects the changes.
  34.  
  35.  
  36. IMPORTANT
  37.  
  38.     If you do find this software useful, I ask you to send me a small fee
  39. ($3-$5 CAN or US) to encourage me to write more useful tools.  I will
  40. listen more carefully to those people who have contributed as far as
  41. changes go.  Also, those who send in a small fee will receive the newest
  42. updates.  This software is freely distributable so long as no files are
  43. added or removed from the original archive, no modifications are made to
  44. any of the files, and no profit is made by distributing the archive.
  45.  
  46.  
  47. USAGE
  48.  
  49.     Pager will detect errors on the command line.  So if you're having
  50. difficulties just type the executable in a shell and it will prompt you
  51. with the following.
  52.  
  53.     Pager "%NAME" [-c] [-d] [-e] [-l length] [-r] [-t]
  54.  
  55.   Options:
  56.     -c             => use config file instead of defaults
  57.     -d             => print duration of chat
  58.     -e             => log reason to SysOp's Event.log file
  59.                       (config file must be enabled)
  60.     -l length      => minimum char length for reason (min=1, max=60)
  61.     -r             => ask user for a reason before paging
  62.     -t             => use time schedule (if no config file
  63.                       specified, defaults will be used!)
  64.  
  65. The order of the options is immaterial.  My current setup has the following
  66. command line entry in the main menu:
  67.  
  68.     DLG:Pager "%NAME" -c -d -e -l 10 -r -t
  69.  
  70. Make sure the type is set to EXECUTABLE and the load type is set to OVERLAY.
  71.  
  72.  
  73. CONFIG FILE
  74.  
  75.     The format of the config file is crucial to the operation of Pager.
  76. Full pathnames must be given.  The format of the text files is governed by
  77. DF supplied by Telepro.  
  78.  
  79. DLGConfig:Text/Pager/Abort.txt        => shown if the user aborts
  80. DLGConfig:Text/Pager/Busy.txt            => shown if the SysOp is not available
  81.                                                     according to schedule
  82. DLGConfig:Text/Pager/Denied.txt        => shown if the SysOp ignores the chat
  83. DLGConfig:Text/Pager/Paging.txt        => shown just before invoking chat
  84. DLGConfig:Text/Pager/Reason.txt        => shown when asking for a reason
  85. DLGConfig:Text/Pager/Resume.txt        => shown after a successful chat
  86. UNDERSCORED_SYSOP_NAME                    => change this to your name
  87. 1 1 1 1 0 0 0 0 0 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
  88.  
  89. \_____________________________________________/
  90.  
  91. These numbers denote the SysOp's schedule starting with midnight (0 hrs) on
  92. the left and ending with 11pm (23 hrs) on the right.  A '1' indicates you are
  93. available whereas a '0' indicates you should not be bothered.  The numbers
  94. must be separated by white spaces.  Also, there cannot be any blank lines
  95. in the config file as the documentation suggests.  If the -c option is not
  96. used, all text files are assumed to be in "DLGConfig:Text/" by the above
  97. names.
  98.  
  99.  
  100. DISCLAIMER
  101.  
  102.     This software comes with no guarantee.  I will *NOT* be held responsible
  103. for any losses incurred by the use of this program.  USE IT AT YOUR OWN
  104. RISK!  If you do find a problem with the software, I'd appreciate knowing
  105. about it so I can fix it!
  106.  
  107.     You can reach me by sending email to:
  108.  
  109.         tom@manning.cs.ualberta.ca
  110.  
  111.     or calling:
  112.  
  113.         The Spectre BBS (still 2400)
  114.         (403) 435-9486
  115.         Edmonton, AB
  116.  
  117.     or sending snail mail to:
  118.  
  119.         Tom H. Warkentin
  120.         1016 Buchanan Place
  121.         Edmonton, AB
  122.         T6R 2A7
  123.