home *** CD-ROM | disk | FTP | other *** search
/ Hacker Chronicles 2 / HACKER2.BIN / 504.NEWMSG.DOC < prev    next >
Text File  |  1990-07-19  |  6KB  |  139 lines
  1.     How to use KJ4LQ New Message Printer V 6.0 (NEWMSG.EXE)   Page 1 of 3
  2.  
  3.     SYSOPS, here is a program I wrote to reduce the drudgery of daily
  4.     chores each of us must go through to keep the BBS running smoothly.
  5.     I am a lazy sort, and figured there must be a better way to keep
  6.     track of what is coming into the BBS than the list/read/list/read
  7.     ritual we all endure. NEWMSG.EXE will automatically send EVERY new
  8.     message entering the PBBS to LPT1 for immediate printing, or to a
  9.     user specified file for printing at a later time. It does this once
  10.     every hour, at the time you specify. What it won't do is give you
  11.     "TO FROM @ SUBJECT BID", unless it is included in the message proper;
  12.     but it still has cut my keyboard time down to zilch! If I see some-
  13.     thing "improper" on the printout, then I sign-on and browse around
  14.     the BBS. I have gone days without signing-on since I started using
  15.     NEWMSG; I just drop by the printer and zip off the messages that have
  16.     arrived since last time I dropped by, skim through them, and then go
  17.     back to whatever it was the XYL had me doing in the first place!
  18.  
  19.     KJ4LQ New Message Printer V6.0 can be used with any BBS that
  20.     stores messages in files with the format n - nnnnn or n.xxx -
  21.     nnnnn.xxx (where n is a number from 0 through 9). If the message
  22.     text file uses an extension, i.e., nnnnn.MAI, etc., then the /E:xxx
  23.     switch must be used (see below). It is free to all to use, at your
  24.     own risk. It has been uploaded to various Landline Ham BBS's as
  25.     "NEWMSGV6.ZIP", with the following files included:
  26.  
  27.         o NEWMSG.EXE    (The program)
  28.         o NM-PIF.DVP    (The DESQVIEW (tm) window [NEWMSG])
  29.         o NEWMSG.DAT    (The next message pointer)
  30.         o NEWMSG.DOC    (This file)
  31.         o CHANGE.DOC    (Changes between version 2.00 and 6.00)
  32.  
  33.     To install this program under DESQVIEW (tm), do the following steps:
  34.  
  35.         1) Copy NEWMSG.EXE into an executable files directory, i.e.
  36.            C:\DOS, D:\DV, C:\BIN, or wherever you put such things.
  37.  
  38.         2) Make sure the "SET PATH = " command in AUTOEXEC.BAT
  39.            includes the directory used in STEP 1.
  40.  
  41.         3) Copy NM-PIF.DVP into the DESQVIEW (tm) directory, whatever
  42.            you have named it, then under DV, use the AP, O/ther
  43.            commands to install it. Now, use the CP, NM commands to
  44.            edit the DV setup to suit you application. The program
  45.            needs 50 KB window space; and all that need be done to
  46.            the included NM-PIF.DVP file is change the drive where
  47.            \BBS directory is located, i.e., change D:\BBS to C:\BBS,
  48.            if that is where your \BBS directory is.
  49.  
  50.         4) To prepare for the first run, you need to create a file
  51.            in the \BBS directory called NEWMSG.DAT. This file
  52.            contains one record, which is the MESSAGE NUMBER of the
  53.            next message to print. Issue the following DOS commands
  54.            (this example is for D: drive):
  55.  
  56.             d:
  57.             cd \bbs
  58.             copy con newmsg.dat
  59.             nnnnn <enter>        (nnnnn is last message on your BBS)
  60.             <control-z>
  61.                                 Page 2 of 3
  62.  
  63.     There are seven valid command line switches available in version 6.0
  64.     that may be used with NEWMSG. The switches are not case sensitive,
  65.     and can be used in any combination. NM-PIF.DVP has samples of these
  66.     switches, used at KJ4LQ BBS. The switches are optional, and the
  67.     defaults take effect if not used:
  68.  
  69.     /E:xxx  (xxx = message file extension) Example: If your PBBS software
  70.         uses the format 12345.DAT to store message text, then use
  71.         "/E:dat" switch for proper operation. (default = no extension)
  72.  
  73.     /F     (use form feeds between messages, default = no form feeds)
  74.  
  75.     /H    (print headers along with message text, default = none)
  76.  
  77.     /H2    (print first and last headers, but NO others, default = none)
  78.  
  79.     /M:nn    (where nn is the minute of the hour to print new messages,
  80.         default = 00)
  81.  
  82.     /O:{drive}{path}[filename] (Redirect output to the named file. Useful
  83.             if you don't want to print while away from the equipment.)
  84.         WARNING: This MUST be last switch on the command line!
  85.  
  86.     /S    (disables internal timers and screen output for operation
  87.         under the control of a parent server program)
  88.  
  89.     NEWMSG is now ready to go to work for you! Open your BBS windows as
  90.     normal, then open NEWMSG window. The copyright message will appear,
  91.     and NEWMSG will cycle immediately, printing any new messages, then go
  92.     into the "waiting" mode. There are two commands available to the SYSOP
  93.     while the program is idle, as follows:
  94.  
  95.     <control + f>    Force a print cycle. NOTE: A regular timed print
  96.             cycle will always leave the latest message unprinted
  97.             because that message may still be in transit to the
  98.             BBS. Forcing a print cycle will print the last
  99.             message, regardless of whether it is complete or not,
  100.             however, it will again be printed at the next timed
  101.             cycle (if the next message has arrived), or at any
  102.             forced cycle where it is still the latest message.
  103.  
  104.     <esc>        Exit to DOS (Close window)
  105.                                 Page 3 of 3
  106.  
  107.     USING NEWMSG UNDER SERVER CONTROL - The following steps are written
  108.     for W0RLI ver. 11.xx users; other BBS systems may handle servers
  109.     differently:
  110.  
  111.     1) If you have never used the W0RLI server routines, PLEASE READ
  112.        Hank's documentation, as the following steps assume you are
  113.        familiar!
  114.     2) Set window size for SERVER.EXE to 144 K minimum.
  115.     3) In SERVER.MB, add the line: ! {drive}{path}nm.bat
  116.     4) In your executable files directory, create the file NM.BAT with
  117.        the following text:
  118.         newmsg /S [/switch2][/switch3]...
  119.        (Note the /S switch MUST be specified to disable all internal
  120.         keyboard, timer, and screen functions. All other switches may
  121.         be used as described earlier.)
  122.  
  123.     NEWMSG will now run at every server cycle, which you have specified
  124.     in INIT.MB .
  125.  
  126.     DISCLAIMER: This program is simplistic in nature, and little error
  127.          trapping has been included to recover from YOUR mistakes!
  128.          If an unexpected error occurs, the program will terminate,
  129.          and send an error message to the console. It is advised
  130.          that you SET YOUR BBS SO IT DOES NOT DO AN AUTOMATIC DAILY
  131.          CLEAN-UP, as some messages may be deleted before they are
  132.          printed!!! Best way to handle a clean-up is to first, force
  133.          a print cycle first using <CTRL + f>, then do a clean-up. If
  134.          you goof, just edit NEWMSG.DAT to reflect the next message
  135.          number you wish to print.
  136.  
  137.     Send queries, suggestions, etc., to KJ4LQ @ KJ4LQ.VA.USA.NA, Ed Lowe,
  138.     449 Wittington Drive, Chesapeake, VA. 23320-7522         73!
  139.