Recipient

Top  Previous  Next

This section is where you configure the pattern recognition to determine what represents who the messages should go to.

 

ascrecip

 

There are two possible configurations you can use:

Static Recipient

ascstatrecip

 

Selecting this option tells the GetSerial module that all messages processed from the RS232/Serial line should go to the specified recipient or group.

 

Dynamic Recipient

ascdynrecip

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

 

Start Pattern

This value determines the first character in the recipient value.

 

For example, let's say this is a data string identified as the record and let's also say that the first three characters represent the recipient or group this message should go to:

A04 Refrigeration Unit 003 Temperature High 84.31 N773

 

or another example:

B16 Refrigeration Unit 007 Temperature High 92.74 N712

 

or another example:

A29 Refrigeration Unit 005 Temperature High 85.93 N798

 

You would want to use * as the Start Pattern as the recipient information is the first value in the string of data. Start patterns are included in the recipient processed unless you specify the otherwise with the Start Offset.

 

Start Offset

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

 

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

 

To use our earlier example, we would want a Start Offset of 0 because we want everything from the first character in the data stream.

 

End Pattern

This value determines the last character in the recipient value.

 

Using our earlier example, we've already specified that the recipient value starts at the very first character in the stream.

A04 Refrigeration Unit 003 Temperature High 84.31 N773

 

or another example:

B16 Refrigeration Unit 007 Temperature High 92.74 N712

 

or another example:

A29 Refrigeration Unit 005 Temperature High 85.93 N798

 

Assuming ? represents the single character wildcard value assigned in the Symbols section, you would want to use ??? as the End Pattern as the first three character sequence in the data represents the recipient value.

 

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 recipient value 3 characters after the first character in the End Pattern. A value of -5 means that GetSerial will stop looking for the recipient value 5 characters before the first character the End Pattern.

 

To use our earlier example, since we have ??? specified as the End Pattern and that three character value represents the recipient value, we would set the Start Offset value to 3. That way, the data record ends three characters after the first character in the file.

 

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.

GetSerialRecipientLookupTable