Message

Top  Previous  Next

This section is where you configure the pattern recognition to determine what value represents the messages read in from the RS232/Serial line.

 

message

 

There are two possible configurations you can use:

Static Message

GetSerialStaticMessage

 

Selecting this option allows you to specify a pre-canned message to be delivered when activity is detected on the serial line.

 

Dynamic Message

message3

Selecting this option tells the GetSerial module to look for specific patterns that denote where the message is located in within the record.

 

Start Pattern

This value determines the first character in the message value.

 

To use the example we've been working with, the record originally started as:

A04 Refrigeration Unit 003 Temperature High 84.31 N773

 

We then configured GetSerial to treat A04 as the recipient value, which removes it from the data string. So, by the time the Message processing happens, this is the remaining data:

Refrigeration Unit 003 Temperature High 84.31 N773

 

As a result, we would want a Start Pattern of * to indicate that the message begins at the first remaining character.

 

Start Offset

This value determines how many characters before or after the identified start pattern to accept as the message. This field can be set to positive or negative values.

 

For instance, a value of 5 means that GetSerial will begin looking for the message 5 characters after the first character in the Start Pattern. A value of -5 means that GetSerial will begin looking for the message 5 characters before the first character the Start Pattern.

 

Using our example, you would want to set the Start Offset to 0.

 

End Pattern

This value determines the last character in the message.

 

In our example, you would want to set the End Pattern to the End of Record symbol in the GetSerial - Settings - Symbols section. This tells PageGate that the last character of the data line is the termination point for the message. So, by configuring a * for the Start Pattern and a ~ for the End Pattern, we're telling PageGate that all of the remaining data is relevant and needs to be in the body of the message delivered.

 

End Offset

This value determines how many characters before or after the identified End Pattern to stop character recognition. This field can be set to positive or negative values.

 

For instance, a value of 5 means that GetSerial will stop looking for the message 5 characters after the first character in the End Pattern. A value of -5 means that GetSerial will stop looking for the message 5 characters before the first character the End Pattern.

 

Lookup Table

The lookup table enables PageGate to perform basic search and replace commands. This allows you to interchange or translate values as needed. To enable this feature, check Use Lookup Table and click Edit Table.

GetSerialMessageLookup