home *** CD-ROM | disk | FTP | other *** search
/ synchro.net / synchro.net.tar / synchro.net / modem.madness / SMMNETML / MSGALRT2.ZIP / MSGS.DOC < prev    next >
Encoding:
Text File  |  1991-10-21  |  6.7 KB  |  130 lines
  1.  
  2. PCBOARD is a registered trademark of Clark Development Company, Inc.
  3.  
  4. *:::::::::::::::::::::::::::[ DISCLAIMER ]:::::::::::::::::::::::::::::::::*
  5.  
  6. MSGS.EXE by Bill Shields is released to public domain.
  7.  
  8. MSGS.EXE is provided AS IS without any warranty,  expressed or implied.
  9. This  includes  without  limitation  the  fitfulness  to  a particular
  10. purpose or application and any warranties of merchantability.  While I tried
  11. to be as thorough as  possible while  debugging MSGS.EXE, I shall  not  be
  12. liable for any damages, whether direct, indirect, special,  or  consequential
  13. arising  from a failure of MSGS.EXE to operate in a manner desired by the
  14. user. I shall  not be  liable for  any damage to data or property which may
  15. by caused directly or indirectly  by use of MSGS.EXE.
  16.  
  17. In no event will I be liable to you for any damages, including any lost
  18. profits, lost savings or  other incidental or consequential  damages arising
  19. out of your use or inability to use the program, or for any claim by any
  20. other party.
  21.  
  22. =========================[ BETA TEST VERSION ]==============================
  23. NOTE: If you have problems with this program please let me know on the
  24.       SALT AIR.  PD does not mean it's not supported.
  25. =========================[ BETA TEST VERSION ]==============================
  26.  
  27.  
  28. MESSAGE ALERT PROGRAM FOR PCBOARD 
  29. =================================
  30.     Ver: 1.1
  31.   Usage: MSGS [/N]
  32. Purpose: Allows you to send messages, addressed to specific individuals, to 
  33. the printer or conference during event or logoff (assuming $$LOGOFF.BAT 
  34. exist).
  35.  
  36. The /N switch will force MSGS.EXE to use file locks allowing it to work in a 
  37. multi-node environment.  By default there is a 30 seconds retry on file locks 
  38. (this should be adequate to wait out the slowest message base utility which 
  39. may have the message base locked).  
  40.  
  41. The nature of this program lends itself to a Multi-tasking environment 
  42. without having to install it on every node.  It is designed to be installed 
  43. on "only" one node.  When a person logs off of the node it is installed on 
  44. (assuming executing from $$LOGOFF.BAT) it will collect and process all 
  45. applicable conference mail.  Mail processed on other nodes will not be 
  46. processed until the node the program is installed on is exited by a user 
  47. (thus you want to install it on your most active node).  A version will be 
  48. released in the future that will allow this program to be installed on every 
  49. node.  If you attempt to run this program from each node it will work but you 
  50. will have messages duplicated each mail run (since each node would maintain 
  51. its own message pointers).
  52.  
  53. You must first create a MSGALRT.USR file (or edit the one in this package). 
  54. An example MSGALRT.USR file follows:
  55.  
  56. ----------------------------[ MSGALRT.USR ]----------------------------------
  57. 3
  58. 0 1  SYSOP                              3    4
  59. 1 2  BILL SHIELDS                  10   8    8
  60. 1 2  PETE AUSTIN                   2    1899 1902
  61. ·─·──┼────────┼────────┼────────┼────────┼────────┼────────┼────────┼
  62.           1         2         3         4         5         6         7
  63. 0123456789012345678901234567890123456789012345678901234567890123456789012345
  64. ────────────────────────────────────────────────────────────────────────────
  65.  
  66. NOTES:
  67.  
  68. 1. Only the number of lines specified by row 1 is read into system.  For 
  69. example in this MSGALRT.USR file everything under PETE AUSTIN is ignored.
  70.  
  71. 2. Because this program is in beta test, no messages will be deleted for
  72. the active status=2 option.  Soon as I get the go-ahead (from my beta tester) 
  73. that it works as advertised this will be a configurable option (to delete or
  74. not delete (that is the question-grin)).  
  75.  
  76. 3. First Row designates number of names to process.  In our example we have
  77. three names.  This is needed because I am using a dynamically allocated array
  78. for the above individuals data. This will allow you to add as many names as 
  79. you wish to the listing, be sure to have this value consistent with the 
  80. number of names in your MSGALRT.USR.
  81.  
  82. 4. There will be a configuration program (eventually) that will create this
  83. Configuration file.
  84.  
  85. COL        DESCRIPTION
  86. ~~~~      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  87.  0 ...... Print Private Mail.  
  88.           '0' only message header is printed for private mail.
  89.           '1' print private mail (header and text).
  90.  2 ...... Active status.  Valid status codes follow:
  91.           '0' Inactive user (messages will not be processed for this individual)
  92.           '1' Active user (messages are processed for printer output).
  93.           '2' Active user (message copied to the conference specified at col 35.)
  94.  5 ...... Name of person you wish to have mail printed or message copied for.
  95. 35 ...... Conference to place messages in for individual specified on col
  96.           5 (active status = 2 only).
  97. 40 ...... Conference to start at for this individual.
  98. 45 ...... Conference to stop at for this individual.
  99. --------------------------------[ EOF ]---------------------------------------
  100.  
  101. Once the MSGALRT.USR file is complete you are just about done.  You'll need 
  102. to type in MSGS while in the directory that your PCBOARD.DAT file resides.  
  103. MSGS.EXE will read in the CNAMES.@@@ file and create a MSGALRT.NDX file with 
  104. message pointers for each conference.  The first time the program is executed 
  105. message pointers will be set to the last message.  All future messages 
  106. entered on the system will be sent to printer/conference if the individuals 
  107. they are addressed to are in the MSGSALRT.USR file and the messages are 
  108. within the range of conferences specified.
  109.  
  110. When the MSGS.EXE program is next executed it will search each specified 
  111. message base (very quickly I might add) from the current message pointer to 
  112. last message.  It will then set the message pointer to point to the last 
  113. message.
  114.  
  115. It should be noted that should the program abort (error exit) for any reason 
  116. (i.e., couldn't find a MSGS, MSGS.NDX) pointers will not be saved to disk 
  117. (indirectly restoring them to where they were prior to the program execution.  
  118. This does not apply to PRINTER errors, PRNERR.BAT will be executed upon a 
  119. printer error and program execution will continue.
  120.  
  121. PRNERR.BAT will be executed (if it exist) when printer errors are 
  122. encountered.  Using a utility, such as CALLERUP.EXE, you can let yourself 
  123. know by bulletin or CALLERS log that a printer error occurred.
  124.  
  125. P.S.  PD does not mean it's not supported.  If you encounter problems with 
  126. this program OR have ideas for improvement by all means drop me message on 
  127. the SALTAIR.  Time permitting I will update/fix as required, personal pride 
  128. will ensure a timely repair on 'critters' found crawling in the program.
  129.  
  130.