readme

g-page 是一款客户端/服务器应用程序

SIGNATURE:

	To include a page signature automatically with every message select the 
signature tab and fill in the appropriate fields. 

	To include a time stamp at the end of every page activate this field. This 
is separate from your signature and is in military (24 hour) time and will increase
the length of every page by 6 characters. Note that the time stamp option is not
affected by the signature option.


PROTOCOL:

	Click on the protocols tab if you wish to configure g-page to send a copy 
of every page to the specified email address of every pager. Note: You will still 
have to select the smtp protocol in the add-receiver dialog box for this to take 
effect. I did this because there might be some receivers you don't wish to cc a 
message to. You cannot send a page to a pager with an email address if you have
the cc to email option checked. This will be fixed in later versions.
		
	You can also select the order in which g-page will attempt to send the 
messages. The standard order is to send via WCTP then SNPP then Email. You can 
change this order to fit any combination you want. Be aware that you must select 
each protocol to have a unique order-number or g-page will complain.


AUTO PAGE:

	You can change three values for the autopage feature here: 

script delay - This is the number of seconds g-page will wait after a defined script
               has been executed before attempting to locate the target file. If your
               script is performing time consuming tasks or perhaps gathering data from
               the Internet you might want to experiment with higher values for this number.

default polling - This is the number of seconds g-page will wait before looking for a target
                  file if you set the manual time to zero in your auto page settings. Use
		  this setting at low values if you are sending data from other applications
		  for g-page to send out.

locate attempts - This is the number of attempts g-page will make to look for a target file 
                  before giving up.

create error files when g-page is unable to parse a file - This forces g-page to create a file called
                  GPAGE.PARSE.ERROR when autopage cannot match a receiver or group name in a file it
                  is trying to parse data from. G-page logs the actual file data it was unable to parse
                  and the date and time of the error in the file, which will be located in the same
                  directory as the original file it was attempting to parse.
Msg Entry Box:

	You can define how g-page handles the text you have entered into the message entry box 
after a page has been attempted. The default selection is "Always" which means g-page will remove the 
text from the message entry box after every page attempt. If you select "On Success" g-page will 
only delete the text if your page was sent. If you select "Never" g-page will leave the text in 
the message box regardless of the outcome of the page.


ADVANCED:


	SENDING OPTIONS:
	
Set page mode - You can choose between asynchronous or serial paging. Asynch paging
                will increase your speed by creating a different network connection
                for each page you are sending, allowing up to 100 connections at a time.
                This will greatly increase your throughput if you are sending many
                group pages.

View Page Status - Turn this off when you use asynch mode otherwise you will get 
                   page status updates on the main statusbar which will be out of 
                   order and difficult to interpret.

Dial Internet on No Connect - Turn this option on and you will allow the server, if it was started 
		              with the -c switch, to execute a script that can dial your Internet
		              provider if a connection cannot be found. Note - unless the server
			      is started with the -c switch followed by the script to execute, this
			      option will have no effect. That's a feature not a bug :)

	QPAGE OPTIONS:

Rollover to local server on no connect - If you select yes for this option g-page
	will attempt to send the message to your local snpp (Qpage snpp data) settings
	if it is unable to find a live Internet connection to connect with.

View Qpage options - This allows you to enable or disable the qpage options on the
                     main g-page screen.

Qpage snpp data - Here is where you will setup your qpage settings if you wish to 
                  have gpage talk directly to a qpage server for sending pages via
                  the TAP protocol.



COMMAND LINE PAGING:

	You can send a page to multiple receivers or groups from the command line of a shell by starting 
g-page with the following command:

gpage <Receiver Name> <Receiver Name> <Group Name>... <message to be sent>

For example, if I want to send a page to Sales Guy from the command line I would enter:

gpage "Sales Guy" "Sales Manager" "Admin Group" "Call the office right away"

Of course this assumes that there is a receiver in the database with the name Sales Guy, 
Sales Manager and a group with the name Admin Group. The names must be an exact match with 
the names in your receiver/group database. You can have as many names prior to the message 
as you wish. 


SENDING A SCHEDULED PAGE:
	
	If you wish to send a scheduled page you simply enter the page in the
message entry box and select the receiver(s) to send the message to. Then click 
on the "Schedule" button on the toolbar. Select the time you want to page to go 
out and click the "send" button from the scheduled page dialog. The statusbar
on the bottom of the g-page client will indicate if there were any problems 
sending the message to the server. If all went well you will see a 
"message scheduled" message in the statusbar.

	If you wish to delete any scheduled messages or obtain the status of 
messages that were scheduled you will need to click on 
Maintenance->Scheduled Msgs on the menu bar. The scheduled messages dialog box 
should popup with the ability to query the server for status on any scheduled 
pages, or to delete any that have not already been sent. Once you click on 
the "Get Status" button to obtain the status of a page it will tell you all 
the details and any error messages if the page did not go, then that information 
will automatically be moved to the log files. 

SEND A RECURRING PAGE
	
	You can mark a scheduled page to be sent once every hour, once a day
or once a week. To do this you simply select one of the recurring page options
when you select the scheduled page option. To check on the status of your 
recurring pages you will need to click on Maintenance->Scheduled Msgs from 
the main menu. This will bring up a dialog box showing all the scheduled 
messages you currently have. The list box will tell you when the page 
was originally scheduled and if it is recurring. In order to check the status
of a page you will need to click on the message and click on the Status button.
The client will query the server for the status of that message and update the 
statistics to show you how many times the message has been sent and the next
time it is due to be sent. All logging information will show up in the text 
box under the statistics for any messages that were already attempted.

VIEW LOGGED PAGES

	Click on the log button from the toolbar to bring up the history of 
all the messages you have sent out. The initial dialog box will show you a 
list of all the receivers who have had a message to them and the number of
messages. Note that this number also includes failed pages too. To view a 
list of the actual pages you can double click on the receiver name. If you 
wish to see a listing of the pages sorted by the date they were send out 
you can select the date button on the top of the dialog box.

	Once you double click on a receive name or date a new dialog box will
open with the actual listing of the messages sent. To view the full message
simply select that message from the list. You will now see the full message 
that was sent in the text box on the bottom of the dialog and an error 
message in the status bar just above it if the message failed.

	If you wish to delete the logs you can select the date or name you wish 
to delete and press the delete button. You can also go to the Pref button on 
the main toolbar and select to have the logs deleted after X number of days.
Note that at this time g-page only scans for logs to delete when it is started
up, if you leave your g-page client up and running all the time the auto log
delete function will not work properly.


RUNNING IN QPAGE MODE
	
	If you want to send pages to a quick page snpp server to dispatch
them via the TAP protocol you need to click on the Pref toolbar then select
the advanced tab. Select yes for view advanced options. You should now have
a set of radio buttons on the main q-page screen. If you activate qpage mode
from this screen g-page will ignore the service you have setup for all your 
receivers and send them to the SNPP address defined under the advanced options, 
this should be the address that quick page is listening on. This is a bit of
a kludge but should work fine for using g-page as a front end to quick page.


	                      AUTO PAGE

	Auto Page is a mode which includes many different features and means for
sending a page automatically. You can access autopage by clicking the Auto button
on the main toolbar or from menu Utilities->Auto page. Autopage can be run from 
the client or run as a daemon without the client. All the data for autopage is kept 
local to each client so it needs to be running. Of course you can minimize it and 
let it run in the background.

RUNNING AUTOPAGE AS A DAEMON:

	To run autopage as a daemon you will need to start it from a terminal command
prompt with the following command:

gpage auto "complete profile name" (minus the quotes) where the profile name can be 
the default "AUTO_SCRIPT.dat" or any other profile that you have created and saved.
To stop the autopage daemon it is recommended that you use the stop_deamon.pl script
included with the g-page files as it will kill the daemon and cleanup any temp files
created by autopage.

The auto page dialog box has four tabs:

ACTIVE FILE: -  This box shows the current auto page settings if you have an active file. If
		you do have an active file you can disable it by clicking on the 
		"Deactivate Current Script" button. If you want to re-start the previous
		script while there isn't an active file you can click the "Reload Previous
		Script" button. If you have autopage running and try to save new settings
 		you will get an error message. You must deactivate autopage before
		trying new settings.

		If you click on the Run button g-page will save the current autopage
		settings in the AUTO_SCRIPT.dat" profile. If you wish to save multiple
		profiles you will need to click on the Save/Run button. You will then
		be prompted for a name for your profile then it g-page will save that
		profile and launch autopage.

		To delete a profile you need to select that profile name in the 
		drop-down list box and click on the Delete button.

		
FILE OPTIONS - 	This is where you will define the data you want to have sent out to a 
		pager or group of pagers. You can do this in several ways:

1) You can define a script for g-page to execute which performs some action then loads some
   data into a file. The file will then be sent out to a pager. The script to execute needs 
   to be entered in the "Full path of script" field, and the target file that will be 
   sent out needs to be entered in the "Full path of target file" field. You must enter
   the full path and not the relative path for these files. You must have permission to
   execute the script you enter or g-page will not attempt to send any data.

2) You can leave the script field blank and just enter the name of the target file. In this 
   case g-page will not try to execute any scripts and will just look for the target file
   to send to a pager. You will do this if the file is going to be created by another