The Regions section of the XML file is made up of three pieces of information.

• ISO2 two-letter country code   This is the two-letter code from ISO 3166-1 alpha-2.
  
  
• Country code   This code is obtained from the List of ITU-T Recommendation E.164 Assigned Country Codes.
  
  
• Phone number example   This example format is optional.
  
  
• The regions section in the XML file might look like the following:
  
  

	Copy Code
<Regions> <Region Iso2="CN"> <CountryCode>86</CountryCode> <PhoneNumberExample>139 0000 0000</PhoneNumberExample> </Region> </Regions>

Note:
If the custom XML file tries to define the same region as one contained in the default file, the entry in the default file will be overwritten.

The carrier information section contains the following two pieces of information:

• ID   This is a 5-digit number that's unique within the default and customized SMTP configuration XML files.
  
  
• Carrier localized name   Each carrier can have multiple names. This is the localized name for the carrier in the local region. You can specify display names for a variety of localities. An English display name should always be specified as a default.
  
  

The carriers section of the XML file might look like the following:

	Copy Code
<Carriers> <Carrier Identity="30344"> <LocalizedInfo Culture="en"> <DisplayName>Gold Systems, Inc.</DisplayName> </LocalizedInfo> </Carrier> <Carrier Identity="30345"> <LocalizedInfo Culture="en"> <DisplayName>China Mobile</DisplayName> </LocalizedInfo> <LocalizedInfo Culture="zh"> <DisplayName>中国移动</DisplayName> </LocalizedInfo> </Carrier> </Carriers>

Note:
If the XML file contains Unicode text for the localized carrier name, you must save the XML file in a UTF-8 or Unicode encoding format.

The service section defines the SMTP gateway specification. Three types of information are included in this section of the XML file.

• Region ISO   The Region ISO you are specifying must have been previously defined in the Region section of the XML file.
  
  
• Carrier   The Carrier identity must have been previously defined in the Carriers section of the XML file.
  
  
• SMTPToSMSGateway   This section of the file contains the following information:
  
  
  • SMTP address   This is the SMTP address for the message to be routed to when an SMS notification is generated. There are two keywords in this field. %c is the country code specified in region section and %n is the local phone number.
    
    
  • MessageRendering   This container defines how the message is rendered. It includes several parameters. The Container parameter can have one of two values. If the value is body, then the SMS message content is stored in the message body. If the value is subject, then the SMS message content is stored in the message subject. The Capacity parameter specifies how many characters can be contained in one SMS message. The CodingScheme property of the Capacity parameter can be either GSMDefault, Unicode, or Euc-KR.
    
    

An example service section might look like the following.

	Copy Code
<Service> <RegionIso2>CN</RegionIso2> <CarrierIdentity>30345</CarrierIdentity> <Type>SmtpToSmsGateway</Type> <SmtpToSmsGateway> <RecipientAddressing> <SmtpAddress>%n@139.com</SmtpAddress> </RecipientAddressing> <MessageRendering Container="Body"> <Capacity CodingScheme="GsmDefault">140</Capacity> <Capacity CodingScheme="Unicode">50</Capacity> </MessageRendering> </SmtpToSmsGateway> </Service>

For a GSM network, GsmDefault capacity should always be specified, while Unicode is optional. When Unicode is not specified, all Unicode characters will be automatically converted to ? in the system.

For a CDMA network, at least one capacity should be specified.

Note:
Typically, the SMTP gateway will use some characters for extra information, such as the from field. Set aside enough buffer when specifying message length for some of this extra information.