電子郵件至 SMS 轉換:控制電子郵件至 SMS 轉換程序的選項。
SMS 閘道伺服器選項︰閘道設定檔選項。
SMS 欄位︰控制已產生的 SMS 郵件中特定 SMS 欄位的選項。
SMPP 協定︰與經由 TCP/IP 的 SMPP 協定之使用關聯的選項。
本土化︰允許插入 SMS 郵件中的文字欄位本土化的選項。
其他︰除錯和記錄選項。
這些選項在下表中概括,並會在後續各節中加以更完整的說明。
表 C–5 SMS 通道選項
|
|
|
---|---|---|
電子郵件至 SMS 轉換選項 |
||
選項 (頁碼) |
說明 |
預設值 |
指定是否將電子郵件通知郵件轉換成 SMS 郵件。 |
0 |
|
從電子郵件中擷取的郵件部分之最大數量 |
2 |
|
從電子郵件中擷取的最大位元組數量 |
960 |
|
可置入單封 SMS 郵件中的最大位元組數量 |
160 |
|
電子郵件可分割成的 SMS 郵件最大數量 |
6 |
|
路由 SMS 郵件至指定 IP 主機名稱。 | ||
SMSC 使用的預設字元集。 |
US-ASCII |
|
設定 SMS 來源位址 |
0 |
|
控制電子郵件標頭中優先權資訊的使用 |
1 |
|
產生 SMS 來源位址時,控制 Reply-to: 標頭行的使用 |
0 |
|
產生創建者資訊時,控制 Resent-*: 標頭行的使用 |
0 |
|
控制電子郵件標頭中私密性資訊的使用 |
1 |
|
在 SMS 郵件中使用 UCS2 字元集 (如果有) |
1 |
|
SMS 閘道伺服器選項 |
||
符合在 SMS 閘道伺服器的配置檔案 sms_gateway.cnf 中配置的閘道設定檔名稱 |
不適用 |
|
SMS 欄位選項 |
||
SMS 目標位址的預設 NPI |
0x00 |
|
SMS 目標位址的預設 TON |
0x01 |
|
SMS 郵件的預設優先順序設定 |
0=GSM, CDMA 1=TDMA |
|
SMS 郵件的預設私密性值旗標 |
-1 |
|
與已提交的 SMS 郵件關聯的 SMS 應用程式服務 |
不適用 |
|
預設 SMS 來源位址 |
0 |
|
SMS 來源位址的預設 NPI |
0x00 |
|
SMS 來源位址的預設 TON |
0x01 |
|
SMS 郵件的預設有效期 |
不適用 |
|
縮減目標 SMS 位址為僅含字元 0 - 9 |
0 |
|
置於目標 SMS 位址之前的文字字串 |
不適用 |
|
要使用的 SMS 設定檔 |
GSM |
|
使用 SMS sar_ 欄位列出多個 SMS 郵件 |
0 |
|
SMPP 協定選項 |
||
連結至 SMPP 伺服器時指定的 ESME NPI |
0x00 |
|
連結至 SMPP 伺服器時指定的 ESME TON |
0x00 |
|
執行 Sun Java System MessagingServer 的主機 IP 位址 |
不適用 |
|
連結至 SMPP 伺服器時提交的密碼 |
不適用 |
|
連結時向 SMSC 提交的系統標識 |
不適用 |
|
連結時向 SMSC 提交的系統類型 |
不適用 |
|
單一階段作業中,可透過 SMPP 伺服器提交的 SMS 郵件之最大數量 |
1024 |
|
多部分 SMS 郵件的傳輸序列 |
0 |
|
同時執行的 SMPP 伺服器連線的最大數量 |
20 |
|
對於單向 SMS,SMPP 伺服器偵聽的 TCP 連接埠。對於雙向 SMS,為供 SMPP 轉送的 LISTEN_PORT 使用的 TCP 連接埠。 |
不適用 |
|
對於單向 SMS,要連線的 SMPP 伺服器之主機名稱。 對於雙向 SMS,設定為指向 SMS 閘道伺服器主機名稱或 IP 位址。如果使用 SMPP 轉送的 LISTEN_INTERFACE_ADDRESS 選項,則務必使用與指定的網路介面位址關聯的主機名稱或 IP 位址。 |
不適用 |
|
透過 SMPP 伺服器完成讀取和寫入的逾時 |
30 |
|
本土化選項 |
||
用於介紹電子郵件內容的文字 |
Msg: |
|
遞送延遲通知的格式化字串 |
空白字串 |
|
遞送失敗通知的格式化字串 |
請參閱說明 |
|
轉送通知的格式化字串。 |
請參閱說明 |
|
遞送成功通知的格式化字串。 |
請參閱說明 |
|
顯示用於指示電子郵件創建者的文字 |
$a |
|
沒有創建者時顯示的文字 |
不適用 |
|
(i-預設) 可從中選取文字欄位的語言群組 |
i-default |
|
置於從電子郵件中擷取的每行結尾處的文字 |
空格字元 |
|
用於指示郵件無內容的文字 |
]no message] |
|
顯示用於指示電子郵件訊息主旨的文字 |
$s |
|
電子郵件無主旨時顯示的文字 |
不適用 |
|
其他選項 |
||
啟用詳細除錯輸出 |
6 |
|
所有 SMPP 轉送器與伺服器實例中並行運作的內送 TCP 連線最大數量 |
10,000 |
|
控制 mail.log 檔案訊息大小欄位中記錄的值是頁數,而不是區段。 |
0 |
以下選項控制電子郵件至 SMS 郵件的轉換。括號中是選項值的範圍。一封指定的電子郵件一般都可以轉換成一封或多封 SMS 郵件。請參閱C.2.2 電子郵件至 SMS 轉換程序
(0 或 1) 指定是否將電子郵件通知轉換成 SMS 通知。電子郵件通知郵件必須符合 RFC 1892、1893、1894。預設值為 0。
當 GATEWAY_NOTIFICATIONS=0 時,這類通知將被捨棄,不會轉換成 SMS 通知。
若要啟用將通知轉換成 SMS 通知的功能,請設定 GATEWAY_NOTIFICATIONS=1。當此選項設定為 1 時,本土化選項 (DSN_*_FORMAT) 將控制轉換成 SMS 郵件並經由閘道傳送的通知類型 (成功、失敗、延遲、轉送)。(如果通知類型的值為空白字串,則此類型通知不會轉換成 SMS 郵件。)
(整數) 將多部分電子郵件轉換成一封 SMS 郵件時,僅第一批 MAX_MESSAGE_PARTS 數量的文字部分會被轉換。其餘部分將被捨棄。依預設,MAX_MESSAGE_PARTS 為 2。若要讓郵件部分的數量不受限制,可將此值指定為 -1。指定值為 0 時,沒有郵件內容會置於 SMS 郵件中。僅使用電子郵件中的標頭行 (例如,Subject:) 會產生 SMS 郵件。
請注意,包含文字和附件的電子郵件通常由兩個部分組成。更需注意,只有一般文字郵件部分才會轉換。所有其他 MIME 內容類型都將被捨棄。
(整數,>= 10) 使用此選項,可設定從電子郵件產生的 SMS 郵件中能包含的位元組總數的上限。具體來說,MAX_MESSAGE_SIZE 指定的最大位元組數量將用於一封或多封產生的 SMS 郵件。任何額外的位元組都將被捨棄。
依預設,設定上限為 960 個位元組。此對應於 MAX_MESSAGE_SIZE=960。若要讓位元組數量不受限制,可將此值指定為零。
所用的位元組數在電子郵件從 Unicode 轉換成 SMSC 的預設字元集或 UCS2 後產生。這表示,轉換成 UCS2 時,值為 960 個位元組的 MAX_MESSAGE_SIZE 至多產生 480 個字元,因為每個 UCS2 字元的長度至少為兩個位元組。
請注意,MAX_MESSAGE_SIZE 和MAX_PAGES_PER_MESSAGE選項同時服務於同一目的︰限制產生的 SMS 郵件之整體大小。更確切地說,MAX_PAGE_SIZE=960 和MAX_PAGE_SIZE=160 表示 MAX_PAGES_PER_MESSAGE=6。那為何會有兩個不同的選項?這是為了便於控制整體大小或頁數,而不必考量單一 SMS 郵件的最大大小 MAX_PAGE_SIZE。在通道選項檔案中此功能可能不重要,但在使用C.2.1 將電子郵件導向通道或C.2.1 將電子郵件導向通道定址屬性時很重要,如C.2.1 將電子郵件導向通道中所述。
最後,請注意,會使用 MAX_MESSAGE_SIZE 和 MAX_PAGE_SIZE * MAX_PAGES_PER_MESSAGE 兩個中較小的限制。
(整數,>= 10) 允許在單一 SMS 郵件中使用的最大位元組數目由 MAX_PAGE_SIZE 選項控制。依預設,將使用 160 個位元組的值。其與 MAX_PAGE_SIZE=160 對應。
(整數,1 - 255) 此選項可控制指定的電子郵件能產生的 SMS 郵件之最大數目。實際上,此選項會截斷電子郵件,只將電子郵件中符合 MAX_PAGES_PER_MESSAGE SMS 郵件選項的部分轉換成 SMS 郵件。請參閱MAX_PAGE_SIZE選項的說明,以取得進一步論述。
依預設,MAX_PAGES_PER_MESSAGE 設定為 1 和由MAX_PAGE_SIZE分割的MAX_MESSAGE_SIZE兩者中較大值。
(字串,IP 主機名稱,1-64 個位元組) 所有以設定檔為目標的 SMS 郵件將會使用以下格式的電子郵件位址重新路由至指定的 IP 主機名稱:
SMS-destination-address@route-to
其中 SMS-destination-address 為 SMS 郵件的目標位址,而 route-to 為此選項指定的 IP 主機名稱。SMS 郵件的整個內容會做為產生的電子郵件之內容傳送。PARSE_RE_* 選項會被忽略。
PARSE_RE_* 和 ROUTE_TO 選項互相排斥。在同一閘道設定檔中同時使用這兩個選項會造成配置錯誤。
(字串) 透過此選項,可以指定 SMSC 的預設字元集。請使用以下檔案中指定的字元集名稱
installation-directory/config/charsets.txt
如果未指定此選項,則假定為 US-ASCII。請注意,charsets.txt 使用的助憶名稱在同一目錄中的 charnames.txt 內定義。
處理電子郵件時,標頭行和文字郵件部分會先被解碼,然後轉換成 Unicode。然後,資料會轉換成 SMSC 的預設字元集或 UCS2,具體取決於USE_UCS2選項的值,以及 SMS 郵件是否至少包含一個在預設 SMSC 字元集中找不到的文字影像。請注意,UCS2 字元集是 16 位元的 Unicode 編碼,通常被稱為 UTF-16。
(整數,0 - 2) 設定此選項以允許 From: 位址傳送至 SMSC。該值表示 From: 位址的來源及其具有的格式。表 C–6 顯示允許的值及其涵義。
表 C–6 USE_HEADER_FROM 的值
值 |
說明 |
---|---|
0 |
永遠不從 From: 位址設定 SMS 來源位址。使用找到的屬性-值對 |
1 |
SMS 來源位址設定為 from-local@from-domain,其中 From: 位址為:@from-route:from-local@from-domain |
2 |
SMS 來源位址設定為 from-local,其中 From: 位址為:@from-route:from-local@from-domain |
(0 或 1) 此選項控制 RFC 822 Priority: 標頭行的處理。依預設,Priority: 標頭行的資訊用於設定產生的 SMS 郵件之優先權旗標,覆寫由DEFAULT_PRIORITY選項指定的預設 SMS 優先權。其與 USE_HEADER_PRIORITY=1 對應。若要停用 RFC 822 Priority: 標頭行,請指定 USE_HEADER_PRIORITY=0。
請參閱 DEFAULT_PRIORITY 選項的說明,以取得有關處理 SMS 優先權旗標的進一步資訊。
(0 或 1) 當 USE_HEADER_FROM =1 時,此選項控制是否考量將 Reply-to: 或 Resent-reply-to: 標頭行做為 SMS 來源位址使用。依預設,忽略 Reply-to: 和 Resent-reply-to: 標頭行。與此對應,選項值為 0。若要啟用對這些標頭行的考量,請使用選項值 1。
請注意,RFC 2822 已停用 Reply-to: 和 Resent-reply-to: 標頭行。
(0 或 1) 當 USE_HEADER_FROM =1 時,此選項控制是否考量使用 Resent- 標頭行做為 SMS 來源位址。依預設,忽略 Resent- 標頭行。與此對應,選項值為 0。若要啟用對這些標頭行的考量,請使用選項值 1。
請注意,RFC 2822 已停用 Resent- 標頭行。
(0 或 1) USE_HEADER_SENSITIVITY 選項控制 RFC 822 Sensitivity: 標頭行的處理。依預設,Sensitivity: 標頭行的資訊用於設定產生的 SMS 郵件之私密性旗標,覆寫由 DEFAULT_PRIVACY 選項指定的預設 SMS 私密性。這種情況為預設,對應於 USE_HEADER_SENSITIVITY=1。若要停用 RFC 822 Sensitivity: 標頭行,請指定 USE_HEADER_SENSITIVITY=0。
請參閱DEFAULT_PRIVACY選項的說明,以取得有關處理 SMS 私密性旗標的進一步資訊。
(0 或 1) 如果可能,通道將在其產生的 SMS 郵件中使用 UCS2 字元集。此為預設運作方式,對應於 USE_UCS2=1。若要停用 UCS2 字元集,請指定 USE_UCS2=0。請參閱SMSC_DEFAULT_CHARSET選項的說明,以取得有關字元集問題的進一步資訊。
表 C–7 USE_UCS2 的有效值
USE_UCS2 的值 |
結果 |
---|---|
預設 |
將會儘可能地使用 SMSC 預設字元集。當原始電子郵件包含不屬於 SMSC 預設字元集的文字影像時,便會使用 UCS2 字元集。 |
0 |
一律使用 SMSC 預設字元集。此字元集內不可用的文字影像將以快捷名稱表示,例如以「AE」表示 AE-ligature。 |
SMS 閘道伺服器配置檔案 sms_gateway.cnf 中的閘道設定檔名稱。
以下選項允許用於產生的 SMS 郵件中的 SMS 欄位規格。
(整數,0 - 255) 依預設,會為目標位址指定 NPI (數值規劃指示器) 零值。透過此選項,可以指定替代整數值,範圍為 0 至 255。典型 NPI 值包含下面表 C–8 中的內容︰
表 C–8 數值規劃指標值
值 |
說明 |
---|---|
0 |
未知 |
1 |
ISDN (E.163, E.164) |
3 |
資料 (X.121) |
4 |
電報 (F.69) |
6 |
陸上行動電話 (E.212) |
8 |
國內 |
9 |
Private |
10 |
ERMES |
14 |
IP 位址 (網際網路) |
18 |
WAP 用戶端 ID |
>= 19 |
未定義 |
此選項的值可用以下三種方式指定:
十進位值 (例如 10)。
「0x」前置的十六進制值 (例如,0x0a)。
以下不區分大小寫的文字字串 (括號中是相應的十進位值) 之一資料 (3)、預設 (0)、e.163 (1)、e.164 (1)、e.212 (6)、ermes (10)、f.69 (4)、網際網路 (14)、ip (14)、isdn (1)、陸上行動電話 (6)、國內 (8)、private (9)、電報 (4)、未知 (0)、wap (18)、x.121 (3)。
(整數,0 - 255) 依預設,會為目標位址指定 TON (數字類型) 指標值零。透過此選項,可以指定替代整數值,範圍為 0 至 255。典型 TON 值包含下面表 C–9 中的內容︰
表 C–9 典型 TON 值
值 |
說明 |
---|---|
0 |
未知 |
1 |
國際 |
2 |
國內 |
3 |
網路特定 |
4 |
訂閱者號碼 |
5 |
字母數字式 |
6 |
縮寫式 |
>=7 |
未定義 |
此選項的值可用以下三種方式指定:
十進位值 (例如 10)
「0x」前置的十六進制值 (例如,0x0a)
以下不區分大小寫的文字字串 (括號中是相應的十進位值) 之一縮寫式 (6)、字母數字式 (5)、預設 (0)、國際 (1)、國內 (2)、網路特定 (3)、訂閱者 (4)、未知 (0)。
(整數,0 - 255) SMS 郵件具有強制性優先權欄位。SMS 優先權值的轉譯顯示於以下的表 C–10 中︰
表 C–10 為每個 SMS 設定檔類型解譯的 SMS 優先順序值
值 |
GSM |
TDMA |
CDMA |
---|---|---|---|
0 |
Non-priority |
Bulk |
Normal |
1 |
Priority |
Normal |
Interactive |
2 |
Priority |
Urgent |
Urgent |
3 |
Priority |
Very urgent |
Emergency |
透過此選項可以指定 SMS 郵件的預設優先順序。未指定時,會將預設優先權 0 用於 PROFILE=GSM 和 CDMA,將優先權 1 用於PROFILE=TDMA。
請注意,如果USE_HEADER_PRIORITY=1,且電子郵件具有 RFC 822 Priority: 標頭行,則在該標頭行中指定的優先權將用於設定產生的 SMS 郵件之優先權。尤其是,如果 USE_HEADER_PRIORITY=0,則 SMS 優先權旗標一律會依據 DEFAULT_PRIORITY 選項設定,且一律會忽略 RFC 822 Priority: 標頭行。如果 USE_HEADER_PRIORITY=1,則會使用原始電子郵件 RFC 822 Priority: 標頭行設定 SMS 郵件的優先權旗標。如果此標頭行不存在,則使用 DEFAULT_PRIORITY 選項設定 SMS 優先權旗標。
用於將 RFC 822 Priority: 標頭行值翻譯為 SMS 優先權旗標的對映在下表中顯示︰
表 C–11 將 Priority 標頭翻譯為 SMS 優先權旗標的對映
RFC 822 |
SMS 優先順序旗標 | ||
---|---|---|---|
優先順序:value |
GSM |
TDMA |
CDMA |
Third |
Non-priority (0) |
Bulk (0) |
Normal (0) |
Second |
Non-priority (0) |
Bulk (0) |
Normal (0) |
Non-urgent |
Non-priority (0) |
Bulk (0) |
Normal (0) |
Normal |
Non-priority (0) |
Normal (1) |
Normal (0) |
Urgent |
Priority (1) |
Urgent (2) |
Urgent (2) |
(整數,-1、0 - 255) 是否在 SMS 郵件中設定私密性旗標,且要使用的值由 DEFAULT_PRIVACY 和 USE_HEADER_SENSITIVITY 選項控制。依預設,值 -1 用於 DEFAULT_PRIVACY。表 C–12 顯示了將 DEFAULT_PRIVACY 和USE_HEADER_SENSITIVITY選項設定為各種值的結果。
表 C–12 DEFAULT_PRIVACY 和 USE_HEADER_SENSITIVITY 值的結果
DEFAULT_PRIVACY |
USE_HEADER_SENSITIVITY |
結果 |
---|---|---|
-1 |
0 |
永遠不在 SMS 郵件中設定 SMS 私密性旗標。 |
n >= 0 |
0 |
總是將 SMS 私密性旗標設定為值 n。總是忽略 RFC 822 Sensitivity: 標頭行。 |
-1 (預設) |
預設 |
僅當原始電子郵件包含 RFC 822 Sensitivity: 標頭行時,才設定 SMS 郵件的私密性旗標。在該情況下,SMS 私密性旗標會設定為對應 Sensitivity: 標頭行的值。這是預設。 |
n >= 0 |
1 |
設定 SMS 郵件私密性旗標,使之對應於原始電子郵件的 RFC 822 Sensitivity: 標頭行。如果電子郵件不具有 Sensitivity: 標頭行,則 SMS 私密性旗標的值設定為 n。 |
SMS 私密性值的解譯顯示於以下的表 C–13 中︰
表 C–13 SMS 私密性值的解譯
值 |
說明 |
---|---|
0 |
無限制 |
1 |
有限制 |
2 |
機密 |
3 |
秘密 |
>= 4 |
未定義 |
用於將 RFC 822 Sensitivity: 標頭行值翻譯為 SMS 私密性值的對映,顯示於以下的表 C–14 中︰
表 C–14 Sensitivity 標頭轉換為 SMS 私密性值的對映
RFC 822 Sensitivity: value |
SMS 私密性值 |
---|---|
Personal |
1 (有限制) |
Private |
2 (機密) |
Company confidential |
3 (秘密) |
(字串,0 - 5 位元組) 與通道產生的 SMS 郵件關聯的服務類型。依預設,不指定服務類型 (即為零長度字串)。一些常見服務類型為:CMT (行動郵件傳送)、CPT (行動傳呼)、VMN (語音郵件通知)、VMA (語音郵件提示)、WAP (無線應用程式協定) 以及 USSD (非結構化輔助資料服務)。
(字串,0 - 20 位元組) 供電子郵件產生的 SMS 郵件使用的來源位址。請注意,當 USE_HEADER_FROM=1 時,透過此選項指定的值會由電子郵件的創建者位址所覆寫。依預設,停用此值,亦即值為 0。
(整數,0 - 255) 依預設,為來源位址指定 NPI 值零。透過此選項,可以指定替代整數值,範圍為 0 至 255。請參閱DEFAULT_DESTINATION_NPI選項的說明,以取得典型 NPI 值表。
(整數,0 - 255) 依預設,為來源位址指定 TON 指標值零。透過此選項,可以指定替代整數值,範圍為 0 至 255。請參閱DEFAULT_DESTINATION_TON選項的說明,以取得典型 TON 值表。
(字串,0 - 252 位元組) 依預設,不會為 SMS 郵件指定相對有效期,而是使用 SMSC 的預設值。使用此選項來指定不同的相對有效期。以秒、分鐘、小時或天為單位來指定值。以下的表 C–15 指出此選項中各種值的格式和說明︰
表 C–15 DEFAULT_VALIDITY_PERIOD 格式和值
格式 |
說明 |
---|---|
nnn |
秒鐘的隱式單位;例如 604800 |
nnns |
秒鐘單位;例如 604800s |
nnnm |
分鐘單位;例如 10080m |
nnnh |
小時單位;例如 168h |
nnnd |
天的單位;例如 7d |
可以使用 0、0s、0m、0h 或 0d 規格選取 SMSC 的預設有效期。即,使用 0、0s、0m、0h 或 0d 的規格時,會為產生的 SMS 郵件中的有效期指定一個空白字串。
請注意此選項不接受 UTC 格式的值。
(0 或 1) 使用此選項刪除擷取自電子郵件訊息封 To: 位址的 SMS 目標位址中的所有非數值字元。例如,如果訊息封 To: 位址為︰
"(800) 555-1212"@sms.siroe.com
將被縮減成:
8005551212@sms.siroe.com
若要啟用此刪除功能,請指定此選項的值為 1。依預設,停用此刪除功能,對應於選項值 0。請注意,啟用後,刪除作業會在透過DESTINATION_ADDRESS_PREFIX選項增加任何目標位址字首之前完成。
(字串) 在某些情況下,可能需要確保所有 SMS 目標位址都前置有固定文字字串,例如「+」。此選項可以用於指定這樣一個字首。然後,該字首會加入缺少指定字首的任何 SMS 目標位址中。若要防止被DESTINATION_ADDRESS_NUMERIC選項刪除,應在 DESTINATION_ADDRESS_NUMERIC 選項之後套用此選項。
(字串) 指定與 SMSC 配合使用的 SMS 設定檔。可能的值為 GSM、TDMA 和 CDMA。如未指定,則假定為 GSM。此選項僅用於為其他通道選項 (例如DEFAULT_PRIORITY和DEFAULT_PRIVACY) 選取預設。
(0 或 1) 過大的電子郵件可能需要分割成多封 SMS 郵件。發生這種情況時,個別 SMS 郵件可以選擇性地包含使用 SMS sar_ 欄位加入的定序資訊。這會產生「分段的」SMS 郵件,這些郵件可以透過接收終端機重新組合成單一 SMS 郵件。指定 USE_SAR=1 來指示加入此序列資訊 (如果有)。預設為不加入序列資訊,對應於 USE_SAR=0。
指定 USE_SAR=1 時,會忽略REVERSE_ORDER選項。
以下選項允許用於 SMPP 協定參數規格。這些名稱以字串「ESME_」開頭的選項可用於識別充當外部簡訊實體 (ESME) 的 MTA;亦即 MTA 連結至 SMPP 伺服器,以將 SMS 郵件提交至該伺服器的關聯 SMSC 的情況。
(整數,0 - 255) 依預設,連結作業將指定 ESME NPI 的值為零,表示不明的 NPI。透過此選項,可以指定替代整數值,範圍為 0 至 255。請參閱DEFAULT_DESTINATION_NPI選項的說明,以取得典型 NPI 值表。
(整數,0 - 255) 依預設,連結作業將指定 ESME TON 的值為 0。透過此選項,可以指定替代整數值 (範圍為 0 至 255)。請參閱DEFAULT_DESTINATION_TON選項的說明,以取得典型 TON 值表。
(字串,0 - 15 位元組) 連結至 SMPP 伺服器時,BIND PDU 表示用戶端 (亦即 ESME) 的位址範圍是一個 IP 位址。透過指定 TON 值為 0x00,NPI 值為 0x0d 來完成此作業。位址範圍欄位的值會設定為正在執行 SMS 通道的主機之 IP 位址。請以帶點的十進位格式指定 IP 位址,例如 127.0.0.1。
(字串,0 - 8 位元組) 連結至 SMPP 伺服器時,可能需要密碼。如果是這樣,請透過此選項指定密碼。依預設,使用零長度密碼字串。
(字串,0 - 15 位元組) 連結至 SMPP 伺服器時,可以提供 MTA 的系統 ID。依預設,不指定系統 ID (即,使用零長度字串)。若要指定系統 ID,請使用此選項。
(字串,0 - 12 位元組) 連結至 SMPP 伺服器時,可以提供 MTA 的系統類型。依預設,不指定系統類型 (即,使用零長度字串)。
(整數,>= 0) 有些 SMPP 伺服器可能會限制單一連結階段作業中提交的 SMS 郵件之最大數目。鑑於此,此選項可規定單一階段作業中可提交的 SMS 郵件的最大數量。達到此限制時,通道將中斷連結,關閉 TCP/IP 連線,然後重新連線並再次連結。
依預設,MAX_PAGES_PER_BIND 使用值 1024。請注意,通道還會偵測 ESME_RTHROTTLED 錯誤並在通道的單次執行中相應地調整 MAX_PAGES_PER_BIND。
(0 或 1) 當電子郵件產生多封 SMS 郵件時,這些 SMS 郵件會依排定次序 (REVERSE_ORDER=0) 或反向排定次序 (REVERSE_ORDER=1) 提交至 SMSC。反向排定次序適用於接收終端機首先顯示最後收到的郵件之情形。在這種情況下,最後收到的郵件會是電子郵件的第一部分,而非最後一部分。依預設,使用 REVERSE_ORDER=1。
請注意,指定USE_SAR=1 時,會忽略此選項。
(整數,1 - 50) 此選項控制每個程序中同步執行的 SMPP 連線的最大數量。由於每個連線都有一個關聯的執行緒,因此,此選項還可對每個程序中「工作者」執行緒的最大數量進行限制。依預設,SMPP_MAX_CONNECTIONS=20。
(整數,1 - 65535) 可以使用此選項或 port 通道關鍵字指定 SMPP 伺服器偵聽的 TCP 連接埠。此連接埠號必須透過這兩種機制之一指定。如果同時使用這兩種機制指定,則透過 SMPP_PORT 選項做出的設定優先。請注意,此選項無預設值。
對於雙向 SMS,請確定其連接埠與 SMPP 轉送的 LISTEN_PORT 相同。
(字串,1 - 252 位元組) 對於單向 SMS,依預設,要連線的 SMPP 伺服器之 IP 主機名稱為與通道關聯的正式主機名稱,亦即顯示在 MTA 配置內通道定義第二行的主機名稱。此選項可用於指定不同的主機名稱或 IP 位址,而該主機名稱或 IP 位址將覆寫通道定義中指定的值。指定 IP 位址時,請使用帶點的十進位表示法,例如 127.0.0.1。
對於雙向 SMS,設定為指向 SMS 閘道伺服器主機名稱或 IP 位址。如果使用 SMPP 轉送的 LISTEN_INTERFACE_ADDRESS 選項,則務必使用與指定的網路介面位址關聯的主機名稱或 IP 位址。
(整數,>= 2) 依預設,等候資料寫入 SMPP 伺服器完成或從 SMPP 伺服器接收資料時,逾時時間為 30 秒。使用 TIMEOUT 選項來指定不同的逾時值 (以秒為單位)。指定的值至少為 1 秒。
建構 SMS 郵件時,SMS 通道有大量固定文字字串將置入郵件中。例如,這些字串說明了電子郵件的 From: 位址和 Subject: 標頭行。透過本小節說明的通道選項,可以為不同語言指定這些字串版本,並指定通道的預設語言。範例 C–2 顯示選項檔案的語言部分:
LANGUAGE=default-language [language=i-default] FROM_PREFIX=From: SUBJECT_PREFIX=Subj: CONTENT_PREFIX=Msg: LINE_STOP= NO_MESSAGE=[no message] REPLY_PREFIX=Re: [language=en] FROM_PREFIX=From: SUBJECT_PREFIX=Subj: CONTENT_PREFIX=Msg: LINE_STOP= NO_MESSAGE=[no message] REPLY_PREFIX=Re: ... |
在每個 [language=x] 區塊內,均可以指定與該語言相關的本土化選項。如果在該區塊內未指定特定選項,則會使用此選項的全域值。[language=x] 區塊以外指定的本土化選項會設定此選項的全域值。
對於下列選項字串值必須使用 US-ASCII 或 UTF-8 字元集指定。請注意,US-ASCII 字元集為 UTF-8 字元集的特例。
(字串,0 - 252 位元組) 置於 SMS 郵件內、電子郵件內容自身之前的文字字串。預設的全域值為 US-ASCII 字串「Msg:」。
(字串,0 - 256 個字元) 傳送延遲通知的格式化字串。依預設,此選項使用空白字串,因此禁止延遲通知轉換成 SMS。請注意,GATEWAY_NOTIFICATIONS必須設定為 1,才能使此選項生效。GATEWAY_NOTIFICATIONS=0 時,會忽略此選項。
(字串,0 - 256 個字元) 永久性傳送失敗通知的格式化字串。此選項的預設值為字串:
Unable to deliver your message to $a; no further delivery attempts will be made.
若要禁止轉換失敗通知,請為此選項指定空白字串。請注意,GATEWAY_NOTIFICATIONS必須設定為 1,才能使此選項生效。GATEWAY_NOTIFICATIONS=0 時,會忽略此選項。
(字串,0 - 256 個字元) 轉送通知的格式化字串。預設值為字串:
Your message to $a has been relayed to a messaging system which may not provide a final delivery confirmation
若要禁止轉換轉送通知,請為此選項指定空白字串。請注意,GATEWAY_NOTIFICATIONS必須設定為 1,才能使此選項生效。GATEWAY_NOTIFICATIONS=0 時,會忽略此選項。
(字串,0 - 256 個字元) 傳送成功通知的格式化字串。預設值為字串:
Your message to $a has been delivered
若要禁止轉換遞送成功通知,請為此選項指定空白字串。請注意,GATEWAY_NOTIFICATIONS必須設定為 1,才能使此選項生效。GATEWAY_NOTIFICATIONS=0 時,會忽略此選項。
(字串,0 - 252 位元組) 用於格式化創建者資訊以插入 SMS 郵件中的格式化範本。預設全域值為 US-ASCII 字串「$a」,它會在創建者的電子郵件位址進行替換。請參閱C.3.3.6 格式化範本
(字串,0 - 252 位元組) 沒有創建者位址可供顯示時,置於 SMS 郵件中的文字字串。預設全域值為空白字串。
請注意通常不使用此選項,因為網站通常會拒絕缺少創建者位址的電子郵件。
(字串,0 - 40 位元組) 用於從中選取文字字串的預設語言群組。如未指定,則該語言將取自主機的預設本機規格。如果主機的本機規格不可用或對應於「C」,則使用 i-default。(i-default 對應於「適用於國際使用者的英語文字」。)
(字串,0 - 252 位元組) 置於 SMS 郵件內、自電子郵件擷取的各行之間的文字字串。預設全域值為 US-ASCII 空格字元「 」。
(字串,0 - 252 位元組) 置於 SMS 郵件內以表示電子郵件沒有內容的文字字串。預設全域值為 US-ASCII 字串「[no message]」。
(字串,0 - 252 位元組) 格式化在 SMS 郵件中顯示的 Subject: 標頭行內容的格式化範本。此選項的全域預設值為 US-ASCII 字串「($s)」。請參閱C.3.3.6 格式化範本,以取得進一步詳細資訊。
請參閱 SUBJECT_NONE 選項,以取得不存在 Subject: 標頭行,或該標頭行內容為空字串時如何進行處理的說明。
(字串,0 - 252 位元組) 當原始電子郵件不具有 Subject: 標頭行或 Subject: 標頭行值為空字串時,顯示的文字字串。此選項的預設全域值為空白字串。
(整數,位元遮罩) 啟用除錯輸出。預設值為 6,選取警告郵件和錯誤郵件。任何非零值均會啟用通道自身的除錯輸出,與通道定義上指定 master_debug 相同。表 C–16 定義了 DEBUG 位元遮罩的位元值。
表 C–16 DEBUG 位元遮罩
位元 |
值 |
說明 |
---|---|---|
0 - 31 |
-1 |
極其詳細輸出 |
0 |
1 |
資訊郵件 |
1 |
2 |
警告郵件 |
3 |
4 |
錯誤郵件 |
3 |
8 |
子常式呼叫追蹤 |
4 |
16 |
雜湊表診斷 |
5 |
32 |
I/O 診斷,接收 |
6 |
64 |
I/O 診斷,傳輸 |
7 |
128 |
SMS 至電子郵件轉換診斷 (行動電話發出的郵件與 SMS 通知) |
8 |
256 |
PDU 診斷,標頭資料 |
9 |
512 |
PDU 診斷,內文資料 |
10 |
1024 |
PDU 診斷,類型-長度-值資料 |
11 |
2048 |
選項處理;傳送所有選項設定至記錄檔。 |
使用FROM_FORMAT、SUBJECT_FORMAT以及所有 DSN_* 通道選項指定的格式化範本為 UTF-8 字串,其可能包含文字列文字和替換序列的組合。假定範例電子郵件位址為
Jane Doe <user@siroe>
識別的替代序列顯示於以下的表 C–17 中︰
表 C–17 替代序列
序列 |
說明 |
---|---|
$a |
以創建者電子郵件位址的本機與網域部分替代 (例如,「user@siroe」) |
$d |
以創建者電子郵件位址的網域部分替代 (例如,「 domain」) |
$p |
以創建者電子郵件位址的片語部分 (如果有) 替代 (例如,「Jane Doe」) |
$s |
以 Subject: 標頭行的內容替代 |
$u |
以創建者電子郵件位址的本機部分替代 (例如,「user」) |
\x |
以文字字元「x」替代 |
例如,格式化範本
From: $a
會產生文字字串
From: user@siroe
建構
${xy:alternate text}
可用於在序列 x 關聯的文字中進行替換。如果該文字為空白字串,則會使用與序列 y 關聯的文字。而如果此文字也為空白字串,則以替代文字進行替代。例如,考量格式化範本
From: ${pa:unknown sender}
對於創建者電子郵件位址
John Doe <jdoe@siroe.com>
該位址中包含片語部分,因此範本產生:
From: John Doe
但是對於位址
jdoe@siroe.com
該位址缺少片語,因此產生
From: jdoe@siroe.com
而對於空白創建者位址,則會產生
From: unknown sender