sms messaging
NotePage Logo
NotePage Software
NotePage Orders
Download NotePage Software
Software Solutions
NotePage Support

 SNPP Settings
 WCTP Settings
 TAP Numbers
 SMTP Settings
 PageGate Support
 NotePager Pro Support
 Learning Center
 Support Forum
NotePage Resellers
NotePage Press Releases

NotePage Background Graphic

PageGate Advanced ASCII Setup Video Tutorial

PageGate Advanced ASCII Setup

Please be patient while the video loads
wmv video format mov video format
itunes feed avi video format

PageGate Advanced ASCII Setup Transcript for Video:
Welcome to the tutorial on how to configure the Advanced Options for the GetAscii module in PageGate.

In this tutorial, we'll be going over how to configure the program to read in non-standard ascii data types.

Before we begin with the configuration, I'm going to pull up an example of a standard ASCII data file.

You should notice that the first line of the file is the recipient the message should be delivered to.

The second line identifies who sent the message.

The third and following lines tells the program what message to be sent to the recipient.

Now I'm going to pull up an example of a nonstandard ASCII data file.

You should notice that the data looks nothing like the standard file. Even though the data is in different places and parsed by different strings, the program can still read this data file in, parse the data, and send out the message.

So, to begin, run the PageGate Admin.

In Windows, go to your start menu, go to programs, find the PageGate program group, and left click on the PageGate Admin.

Once in the Admin, left click on the + next to Interfaces.

Then click on the + next to GetAscii.

Click on the + next to Settings under GetAscii.

Left click on the + next to Advanced Polling and you'll see these sections expand: Files, Symbols, Record, Recipient, Sender, and Message.

The first step is to click on the Files section.

The Files section allows you to specify new polling directories and also allows you to specify nonstandard file types for the program to look for.

Left click on Add.

In the Add Polling Entry section, you'll see the following fields.

The Recipient section allows you to specify whether files of a certain type should always go to the exact same recipient or group or if it should apply to all recipients and groups.

For this example, we're going to leave the Recipient as an Asterisk, indicating all recipients and groups.

Next is the From field. If you want to hard code a sender's name that will override any sender's information read in from a file, enter it here.

In the Files section, specify the specific file name or extension of the files to look for.

If you remember, my nonstandard sample file ended in .txt

By default, PageGate does not look for .txt files but it looks for .asc files. In order for PageGate to read in a .txt file, we'll need to enter *.txt in the File(s) section.

Next is the path. If these .txt files are going to be written to the standard polling directory, enter it there. If the fields are going to be written to a completely separate directory, left click on the elapses button, browse out to the folder, select it, then left click on okay.

Finally, we have the File Type. Since we want to read in a nonstandard ASCII data file, change this to Custom.

After entering your information, left click on Apply.

Left click on Apply one more time to close the Advanced Polling files.

The next category is Symbols.

By default, the program considers the following characters as special symbols:

? represents a single character wildcard.

* represents Multiple characters.

~ represents the end of record symbol.

\ represents the beginning of an ASCII value.

More often than not, you'll want to leave these symbols on their default values.

Next we have the Record section.

The record defines the full record, from beginning to end, and should not be confused with the message. All information contained within a single file is considered a record.

If we want PageGate to consider all information in a file, from start to finish, a record then we'll need to change the start pattern to a *, indicating any character can be the first character of the record.

Then change the End Pattern to a ~ and left click on Apply.

Next we have the Recipient section.

In this section, we can specify a static recipient or group, indicating that all custom files processed should always go to a specific recipient or group or we can choose to have the program dynamically process the data of the record for the recipient information.

In this case, we want to have a Dynamic Recipient.

In the background, you should see the nonstandard sample that we saw earlier.

To get PageGate to properly process the data, we'll need to tell it how to do so.

The Start Pattern indicates the character or string of characters that will always precede the recipient value. In the example file, this is Name=

So, in the Start Pattern, enter Name=

The Start Offset, in this case, needs to be set to 5 since Name= is five characters. This tells PageGate not to actually include the Start Pattern as part of the recipient's name.

The End pattern indicates the character or string of characters that will always come after the recipient value. In this example, it's a carriage return.

To enter a carriage return as an end pattern, we first need to know what the ASCII value for a carriage return is. It's \013. If you'll remember the \ indicates the ASCII value delimiter and let's the program know that this sequence is to be considered an ASCII string.

Change the End Offset to -1 to tell the program not to include the carriage return as part of the end pattern.

Below that, you'll see a checkbox that says "Use Lookup Table".

The lookup table function allows use to modify data on the fly. So, in the example data file, you'll see that the recipient referenced is 'sample'.

I don't have a recipient named sample, so the message will fill if the program attempts to read the data in as it is.

Put a check in Lookup Table, then left click on the Edit Table button.

Left click on Add.

Now, in my example, I don't have a recipient named sample, so for the data in, I'm going to enter sample

Then, in the data out, I'm going to enter the name of a valid recipient in the program: sample_smtp_recipient.

Left click on Apply, then left click on Apply again.

Next is the Sender section.

In my example file, the sender is denoted by the 'Generated by=' line.

So, my start pattern is going to be Generated by= and the start offset is going to be 13, since there are thirteen characters in Generated by=

Next, we need to tell it the End Pattern. In the Recipient section, we used a carriage return because it was the first carriage return in the file.

If we attempt to use a carriage return in the sender's end pattern, the program won't know what to do and won't process the data properly.

In my example file, my end pattern for the Sender's information is actually the following line. So, in the end pattern, I'm going to enter Generated on= and set the offset to -14. The reason I set it to -14 is that I want the program NOT to include the data value... and I also don't want it to include the carriage return.

As in the recipient section, you can use the lookup table to search and replace data strings within the sender's value.

Left click on Apply.

The final section is the message section.

In my example file, the start pattern would be Message contents= and my start offset will be 17.

The end pattern we will set to a ~ because we want all information between Message contents= and the end of the file. Leave the end offset at zero.

Left click on Apply.

This concludes the tutorial for how to configure the Advanced Options for the GetAscii module in PageGate. For more tutorials, including how to configure the other modules of PageGate, please visit our website, www.notepage.net

- Video RSS Feed


Video Tutorials

Video tutorials for NotePager Pro and PageGate.

Educational Articles

Educational articles for text messaging software.

NotePager Pro Screen Shot Tutorials

Tutorials on how to use NotePager Pro.

How Messaging Works

Explains the in's and out's of text messaging.

Wireless Messaging Glossary

Glossary containing terms related to wireless messaging.

Support Forum

Forum for technical support for NotePager Pro and PageGate.

Support Settings

We have updated a number of the SNPP, WCTP, TAP and SMTP settings in the support section.

send sms
Copyright 1996-2020 NotePage, Inc. Privacy Policy
View Mobile Version NotePage.net