管理員可以修改 CSA 應用程式的 WAR 檔案中的相關資訊環境參數，以進一步設定從屬端系統分析器 (CSA)。
|
參數名稱 |
說明 |
預設值 |
|---|---|---|
| alertWhenDone | 如果設定成 true，會顯示一個訊息，指示已經執行 Applet。 | false |
| appletJAR | JAR 檔案的名稱。 | CSA.jar |
| application |
CSA 執行處理關聯的應用程式的名稱。如果未指定應用程式，此 CSA 執行處理收集的從屬端，就不會有應用程式。 |
無 |
| autoRedir | 如果 JVM 設成 Jinitiator 但從屬端未安裝適當的 Jinitiator 版本時，若設定 true，會造成 CSA JSP 頁面自動切換成使用 Sun JVM。 | false |
| bwTestFile | 測試頻寬時，從伺服器下載之檔案的名稱。 |
CSA.mb (包括在 Grid Control 應用程式的 CSA 中) |
| bwTestMsec | Applet 應該用於測試頻寬的時間量。Applet 會計算它可以在此間隔下載的位元組數目，得出頻寬。 | 200 ms |
| classid |
OBJECT 標記的 "classid" 欄位。只有當 JVM 設為 "JInitiator" 時才適用。Sun 的 classid 為 "clsid:8AD9C840-044E-11D1-B3E9-00805F499D93"。 |
無 -- 如果 JVM 設為 "JInitiator"，就必須設定此欄位，否則可加以忽略 |
| codebase | OBJECT 標記的 codebase 欄位。JVM 設定成 "KInitator" 時才適用。 | Sun 的預設值是 http://java.sun.com/products/plugin/autodl/jinstall-1_4_2-windows-i586.cab#Version=1,4,0,0 |
| classid |
OBJECT 標記的 "classid" 欄位。JVM 設為 "JInitiator" 時才適用。Sun 的 classid 為 "clsid:8AD9C840-044E-11D1-B3E9-00805F499D93"。 |
無 -- 如果 JVM 設為 "JInitiator"，就必須設定此欄位，否則可加以忽略 |
| collectCookie | 要收集的 Cookie 名稱之清單。此參數是逗點分隔的 Cookie 名稱清單。只會收集目前瀏覽器中目前作業系統使用者的 Cookie。管理員可指定 '*' 以收集目前瀏覽器的所有目前使用者 Cookie。 | 如果未顯示此欄位，則不會收集 Cookie |
| cookieDomain | CSA Cookie 的網域。 | 如果未設定 Cookie 的網域或路徑，就會停用 Cookie |
| cookieMaxAge | 從屬端機器上，Cookie 的持續時間最長秒數。 | 預設值是 1 年 |
| cookiePath | CSA Cookie 的路徑。 | 如果未設定網域或路徑，就會停用 Cookie |
| customClass | 類別名稱，該類別用於收集自訂資料 (請參閱下面)。 | 無 -- 預設行為是不會執行自訂程式碼 |
| customKey1 customKey2 customKey3 |
三個自訂索引鍵的值。使用此建置描述區並且由 CSA JSP 頁面完成的所有從屬端收集，會擁有自訂索引鍵的三個值。這三個值可以由自訂程式碼覆寫。 | 如果未指定自訂索引鍵值，則不會收集任何值 (除非由自訂程式碼收集) |
| descriptionFile | 文件檔的完整路徑，該檔案包含顯示在建置頁面的說明。檔案的內容應該是 HTML 格式文字。 | 無 |
| destURL | 指定目的地 URL。這是 CSA JSP 頁面上的「繼續」按鈕所連結的 URL。 | 如果未指定 destURL，「繼續」按鈕會將使用者移至參照頁面；如果沒有參照頁面，就不會顯示「繼續」按鈕 |
| destURLResultsParam | 指定要新增至「目的地 URL」的 URL 參數名稱，用來指示從屬端的相容層次。例如，如果值是 "compliance"，而且從屬端的整體相容層次很嚴格，則參數 "compliance=critical" 會新增至目的地 URL。 | Sun |
| JVM | 這會判斷要使用的 JVM 類型。如果值是 "Sun"，JSP 頁面會引導瀏覽器使用 Sun JVM。如果值是 "Oracle"，頁面會引導瀏覽器使用 Oracle Jinitiator。如果值是 "any"，則 JSP 會填寫標準 "applet" 標記，造成從屬端使用外掛至瀏覽器的 JVM。 | Sun |
| maxExecInterval | 新增至 CSA Cookie 有效負載的參數。重導邏輯讀取 Cookie 時，如果 Cookie 的時戳與此值的目前時間不同，Applet 會再次建置。此參數可由重導 JSP/篩選的 "csa_execInterval" 相關資訊環境參數覆寫。 | 90 天 |
| maxFileSize | 單一要求，可以張貼至接收者的資料總數上限 (KB)。如果張貼的資料大小超過此限制。會拒絕要求並刪除寫入硬碟的任何資料。 | 100 |
| maxOutptFiles | XML OutputDir 中所能顯示的輸出檔數目上限。 |
100 |
| outputDir | CSA 組態 XML 檔會寫入的目錄。Applet 頁面和接收者頁面必須讀取此參數，而且此參數在兩個頁面中必須是相同的。 | 根據預設，輸出檔會寫入應用程式根目錄的 "csa_results" 子目錄 (如果應用程式根目錄存在，且子目錄存在或可以建立)。不建議使用此參數的預設值 |
| outputEnabled | 啟用或停用建立輸出 XML 檔案。適用於這兩個頁面。 |
依照預設，會建立 XML 檔案並儲存在 XMLOutputDir |
| pluginspage | 用於將使用者引導至 Netscape 底下的 JVM 安裝程式，因為 Netscape 不支援自動安裝。當 JVM 是 Jinitiator 的時候才適用。Sun 的預設值是 http://java.sun.com/products/plugin/index.html#download。 | 無 -- 如果 JVM 設為 "JInitiator"，就必須設定此欄位，否則可加以忽略 接收者 |
| receiver |
Applet 應該在哪一個 URL 張貼收集的資料。 注意：在設定參數時，管理員必須確定接收者的版本和 Applet 的版本相同。 |
預設值是尋找與 CSA JSP 頁面的路徑相同的 "CSAr.jsp" |
| ruleFile | 指定伺服器的路徑，相對於包含要評估之規則的檔案其 Web 應用程式根目錄。 | rules.xml |
| script | 指定管理員提供的命令檔，標示成由代理程式上傳之前，它可以在 CSA XML 檔案執行。 | 無 -- 如果未指定命令檔，則不會執行命令檔 |
| type | CSA JSP 頁面提供的 OBJECT 標記的 "type" 欄位，用於建置 Applet。如果 JVM 設成 "JInitiator"，則不適用。如果 JVM 設定成 "Sun"，則類型是 "application/x-java-applet"。 | 無 -- 如果 JVM 設為 "JInitiator"，就必須設定此欄位，否則可加以忽略 |
| viewData | 如果設定成 true，此參數允許一般使用者在收集的資料張貼至伺服器後便能檢視。 | false |
除了這些參數外，也可以設定 CSA 重導參數。使用 Servlet 篩選或將 CSA 重導 JSP 檔案包括在部份其他頁面，也可以啟用重導。以下相關資訊環境參數可用來讓重導產生作用。
|
參數名稱 |
說明 |
預設值 |
|---|---|---|
| csa_csaURL | CSA JSP 頁面的 URL，會將使用者重導至此 URL。 | 沒有預設值：必須設定此值，否則重導無法作用 |
| csa_execInterval | 執行 CSA 的間隔 (秒)。如果 Cookie 的期限及目前的伺服器時間差異大於 execInterval，就會重導使用者。 |
無 - 如果未設定 execInterval，唯有 CSA Cookie 存在時，才會重導使用者 |
| csa_redirectURL | 執行 CSA 之後，會將使用者重導至此 URL。 |
無 - 如果未設定此參數，使用者會被導回最初要求的頁面 |
| csa_UIMode |
0 -- 同步 (在目前的瀏覽器視窗)。 1 -- 非同步可見。 2 -- 非同步不可見。 |
同步 |
注意：如果管理員使用 CSA Servlet 篩選啟用重導，則必須以篩選的初始化參數形式提供以上顯示的參數 (UIMode 參數除外，因為 Servlet 篩選不需使用它)。
在特定情況下，不同的應用程式可能需要不同的參數集。例如，兩個不同的應用程式可能會有不同的規則集和自訂程式碼，而管理員可能希望將它們與不同的「CSA 收集器目標」建立關聯。在本案例中，管理員可以使用 "<application name> ruleFile"、"<application name> appletJar" 等參數，指定 ruleFile、appletJar 命令檔和 outputDir 參數給特定應用程式。如果將應用程式指定為相關資訊環境參數或透過 URL 來指定應用程式，便可以使用應用程式特定的參數值來執行 CSA。如果未指定應用程式，或未覆寫應用程式的參數之一，則會使用預設參數。
上述表格中有些指定的參數也可指定為 URL 參數。如果在 URL 指定 "application" 參數，則會使用該應用程式的相關資訊環境參數，而不使用預設參數。如果在 URL 指定參數，它會覆寫 CSA 應用程式建置描述區中指定給該參數的值，而且在指定應用程式時，也會覆寫該相關資訊環境參數的應用程式特定值。
可在 URL 指定的參數為：customKey1-3、alertWhenDone、application、autoRedir、bwTestMsec、JVM、uiMode。
版權所有 © 1996，2007，Oracle。保留一切權利。