home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / PORTH102.ZIP / PORTHOLE.DOC < prev    next >
Text File  |  1994-02-27  |  11KB  |  235 lines
  1.    ┌──────┐ ┌──────┐ ┌──────┐ ┌───────┐ ┌─┐  ┌─┐ ┌──────┐ ┌─┐      ┌──────┐
  2.    └──────┘ └──────┘ └──────┘ └───────┘ └─┘  └─┘ └──────┘ └─┘      └──────┘
  3.    ┌──────┐ ┌─┐  ┌─┐ ┌──────┐    ┌─┐    ┌──────┐ ┌─┐  ┌─┐ ┌─┐      ┌────┐
  4.    │ ┌────┘ │ │  │ │ │ ┌─┐ ┌┘    │ │    │ ┌──┐ │ │ │  │ │ │ │      │ ┌──┘
  5.    │ │      │ └──┘ │ │ │ │ │     │ │    │ │  │ │ │ └──┘ │ │ └────┐ │ └────┐
  6.    └─┘      └──────┘ └─┘ └─┘     └─┘    └─┘  └─┘ └──────┘ └──────┘ └──────┘
  7.  
  8.                       Copyright Rob Wall 1994 (c)1994
  9.                             All Rights Reserved
  10.  
  11.                       [This sofware is in BETA mode]
  12.  
  13.   NOTE: if you are upgrading from 1.00.1b to 1.00.2b you may skip this
  14.   documentation (after the liscense agreement) <grin> and read the WHATZ.NEW
  15.   documentation explaing any changes...
  16.  
  17.                              License Agreement
  18.  
  19.    By using, executing or installing PortHole and or all other software
  20.    contained on this original distribution disk or original archive, you
  21.    agree to all the terms listed below.  Failure to comply with all or any
  22.    of these terms is considered a breach of this agreement and terminates
  23.    any existing license made with the author including this agreement.
  24.  
  25.    PortHole refers to the executable programs, documentation and
  26.    report files created by the executable programs contained on PortHole
  27.    Software distribution diskettes or within PortHole Software distribution
  28.    archives released by Rob Wall.
  29.  
  30.    PortHole is the copyrighted material of Rob Wall.  It may only be used
  31.    in accordance with the conditions set out in this license agreement.
  32.  
  33.    The author Rob Wall is in no way obligated to provide future versions
  34.    of, or support for, PortHole or any PortHole product distributed.
  35.  
  36.    No part of PortHole, PortHole Utilities, any other file or program
  37.    contained on the original PortHole distribution disk or within the
  38.    original PortHole archive including this publication may be reproduced,
  39.    transmitted, transcribed, stored in any retrieval system or device, or
  40.    translated into any other language or computer language in whole or in
  41.    part, in any form or by any means, whether it be electronic, mechanical,
  42.    magnetic, optical, radio wave, manual or otherwise, without prior written
  43.    consent of the author Rob Wall.
  44.  
  45.    The author has granted you permission to make ONE copy of the PortHole
  46.    distribution disk for back-up.  You are allowed only to execute the
  47.    files contained on the back-up disk once for integrity evaluation.  In
  48.    the event of an error or problem arising where the back-up copy of
  49.    PortHole is needed to restore the original copy, you must delete/destroy
  50.    all PortHole information except the back-up disk and then re-install the
  51.    software.  This back-up disk then becomes the primary PortHole disk and
  52.    you may once again make a single back-up (as above).
  53.  
  54.    Rob Wall, disclaims all warranties as to this software, whether
  55.    expressed or implied, including without limitation any implied
  56.    warranties of merchantability, fitness for a particular purpose,
  57.    functionality, data integrity or protection.
  58.  
  59.    To use PortHole in a commercial, educational, governmental agency or
  60.    on more than one computer or Local Area Network (LAN), it is necessary to
  61.    negotiate a SITE LICENSE with the author Rob Wall.
  62.  
  63.    Site, Group and Special license agreements are available, and are dealt
  64.    with on a case by case basis.
  65.  
  66.    The author Rob Wall reserves the right to terminate a site license or
  67.    license agreement without notice to the license holder.  Failure to
  68.    destroy or return all copies of PortHole and PortHole utilities within
  69.    SEVEN business days from notification of a license termination may
  70.    result in legal action being taken depending upon provincial, state and
  71.    country laws.
  72.  
  73.    NOTE THAT THE SITE LICENSE INCLUDES ONE COPY OF THE SOFTWARE ONLY.
  74.    The site license allows the bearer to copy it for the number of machines
  75.    or (LAN) networks licensed.
  76.  
  77.    Distributing, repackaging, or reselling of PortHole and PortHole
  78.    utilities to third parties is not allowed and in violation of your
  79.    agreement to use PortHole.
  80.  
  81.    Software vendor's, packagers or any agency that wishes to distribute,
  82.    sell, package or include PortHole with another package must first obtain
  83.    a written agreement from the author Rob Wall.
  84.  
  85.    Decompilation of PortHole is forbidden and a direct violation of this
  86.    agreement.  You may not modify or otherwise reverse-engineer PortHole.
  87.  
  88.    PortHole may not be used in any unlawful or illegal manner.
  89.  
  90.    This COPY of PortHole is UN-REGESTERED.  Your license TERMINATES 30 days
  91.    after installing PortHole for the first time.  Please help us bring you
  92.    software at reasonable prices and register PortHole.
  93.  
  94.  
  95.    Registration
  96.    ────────────
  97.  
  98.    To use PortHole in a commercial enviroment or private enviroment past 30
  99.    day's you must register.  See the REGISTER.DOC for rates and information.
  100.  
  101.    What is PortHole?
  102.    ─────────────────
  103.  
  104.    PortHole is a RING smart TSR that watches your COM ports 1-4 for a
  105.    specified amount of RING's before CARRIER DETECT.  If the command line
  106.    specified limit is reached before a carrier is detected then the machine is
  107.    reset via cold-boot <--Count's memory...
  108.  
  109.    Yes it's true... although you  don't see the full potential of PortHole,
  110.    PortHole is using full Asynch control over the 4 basic port addresses
  111.    0x3f8, 0x2f8, 0x3e8 & 0x2e8 (Com1 - Com4).   PortHole has anti-locking
  112.    routines to minimize and reboot if it detects and error in your current
  113.    session.
  114.  
  115.    If your a SysOp like myself then you won't want to be without PortHole.
  116.    Porthole's applications exceed much further then those K-9 programs that
  117.    claim to watch the modem but only function with one line...   PortHole is
  118.    MODEM smart... If there is no port installed it will simply move on to
  119.    watch the ports available.
  120.  
  121.    Imagine how much better you can sleep at night knowing that if your board
  122.    or HOST goes down PortHole is on the job and will reset the system for you.
  123.    PortHole never sleeps and is always on the JOB...
  124.  
  125.    No SysOp or HOST want's to lose customers/users because of a small
  126.    malfunction.  By the time you read this there are already 100's who are
  127.    running PortHole and who can accomidate a new user/customer who may have
  128.    tried your number but did'nt get an answer.
  129.  
  130.    Even if you feel confident that you system is stable (No System is
  131.    stable... Murphy's law #1) then PortHole can offer that concrete security
  132.    to back you up...
  133.  
  134.  
  135.  
  136.    How do I RUN PortHole?
  137.    ──────────────────────
  138.  
  139.    Version 1.00.1a accepts only three command line option and that's ammount
  140.    of RINGS before a carrier is detected to reboot the system , -REBOOT.
  141.    Assuming that -REBOOT is obvious I'll leave that option alone.  Infact It
  142.    will most likly not be available in future versions.  It was added on
  143.    request by one of out Beta sites who wanted a means of rebooting
  144.    (Cold-Boot) on an ERRORLEVEL from an event batch file.  Instead of leaving
  145.    it an undocumented option I'm leaving it active in this version to see if
  146.    anyone else finds it usfull.
  147.  
  148.    I would suggest using a command line option of 6-10 ie. PORTHOLE 8 [enter].
  149.    PortHole will not allow an option lower then 2.  Remember that if your
  150.    modem is set to answer on the second ring and a user calls, allows one
  151.    ring then hang's up.  PortHole will count that as one ring in the BAD-RING
  152.    buffer for that line or port.   If the bad ring buffer count reaches the
  153.    number you have entered in the command line then the system is rebooted.
  154.    It should be obvious that your BBS or COMMICATIONS PACKAGE should be called
  155.    from your AUTOECEC.BAT in case PortHole detect's an ERROR and reboot's the
  156.    system.  The third option is for monochrome users.  -MONO will allow the
  157.    detection window to appear on a monochrome machine.
  158.  
  159.    NOTE:  Toggle PortHole's ON/OFF switch you must use the SCROLL LOCK.  When
  160.    the scroll lock is on PortHole will be active and when it is off the boxed
  161.    window will be cleared from the upper right hand corner and PortHole will
  162.    no longer monitor the ports.  You may disable and enable PortHole as often
  163.    as you wish.
  164.  
  165.  
  166.    If PortHole finds the modem streaming without carrier detect otherwise know
  167.    as RUNNING AWAY, it will lower DTR for one second and then restore it.
  168.    Thus attempting to free and reset it.
  169.  
  170.    Once PortHole is resident a small box will appear in the upper right hand
  171.    corner of the screen which looks somthing like this...
  172.  
  173.         [1-WL 2-WL 3-NA 4-NA]
  174.          │ │  │ │  │ │  │ │
  175.          └─┼──┴─┼──┴─┼──┴─┼────── Indicates Com1 to Com4
  176.            │    │    │    │
  177.            └────┴────┴────┴────── Current device resault.
  178.  
  179.    The current device resault will be one of the below
  180.  
  181.    WL - Watching line.... (The Port is being watched)
  182.    NA - Not Available.... (No port active or device time out)
  183.    RR - Ring Register.... (The line is ringing)
  184.    RA - Run Away......... (The port is streaming but there is no carrier)
  185.    LD - Lower DTR........ (PortHole has lowered DTR for 1 second due to above)
  186.  
  187.  
  188.    Other Information
  189.    ─────────────────
  190.  
  191.    PortHole should function fine on any IBM based system running, MSDOS, Os2,
  192.    CoreScanII PlexII, DESQview, MS Windows, Unix (Unix version Only), Double
  193.    Dos and Dr Dos and a few others.
  194.  
  195.    PortHole functions fine on network bassed systems and has been tested on
  196.    ARCNet, EITHERNet, CBIS, NOVELL and a few others.  PortHole also supports
  197.    the OS Network VIRTUAL MODEM PORT class (See your network manual).
  198.  
  199.    PortHole Requires about 11k of ram and can be loaded HIGH for memory
  200.    optomization.  Smaller versions are available as a custom application.
  201.  
  202.    PortHole bypasses the bios and is compatible with most if not all IBM or
  203.    CLONE machines.  PortHole has been tested on the following machines.  IBM
  204.    XT, AT, 80286, 80386sx, 80386dx, 80486 and 80486dx2 class.
  205.  
  206.    PortHole functions fine under Desqview and should be loaded prior to
  207.    calling Desqview.  Although if memory does not permit you may call PortHole
  208.    from an OS session.
  209.  
  210.    WARNING: On some machine a software Cold-Boot is not possible.  I strongly
  211.    suggest you try PH102 -REBOOT to test the REBOOT option on your machine.
  212.  
  213.    How To Contact Us
  214.    ─────────────────
  215.  
  216.    Call the Support BBS (We never go down) <smile> at (905) 770-1391 14.4HST.
  217.    or call us voice (905) 770-0387.  or write to
  218.  
  219.                           PortWatch H.Q.
  220.                           10117a Yonge Street Suite #1
  221.                           Richmond Hill, Ontario CANADA
  222.                           L4T 1C7
  223.  
  224.    Don't forget to ask about our other products including CoreScanII to be
  225.    released in the spring of '94.
  226.  
  227.    If there is anything you would like to see added to one of our existing
  228.    products or if you would like a new product developed feel free to drop us
  229.    a line or note and we'll respond...
  230.  
  231.    Thank you for using PortWatch.   Have a nice day.
  232.  
  233.    Rob Wall
  234.    System Programmer.
  235.