SNPP Server

Top  Previous  Next

This interface allows PageGate to function as an SNPP server to receive this protocol. Messages received by this API are output to a directory as a text file that is then read in by the GetASCII API.

 

Step 1: Create a directory for the SNPP Server

 

1) In Windows, create a new directory for the SNPP Server. 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 SNPP as a sub-directory of PageGate's database directory (By default, c:\PageGateData\SNPP\).

 

2) In Windows, browse in to the PageGate program directory.

 

3) Move the snppserver.exe, pininfo.txt and snpp.ini files to the folder you created in step 1.

 

Step 2: Configure the SNPP Server's settings

 

1) The first thing we'll need to do is modify the snpp.ini file. Open the file in notepad.

 

To give you a little more information, the snpp.ini file controls the behavior of the SNPP 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\SNPP\

 

3) Change the LogFolder= value to your logging directory. If you are unsure of what this folder is, open the PageGate Admin and go to the Program - Settings section. By default, C:\PageGateData\Logs\

 

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:

"0001","9999", "PG_Recipient"

 

If you would like ID numbers in a range to be passed through PageGate as intact ID's to another source in an ad-hoc range, use the name of a Recipient in PageGate whose type is Ad-Hoc.

"0000001","4999999","adhoc1"

6) After declaring the appropriate ID ranges, save and close the file.

 

Step 3: Run the SNPP Server

 

1) Open a command prompt with elevated permission.

 

2) Change directory to the SNPP Server's program directory. By default, c:\PageGateData\SNPP\

 

3) Type the following and hit enter:

snppserver /install

 

4) Exit the command prompt.

 

5) Open the Services list in Windows.

 

6) Go in to the Properties of the PageGate SNPP Server service.

 

7) Change the Startup Type to Automatic and Start the Service.

 

Step 4: Configure the GetASCII API to process the SNPP Server's messages

 

1) Go to Interfaces - GetASCII - Settings.

 

2) Set the 'Polling Directory' to the output folder. By default, C:\PageGateData\SNPP\

 

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 SNPP 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.