------------------------------------------------------------------------------
Alarm Pager Version 1.0
Shareware Evaluation Copy
written by
William E. Davidson IV
compiled: 11/03/93
------------------------------------------------------------------------------

Description:
SETUP.EXE -
Configures the programs for your specific setup.
ALRMPGR.EXE -
Sets up an alarm at a specific time that pages a pager according
to SETUP.DAT
INSTPGR.EXE
Pages a pager at execution time according to SETUP.DAT

-----------------------------------------------------------------------------

To run these programs you need:

[ Computer ]
o Approximately 53 K of free RAM
o Approximately 152 K of disk space
o CGA graphics or better (except for INSTPGR.EXE, which
requires no graphics with /Q)

[ Modem ]
o Modem on COM 1 or COM 2
Version 1.0 allows only COM 1 or 2
COM 3 or COM 4 selection will result in an error

o Baud Speed of 300, 1200, 2400, 9600, 19,200
o Hayes Compatible

[ Pager ]
o Should work with any pager because of the built-in versatility
(Been tested with Motorola Bravo & Bravo Plus)

------------------------------------------------------------------------------
To start, the SETUP.EXE program must be run.

For all options in Setup, defaults are loaded from the included SETUP.DAT.
This SETUP.DAT file is used for my setup (Modem/Pager).

The setup you choose may need to be adjusted after testing the software, but
the included defaults work for most cases.
------------------------------------------------------------------------------


To use the ALRMPGR program, make sure it is run from the directory that
contains SETUP.DAT!


------------------------- DEFAULTS IN SETUP ----------------------------


Here is an explanation of the defaults in Setup:


Modem Specific Setup


Com Port(1 or 2): 2
Baud Speed : 19,200
Init String : ATZM1
Dialing Prefix : ATDT *70, 9,









This dictates:

o That the modem is connected or assigned to COM port 2 running
at 19,200 baud.

o Send an initialization string of "ATZM1" to the modem.
(ATZ resets the modem and M1 turns the speaker on)

o To dial, send the modem, first, "ATDT" which translates as
'attention dial touch tone', then "*70" then a pause (,) then
"9" then a pause (,).
(The *70 turns off call waiting in my area and 9 tells the phone
system to give me a outgoing line).



Pager Specific Setup


Pager Phone Number : 555-4053
Length of pause after answer: 2
Default Message to Send : *811*711*611
Pause after message send : 1
Ending message (i.e. '#') : #
Pause before hangup : 2
Avg. Delay before page rec'd: 16






This dictates:
o That the pager's phone number is 541-4053.

o To wait 2 seconds after the answer to dial the message.

o To send the message '*811*711*611'.

o To wait 1 second before sending the ending code.

o To send '#' as the ending code to send the message to the pager.

o Wait 2 seconds before hanging up to hear the confirmation message.

o To wait approximately 16 seconds to display the graphical representation
of the page reception.


Note: The system used for this setup is 80386 machine with a CompuCom modem
on COM2 and a VIPaging Company Motorola Bravo Plus pager.

---------------------------- USING SETUP -----------------------------------

When entering data into setup, except for the baud speed, full editing
capabilities are supported (INS, DEL, BACKSPACE, HOME for beginning of
entry, END for end of entry).

--------------------------- USING ALRMPGR ----------------------------------
The following command line options are valid:
/? or /HELP or /H or /help or /h -
Displays program description and help on other command lines
/Q or /q
Turns all bells off, making the title screen go from simulating
a pager set to beep to a pager set to vibrate.
/N or /n
Turns off title screen


Note: These command line options are valid for all three programs included in
in this package, excluding /N or /n for INSTPGR. Also /Q or /q for
INSTPGR turns off all display messages and sends an "ATM0" to the modem
to turn off the speaker.

When entering a time for Alarm Pager to go off, the time must be entered as
military time (24 hour format), and will then be converted to 12 hour format.
The program will then go into a checking loop, if the alarm time is reached,
unless the press a key, then the message will be sent to the pager.



--------------------------- USING INSTPGR ----------------------------------

Type INSTPGR at the command prompt and press enter or place 'INSTPGR.EXE'
into a batch file and run it. Easy as that.

Note: To make INSTPGR silent add /q to the command line and it will not make
a sound or display anything.

-------------------- POSSIBLE USES FOR THIS SOFTWARE -----------------------

In a batch file (calcl.bat):

ECHO OFF
D:
CD\CALC
CALCL.EXE
C:
CD\ALRMPGR
INSTPGR /Q

This runs a program d:\calc\calcl.exe and pages you when it is finished
executing.

In the background (Using DesqView)
run DesqView
Open Alarm Pager Window
Set up an alarm
Open DOS window
Operate in DOS window and Alarm Pager will go off when it is time.

Note: Alarm Pager has been fully tested with DesqView and an included sample
DesqView Information File (AM-PIF.DVP) has been included for a normal
setup of Alarm Pager on drive c: in directory \ALRMPG.

------------------------ LICENSE AGREEMENT -----------------------------

ALRMPG.DOC is licensed for a free 15 day trial period. If you find this
software useful please register it!

Registration costs are as follows:
$10 for single user (non-commercial)
$20 for up to two users (commercial)
$30 for multi-user (3 to 20, commercial)
$45 for multi-user (20 and up, commercial)

A commercial site is defined as a business or individual using ALRMPGR as part
of his/her business activities.

To Register send check for amount of registration + $5 (S/H and cost of
materials) and either a printout of SETUP.DAT or a disk copy of it,
including an explanation of your system setup (Modem make/type and Pager
make/type) to:

William Davidson
Towson State University
P.O. Box 1264
Towson, Md. 21204

(MAKE SURE TO INCLUDE A RETURN ADDRESS!)
If you include a disk copy of your SETUP.DAT there will be a 3 dollar discount
for materials.

(SUBTRACT DISCOUNT FROM AMOUNT OF YOUR CHECK!)
You will receive in return:

(1) Mailed (Latest Version) Registered copy of Alarm Pager
(3) Mailed Major upgrade copies (V 2.0, 3.0, etc.)
(unlimited) Upgrades via modem, details included in mail back.
and
(1) Clear conscious


ALRMPGR.EXE, INSTPGR.EXE, AND SETUP.EXE may not be changed or modified in
any way except by the author. Alarm Pager may be freely distributed for
the fifteen day trial period as long as it remains in its complete form.
Regardless of how the copy is obtained, it is requested that all users comply
with the licensing agreement.

All files included in the original archive must be included!

All warranties are disclaimed, including damage to hardware and/or software from
use of this product. In no event will I be liable to you for any damages,
including lost profits, lost savings or other incidental or consequential
damages arising out of your use or inability to use the program, or any other
claim by any other party.

Any suggestions or comments should be mailed directly to me.


-------------------- VERSION HISTORY OF THIS SOFTWARE ---------------------

History of Alarm Pager.

Alarm Pager V 1.0
(ALRMPG10.ZIP)
First Release of Alarm Pager
Only major version of Alarm Pager that is shareware!

Alarm Pager V 1.1
Major communications bug fix
Made it more evident that COM 3 & 4 are NOT supported in
shareware version (1.x).
Set new prices for registration

Alarm Pager V 2.0+
Registered users only

-------------------- FUTURE UPGRADES OF ALARM PAGER ----------------------
Look for in future Alarm Pager upgrades:

MAJOR VERSION UPGRADES:
Multi-User version (Allows for paging multiple pagers, of multiple types
with a single or multiple alarm times or a command)

Multiple Alarms (Allows for more than one alarm, all being saved to disk for
latter retrieval.

Support for COM3 & COM4

MINOR VERSION UPGRADES:
Better Interface (Non-military time alarms, etc.)
Bug-fixes (if any)
Cosmetic improvements, if necessary

-----------------------------------------------------------------------------
NOTE - For Non-CGA graphics or better users!:
You may use INSTPGR.EXE (/q) if you create a SETUP.DAT file using a
text editor with the format described in SETUP.INF.