Sun Java System Messaging Server 6 2005Q4 管理指南

可用選項

SMS 通道包含大量選項,這些選項可以分為六大種類︰

這些選項在下表中概括,並會在後續各節中加以更完整的說明。

表 D–5 SMS 通道選項

 

 

 

電子郵件至 SMS 轉換選項 

選項 (頁碼) 

說明 

預設 

GATEWAY_NOTIFICATIONS

指定是否將電子郵件通知郵件轉換成 SMS 郵件。 

0

MAX_MESSAGE_PARTS

從電子郵件中擷取的郵件部分之最大數量 

2

MAX_MESSAGE_SIZE

從電子郵件中擷取的最大位元組數量 

960

MAX_PAGE_SIZE

可置入單封 SMS 郵件中的最大位元組數量 

160

MAX_PAGES_PER_MESSAGE

電子郵件可分割成的 SMS 郵件最大數量 

6

ROUTE_TO

路由 SMS 郵件至指定 IP 主機名稱。 

 

SMSC_DEFAULT_CHARSET

SMSC 使用的預設字元集。 

US-ASCII

USE_HEADER_FROM

設定 SMS 來源位址 

0

USE_HEADER_PRIORITY

控制電子郵件標頭中優先權資訊的使用 

1

USE_HEADER_REPLY_TO

產生 SMS 來源位址時,控制 Reply-to: 標頭行的使用

0

USE_HEADER_RESENT

產生創建者資訊時,控制 Resent-*: 標頭行的使用

0

USE_HEADER_SENSITIVITY

控制電子郵件標頭中私密性資訊的使用 

1

USE_UCS2

在 SMS 郵件中使用 UCS2 字元集 (如果有) 

1

     

SMS 閘道伺服器選項 

GATEWAY_PROFILE

符合在 SMS 閘道伺服器的配置檔案 sms_gateway.cnf 中配置的閘道設定檔名稱

不適用 

     

SMS 欄位選項 

DEFAULT_DESTINATION_NPI

SMS 目標位址的預設 NPI 

0x00

DEFAULT_DESTINATION_TON

SMS 目標位址的預設 TON 

0x01

DEFAULT_PRIORITY

SMS 郵件的預設優先順序設定 

0=GSM, CDMA

1=TDMA

DEFAULT_PRIVACY

SMS 郵件的預設私密性值旗標 

-1

DEFAULT_SERVICE_TYPE

與已提交的 SMS 郵件關聯的 SMS 應用程式服務 

不適用 

DEFAULT_SOURCE_ADDRESS

預設 SMS 來源位址 

0

DEFAULT_SOURCE_NPI

SMS 來源位址的預設 NPI 

0x00

DEFAULT_SOURCE_TON

SMS 來源位址的預設 TON 

0x01

DEFAULT_VALIDITY_PERIOD

SMS 郵件的預設有效期 

不適用 

DESTINATION_ADDRESS_NUMERIC

縮減目標 SMS 位址為僅含字元 0 - 9 

0

DESTINATION_ADDRESS_PREFIX

置於目標 SMS 位址之前的文字字串 

不適用 

PROFILE

要使用的 SMS 設定檔 

GSM

USE_SAR

使用 SMS sar_ 欄位列出多個 SMS 郵件

0

     

SMPP 協定選項 

ESME_ADDRESS_NPI

連結至 SMPP 伺服器時指定的 ESME NPI 

0x00

ESME_ADDRESS_TON

連結至 SMPP 伺服器時指定的 ESME TON 

0x00

ESME_IP_ADDRESS

執行 Sun Java System MessagingServer 的主機 IP 位址 

不適用 

ESME_PASSWORD

連結至 SMPP 伺服器時提交的密碼 

不適用 

ESME_SYSTEM_ID

連結時向 SMSC 提交的系統標識 

不適用 

ESME_SYSTEM_TYPE

連結時向 SMSC 提交的系統類型 

不適用 

MAX_PAGES_PER_BIND

單一階段作業中,可透過 SMPP 伺服器提交的 SMS 郵件之最大數量 

1024

REVERSE_ORDER

多部分 SMS 郵件的傳輸序列 

0

SMPP_MAX_CONNECTIONS

同時執行的 SMPP 伺服器連線的最大數量 

20

SMPP_PORT

對於單向 SMS,SMPP 伺服器偵聽的 TCP 連接埠。對於雙向 SMS,為供 SMPP 轉送的 LISTEN_PORT 使用的 TCP 連接埠。

不適用 

SMPP_SERVER

對於單向 SMS,要連線的 SMPP 伺服器之主機名稱。 

對於雙向 SMS,設定為指向 SMS 閘道伺服器主機名稱或 IP 位址。如果使用 SMPP 轉送的 LISTEN_INTERFACE_ADDRESS 選項,則務必使用與指定的網路介面位址關聯的主機名稱或 IP 位址。

不適用 

TIMEOUT

透過 SMPP 伺服器完成讀取和寫入的逾時 

30

     

本土化選項 

CONTENT_PREFIX

用於介紹電子郵件內容的文字 

Msg:

DSN_DELAYED_FORMAT

遞送延遲通知的格式化字串 

空白字串 

DSN_FAILED_FORMAT

遞送失敗通知的格式化字串 

請參閱說明 

DSN_RELAYED_FORMAT

轉送通知的格式化字串。 

請參閱說明 

DSN_SUCCESS_FORMAT

遞送成功通知的格式化字串。 

請參閱說明 

FROM_FORMAT

顯示用於指示電子郵件創建者的文字 

$a

FROM_NONE

沒有創建者時顯示的文字 

不適用 

LANGUAGE

(i-預設) 可從中選取文字欄位的語言群組 

i-default

LINE_STOP

置於從電子郵件中擷取的每行結尾處的文字 

空格字元 

NO_MESSAGE

用於指示郵件無內容的文字 

]no message]

SUBJECT_FORMAT

顯示用於指示電子郵件訊息主旨的文字 

$s

SUBJECT_NONE

電子郵件無主旨時顯示的文字 

不適用 

     

其他選項 

DEBUG

啟用詳細除錯輸出 

-1

電子郵件至 SMS 轉換選項

以下選項控制電子郵件至 SMS 郵件的轉換。括號中是選項值的範圍。一封給定的電子郵件一般都可以轉換成一封或多封 SMS 郵件。請參閱電子郵件至 SMS 轉換程序

GATEWAY_NOTIFICATIONS

(0 或 1) 指定是否將電子郵件通知轉換成 SMS 通知。電子郵件通知郵件必須符合 RFC 1892、1893、1894。預設值為 0

GATEWAY_NOTIFICATIONS=0 時,這類通知將被捨棄,不會轉換成 SMS 通知。

若要啟用將通知轉換成 SMS 通知的功能,請設定 GATEWAY_NOTIFICATIONS=1。當此選項設定為 1 時,本土化選項 (DSN_*_FORMAT) 將控制轉換成 SMS 郵件並經由閘道傳送的通知類型 (成功、失敗、延遲、轉送)。(如果通知類型的值為空白字串,則此類型通知不會轉換成 SMS 郵件。)

MAX_MESSAGE_PARTS

(整數) 將多部分電子郵件轉換成一封 SMS 郵件時,僅第一批 MAX_MESSAGE_PARTS 數量的文字部分會被轉換。其餘部分將被捨棄。依預設,MAX_MESSAGE_PARTS 為 2。若要讓郵件部分的數量不受限制,可將此值指定為 -1。指定值為 0 時,沒有郵件內容會置於 SMS 郵件中。僅使用電子郵件中的標頭行 (例如,Subject:) 會產生 SMS 郵件。

請注意,包含文字和附件的電子郵件通常由兩個部分組成。更需注意,只有一般文字郵件部分才會轉換。所有其他 MIME 內容類型都將被捨棄。

MAX_MESSAGE_SIZE

(整數,>= 10) 使用此選項,可設定從電子郵件產生的 SMS 郵件中能包含的位元組總數的上限。具體來說,MAX_MESSAGE_SIZE 指定的最大位元組數量將用於一封或多封產生的 SMS 郵件。任何額外的位元組都將被捨棄。

依預設,設定上限為 960 個位元組。其與 MAX_MESSAGE_SIZE=960 對應。若要讓位元組數量不受限制,可將此值指定為零。

在將電子郵件從 Unicode 轉換成 SMSC 的預設字元集或 UCS2 後使用位元組計數。這意味著,對於 UCS2,將產生至多 960 位元組的 MAX_MESSAGE_SIZE,480 個字元 (由於每個 UCS2 字元至少兩個位元組長。)

請注意,MAX_MESSAGE_SIZEMAX_PAGES_PER_MESSAGE選項同時服務於同一目的︰限制產生的 SMS 郵件之整體大小。更確切地說,MAX_PAGE_SIZE=960 和MAX_PAGE_SIZE=160 表示 MAX_PAGES_PER_MESSAGE=6。那為何會有兩個不同的選項?這是為了便於控制整體大小或頁數,而不必考量單一 SMS 郵件的最大大小 MAX_PAGE_SIZE。在通道選項檔案中此功能可能不重要,但在使用將電子郵件導向通道將電子郵件導向通道定址屬性時很重要,如將電子郵件導向通道中所述。

最後,請注意,會使用 MAX_MESSAGE_SIZEMAX_PAGE_SIZE * MAX_PAGES_PER_MESSAGE 兩個中較小的限制。

MAX_PAGE_SIZE

(整數,>= 10) 允許在單一 SMS 郵件中使用的最大位元組數目由 MAX_PAGE_SIZE 選項控制。依預設,將使用 160 個位元組的值。其與 MAX_PAGE_SIZE=160 對應。

MAX_PAGES_PER_MESSAGE

(整數,1 - 255) 此選項可控制給定的電子郵件能產生的 SMS 郵件之最大數目。實際上,此選項會截斷電子郵件,只將電子郵件中符合 MAX_PAGES_PER_MESSAGE SMS 郵件選項的部分轉換成 SMS 郵件。請參閱MAX_PAGE_SIZE選項的說明,以取得進一步論述。

依預設,MAX_PAGES_PER_MESSAGE 設定為 1 和由MAX_PAGE_SIZE分割的MAX_MESSAGE_SIZE 兩者中較大值。

ROUTE_TO

(字串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_DEFAULT_CHARSET

(字串) 透過此選項,可以指定 SMSC 的預設字元集。請使用以下檔案中給定的字元集名稱

installation-directory/config/charsets.txt

如果未指定此選項,則假定為 US-ASCII。請注意,charsets.txt 中使用的快捷名稱在同一目錄中的 charnames.txt 內定義。

處理電子郵件時,標頭行和文字郵件部分會先被解碼,然後轉換成 Unicode。然後,資料會轉換成 SMSC 的預設字元集或 UCS2,具體取決於USE_UCS2選項的值,以及 SMS 郵件是否至少包含一個在預設 SMSC 字元集中找不到的文字影像。請注意,UCS2 字元集是 16 位元的 Unicode 編碼,通常被稱為 UTF-16。

USE_HEADER_FROM

(整數,0 - 2) 設定此選項以允許 From: 位址傳送至 SMSC。該值表示 From: 位址的來源及其具有的格式。表 D–6 顯示允許的值及其涵義。

表 D–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

USE_HEADER_PRIORITY

(0 或 1) 此選項控制 RFC 822 Priority: 標頭行的處理。依預設,Priority: 標頭行的資訊用於設定產生的 SMS 郵件之優先權旗標,覆寫由DEFAULT_PRIORITY選項指定的預設 SMS 優先權。其與 USE_HEADER_PRIORITY=1 對應。若要停用 RFC 822 Priority: 標頭行,請指定 USE_HEADER_PRIORITY=0

請參閱 DEFAULT_PRIORITY 選項的說明,以取得有關處理 SMS 優先權旗標的進一步資訊。

USE_HEADER_REPLY_TO

(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: 標頭行。

USE_HEADER_RESENT

(0 或 1) 當 USE_HEADER_FROM =1 時,此選項控制是否考量使用 Resent- 標頭行做為 SMS 來源位址。依預設,忽略 Resent- 標頭行。與此對應,選項值為 0。若要啟用對這些標頭行的考量,請使用選項值 1。

請注意,RFC 2822 已停用 Resent- 標頭行。

USE_HEADER_SENSITIVITY

(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 私密性旗標的進一步資訊。

USE_UCS2

(0 或 1) 如果可能,通道將在其產生的 SMS 郵件中使用 UCS2 字元集。此為預設運作方式,對應於 USE_UCS2=1。若要停用 UCS2 字元集,請指定 USE_UCS2=0。請參閱SMSC_DEFAULT_CHARSET選項的說明,以取得有關字元集問題的進一步資訊。

表 D–7 USE_UCS2 的有效值

USE_UCS2 的值 

結果 

預設 

將會儘可能地使用 SMSC 預設字元集。當原始電子郵件包含不屬於 SMSC 預設字元集的文字影像時,便會使用 UCS2 字元集。 

始終使用 SMSC 預設字元集。此字元集內不可用的文字影像將以快捷名稱表示,例如以「AE」表示 AE-ligature。 

SMS 閘道伺服器選項

GATEWAY_PROFILE

SMS 閘道伺服器配置檔案 sms_gateway.cnf 中的閘道設定檔名稱。

SMS 選項

以下選項允許用於產生的 SMS 郵件中的 SMS 欄位規格。

DEFAULT_DESTINATION_NPI

(整數,0 - 255) 依預設,會為目標位址指定 NPI (數值規劃指示器) 零值。透過此選項,可以指定替代整數值,範圍為 0 至 255。典型 NPI 值包含下面表 D–8 中的內容︰

表 D–8 數值規劃指標值

值 

說明 

未知 

ISDN (E.163, E.164) 

資料 (X.121) 

電報 (F.69) 

陸上行動電話 (E.212) 

國內 

Private 

10 

ERMES 

14 

IP 位址 (網際網路) 

18 

WAP 用戶端 ID 

>= 19 

未定義 

此選項的值可用以下三種方式指定:

DEFAULT_DESTINATION_TON

(整數,0 - 255) 依預設,會為目標位址指定 TON (數字類型) 指標值零。透過此選項,可以指定替代整數值,範圍為 0 至 255。典型 TON 值包含下面表 D–9 中的內容︰

表 D–9 典型 TON 值

值 

說明 

未知 

國際 

國內 

網路特定 

訂閱者號碼 

字母數字式 

縮寫式 

>=7 

未定義 

此選項的值可用以下三種方式指定:

DEFAULT_PRIORITY

(整數,0 - 255) SMS 郵件具有強制性優先權欄位。SMS 優先權值的轉譯在下面表 D–10 中顯示︰

表 D–10 為每個 SMS 設定檔類型解譯的 SMS 優先順序值

值 

GSM 

TDMA 

CDMA 

Non-priority 

Bulk 

Normal 

Priority 

Normal 

Interactive 

Priority 

Urgent 

Urgent 

Priority 

Very urgent 

Emergency 

透過此選項可以指定 SMS 郵件的預設優先順序。未指定時,會將預設優先權 0 用於 PROFILE=GSMCDMA,將優先權 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 優先權旗標的對映在下表中顯示︰

表 D–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) 

DEFAULT_PRIVACY

(整數,-1、0 - 255) 是否在 SMS 郵件中設定私密性旗標,且要使用的值由 DEFAULT_PRIVACYUSE_HEADER_SENSITIVITY 選項控制。依預設,值 -1 用於 DEFAULT_PRIVACY表 D–12 顯示了將 DEFAULT_PRIVACYUSE_HEADER_SENSITIVITY選項設定為各種值的結果。

表 D–12 DEFAULT_PRIVACYUSE_HEADER_SENSITIVITY 值的結果

DEFAULT_PRIVACY 

USE_HEADER_SENSITIVITY 

結果 

-1 

永遠不在 SMS 郵件中設定 SMS 私密性旗標。 

n >= 0 

總是將 SMS 私密性旗標設定為值 n。總是忽略 RFC 822 Sensitivity: 標頭行。

-1 (預設) 

預設 

僅當原始電子郵件包含 RFC 822 Sensitivity: 標頭行時,才設定 SMS 郵件的私密性旗標。在該情況下,SMS 私密性旗標會設定為對應 Sensitivity: 標頭行的值。這是預設。

n >= 0 

設定 SMS 郵件私密性旗標,使之對應於原始電子郵件的 RFC 822 Sensitivity: 標頭行。如果電子郵件不具有 Sensitivity: 標頭行,則 SMS 私密性旗標的值設定為 n。

SMS 私密性值的轉譯在下面表 D–13 中顯示︰

表 D–13 SMS 私密性值的解譯

值 

說明 

無限制 

有限制 

機密 

秘密 

>= 4 

未定義 

用於將 RFC 822 Sensitivity: 標頭行值翻譯為 SMS 私密性值的對映,在下面表 D–14 中顯示︰

表 D–14 Sensitivity 標頭翻譯為 SMS 私密性值的對映

RFC 822 Sensitivity: value 

SMS 私密性值 

Personal 

1 (有限制) 

Private 

2 (機密) 

Company confidential 

3 (秘密) 

DEFAULT_SERVICE_TYPE

(字串,0 - 5 位元組) 與通道產生的 SMS 郵件關聯的服務類型。依預設,不指定服務類型 (即為零長度字串)。一些常見服務類型為:CMT (行動郵件傳送)、CPT (行動傳呼)、VMN (語音郵件通知)、VMA (語音郵件提示)、WAP (無線應用程式協定) 以及 USSD (非結構化輔助資料服務)。

DEFAULT_SOURCE_ADDRESS

(字串,0 - 20 位元組) 供電子郵件產生的 SMS 郵件使用的來源位址。請注意,當 USE_HEADER_FROM=1 時,透過此選項指定的值會由電子郵件的創建者位址所覆寫。依預設,停用此值,亦即值為 0

DEFAULT_SOURCE_NPI

(整數,0 - 255) 依預設,為來源位址指定 NPI 值零。透過此選項,可以指定替代整數值,範圍為 0 至 255。請參閱用於典型 NPI 值的DEFAULT_DESTINATION_NPI選項的說明。

DEFAULT_SOURCE_TON

(整數,0 - 255) 依預設,為來源位址指定 TON 指標值零。透過此選項,可以指定替代整數值,範圍為 0 至 255。請參閱用於典型 TON 值的DEFAULT_DESTINATION_TON選項說明。

DEFAULT_VALIDITY_PERIOD

(字串,0 - 252 位元組) 依預設,不會為 SMS 郵件指定相對有效期,而是使用 SMSC 的預設值。使用此選項來指定不同的相對有效期。以秒、分鐘、小時或天為單位來指定值。下面表 D–15 指定了此選項的各種值之格式和說明︰

表 D–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 格式的值。

DESTINATION_ADDRESS_NUMERIC

(0 或 1) 使用此選項刪除擷取自電子郵件訊息封 To: 位址的 SMS 目標位址中的所有非數值字元。例如,如果訊息封 To: 位址為︰

"(800) 555-1212"@sms.siroe.com

將被縮減成:

8005551212@sms.siroe.com

若要啟用此刪除功能,請指定此選項的值為 1。依預設,停用此刪除功能,對應於選項值 0。請注意,啟用後,刪除作業會在透過DESTINATION_ADDRESS_PREFIX選項增加任何目標位址前綴之前完成。

DESTINATION_ADDRESS_PREFIX

(字串) 在某些情況下,可能需要確保所有 SMS 目標位址都前置有固定文字字串,例如「+」。此選項可以用於指定這樣一個前綴。然後,該前綴會加入缺少指定前綴的任何 SMS 目標位址中。若要防止被DESTINATION_ADDRESS_NUMERIC選項刪除,應在 DESTINATION_ADDRESS_NUMERIC 選項之後套用此選項。

PROFILE

(字串) 指定與 SMSC 配合使用的 SMS 設定檔。可能的值為 GSMTDMACDMA。如未指定,則假定為 GSM。此選項僅用於為其他通道選項 (例如DEFAULT_PRIORITYDEFAULT_PRIVACY) 選取預設。

USE_SAR

(0 或 1) 過大的電子郵件可能需要分割成多封 SMS 郵件。發生這種情況時,個別 SMS 郵件可以選擇性地包含使用 SMS sar_ 欄位加入的定序資訊。這會產生「分段的」SMS 郵件,這些郵件可以透過接收終端機重新組合成單一 SMS 郵件。指定 USE_SAR=1 來指示增加此序列資訊 (如果有)。預設為不增加序列資訊,對應於 USE_SAR=0

指定 USE_SAR=1 時,會忽略REVERSE_ORDER選項。

SMPP 選項

以下選項允許用於 SMPP 協定參數規格。這些名稱以字串「ESME_」開頭的選項可用於識別充當外部簡短郵件實體 (ESME) 的 MTA;亦即 MTA 連結至 SMPP 伺服器,以將 SMS 郵件提交至該伺服器的關聯 SMSC 的情況。

ESME_ADDRESS_NPI

(整數,0 - 255) 依預設,連結作業將指定 ESME NPI 的值為零,表示不明的 NPI。透過此選項,可以指定替代整數值,範圍為 0 至 255。請參閱DEFAULT_DESTINATION_NPI選項的說明,以取得典型 NPI 值表。

ESME_ADDRESS_TON

(整數,0 - 255) 依預設,連結作業將指定 ESME TON 的值為 0。透過此選項,可以指定替代整數值 (範圍為 0 至 255)。請參閱DEFAULT_DESTINATION_TON選項的說明,以取得典型 TON 值表。

ESME_IP_ADDRESS

(字串,0 - 15 位元組) 連結至 SMPP 伺服器時,BIND PDU 表示用戶端 (亦即 ESME) 的位址範圍是一個 IP 位址。透過指定 TON 值為 0x00,NPI 值為 0x0d 來完成此作業。位址範圍欄位的值會設定為正在執行 SMS 通道的主機之 IP 位址。請以帶點的十進位格式指定 IP 位址,例如 127.0.0.1。

ESME_PASSWORD

(字串,0 - 8 位元組) 連結至 SMPP 伺服器時,可能需要密碼。如果是這樣,請透過此選項指定密碼。依預設,使用零長度密碼字串。

ESME_SYSTEM_ID

(字串,0 - 15 位元組) 連結至 SMPP 伺服器時,可以提供 MTA 的系統 ID。依預設,不指定系統 ID (即,使用零長度字串)。若要指定系統 ID,請使用此選項。

ESME_SYSTEM_TYPE

(字串,0 - 12 位元組) 連結至 SMPP 伺服器時,可以提供 MTA 的系統類型。依預設,不指定系統類型 (即,使用零長度字串)。

MAX_PAGES_PER_BIND

(整數,>= 0) 有些 SMPP 伺服器可能會限制單一連結階段作業中提交的 SMS 郵件之最大數目。鑑於此,此選項可規定單一階段作業中可提交的 SMS 郵件的最大數量。達到此限制時,通道將中斷連結,關閉 TCP/IP 連線,然後重新連線並再次連結。

依預設,MAX_PAGES_PER_BIND 使用值 1024。請注意,通道還會偵測 ESME_RTHROTTLED 錯誤並在通道的單次執行中相應地調整 MAX_PAGES_PER_BIND

REVERSE_ORDER

(0 或 1) 當電子郵件產生多個 SMS 郵件時,這些 SMS 郵件可以提交至 SMSC,以循序順序 (REVERSE_ORDER=0) 或反向循序順序 (REVERSE_ORDER=1)。反向排定次序適用於接收終端機首先顯示最後收到的郵件之情形。在這種情況下,最後收到的郵件會是電子郵件的第一部分,而非最後一部分。依預設,使用 REVERSE_ORDER=1

請注意,指定USE_SAR=1 時,會忽略此選項。

SMPP_MAX_CONNECTIONS

(整數,1 - 50) 此選項控制每個程序中同步執行的 SMPP 連線的最大數量。由於每個連線都有一個關聯的執行緒,因此,此選項還可對每個程序中「工作者」執行緒的最大數量進行限制。依預設,SMPP_MAX_CONNECTIONS=20

SMPP_PORT

(整數,1 - 65535) 可以使用此選項或 port 通道關鍵字指定 SMPP 伺服器偵聽的 TCP 連接埠。此連接埠號碼必須透過這兩種機制之一指定。如果同時使用這兩種機制指定,則透過 SMPP_PORT 選項做出的設定優先。請注意,此選項無預設值。

對於雙向 SMS,請確定其連接埠與 SMPP 轉送的 LISTEN_PORT 相同。

SMPP_SERVER

(字串,1 - 252 位元組) 對於單向 SMS,依預設,要連線的 SMPP 伺服器之 IP 主機名稱為與通道關聯的正式主機名稱,亦即顯示在 MTA 配置內通道定義第二行的主機名稱。此選項可用於指定不同的主機名稱或 IP 位址,而該主機名稱或 IP 位址將置換通道定義中指定的值。指定 IP 位址時,請使用帶點的十進位表示法,例如 127.0.0.1。

對於雙向 SMS,設定為指向 SMS 閘道伺服器主機名稱或 IP 位址。如果使用 SMPP 轉送的 LISTEN_INTERFACE_ADDRESS 選項,則務必使用與指定的網路介面位址關聯的主機名稱或 IP 位址。

TIMEOUT

(整數,>= 2) 依預設,等候資料寫入 SMPP 伺服器完成或從 SMPP 伺服器接收資料時,逾時時間為 30 秒。使用 TIMEOUT 選項來指定不同的逾時值 (以秒為單位)。指定的值至少為 1 秒。

本土化選項

建構 SMS 郵件時,SMS 通道有大量固定文字字串將置入郵件中。例如,這些字串說明了電子郵件的 From: 位址和 Subject: 標頭行。透過本小節說明的通道選項,可以為不同語言指定這些字串版本,並指定通道的預設語言。範例 D–2 顯示選項檔案的語言部分:


範例 D–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 字元集的特例。

CONTENT_PREFIX

(字串,0 - 252 位元組) 置於 SMS 郵件內、電子郵件內容自身之前的文字字串。預設的全域值為 US-ASCII 字串「Msg:」。

DSN_DELAYED_FORMAT

(字串,0 - 256 個字元) 傳送延遲通知的格式化字串。依預設,此選項使用空白字串,因此禁止延遲通知轉換成 SMS。請注意,GATEWAY_NOTIFICATIONS必須設定為 1,才能使此選項生效。GATEWAY_NOTIFICATIONS=0 時,會忽略此選項。

DSN_FAILED_FORMAT

(字串,0 - 256 個字元) 永久性傳送失敗通知的格式化字串。此選項的預設值為字串:

Unable to deliver your message to $a; no further delivery attempts will be 
made.

若要禁止轉換失敗通知,請為此選項指定空白字串。請注意,GATEWAY_NOTIFICATIONS必須設定為 1,才能使此選項生效。GATEWAY_NOTIFICATIONS=0 時,會忽略此選項。

DSN_RELAYED_FORMAT

(字串,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 時,會忽略此選項。

DSN_SUCCESS_FORMAT

(字串,0 - 256 個字元) 傳送成功通知的格式化字串。預設值為字串:

Your message to $a has been delivered

若要禁止轉換遞送成功通知,請為此選項指定空白字串。請注意,GATEWAY_NOTIFICATIONS必須設定為 1,才能使此選項生效。GATEWAY_NOTIFICATIONS=0 時,會忽略此選項。

FROM_FORMAT

(字串,0 - 252 位元組) 用於格式化創建者資訊以插入 SMS 郵件中的格式化範本。預設全域值為 US-ASCII 字串「$a」,它會在創建者的電子郵件位址進行替換。請參閱格式化範本

FROM_NONE

(字串,0 - 252 位元組) 沒有創建者位址可供顯示時,置於 SMS 郵件中的文字字串。預設全域值為空白字串。

請注意通常不使用此選項,因為網站通常會拒絕缺少創建者位址的電子郵件。

LANGUAGE

(字串,0 - 40 位元組) 用於從中選取文字字串的預設語言群組。如未指定,則該語言將取自主機的預設本機規格。如果主機的本機規格不可用或對應於「C」,則使用 i-default。(i-default 對應於「適用於國際使用者的英語文字」。)

LINE_STOP

(字串,0 - 252 位元組) 置於 SMS 郵件內、自電子郵件擷取的各行之間的文字字串。預設全域值為 US-ASCII 空格字元「 」。

NO_MESSAGE

(字串,0 - 252 位元組) 置於 SMS 郵件內以表示電子郵件沒有內容的文字字串。預設全域值為 US-ASCII 字串「[no message]」。

SUBJECT_FORMAT

(字串,0 - 252 位元組) 格式化在 SMS 郵件中顯示的 Subject: 標頭行內容的格式化範本。此選項的全域預設值為 US-ASCII 字串「($s)」。請參閱格式化範本,以取得進一步詳細資訊。

請參閱 SUBJECT_NONE 選項,以取得不存在 Subject: 標頭行,或該標頭行內容為空字串時如何進行處理的說明。

SUBJECT_NONE

(字串,0 - 252 位元組) 當原始電子郵件不具有 Subject: 標頭行或 Subject: 標頭行值為空字串時,顯示的文字字串。此選項的預設全域值為空白字串。

DEBUG

(整數,位元遮罩) 啟用除錯輸出。預設值為 6,選取警告郵件和錯誤郵件。任何非零值均會啟用通道自身的除錯輸出,與通道定義上指定 master_debug 相同。表 D–16 定義了 DEBUG 位元遮罩的位元值。

表 D–16 DEBUG 位元遮罩

位元 

值 

說明 

0 - 31 

-1

極其詳細輸出 

1

資訊郵件 

2

警告郵件 

4

錯誤郵件 

8

子常式呼叫追蹤 

16

雜湊表診斷 

32

I/O 診斷,接收 

64

I/O 診斷,傳輸 

128

SMS 至電子郵件轉換診斷 (行動電話發出的郵件與 SMS 通知) 

256

PDU 診斷,標頭資料 

512

PDU 診斷,內文資料 

10 

1024

PDU 診斷,類型-長度-值資料 

11 

2048 

選項處理;傳送所有選項設定至記錄檔。 

格式化範本

使用FROM_FORMATSUBJECT_FORMAT以及所有 DSN_* 通道選項指定的格式化範本為 UTF-8 字串,其可能包含文字列文字和替換序列的組合。假定範例電子郵件位址為

Jane Doe <user@siroe>

識別的替換序列在下面表 D–17 中顯示︰

表 D–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