RingRes v1.1 -- The Memory Resident Telephone Ring
Copyright (c) 1996-97, Jem E. Berkes
Compatible with Microsoft(R) Windows(TM)

        RingRes is supposed to help you to never miss a phone call. Even if
you are no where near your telephone (or if you turn off its ringer), RingRes
will alert you of an incoming phone call with a tone through your PC's speaker
indicating a phone call.  Plus, you will notice that your Scroll Lock light is
flashing.  Here are a just a few situations that I can think of for RingRes:

- noisy area/office
- no phone in room
- phone with its ringer turned off
- hearing impaired people

RingRes occupies only 368 bytes of conventional/high memory (RingWin occupies
384 bytes), and its effect on the speed of the system is practically nill.

        As mentioned above, RingRes (and its Windows version, RINGWIN) will
alert you of a phone call by flashing your PC's scroll lock light and sounding
a clicking sound through your PC's speaker. You don't have to have a telephone 
attached to your computer or have a sound card; you just need a modem with a
phone line attached to it. The RingRes syntax is:

RINGRES [PORT] [/M | /U] [/N | /L] [/Q | /S] [/R] [/?]                  
                                                                               
 PORT is the modem's COM port (1, 2, 3 or 4)

 /Mute completely deactivates RingRes
 /Unmute activates RingRes (DEFAULT)

 /Nolight disables flashing of the Scroll Lock light
 /Light enables flashing (DEFAULT)

 /Quiet disables clicking of the speaker as an indicator
 /Sound enables clicking (DEFAULT)

 /Report displays how RingRes is configured (same as no parameters)

 /? displays all of these instructions

RingWin has the exact same syntax as RingRes.

RingRes is completely configurable.  In other words, even after the TSR is
installed, with a second command you can change any of the settings listed
above.  You can even change the COM port.

RingRes isn't very picky on the command line.  You could type the following
command and have RingRes monitor COM2 (in a muted state at start-up).

RINGRES Install me on com#2 and make sure that I am /muted.

That might seem a little extreme. But a command such as this in your startup
file will remind you what RingRes is doing:

RINGRES Listen for rings on COM2

Be careful. The following won't only put RingRes on COM2, but also mute it:
RINGRES /COM2
Because the "M" of "COM" after the slash is interpreted as "mute".

                      =-Running RingRes under Windows-=

        I should tell you that the instructions listed below are relevant for
Microsoft Windows(TM) 3.x. If you want to run RingRes under Windows '95, I can
only suggest that you experiment and see what is necessary to get the desired
result (I do not have Windows 95 on my system).
        If you simply want RingRes to be active during Windows, you should run
its Windows version, RingWin.  RingWin is loaded from DOS before Windows is
active, so you should load it into your AUTOEXEC.BAT file as a DOS command
(e.g. RINGWIN 2 /Q).
        If you are planning to run DOS sessions under Windows, you should also
do the following.  Under the [386Enh] heading of your SYSTEM.INI file (look
through the file for this heading) section, place a ";" in the beginning of
the line that reads "DEVICE=*VCD", i.e. it should say: ;DEVICE=*VCD

-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-
Some practical examples. Let's say you want to start up your computer with
RingRes loaded in memory, watching COM 3, but you do not want it to be active
until you tell it to be. You could enter this command into AUTOEXEC.BAT:
RINGRES COM3 /MUTE

If you are running DOS 6 or higher, you can load RingRes high and conserve
the precious conventional memory by using the LH (LOADHIGH) prefix:
LH RINGRES 3 /MUTE

You installed RingRes but it is muted. Now you want to unmute it and also
turn off the blinking of the scoll lock:
RINGRES /UNMUTE /NOLIGHT

You can't remember if you muted RingWin. You would exit Windows and type:
RINGWIN /REPORT

You want to change the COM port that RingRes is monitoring.  Type:
RINGRES 2

Once again, remember that RingWin works EXACTLY like RingRes, except that it
must be configured outside of Windows (before Windows is loaded).
-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-

Other notes:

  When the Scroll Lock light flashes, the system thinks that a key is being
pressed, so any screen savers that are active at the time will de-active.
        
  RingRes supports error levels. A code of 0 is returned if the TSR is
successfully installed, 1 if incorrect syntax is used, 2 if RingRes is already
installed in memory (the status is returned without reinstalling), and 3 if
an unknown error occurs which prevents RingRes from loading into memory.

I, the author of this program, do not accept any responsibility for what may
happen from using my program. Although RingRes was designed with the upmost
care, has a very stable design, and is used daily on my own computer, I don't
know what lurks behind your computer's switches, and therefore, have to remind
you that you are using this program at your own risk.

RingRes v1.1 is offered as shareware. This means that you may use it for a
month without owing the author a cent. If you use it for longer than one month,
you must send a $15.00 registration fee, along with your name and address to:

Jem E. Berkes
185 Waverley Street
Winnipeg, Manitoba
R3M 3K4
Canada

http://atc.nethosting.com/starlink/bp/
