Variables for SMTP/Email

Top  Previous  Next

These variables control how PageGate sends SMTP/Email messages.

Generally speaking, you'll want to configure the first five variables in the Global Template.

Variables specified on a carrier level will override variables specified on a global level.

 

NOTE: When referencing any non-printable character, such as a line feed, carriage return, horizontal tab or similar, you must use the ASCII code for that character and it must be prefixed by a backslash (\).

 

Click here for more information on how PageGate sends Email.

 

Variable

Description and Possible Values

UseAlternateDNS

Set this to True or False.

This variable tells PageGate to use an alternate method to get MX records from DNS servers.

Example: UseAlternateDNS = True

If this variable is not present, a False value is assumed.

InternetDomain

This variable sets the value of the %InternetDomain% macro used by the SMTPHelloHost and is also used by other protocols when certain values need to be transformed in to valid email addresses.

 

When configured for direct delivery, PageGate must declare an email domain name within the SPF record of the system's public IP address.

When configured for relayed delivery, PageGate must declare the email domain name required by the relaying SMTP server.

SMTPHelloHost

This variable should always be set to %InternetDomain%.

Example: SMTPHelloHost = %InternetDomain%

During the SMTP negotiation sequence, PageGate must declare the domain it is delivering traffic on behalf of in the EHLO/HELO statement. This value is specified by the previous InternetDomain variable.

SubjectDelimiter

This value determines what character PageGate will recognize as the delimiter (separator) for the subject part of a message.

 

PageGate looks for the SubjectDelimiter within the number of characters specified in the SubjectSearchLength (see below) value. If any character in the SubjectDelimiter string is found, PageGate uses everything before the delimiter as the subject. Multiple delimiters can be specified and you will need to separate each value by a pipe '|', which functions as an OR statement.

 

For example, let's say we wanted a colon (:) to be the SubjectDelimiter value. This is what we would use:

SubjectDelimiter = :

 

Let's also say we have a message that says "This is the subject: This is the message".

 

PageGate program would recognize "This is the subject" as the subject and use it as such because it was followed by a ':'.

 

As another example, let's say we have this specified:

SubjectDelimiter = \013\010|\013|\010  

 

This configures PageGate to recognize a Carriage Return + Line Feed OR a Single Carriage Return OR a Single Line Feed as the subject delimiter.

SubjectSearchLength

This variable determines the number of characters within the message to look for the subject.

For example, SubjectSearchLength = 50 would tell PageGate to scan the first 50 characters of the message for any specified subject delimiter.

SubjectDefault

In the event that PageGate does not see any variables specified by SubjectDelimiter within the SubjectSearchLength string, this is the default text that will be used as the subject instead.

From

This variable overrides the value passed into PageGate by the APIs/modules/interfaces. By specifying this variable, you're telling PageGate to use a single, standardized sender's name for all traffic controlled by this template.

ReplyTo

If the reply email address should be something other than the 'From' value, this variable allows you to specify the necessary address. Example:

ReplyTo = YourEmail@domain.com

To

This variable overrides the ID/PIN or Email values. By specifying this variable, you're telling PageGate to send all traffic processed by this template to the specified ID or email address.

EnvelopeFrom

This variable is similar to the 'From' variable found above. However, this setting will only change who the message is reported to be from during the communication session with the carrier.  It has no effect the message content or values specified by any Macro.

EnvelopeTo

This variable is similar to the 'To' variable found above. However, this setting will only change who the message is set to during the communication session with the carrier. It has no effect the message content or values specified by any Macro.

EnvelopeFromAsEmail

Set to True or False. If this variable is not present in the template, a False value is assumed.

 

This variable forces the EnvelopeFrom value to be turned into an valid email address if it isn't already. This variable only applies to the SMTP and WCTP protocols.

InterMessageDelay

Set this to a number of milliseconds (1000 = 1 second).

 

This variable tells PageGate to delay for the specified number of milliseconds after delivering each message.

SMTPForceStartTls

Set this to True or False.
This variable forces a given connector or carrier to use STARTTLS for its SMTP transactions.

SMTPConnectTimeout

This variable specifies the number of seconds PageGate should wait for a response from an SMTP host.

The following example specifies a 40 second time-out:
SMTPConnectTimeout = 40

SMTPQpEncode

By default, PageGate uses Quoted Printable encoding for SMTP/Email. However, there are some systems that can't interpret this format and require plaintext. To turn QP Encoding off, specify the following:

SMTPQpEncode = False