Super Pager Version 1.5 Rev. 1
------------------------------
This OS/2 and Windows program will send a alphanumic message to a pager.

Some of the features are(Windows):
o Standalone Windows Pager.
o Windows SNPP Pager client.  Use this with the paging server and SNPP server.
  For paging over your TCP/IP network.
o Supports TAP(Telocator Alphanumeric Protocol).
o Supports scripts if pager system does not support TAP.
o Supports numeric pagers.
o Supports multiple pager systems.
o Page by a person's name.
o Page a group of people all at once.
o Log file with date, time and who was paged.

Some of the features are(OS/2):
o Standalone PM Pager.  PM Pager will also act as a client to
  the pager server
o Web Pager client. Page from favorite web browser
o A SNPP(Simple network paging protocol) server for paging over your TCP/IP
  network.
o PM SNPP Pager client.  Use this with the paging server and SNPP server.
  For paging over your TCP/IP network.
o Command line SNPP Pager client.
o Supports TAP(Telocator Alphanumeric Protocol).
o Supports scripts if pager system does not support TAP.
o Supports numeric pagers.
o Supports multiple pager systems.
o Page by a person's name.
o Page a group of people all at once.
o Client/Server application.
o Delayed pages.
  - Delay by minutes.
  - Page at a pictular date and time.
o Log file with date, time and who was paged.
o Remembers pages after server has been restarted.
o C Source code for Client, add pageing to your own programs.
o Uses name pipes.  Make you programs page over the network.
o Works with callos2(Caller ID for os/2).  Pages you with who called.  The
  caller ID and pager server will share the same comm port & modem.

What you need:
o A Hayes or compatible modem
o OS/2 or Windows

------------------------------------------------------------------------------
------                     Important Inforation                         ------
------------------------------------------------------------------------------
This is a ShareWare product.  The ShareWare version is limited to 30 characters.
Please support the shareware concept and register.

Registration fee:
            $80 - Web Pager client.                  (wwwpage.exe)     (OS2)
		  Pager server.                      (paged.exe)       (OS2)
		  Standalone PM pager.               (pmpage.exe)      (OS2)
		  Command line Client.               (page.exe)        (OS2)
		  Client Source.                     (page.cpp)        (OS2)
		  SNPP Server.                       (snppd.exe),      (OS2)
		  Command line SNPP client.          (pageip.exe)      (OS2)
		  PM SNPP client.                    (pmpageip.exe)    (OS2)
		  Windows SNPP client.               (wpageip.exe).    (Win)
		  Standalone Windows pager.          (winpage.exe)     (Win)
            $40 - Pager server.                      (paged.exe)       (OS2)
		  PM pager.                          (pmpage.exe)      (OS2)
		  Command line Client.               (page.exe)        (OS2)
		  Client Source.                     (page.cpp)        (OS2)
            $20 - For each copy PM SNPP client.      (pmpageip.exe).   (OS2)
            $20 - For each copy Windows SNPP client. (wpageip.exe).    (Win)
            $20 - For Standalone PM Pager only.      (pmpage.exe)      (OS2)
            $20 - For Standalone Windows pager only. (winpage.exe).    (Win)

           $200 - Site license for every thing per building.

Send check to the address below.

Borghese Software Engineering
981 Hillsdale Dr.
Columbus, OH  43224

Please make check Payable to:     Brent K. Borghese

All technical support is through e-mail.  I would like to here your comments.
Please send them to: brent@dispatch.com
------------------------------------------------------------------------------
------                  End of Important Inforation                     ------
------------------------------------------------------------------------------


Description of included files
-----------------------------
  pmpage.exe       - Standalone OS/2 PM Pager, Also will acted as a client to
                     pager server
  winpage.exe      - Standalone Windows pager.
  pmreg.exe        - OS/2 Registration program(Enters registration info in to
                     INI file)
  winreg.exe       - Windows Registration program(Enters registration info in
                     to INI file)
  paged.exe        - OS/2 Pager server
  page.exe         - OS/2 Command line client for pager server.
  wwwpage.exe      - OS/2 Web server pager client. (Web server needed)
  page.htm         - Sample html file of paging
  snppd.exe        - OS/2 SNPP Server. (TCP/IP needed)
                     Simple network paging protocol server, works with paged.exe
  pmpageip.exe     - OS/2 PM SNPP Pager client. (TCP/IP needed)
  pageip.exe       - OS/2 Command line SNPP Pager client. (TCP/IP needed)
  wpageip.exe      - Windows SNPP client. (TCP/IP needed with Winsock V1.1)
  snpp.ini         - Sample setup file for SNPP server
  page.ini         - Sample setup file for pager system
  file_id.diz      - Description file
  history.txt      - History of modification to Super Pager
  page.cpp         - C Source for client interface
  page.h           - C header file for client interface
  paged.scr        - Sample modem script file for non TAP pager systems
  readme.txt       - This text file

Installing super pager
----------------------
Unzip the zip file to a directory called \PAGE

How to setup:
-------------
The first configuration file is called:  PAGE.INI.
The first section of the file is the pager system section.  The first line of
this section has the keyword PagerSystemsSection.   Next, if you are using a
numeric pager you must have a setup for the numeric pagers.  Here are the
commands needed(The | separates possible options):

 [Numeric]                                   - If there will be numeric pager
                                               being paged, there must be a
                                               [Numberic] section to setup the
                                               comm port.
 ModemInitString = "AT Z"                    - The init string for your modem.
                                               On a numeric pager this could be
                                               just AT, bucause no modem connection
                                               is made.  It just uses the dialing
                                               tones to send the page.
 Port            = "COM1"                    - The Comm port your modem is on.
 Baud            = 1200                      - The baud rate the modem will be
                                               using.
 Parity          = None|Odd|Even|Space|Mark  - Parity to set the comm port to.
                                               On a numeric page this should be
                                               set to None
 DataBits        = 8|7|6|5                   - Data bits to set the comm port to.
                                               On a numeric page this should be
                                               set at 8.
 StopBits        = 1|2                       - The number of Stop bits to set the
                                               port to.  This should be set to 1.

Next setup each pager system you will use. Here are the commands needed.

 [Name of System 1]                           - This is the name of the pager
                                                system.  For each pager system
                                                there will be a header.
 ModemInitString   = "AT Z"                   - The init string for your modem.
                                                On a alpha pager the modem will
                                                need to be setup to hangup when
                                                DTR is droped(&D2) and the host
                                                baud rate to match connect
                                                speed(S37=0).
 Port              = "COM1"                   - The Comm port your modem is on.
 Baud              = 1200                     - The baud rate the modem will be
                                                using.
 Parity            = None|Odd|Even|Space|Mark - Parity to set the comm port to.
                                                On a pager system that uses TAP
                                                it should be set to Ever.  Please
                                                note your pager system might be
                                                different.
 DataBits          = 8|7|6|5                  - Data bits to set the comm port to.
                                                On a numeric page this should be
                                                set at 7.
 StopBits          = 1|2                      - The number of Stop bits to set the
                                                port to.  This should be set to 1.
 SystemPhoneNumber = "690-1234"               - The phone number of the pager
                                                system.
 SystemType        = Tap|TapM|Script          - The type of pager system.  If the
                                                pager system support TAP.  Set the
                                                SystemType to Tap.  There is also
                                                manual mode TAP avalible(TapM),
                                                this does not need to be used
                                                every.  If the pager system does
                                                not suport TAP a script can be used.
 ScriptFileName    = "c:\pageos2\systema.src" - If SystemType = Script then a script
                                                file is needed.  Refere to the
                                                Non-TAP paging systems for more
                                                information.

The modem init string is very important.  When setting up the modem init string.
With some older modem or off brands they will not work right tell it has been
setup correctly.  The modem will need to be setup to hangup when DTR is
droped(&D2) and the host baud rate to match connect speed(S37=0).

Example for Hayes 28.8 V.34
 ModemInitString = "AT&Q0S36=1S37=0S48=128N0B1&D2"
Example for Hayes 2400
 ModemInitString = "ATL0"

The next section of the file will be used to setup the people with the pagers.  The first line of
this section has the keyword NameSection.   Next setup each person's pager system and type.
Here are the commands needed.

 [Bob Smith]
 PageID     = "630-2222"
 PagerType  =  Numeric|Alphanumeric
 SystemName = "Name of System"


The next section of the file will be used to setup groups of people that you can page all at
once.  The first line of this section has the keyword GroupSection.   Next setup each group.
Here are the commands needed.

[Group Name 1]
 Name = "Bob Smit"
 Name = "Mr. Bill"

Non-TAP paging systems
-----------------------
If your system does not support the TAP(System Type) protocol you can setup a script
configuration file.  It is used to send the pages to your pager system. Not all pager systems
are the same so some tuneing might need to be done.  The file is in the format of Send String, Expect String.
There are some esc sequences in the send string, they are shown below:
	\r      - Sends a return(0x0D)
	\n      - Sends a return and a line feed(0x0D,0x0A)
	%i      - Sends the persons pager ID
	%m      - Sends the message
	%p      - Sends the systems phone number
	%d      - Two second pause
	^a      - Sends a control charature, the charature can be form a-z

There is one esc sequences in the expect string, it is shown below:
	\r      - Expect a return(0x0D)(^m does same thing)
	^a      - Expect a control charature, the charature can be form a-z

Here is a sample script:
---------------------
AT DT %p\r
CONNECT
\r
\r
M\r
RETURN.
%i\r
Message, then RETURN.
%m\r
then RETURN.

Here is a sample page.ini file:
---------------------------
PagerSystemsSection
[Numeric]
ModemInitString	= "AT&Q0S36=1S37=0S48=128N0B1&D2"
Port			= "COM1"
Baud			= 1200
Parity			= None
DataBits		= 8

[USA Mobil]
ModemInitString	= "AT&Q0S36=1S37=0S48=128N0B1&D2"
Port			= "COM1"
Baud			= 1200
Parity			= Even
DataBits		= 7
StopBits		= 1
SystemPhoneNumber 	= "842-6252"
SystemType		= Tap

[A Script for USA Mobil]
ModemInitString	= "AT&Q0S36=1S37=0S48=128N0B1&D2"
Port			= "COM1"
Baud			= 1200
Parity			= Even
DataBits		= 7
StopBits		= 1
SystemPhoneNumber 	= "842-6252"
SystemType		= Script
ScriptFileName		= "page.scr"

NameSection
[Brent Borghese]
PageID  	= "555-1212"
PagerType	=  Alphanumeric
SystemName	= "USA Mobil"

[Mr. Bill]
PageID  	= "555-1234"
PagerType	=  Numeric

[Brent with a Script]
PageID  	= "555-1212"
PagerType	=  Alphanumeric
SystemName	= "A Script for USA Mobil"

GroupSection
[Page Brent 3 Times]
Name = "Brent Borghese"
Name = "Brent Borghese"
Name = "Brent Borghese"

[Page everybody]
Name = "Brent Borghese"
Name = "Mr. Bill"
Name = "Brent with a Script"


Log file
--------
All pages are loged to: log.txt.

Using Standalone PM Pager
-------------------------
Run pmpage.exe from the pager directory. Select name from the list, enter
the message and click page button. If the pager server is running the PM pager
will send a message to the server and the server will page the person.

Using pager server
--------------------
Run paged.exe from the pager directory. Once the pager server is running the
pager clients can be run to submit pages to the server.  There are two clients
included a command line version and a pm version.

Using the command line client
-----------------------------
Once the paging server is running the command line client can be run.  The format
of the command is as follows:

page [-nadils args] [@filename.txt] id Message
     n  Page now - Default
        page -n "Bill" "My message"
        page "Bill" "My message"
     a  Page at a date(MM-DD-YY) and time(HH:MM)
        page -a 08-12-95 15:55 "Bill" "My message"
     d  Delete a page at date(MM-DD-YY), time(HH:MM) and ID
        page -d 08-12-95 15:55 "Bill"
        page -d 00-00-00 00:00 ""     - Deletes all pages
     i  Page in xxx minutes
        page -i 10 "Bill" "My message"
     l  List page log file:     page -l index
        index:  0:  Show last 1K of log file - Default
                1:  Show 1K of log file, starting at EOF-2K
     s  List # of pages in Now queue and # of pages in At queue
        page -s type
            type:   0:  Short list - Default
                    1:  Full list

A file can be passed to the command line client.  The format of the command is as
follows:

	  page @filename.txt
	  page id @filename.txt

There are two file formats one with the id and one with out.  The file format
with the id has two parts, the first line has the id and the message is on the
following lines.  The file format with out the id has one part the message.

Using PM Pager as a client to the server
----------------------------------------
Run pmpage.exe from the pager directory. Select time for page to occur and
select name from the list, enter the message and click page button.


Using the SNPP(Simple network paging protocol) server
-----------------------------------------------------
Run paged.exe and snppd.exe from the pager directory. Once the programs are
running the SNPP clients can be run to submit pages to the server.  There are
two clients included a pm version and a windows version.  You will need tcpip
installed on all computer used.  The windows version is winsock V1.1 compatible
program.  When setting up the program you will need to select a TCP port to use
and a host name or IP address.  The setup file for snppd.exe is named SNPP.INI
it has the format of:
TcpPort = PortNumber

Example
TcpPort = 5100

SNPP Client setup
-----------------
The setup the clients you will add two lines to the PAGE.INI.  These lines are
in the format of:
TcpPort  = PortNumber
HostName = "SnppServerHostName"

Example
TcpPort  = 5100
HostName = "pagesrv"

Using the SNPP Clients
----------------------
Once the OS/2 paging server and the SNPP server are running the system is read
to receive page message over the network.   There are three SNPP clients a OS/2
PM version PMPAGEIP.EXE, a Windows version WPAGEIP.EXE and a OS/2 command line
version PAGEIP.EXE.  The PM and windows versions a very simple and need no
explanation.

Using the SNPP command line client
----------------------------------
The format of the command is as follows:
pageip [@msgfile.txt] id Message

examples:
	  pageip "Bill" "My message"
	  pageip @filename.txt
	  pageip id @filename.txt

A file can be passed to the command line client.  The format of the command is as
follows:

	  pageip @filename.txt
	  pageip id @filename.txt

There are two file formats one with the id and one with out.  The file format
with the id has two parts, the first line has the id and the message is on the
following lines.  The file format with out the id has one part the message.

Setting up a OS/2 Web Pager
---------------------------
Copy wwwpage.exe to your web server CGI-BIN directory, then copy the page.htm
file to your web server's DOCS directory. To add people to the paging list on
the web form, you will edit page.htm. Look in the file for something like this
and add your name to the <option> list.

Select one or more names:<br>
<select name="name" size=5 multiple>
<option> Mr. Bill
<option> John Smith

Runing your web pager
---------------------
Run the paged.exe from the pager directory and your OS/2 web server software.
To then call up, run your favorite web browser.  The URL you will enter will
look something like this:

http://www/cig-bin/wwwpage.exe/page.htm

Slect a name and press the page button.


