TAP IP Server
|Top Previous Next|
The TAP IP Server allows PageGate to receive the TAP protocol by TCP request instead of serial or modem line. Messages received by this API are output to a directory as a text file that is then read in by the GetASCII API. This API requires the GetASCII API to function.
Step 1: Create a directory for the TAP IP Server
1) In Windows, create a new directory for the TAP IP receiver. This can be any folder accessible to PageGate, whether on the local hard drive or by UNC path to a network resource. However, if PageGate will need to reference a network resource, the services relevant to these processes will need permission to access it. For more information, see the services section of the documentation. We recommend creating a directory called IPTAP as a sub-directory of PageGate's database directory (By default, c:\PageGateData\IPTAP\).
2) In Windows, browse in to the PageGate program directory.
3) Move the TapIpServer.exe, pininfo.txt and tapip.ini files to the folder you created in step 1.
Step 2: Configure the TAP IP Server's settings
1) The first thing we'll need to do is modify the tapip.ini file. Open the file in notepad.
To give you a little more information, the tapip.ini file controls the behavior of the TAP IP Server. If you are running the evaluation version, it will stop itself every 3-5 days, and/or after 500 messages, whichever comes first.
2) Change the OutputFolder= value to the directory you created in step 1. By default, C:\PageGateData\IPTAP\
4) Save the .ini file and close notepad.
5) Open pininfo.txt in notepad.
This file tells the SNPP server what range of numbers can be passed to the server. The format of the entries defined in this text file are:
"Starting PIN", "Ending PIN", "recipient type"
If you would like ID numbers in a range to be recognized as the recipient's name (not using ad-hoc, but using numeric recipient names in PageGate), use the text "PG_Recipient" as shown below:
6) After declaring the appropriate ID ranges, save and close the file.
Step 3: Run the TAP IP Server
1) Open a command prompt with elevated permission.
2) Change directory to the TAP IP Server's program directory. By default, c:\PageGateData\IPTAP\
3) Type the following and hit enter:
4) Exit the command prompt.
5) Open the Services list in Windows.
6) Go in to the Properties of the PageGate TAP IP Server service.
7) Change the Startup Type to Automatic and Start the Service.
Step 4: Configure the GetASCII API to process the TAP IP Server's messages
1) Go to Interfaces - GetASCII - Settings.
2) Set the 'Polling Directory' to the output folder. By default, C:\PageGateData\IPTAP\
3) Check Enabled.
4) Click Apply.
5) Go to Program - Settings.
6) In the 'Run on this server' section, check GetASCII
7) Click Apply.
8) If prompted for credentials, leave them blank and click Apply again.
Note: If you are already using the GetASCII module, you can use the Advanced Polling Files section to specify the TAP IP Server's output folder as a secondary polling location. The File(s) value will need to be set to *.asc and it is a Standard file type.