C.5.8 全域選項

目前 SMS 閘道伺服器具有三類全域選項：

• C.5.8.1 執行緒調校選項

• C.5.8.2 歷程資料調校

• C.5.8.3 其他

全域選項必須在配置檔案上方、指定任何選項群組之前進行指定。表 C–20 列出了所有全域配置選項。

表 C–20 全域選項

選項	預設值	說明
DEBUG	6	選取產生的診斷輸出類型
HISTORY_FILE_DIRECTORY		歷程資料檔案的絕對目錄路徑
HISTORY_FILE_MODE	0770	歷程資料檔案的權限
HISTORY_FILE_ROLLOVER_PERIOD	30 分鐘	寫入同一歷程資料檔案的最長時間
LISTEN_CONNECTION_MAX	10,000	所有 SMPP 轉送器與伺服器實例中並行運作的內送連線之最大數量
RECORD_LIFETIME	3 天	歷程資料歸檔檔案中記錄的生命週期
THREAD_COUNT_INITIAL	10 個執行緒	工作者執行緒的初始數量
THREAD_COUNT_MAXIMUM	50 個執行緒	工作者執行緒的最大數量
THREAD_STACK_SIZE	64 Kb	每個工作者執行緒的堆疊大小

C.5.8.1 執行緒調校選項

每個內送 TCP 連線代表一個 SMPP 階段作業。對階段作業的處理是由執行緒處理區中的工作者執行緒所操控的。當階段作業處理需要等候 I/O 請求完成時，工作者執行緒會暫停此階段作業，並執行指定的其他工作。I/O 請求完成後，處理區中可用的工作者執行緒會恢復此階段作業。

以下選項允許用於調校工作者執行緒程序的處理區：THREAD_COUNT_INITIAL、THREAD_COUNT_MAXIMUM和THREAD_STACK_SIZE。

THREAD_COUNT_INITIAL

(整數，> 0) 為工作者執行緒處理區初始建立的執行緒數。此計數不包括專門用於管理記憶體內歷程資料的執行緒 (2 個執行緒)，也不包括專門用於偵聽內送的 TCP 連線的執行緒 (SMS 閘道伺服器偵聽的每個 TCP 連接埠/介面位址對使用一個執行緒)。THREAD_COUNT_INITIAL 的預設值為 10 個執行緒。

THREAD_COUNT_MAXIMUM

(整數，>= THREAD_COUNT_INITIAL) 允許工作者執行緒處理區的最大執行緒數。預設值為 50 個執行緒。

THREAD_STACK_SIZE

(整數，> 0) 工作者執行緒處理區中每個工作者執行緒的堆疊大小 (以位元組為單位)。預設值為 65,536 個位元組 (64 Kb)。

C.5.8.2 歷程資料調校

SMS 郵件轉送後，遠端 SMPP 接收伺服器產生的郵件 ID 會儲存在記憶體內雜湊表中。有關原始電子郵件的資訊也會隨此郵件 ID 一同儲存。如果該郵件 ID 隨後被 SMS 通知所參考，則此資訊可以被擷取。然後，擷取的資訊可用於將 SMS 通知傳送至適當的電子郵件收件者。

記憶體內雜湊表會由專門的執行緒備份到磁碟上。結果磁碟檔案被稱為「歷史檔案」。這些歷程檔案有兩個用途：以永久性形式儲存重新啟動 SMS 閘道伺服器之後復原記憶體內雜湊表時所需的資料；透過將可能的詳細資料儲存在磁碟中來保留虛擬記憶體。每個歷史檔案僅可於 HASH_FILE_ROLLOVER_PERIOD 秒內寫入，超過此時間，歷史檔案便會關閉，並建立新的歷史檔案。當歷史檔案超過 RECORD_LIFETIME 的時效 (以秒為單位) 後，便會從磁碟中刪除。

以下選項允許用於調校歷程檔案：HISTORY_FILE_DIRECTORY、HISTORY_FILE_MODE、HISTORY_FILE_ROLLOVER_PERIOD和RECORD_LIFETIME。

HISTORY_FILE_DIRECTORY

(字串，絕對目錄路徑) 會在其中寫入歷史檔案的目錄之絕對路徑。如果該目錄路徑不存在，則會建立一個。此選項的預設值為：

msg-svr-base/data/sms_gateway_cache/

使用的目錄應位於相對較快的磁碟系統上，並有足夠的自由空間用於預期的儲存；請參閱C.6 SMS 閘道伺服器儲存需求，以將此選項變更為更合適的值。

HISTORY_FILE_MODE

(整數，八進制值) 與歷史檔案關聯的檔案權限。依預設，將使用值 0770 (八進位)。

HISTORY_FILE_ROLLOVER_PERIOD

(整數，秒數) 每 HASH_FILE_ROLLOVER_PERIOD 秒，就會關閉目前的歷史檔案，並建立一個新歷史檔案。依預設，將使用值 1800 秒 (30 分鐘)。

RECORD_LIFETIME

(整數，秒 > 0) 歷程記錄的使用期限 (以秒為單位)。時間長於此生命週期的記錄會從記憶體中清除；時間長於此生命週期的歷程檔案會從磁碟中刪除。依預設，將使用值 259,200 秒 (3 天)。儲存在記憶體內的記錄會在掃描過程中被專門用於管理記憶體內資料的執行緒清除。這些掃描每 HASH_FILE_ROLLOVER_PERIOD 秒執行一次。有必要開啟新的歷程檔案時，磁碟上的檔案就會被清除。

C.5.8.3 其他

以下為其他選項：

• DEBUG

• LISTEN_CONNECTION_MAX

• LOG_PAGE_COUNT

DEBUG

(整數，位元遮罩) 啟用除錯輸出。預設值為 6，選取警告郵件和錯誤郵件。

表 C–21 定義 DEBUG 位元遮罩的位元值。

表 C–21 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	選項處理；傳送所有選項設定至記錄檔。

LISTEN_CONNECTION_MAX

(整數，>= 0) 所有 SMPP 轉送與伺服器創設中允許同步運作的傳入 TCP 連線之最大數量。0 (零) 值表示連線數量無全域限制。但是，也可以由指定轉送器或伺服器實例針對每台轉送器或伺服器設定限制。預設值：10,000

LOG_PAGE_COUNT

(0, 1, 2) 只有在以 logging 通道關鍵字啟用通道的記錄時，LOG_PAGE_CONT SMS 通道選項才有作用。啟用記錄時，此選項會控制在 mail.log 檔案的訊息大小欄位中記錄的值。通常該欄位會提供基本訊息檔案的區塊大小。當 LOG_PAGE_COUNT 具有非零值時，記錄檔的該欄位會改為記錄已傳輸頁面的數目。

0 - 記錄基本訊息檔案的區塊大小。這是未指定 LOG_PAGE_COUNT 時的預設運作方式。

1 - 記錄完整訊息成功傳輸至收件者時傳送的頁數。否則，即使某些頁面傳送至收件者，也只會記錄零頁數。

2 - 不論是否傳送完整訊息，都記錄傳送至收件者的頁數。

當訊息過大而分為多頁傳遞時，LOG_PAGE_COUNT=1 和 LOG_PAGE_COUNT=2 之間的差異才會相關聯。在這種狀況下，傳輸全部頁面之前可能會發生錯誤。例如，MTA 和遠端 SMPP 伺服器之間的網路可能中斷。在這種狀況下，會在稍後嘗試重新傳輸訊息。每次進行嘗試時，先前已傳送的頁面都會與未傳送的頁面一併傳送。站點可選擇是否要記錄嘗試傳輸失敗期間成功傳送的頁數。