Peraton TCP
Peraton CAD has the ability to push out RAW TCP information to AlphaLogging and PageGate's TCP server allows it to receive and parse that AlphaLogging data with PageGate's GetAscii interface and Filter Pack.
Step 1: Create a directory for the TCP Server
1) In Windows, create a new directory for the TCP 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 PeratonTCP as a sub-directory of PageGate's data directory. By default, c:\PageGateData\PeratonTCP\
2) In Windows, browse in to the PageGate program directory.
3) Move the pgtcpserver.exe and pgtcp.ini files to the folder you created in step 1. By default, c:\PageGateData\PeratonTCP\
Step 2: Configure the TCP Server's settings
1) The first thing we'll need to do is modify the pgtcp.ini file. Open the file in notepad.
To give you a little more information, this INI file controls the behavior of the TCP 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) Configure the port the TCP server should listen to. This is the port Peraton CAD will output to. By default, the port is set to 5002.
3) Change the OutputFolder= value to the directory you created in step 1. By default, c:\PageGateData\PeratonTCP\
4) 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\
5) Leave the rest of the settings at their defaults and skip down EndOfRecordDelimiter. When the TCP Server is receiving information, it doesn't really know what in the data is important; it's just receiving a series of TCP data packets. The end of record delimiter tells the TCP server that the expressed series of characters denotes a break in the data stream.
This is an example of what a series of data packet from PeratonCAD look like:
mm-dd-yy hh:mm:ss example@address.org<mailto:example@address.org> |CADID# |RECIPIENT CODE CODE CALLSTATUS
mm-dd-yy hh:mm:ss example@address.org<mailto:example@address.org> |CADID# |RECIPIENT CODE CODE CALLSTATUS
mm-dd-yy hh:mm:ss example@address.org<mailto:example@address.org> |CADID# |RECIPIENT CODE CODE CALLSTATUS
If you set EndOfRecordDelimiter = \013, that tells the TCP server that a carriage return denotes the end of a record. Using the above example, each line would be treated as its' own record.
6) Below that, there are RequiredText and RequiredTextOperator values that can be set.
RequiredText specifies text that must appear for a data block to be processed and you may specify multiple values by separating each with a | (pipe).
The RequiredTextOperator specifies whether you're using OR or AND logic.
For example, let's say you specify the following:
RequiredText=DISP|ENR
RequiredTextOperator=OR
That would tell the TCP server that if CAD references DISP or ENR, that data block needs to trigger message delivery.
As another example:
RequiredText=UNIT1|UNIT2|UNIT3
RequiredTextOperator=OR
That would tell the TCP server that CAD has to reference UNIT1, UNIT2 or UNIT3 for it to trigger messages.
7) Next we have EndOfRecordTimeout, whose value is expressed in milliseconds. This value tells the TCP server how long to wait before timeout after receiving data, to accept a data record.
By default, this is set to 3000 milliseconds or 3 seconds.
8) Now let's skip down to the last two two settings: StaticRecipient and StaticSender. Set them both to this:
StaticRecipient=
StaticSender=
9) If you have purchased the program, you'll also want to add this line to the bottom of the file:
Registration= Your PageGate Registration Ke Number, including the dashes
10) Save and close the file.
Step 3: Run the TCP Server
1) Open a command prompt with elevated permission.
2) Change directory to the TCP Server's program directory. By default, c:\PageGateData\PeratonTCP\
3) Type the following and hit enter:
pgtcpserver /install
4) Exit the command prompt.
5) Open the Services list in Windows.
6) Go in to the Properties of the PageGate TCP Server service.
7) Change the Startup Type to Automatic and Start the Service.
Step 4: Configure the GetASCII process the TCP Server's messages
1) Go to Interfaces - GetASCII - Settings.
2) Set the 'Polling Directory' to the output folder. By default, C:\PageGateData\PeratonTCP\
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.
