home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 26 / CD_ASCQ_26_1295.iso / vrac / mred225.zip / MOREINFO.ZIP / PINGPONG.TXT < prev    next >
Text File  |  1995-05-11  |  12KB  |  327 lines
  1.  
  2.             DataEnter, Michael Kocum
  3.             Taborstrasse 27/23
  4.             A-1020 Vienna
  5.             AUSTRIA
  6.  
  7.         CIS: 70143,1667
  8.         MHS: MICHAEL @ DEMK (via CSERVE)
  9.    Internet: michael@demk.co.at
  10.         Fax: +43/1/2143829
  11.  
  12.  
  13.  
  14.  
  15.  
  16. Introduction to PingPong
  17. ------------------------
  18.  
  19. PingPong is a addon for Microsoft Mail and Windows for Workgroups.
  20.  
  21. Its purpose is to check if a link between two postoffices is up and
  22. running. PingPong generates messages to another PingPong or to a
  23. nonexisting mailbox and if it gets no response after a user defined
  24. time, it sends a message to the admin, indicating that the link may down.
  25.  
  26. Also it displays an information screen where the status of every
  27. checked postoffice is listened.
  28.  
  29.  
  30. System Requirements
  31. -------------------
  32.   DOS 3.3 or higher
  33.   Microsoft Mail, version 3.0
  34.  
  35.  
  36.  
  37. Installation
  38. ------------
  39.  
  40.    1) PingPong does in fact two things: In active mode it sends messages
  41.       to another postoffice and wait for the return. On return of the
  42.       message it will update the log files and mark the postoffice in
  43.       its status screen as up and running.
  44.  
  45.       If no message returns in the user defined time, PingPong send a
  46.       message to the PingPong admin, indication the the link may be
  47.       down.
  48.  
  49.       In passive mode it simply bounces back every message it get
  50.       without doing anything.
  51.  
  52.       PingPong need also a person which is responsible for the correct
  53.       working of PingPong. Any time PingPong detects an error, it sends
  54.       a message to this person. The address of this person give at the
  55.       command lime with the -t switch
  56.  
  57.    2) PingPong requires a single user mailbox on your Microsoft Mail
  58.       system in order to work with Microsoft Mail. You have to create
  59.       this mailbox before installing PingPong. On a Microsoft Mail
  60.       Postoffice this is done via ADMIN.EXE.
  61.  
  62.       PingPong need this mailbox for communcation with other Pingpong's
  63.       or non existing user it sends its messages over this mailbox.
  64.  
  65.       We suggest, that you use "PingPong" as the mailbox name and
  66.       "PingPong" as the alias.
  67.  
  68.       Note: No other person should use this mailbox!!! Do not use the
  69.             real Admin's mailbox for this purpose, because PingPong
  70.             seams to work, but in fact it does not work.
  71.  
  72.  
  73.    3) Create a directory on your server and copy PingPong.EXE,
  74.       APPGET.EXE and APPPUT.EXE into this directory. We suggest that you
  75.       make a directory called PingPong below your MAILEXE, so its clear
  76.       that PingPong belongs to MS Mail.
  77.  
  78.  
  79.    4) Start PingPong with the argument -c to configure it. You will get
  80.       a empty list. Press INS to create a new record and fill out the
  81.       fields for the postoffice you want to check.
  82.  
  83.       Note: The field "MailBox" depends on you configuration. When the
  84.       postoffice to check has PingPong in passive mode installed, type
  85.       the name of PingPong's mailbox in (usually PINGPONG). If no
  86.       passive PingPong is installed, you can use a nonexisting mailbox
  87.       like UNKNOWN or something. The POSTMASTER (a hidden mailbox on
  88.       every postoffice) will send PingPong a massage back, that the user
  89.       does not exist. PingPong now get's this message and knows that the
  90.       link is up and running, because POSTMASTER was able to send the
  91.       error message.
  92.  
  93.  
  94.          Network: The network you want to check
  95.  
  96.       Postoffice: The postoffice you want to check
  97.  
  98.          Mailbox: The mailbox of the passive PingPong
  99.                   or a nonexisting mailbox
  100.  
  101.            Activ: Should PingPong check this postoffice?
  102.                   This is useful if you wnat to disable the checking of
  103.                   a postoffice, but dont want to delete it, perhaps
  104.                   because you know the link will be down for several
  105.                   hours.
  106.  
  107.         Descrip.: Description for your information only
  108.  
  109.            Start: check this postoffice from <time>
  110.              End: check this postoffice to <time>
  111.            Every: Check this postoffice every ? minutes between START and
  112.                   END.
  113.  
  114.             Wait: Wait ? minutes for reply. When you start checking the
  115.                   postoffice use a high minute count (300 minutes or so)
  116.                   and lower it down when you get a successfull link
  117.                   until you have found a optimal setting. count
  118.  
  119.           Sunday: Check on Sunday?
  120.           Monday: Check on Monday?
  121.          Tuesday: Check on Tuesday?
  122.        Wednesday: Check on Wednesday?
  123.         Thursday: Check on Thursday?
  124.           Friday: Check on Friday?
  125.         Saturday: Check on Saturday?
  126.  
  127.  
  128.    5) Start PingPong and check if there is any error message.
  129.  
  130.    6) Choose you way of polling (see sectiong "Polling")
  131.  
  132.  
  133. Arguments in active mode
  134. ------------------------
  135.  
  136. When you want to use PingPong in activ mode use the following arguments:
  137.  
  138. -f<Mailbox>          Mailbox name
  139. -p<Password>         Mailbox password (default no password)
  140. -d<Drive>            Drive where MailData is located (default drive M)
  141.                      or full path to MailData with trailing backslash
  142.                      like M:\MAILDATA\
  143.  
  144. -a                   Active mode (send ping to a postoffice)
  145. -t<Dest>             Destination address in full Microsoft format
  146.                      for sending an error report
  147.  
  148.                      Note: The destination adress should be located on
  149.                      the same postoffice a the active PingPong, because
  150.                      due the down link there is perhaps no chance to
  151.                      transfer the message.
  152.  
  153.  
  154.  
  155.                      (Network/Postoffice/User)
  156. -l                   Write PingPong.Log file
  157. -n                   Ping now
  158.  
  159. Sample: PingPong -fPingPong -pPassword -dM -a -tNet/Post/Admin
  160.         PingPong -fPingPong -pPassword -dM:\MAILDATA\ -a -tNet/Post/Admin
  161.  
  162. Arguments in passive mode
  163. -------------------------
  164.  
  165. When you want to use PingPong in passive mode use the following arguments:
  166.  
  167. -f<Mailbox>          Mailbox name
  168. -p<Password>         Mailbox password (default no password)
  169. -d<Drive>            Drive where MailData is located (default drive M)
  170.                      or full path to MailData with trailing backslash
  171.                      like M:\MAILDATA\
  172.  
  173.  
  174. Sample: PingPong -fPingPong -pPassword -dM
  175.         PingPong -fPingPong -pPassword -dM:\MAILDATA\
  176.  
  177.  
  178.  
  179. Arguments in configuration mode
  180. -------------------------------
  181.  
  182. When you want to use PingPong in configuration mode use the following
  183. arguments:
  184.  
  185. -n                   Configuration mode
  186.  
  187. Arguments in show status mode
  188. -----------------------------
  189.  
  190. When you want to use PingPong in show status mode use the following
  191. arguments:
  192.  
  193. -s                   Show status mode
  194.  
  195.  
  196.  
  197.  
  198. Polling
  199. -------
  200.  
  201. In order to work, PingPong has to poll MS Mail for messages from time to
  202. time. This can be done in a lot of different ways:
  203.  
  204. 1) If you have Microsoft Mail Postoffice than you may have a maschine
  205.    which runs EXTERNAL.EXE. You can put PingPong in a loop with External
  206.    and so PingPong will be called periodic.
  207.  
  208.    A sample batch file may look like:
  209.  
  210.    @echo off
  211.    :Start
  212.  
  213.       REM Change to PingPong directory
  214.       cd PingPong
  215.  
  216.       REM Execute PingPong
  217.       PingPong -fPingPong -pPassword -dM -a -tNet/Post/Admin
  218.  
  219.       REM Change back to directory where External is located
  220.       cd ..
  221.  
  222.       REM Call External for 15 minutes
  223.       external -BR0:0:15
  224.  
  225.       REM Check Externals errorlevel to find out if the
  226.       REM operator pressed  ESC
  227.       if errorlevel 66 goto End
  228.       if errorlevel 63 goto Start
  229.       if errorlevel 62 goto End
  230.    :End
  231.  
  232.  
  233. 2) You can also run PingPong in the background of Windows. You can
  234.    request a special programm, MAILWAIT.EXE, for free for this porpose.
  235.    MailWait accepts one argument and this is the time to wait in
  236.    seconds. MailWait is designed so that it releases all recources to
  237.    Windows and runs smoothly in the background.
  238.    It's a good idea to
  239.    create an icon for the batch file
  240.  
  241.    A sample batch file may look like:
  242.  
  243.    @echo off
  244.    :Start
  245.       REM Execute PingPong
  246.       PingPong -fPingPong -pPassword -dM -a -tNet/Post/Admin
  247.  
  248.       REM Call MailWait for 900 seconds (= 15 minutes)
  249.       MailWait 900
  250.  
  251.       REM Check MailWaits errorlevel to find out if the
  252.       REM operator pressed  ESC
  253.       if errorlevel 1 goto End
  254.       goto Start
  255.    :End
  256.  
  257.    It's a good idea to create an icon for the batch file and put that
  258.    icon in your startup folder.
  259.  
  260.    Note: Make sure your _default.pif has background processing enabled
  261.          or PingPong will not work in the background. Optionally create
  262.          a extra PIF file for the batch file.
  263.  
  264.  
  265. Licensing Agreement
  266. -------------------
  267.  
  268.     PingPong (c) is copyrighted 1993-1995 by DataEnter, Michael Kocum,
  269.     portions (c) Microsoft Corp.
  270.  
  271.     This product and its documentation may not, in whole or in part, be
  272.     copied, reproduced, transmitted, transcribed, stored in a retrieval
  273.     system, or translated into any other natural or computer language, in
  274.     any form or by any means whatsoever, be it electronic, mechanical,
  275.     magnetic, optical, manual or otherwise, without the prior written
  276.     consent of DataEnter.
  277.  
  278.     DataEnter makes no warranty or representation, either expressed or
  279.     implied, with respect to the product PingPong and its
  280.     documentation, their quality, perfomance, merchantability, or fitness
  281.     for a particular purpose. DataEnter reserves the right to revise the
  282.     user's guide and make changes in the content without obligation to
  283.     notify any person or organization of such a change.
  284.  
  285.     In no event will DataEnter be liable for any direct, indirect,
  286.     special, incidental or consequential damages, real or imagined,
  287.     resulting from the use or purchase of this software.
  288.     Under no circumstances shall DataEnter's liability for damages
  289.     exceed the price paid for the software license.
  290.  
  291.     Should any remedy hereunder be determined to have failed, all
  292.     limitations of liability and exclusion of damages set forth above
  293.     shall remain in full force and effect.
  294.  
  295.     The extent of the DataEnter's warranty for the software and its
  296.     documentation is limited to physical defects of the distribution media
  297.     containing the software. Contact DataEnter to obtain return
  298.     authorization for the replacement diskette within 30 days of the
  299.     original date of purchase. Any further statement made by agents,
  300.     employees, distributors or dealers of DataEnter do not constitute
  301.     warranties and are not binding. No employee of DataEnter has the
  302.     authority to modify any portion of this warranty.
  303.  
  304.     All brand and product names we refer to in the documentation are used
  305.     solely for identification purposes and may be trademarks of other
  306.     companies.
  307.  
  308.     DataEnter, (the licensor) grants the buyer (the licensee)
  309.     the right to use this copy of PingPong (the program)
  310.     on a single computer at a single location in active mode and a
  311.     second location in passive mode and on a third location in show
  312.     status mode as long as the licensee complies with the terms of this
  313.     license.
  314.  
  315.     The licensor reserves the right to terminate this license if the
  316.     licensee violates any part of the agreement.
  317.  
  318.     The licensee agrees to make copies of the program only for backup
  319.     purposes. The licensee agrees not to copy the documentation and to
  320.     take all necessary precautions to ensure that the backup copies of the
  321.     software are not distributed to or acquired by other parties.
  322.  
  323.     Microsoft Mail is a trademark of Microsoft Corp.
  324.     Windows for Workgroups is a trademark of Microsoft Corp.
  325.  
  326.  
  327.