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