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

使用轉換通道輸出選項

轉換通道輸出選項 (表 13–4) 是動態變數,用於將資訊與特殊指令從轉換程序檔傳送至轉換通道。例如,在內文部分處理期間,程序檔可能會傳送特殊指令,要求轉換通道退回郵件,並在傳回的郵件中加入一些錯誤文字,表明郵件帶有病毒。

輸出選項透過在所需的轉換項目中設定 OVERRIDE-OPTION-FILE=1 來啟動。然後,輸出選項由程序檔依需要設定,並儲存在環境變數檔案 OUTPUT_OPTIONS 中。程序檔處理完內文部分後,conversion 通道會從 OUTPUT_OPTIONS 檔案中讀取這些選項。

OUTPUT_OPTION 變數是 conversion 通道讀取選項時所用的檔案之名稱。通常會用作即時暫存檔來傳送資訊。以下範例顯示程序檔使用輸出選項將錯誤訊息傳回給寄出病毒郵件的寄件者。


/usr/local/bin/viro_screen2k $INPUT_FILE   # run the virus screener

if [ $? -eq 1 ]; then
   echo "OUTPUT_DIAGNOSTIC=’Virus found and deleted.’" > $OUTPUT_OPTIONS
   echo "STATUS=178029946" >> $OUTPUT_OPTIONS
else
   cp $INPUT_FILE $OUTPUT_FILE # Message part is OK
fi

            

在此範例中,會將系統診斷訊息與狀態碼增加至由 $OUTPUT_OPTIONS 定義的檔案中。讀取完 $OUTPUT_OPTIONS 暫存檔後,會看到如下內容:


OUTPUT_DIAGNOSTIC="Virus found and deleted."
STATUS=178029946

其中,OUTPUT_DIAGNOSTIC='Virus found and deleted’ 一行告知 conversion 通道將 Virus found and deleted 文字增加至郵件中。

178029946 是指在 msg_svr_base/include/deprecated/pmdf_err.h 中發現的每個 pmdf_err.h 檔案的 PMDF__FORCERETURN 狀態。此狀態碼指示轉換通道將郵件退回給寄件者。(如需有關使用特殊指令的更多資訊,請參閱使用轉換通道輸出退回、刪除或保留郵件

完整的輸出選項清單如下表所示。

表 13–4 conversion 通道輸出選項

選項 

說明 

OUTPUT_TYPE

輸出郵件部分的 MIME 內容類型。 

OUTPUT_SUBTYPE

輸出郵件部分的 MIME 內容子類型。 

OUTPUT_DESCRIPTION

輸出郵件部分的 MIME 內容描述。 

OUTPUT_DIAGNOSTIC

郵件被轉換通道強制退回給寄件者時,作為郵件的一部分納入的文字。 

OUTPUT_DISPOSITION

輸出郵件部分的 MIME content-disposition

OUTPUT_ENCODING

用於輸出郵件部分的 MIME 內容傳輸 encoding

OUTPUT_MODE

MIME Mode,conversion 通道會以此模式寫入輸出郵件部分,而收件者會以此模式讀取輸出郵件部分。

STATUS

轉換程式的結束狀態。通常是一個特殊的指令可讓轉換通道啟動某個動作。完整的指令清單位於 msg_svr_base/include/deprecated/pmdf_err.h 中。