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