HPEL 文字日誌配置設定

啟用將日誌和追蹤記錄寫入文字日誌檔中。

指定除了以二進位格式來寫入日誌和追蹤記錄之外，記載系統還會將它們寫為文字格式。 您可以配置以基本模式 SystemOut.log 檔所用的其中一種格式，將文字日誌格式化。

文字日誌檔只包含控制器程序所產生的日誌項目，不包含來自服務者或附屬項程序的日誌項目。 因此，應用程式日誌記錄不會寫入 z/OS 上的文字日誌中。如果要檢視所有應用程式伺服器程序的日誌或追蹤資料，請使用管理主控台中的 LogViewer 指令行工具或 HPEL 日誌檢視工具。

避免困難： 所有寫入文字日誌的內容，也都會寫入日誌儲存庫或追蹤儲存庫。 啟用文字日誌之後，經常建立日誌和追蹤項目的應用程式，其效能會降低。gotcha

指定日誌檔寫入其中的目錄。

文字日誌檔名稱的格式如下：TextLog_<yy.mm.dd>_<hh.mm.ss>，其中 "TextLog_" 是固定字首，<yy.mm.dd> 是檔案中第一個記錄的日期（年、月、日），<hh.mm.ss> 是時間（時、分、秒）

避免困難： 伺服器之間無法共用這個路徑。伺服器會建立一個副檔名為 .owner 的檔案，用來協助偵測是否有兩個或兩個以上的伺服器嘗試使用相同的 HPEL 輸出路徑。gotcha

指定記載系統避免在每次建立日誌記錄時，就寫入磁碟。 記載系統會建立一個緩衝區來保留若干日誌記錄，等緩衝區已滿時，再寫入緩衝的事件。 過了幾秒鐘之後，即使緩衝區未滿，記載系統也會寫入緩衝的事件。

選取這個設定，會大幅改進記載效能；不過，如果伺服器非預期地停止，內容可能就不會寫入文字日誌檔中。

最佳作法： 在絕大多數情況下，請啟用日誌記錄緩衝。 只在伺服器非預期地失敗，且無法在停止之前將緩衝的內容寫入磁碟時，才停用日誌記錄緩衝。bprac

使記載架構能夠關閉日誌檔，到了指定時間再啟動新的檔案。 關閉檔案，檔案比較容易複製到保存檔中。

最佳作法： 如果您想要自動保存日誌檔，請設定備份程式，以便在過了配置啟動新日誌的時間之後複製檔案。 請配置為在配置啟動新日誌的時間過了至少 10 分鐘之後，才進行備份，以確保伺服器已關閉先前的檔案。bprac

指定日誌清理設定，以將最舊的日誌記錄或已無法放入配置空間的日誌記錄，從文字日誌目錄中自動清除。

請選取當日誌大小接近上限，配置在文字日誌檔的大小總計接近配置的大小上限時，開始自動清理日誌檔。

請選取當最舊的記錄達到經歷時間限制，配置在日誌內容達到指定的經歷時間限制時，開始自動清理日誌檔。

請選取當符合經歷時間或大小限制，配置在符合上述任何一個狀況時，開始自動清理日誌檔。

不論您選擇哪個選項，文字日誌目錄中的文字日誌檔都會依照它們寫入文字日誌目錄的順序來依序刪除。

指定在無法新增內容到文字日誌目錄時，伺服器要如何回應。

請選取停止伺服器來指定在伺服器無法寫入文字日誌目錄時，就停止伺服器。

請選取清除舊記錄來指定伺服器繼續執行，且在伺服器無法寫入文字日誌目錄時，立即移除含有最舊日誌記錄的檔案。

請選取停止記載來指定伺服器繼續執行，但在伺服器無法寫入文字日誌目錄時，伺服器就不會繼續寫入日誌。

指定文字日誌檔中所用的格式。

選取基本會指定每個記錄一行的較短格式。

選取進階會利用完整日誌程式名稱和每個記錄的更多詳細資料，來指定較長的格式。

指定是否將追蹤記錄及日誌記錄併入文字日誌檔中。

指定執行中伺服器的動態狀態變更，以及伺服器配置的變更，都在下次重新啟動時生效。 如果未選取這個勾選框，伺服器就不會將設定複製到伺服器配置中。