home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / BBS2DRAG.ZIP / PMSTR400.ZIP / POSTMSTR.DOC < prev    next >
Text File  |  1994-07-29  |  18KB  |  494 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                             PostMaster Version 4.0
  17.  
  18.                 -= For Wildcat! 4.00 and higher systems only =-
  19.       ** This program is compatible with all 4.XX versions of Wildcat! **
  20.  
  21.              Copyright (c) 1994 Joe Lemoine - All Rights Reserved.
  22.  
  23.                    Technical Support and the latest versions!
  24.  
  25.                      The NDE BBS  (504) 796-5860 (DATA)
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  PostMaster - An automatic message sending program for Wildcat! BBS systems.
  32.  ─────────────────────────────────────────────────────────────────────────────
  33.  
  34.  
  35.   Disclaimer
  36.  
  37.   The author hereby disclaims all warranties relating to this product,
  38.   whether express or implied, including without limitation any implied
  39.   warranties of merchantability or fitness for a particular purpose. The
  40.   author cannot and will not be liable for any special, incidental,
  41.   consequential, indirect or similar damages due to loss of data or any
  42.   other reason, even if the author or an authorized the author agent has
  43.   been advised of the possibility of such damages.  In no event shall the
  44.   liability for any damages ever exceed the price paid for the license to
  45.   use software, regardless of the form and/or extent of the claim.  The user
  46.   of this program bears all risk as to the quality and performance of the
  47.   software.
  48.  
  49.   Copyright
  50.  
  51.   Regardless of the method of marketing used, PostMaster is NOT in the
  52.   "Public Domain".  It is copyrighted by Joe Lemoine.
  53.  
  54.   License
  55.  
  56.   PostMaster is a Shareware product.  As such, it is made available to the
  57.   general computing public for evaluation.  Users are licensed to operate
  58.   PostMaster on their personal computers for the purpose of test and
  59.   evaluation on a trial basis for a limited trial period.  It is not
  60.   possible to reasonably define any definitive limits of a fair and
  61.   equitable time period for evaluation, therefore, it is left to the user's
  62.   decision as to its usefulness.  If the user decides the program is not of
  63.   sufficient merit to warrant purchase through registration with the author,
  64.   the program should be removed from their personal computer.  Otherwise, if
  65.   the program is deemed useful and is in regular use on the user's personal
  66.   computer system, registration with the author is required.
  67.  
  68.   Registration
  69.  
  70.   You may register PostMaster by sending the enclosed REGISTER.FRM along with
  71.   a check in the amount of $25.00 to Joe Lemoine at the address listed below:
  72.  
  73.  
  74.                       Joe Lemoine
  75.                       77088 Tantella Ranch Rd. #20
  76.                       Folsom, LA  70437
  77.  
  78.   Technical Support
  79.  
  80.   Comments and suggestions about PostMaster are welcome as well as any
  81.   comments or suggestions that you may have in terms of additional utilities
  82.   you would like to see written.  Please call The NDE BBS! at (504) 796-5860.
  83.   I can also be reached via Fidonet at 1:390/3, the Mustang Software Support
  84.   BBS, and Compuserve 72320,660.
  85.  
  86.  
  87.  
  88.  PostMaster - An automatic message sending program for Wildcat! BBS systems.
  89.  ─────────────────────────────────────────────────────────────────────────────
  90.  
  91.   What is PostMaster?
  92.  
  93.   The point of the program is the ability to send one message to one or more
  94.   callers from the DOS command line.  You start by creating a text file or
  95.   use one created for you by another program. Using any of the available
  96.   command line parameters you can send this message to callers by name,
  97.   security level, or using a merge file created by a program like WCPRO.
  98.   PostMaster will add the message(s) to the database very quickly.  I have
  99.   included some examples and suggested uses towards the end of this
  100.   documentation.
  101.  
  102.   How do I install PostMaster?
  103.  
  104.   Previous versions of PostMaster required that it be run from the Wildcat
  105.   home directory.  PostMaster supports the "WCHOME" environment variable
  106.   that so many other Wildcat utilities use.  If you want to run PostMaster
  107.   from any directory other than the Wildcat home directory, simply add the
  108.   following command to your AUTOEXEC.BAT or CAT.BAT files:
  109.  
  110.     SET WCHOME=C:\WC40
  111.  
  112.   Make sure and change the drive and directory to match your system.
  113.  
  114.   And that's all the configuration you need to do!
  115.  
  116.  
  117.   Operation
  118.  
  119.   PostMaster is fairly straight forward and most of the information you need
  120.   to run the program is in the help screen you can view by running the
  121.   program with no parameters or with /?.
  122.  
  123.   Multi-Node
  124.  
  125.   If you run a multi-node system you can safely use PostMaster while other
  126.   nodes are running since PostMaster uses the same file locking routines as
  127.   used by Wildcat!.  However, PostMaster REQUIRES the WCNODEID environment
  128.   variable to be set.
  129.  
  130.  
  131.  PostMaster - An automatic message sending program for Wildcat! BBS systems.
  132.  ─────────────────────────────────────────────────────────────────────────────
  133.  
  134.  
  135.   Feature List
  136.  
  137.   ■  Create a message from a text file and send from DOS command line.
  138.  
  139.   ■  Send one message to one or more callers including ALL users
  140.  
  141.   ■  Will use a merge list or allow you to specify a security level
  142.  
  143.   ■  Allows messages to be flagged as private or for a return receipt.
  144.  
  145.   ■  Checks and uses the conference settings for allow private, force private,
  146.      allow return receipt, allow attachments.
  147.  
  148.   ■  Will allow file attachments to multiple users.
  149.  
  150.   ■  Purges message of all control characters below #32
  151.  
  152.   ■  Sets the mail waiting flag for callers to whom the message is sent
  153.  
  154.   ■  Truncates message lines at 79 characters - does not word wrap.
  155.  
  156.   ■  Import a text file directly or an IMP file in the message database dir
  157.  
  158.   ■  Updates Quick Stats for Total messages and Today's messages.
  159.  
  160.  *■  Text files sized up to 64K can be imported.
  161.  
  162.   ■  Support for FidoNet Netmail addressing in both command line and
  163.      Merge list addressing.
  164.  
  165.   ■  Support for sending File Attaches and File Requests from your
  166.      NetMail conference in Wildcat along with the ability to set the
  167.      Crash, Hold, and Kill/Sent Immediate flags.
  168.  
  169.   ■  Built in support for sending a message to each new user to your bbs.
  170.  
  171.   ■  Maintains a log of all messages sent.
  172.  
  173.  
  174. [*]  New features for this version.
  175.  
  176.  
  177.   PostMaster - An automatic message sending program for Wildcat! BBS systems.
  178.   ─────────────────────────────────────────────────────────────────────────────
  179.  
  180.  
  181.   Command line switches
  182.  
  183.   Case is not important but each option must be separated by a space.
  184.  
  185.   /I:<text file>
  186.  
  187.   This is the only required switch except when sending NetMail File Attaches
  188.   or File Requests in which case it is not required.  All the others have
  189.   defaults or are not necessary to the functionality of the program.  The
  190.   import file must be an ASCii text file and can be in the current directory
  191.   or you may specify the name and path to it on the command line.  PostMaster
  192.   will read the file and extract control characters like the page feed and
  193.   bell characters.  If this filename has an extension of "IMP" PostMaster
  194.   will simply add the line <<filename.imp to the message.  It will not test
  195.   for the existence of this import file, it is your responsibility to place
  196.   the file in the proper message subdirectory.  If you use the IMP feature,
  197.   do not specify a path.
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.   PostMaster - An automatic message sending program for Wildcat! BBS systems.
  207.   ─────────────────────────────────────────────────────────────────────────────
  208.  
  209.  
  210.   @-CODES
  211.  
  212.   The text file can contain @-Codes that are supported by Wildcat. Post
  213.   Master will translate them into the appropriate text.
  214.  
  215.   The currently supported codes are as follows:
  216.  
  217.     System Codes
  218.  
  219.     @VER@.........Version Number
  220.     @BBS@.........Bulletin Board Name
  221.     @SYSOP@.......SysOp's Full Name
  222.     @TMSG@........Total Messages on System
  223.     @TUSER@.......Total number of Users
  224.     @TFILE@.......Totat Number of Files
  225.     @TCALLS@......Total Calls to System
  226.  
  227.     User Codes
  228.  
  229.     @USER@........Users Full Name
  230.     @FIRST@.......Users First Name
  231.     @PHONE@.......Users Phone Number
  232.     @FROM@........Users Location
  233.     @CPU@.........Users CPU type
  234.    *@BDATE@.......Users birth date
  235.     @CALLS@.......Users Calls to System
  236.    *@MEMO@........Users Memo Date
  237.     @SEC@.........Users Security Profile
  238.    *@SINCE@.......Users Date of First Login
  239.    *@LASTON@......Users Last Call Date/Time
  240.     @UPK@.........Users Upload K-Bytes
  241.     @UPS@.........Users Number of Uploads
  242.     @DOWNK@.......Users Download K-Bytes
  243.     @DOWNS@.......Users Number of Downloads
  244.     @MAXDL@.......Maximum DL's/day
  245.     @MAXDK@.......Maximum KB's/day
  246.    *@EXDATE@......Users Expiration Date
  247.  
  248. [*] - Items marked with an asterisk are formatted according to the form
  249.       specified in Makewild.
  250.  
  251.  
  252.   PostMaster - An automatic message sending program for Wildcat! BBS systems.
  253.   ─────────────────────────────────────────────────────────────────────────────
  254.  
  255.  
  256.   /M:<merge file>
  257.  
  258.   The merge file is a list of names to which you want the message sent.  This
  259.   list can be created with a number of programs, but must be an ASCii text
  260.   file and must have one name only on each line of the file.  ie:
  261.  
  262.   DONALD DUCK
  263.   BUGS BUNNY
  264.   PORKY PIG
  265.   JOE LEMOINE [1:390/3]
  266.  
  267.   PostMaster will read the merge file one line at a time and send a duplicate
  268.   message to each of the callers listed.  A FidoNet address can be included
  269.   within brackets AFTER the name of the addressee.  It will only be used for
  270.   setting the address field for messages posted in your Netmail conference.
  271.   It will be stripped and ignored when posting in a non-Netmail conference.
  272.  
  273.  
  274.   /L:<security name> OR <*>
  275.  
  276.   This parameter can be used to send a message to all callers matching
  277.   security level name.  If an asterisk (*) is entered instead of a security
  278.   level name, then PostMaster will send a message to ALL users on your
  279.   system.
  280.  
  281.  
  282.   /T:<message to>  DEFAULT = ALL
  283.  
  284.   Use this parameter to send a message to one caller, for instance, yourself.
  285.   This persons name does not need to be in the Wildcat! User database so you
  286.   can use PostMaster to send messages via ECHOmail conferences, but be
  287.   careful to follow the Networks rules in this area.
  288.  
  289.   To add the Fido address to a message being posted in a Netmail conference,
  290.   enclose the address information within brackets AFTER the name of the
  291.   addressee.  ie:
  292.  
  293.   /T:JOE LEMOINE [1:390/3]
  294.  
  295.   The address must be in the form of Zone:Net/Node - no error checking is
  296.   performed.
  297.  
  298.   See POWER USER NOTE below.
  299.  
  300.  
  301.   /F:<message from>  DEFAULT = SYSOP NAME FROM MAKEWILD
  302.  
  303.   Use this parameter to specify the sender of the message.  This caller does
  304.   not need to exist in your Wildcat! User database so you can use it to
  305.   send messages from "PostMaster"  and other non-human.
  306.  
  307.  
  308.  PostMaster - An automatic message sending program for Wildcat! BBS systems.
  309.  ─────────────────────────────────────────────────────────────────────────────
  310.  
  311.  
  312.       POWER USER NOTE
  313.  
  314.       /T:DOOR OR /F:DOOR
  315.  
  316.       When using either the /T or /F parameter in a door batch file you can
  317.       use the key word DOOR as in /T:DOOR to send the message to the person
  318.       in the door at the time.  Example uses would include sending a
  319.       WELCOME.MSG to a caller who has passed your call back verification or
  320.       sending a message to yourself after someone enters a certain door so
  321.       you can monitor it's usage.
  322.  
  323.       /T:NEW OR /F:NEW
  324.  
  325.       Another extremely useful key word is NEW - as in /T:NEW.  This keyword
  326.       instructs PostMaster to send a message to a user in a door but only if
  327.       this is their first call.  Now you can send a message to each new user
  328.       of your system simply by using the LOGIN1.BAT file to run PostMaster.
  329.       Check the example section at the end of this file for an example
  330.       that demonstrates how to send a message to each new user on their first
  331.       call.
  332.  
  333.  
  334.   /S:<message subject>  DEFAULT = Message from PostMaster
  335.  
  336.   Use this parameter to change the default message subject.
  337.  
  338.       POWER USER NOTE
  339.  
  340.       This field is also used for specifying filename(s) when sending FidoNet
  341.       File Attaches or File Requests.  Wildcards are accepted but no error
  342.       checking is performed so make sure the files exist and your spelling is
  343.       correct.
  344.  
  345.   /A:<attached file>
  346.  
  347.   Enter the complete path and filename of the file you want attached and Post
  348.   Master will copy it to your Wildcat! attach directory and give it a unique
  349.   filename.  Be aware that if you send the same file to more than one caller,
  350.   you will have one copy of the attached file for message PostMaster creates.
  351.   PostMaster will NOT monitor your disk space.
  352.  
  353.   This switch is NOT compatible with Fido style File Attaches or Requests.
  354.   You must use the /S switch to indicate filespecs when attaching or
  355.   requesting files from other FidoNet systems from your Netmail conference.
  356.  
  357.  
  358.   PostMaster - An automatic message sending program for Wildcat! BBS systems.
  359.   ─────────────────────────────────────────────────────────────────────────────
  360.  
  361.   /G:<PCHDFRKI>
  362.  
  363.   Use this parameter to indicate the flags you want set for messages
  364.   posted in your Netmail conference.  Please note that you must first
  365.   "SCAN" out messages that are posted in your netmail conference with your
  366.   mail tosser before your front end software will send them.
  367.  
  368.      P - Mark the message as Private.
  369.      C - Mark the message with Crash mail priority.
  370.      H - Mark the message as Hold to be picked up by the addressee.
  371.      F - Indicate that the Filespec contained in the Subject field of the
  372.          message is to be sent along with the message as a File Attach.
  373.      R - Indicate that the Filespec contained in the Subject field of the
  374.          message is to be requested (FREQued) from the addressee system when
  375.          this message is delivered.
  376.      K - Indicate to your mailer software that the message is to be deleted
  377.          from your *.MSG message area once the message has been sent.  The
  378.          message will not be deleted from your Wildcat Netmail conference.
  379.  
  380.   /P - Private
  381.  
  382.   Use this parameter to change the message to a private message.  This will be
  383.   overridden by any conference specific parameter you might have set.
  384.  
  385.   /R - Return Receipt
  386.  
  387.   Use this parameter to toggle the return receipt flag.  This will be
  388.   overridden by any conference specific parameter you might have set.
  389.  
  390.   /C:<conference number>  DEFAULT = 0
  391.  
  392.   PostMaster will send messages to any established conference.  It defaults
  393.   to conference 0 as does Wildcat! itself, but it will NOT create a conference
  394.   database if one does not exist.
  395.  
  396.   If the /G:<flag> switch is used, PostMaster will automatically post the
  397.   message(s) in your Netmail conference. It will even override the
  398.   conference indicated by the /C:<conference> switch if it is present.
  399.  
  400.   /O - Override Conference Settings
  401.  
  402.   This switch gives PostMaster permission to ignore the conference
  403.   settings for allowing private messages, return receipts, and file
  404.   attachments.
  405.  
  406.  PostMaster - An automatic message sending program for Wildcat! BBS systems.
  407.   ─────────────────────────────────────────────────────────────────────────────
  408.  
  409.  
  410.   /X - Disable Tagline  [Registered version only]
  411.  
  412.   Disable's the PostMaster tag line to allow messages to keep that personal
  413.   touch.
  414.  
  415.  
  416.   /N:<new program name>
  417.  
  418.   If for any reason you wish to change the name of the executable file to
  419.   something else you will need to run PostMaster with this parameter once
  420.   after the name change.  You might want to change the name to PM.EXE, so you
  421.   would use the DOS rename command to do this and then run: PM /N:PM.EXE
  422.  
  423.   NOTE: PostMaster cannot be made READ ONLY or HIDDEN due to the way it
  424.   "clones" the registration information inside the EXE file.
  425.  
  426.  
  427.  
  428.   Suggested uses:
  429.  
  430.   Some of the uses I have discovered or have been told of for PostMaster are:
  431.  
  432.   ■ Send a message to yourself from your new user questionnaire
  433.  
  434.     POSTMSTR /i:c:\wc30\ques\quesnew.001 /t:your name /f:PostMaster /p
  435.  
  436.   ■ Send a message to new users on their first call to your system from the
  437.     LOGIN1.BAT file.
  438.  
  439.     POSTMSTR /f:your name /t:new /S:Welcome! /I:c:\wc30\welcome.txt /p
  440.  
  441.   ■ Send a new user letter to all new users with a membership letter and
  442.     registration file attached and a receipt back to you that they read it.
  443.  
  444.     POSTMSTR /i:welcome.imp /L:NEW USER /a:member.zip /p /r /s:Welcome!
  445.  
  446.   ■ Send the output of your nightly mail run to yourself
  447.  
  448.     POSTMSTR /i:c:\robo\robocomm.log /t:your name /f:PostMaster /p
  449.  
  450.   ■ Send a mass mailing to all "MEMBERS" about new features of you BBS
  451.  
  452.     POSTMSTR /i:member.msg /f:your name /m:member.lst /p  (by list)
  453.      or
  454.     POSTMSTR /i:member.msg /f:your name /l:member /p  (by security level)
  455.  
  456.   ■ Update registered users of a companies software of an update
  457.  
  458.     POSTMSTR /i:update.txt /m:register.lst /p /s:Release of PostMaster 2.1!
  459.  
  460.  
  461.   There are many more possibilities for you to discover.  Have fun!
  462.  
  463.  
  464.  
  465.  PostMaster - An automatic message sending program for Wildcat! BBS systems.
  466.  ─────────────────────────────────────────────────────────────────────────────
  467.  
  468.  
  469.   Acknowledgements
  470.  
  471.   PostMaster was written in Turbo Pascal v7.01 from Borland International
  472.   with additional help from Turbo Power Software in the use of their
  473.   outstanding Btree Filer and Object Professional libraries for Turbo Pascal.
  474.   I would also like to thank MSI since none of this would have been possible
  475.   without them and their excellent bulletin board program, Wildcat!.  And
  476.   lastly, Gwen Barnes who came up with the original idea for the program.
  477.  
  478.   PostMaster was originally developed by Dave Cody of Boardwalk Software.
  479.  
  480.   Thanks!
  481.  
  482.  
  483.   Other programs by Joe Lemoine
  484.  
  485.   WcEDIT!     - Offline Message Reader/User editor for Wildcat sysops.
  486.  
  487.   WCToday     - The Original Who Called Today for Wildcat!
  488.  
  489.   AFTCALL     - Combination of 3 utilities in one for Front Door/Wildcat
  490.                 Sysops.
  491.  
  492.   ADDTIME     - Give additional time to users during off-peak periods.
  493.  
  494.