Jython Script 程式庫: 伺服器設定配置 Script

configureAdmin服務

此 Script 會配置 AdminService 介面的設定。 AdminService 介面是應用程式伺服器管理功能的伺服器端介面。

表 1. configureAdmin服務引數說明。使用節點名稱、伺服器名稱、本端連線通訊協定及遠端連線通訊協定來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`localAdmin通訊協定`	指定連接器類型，用來將 AdminService 介面連接至應用程式伺服器，以進行本端連線。
`remoteAdmin通訊協定`	指定連接器類型，用來將 AdminService 介面連接至應用程式伺服器以進行遠端連線。
`otherAttribute清單`	選擇性地以下列格式指定其他屬性: [[enabled， true] ， [pluginConfigService， (cells/timmieNode02Cell/nodes/timmieNode01/servers/server1\|server.xml#PluginConfigService_1183122130078)]]

語法

AdminServerManagement.configureAdminService(nodeName, serverName, localAdminProtocol, remoteAdminProtocol, otherAttributeList)

範例用法

AdminServerManagement.configureAdminService("myNode", "myServer", "IPC", "SOAP",
    [["enabled", "true"], ["pluginConfigService", 
       "(cells/timmieNode02Cell/nodes/timmieNode01/servers/server1|server.xml#PluginConfigService_1183122130078)"]])

configureApplicationServerClassloader

這個 Script 會配置應用程式伺服器的類別載入器。類別載入器可讓部署在應用程式伺服器上的應用程式，存取有可用類別和資源的儲存庫。

表 2. configureApplicationServerClassloader 引數說明。使用節點名稱、伺服器名稱、原則、模式及程式庫名稱引數來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`原則`	將應用程式類別載入器原則指定為 SINGLE 或 MULTIPLE。指定 SINGLE 值以防止隔離應用程式，並將應用程式伺服器配置成使用單一應用程式類別載入器來載入系統中的所有 EJB 模組、共用程式庫及相依關係 Java 保存檔 (JAR)。指定多重值來隔離應用程式，並提供每一個應用程式自己的類別載入器來載入 EJB 模組、共用程式庫和相依關係 JAR 檔。
`模式`	將類別載入器模式指定為 PARENT_FIRST 或 APPLICATION_FIRST。 PARENT_FIRST 選項會使類別載入器在嘗試從本端類別路徑載入類別之前，先將類別的載入委派給它的母類別載入器。 APPLICATION_FIRST 選項會導致類別載入器在將類別載入委派給母項之前，嘗試從本端類別路徑載入類別。當使用這個原則時，應用程式類別載入器能夠置換在母項類別載入器中的類別並提供它自己的版本。
`libraryName`	指定感興趣的共用程式庫名稱。

語法

AdminServerManagement.configureApplicationServerClassloader(nodeName, serverName,
 policy, mode, libraryName)

範例用法

AdminServerManagement.configureApplicationServerClassloader("myNode", "myServer", "MULTIPLE", "PARENT_FIRST", 
"myLibraryReference")

configureDynamic快取

這個 Script 會在伺服器配置中配置動態快取服務。動態快取服務在應用程式伺服器 JVM 內運作，截取可快取物件的呼叫。例如，動態快取服務會透過 Servlet 服務方法或指令執行方法來截取呼叫，並將物件的輸出儲存至快取，或從動態快取提供物件的內容。

表 3. configureDynamicCache 引數說明。使用節點名稱、伺服器名稱、預設優先順序、快取記憶體大小、外部快取群組名稱及外部快取群組類型引數來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`defaultPriority`	指定快取項目的預設優先順序，決定項目保留在完整快取中的時間長度。請指定介於 1 和 255 之間的整數。
`cacheSize`	指定一個正整數，作為快取要保留的項目數上限值。在此欄位中輸入介於 100 到 200000 範圍之間的快取大小值。
`externalCacheGroupName`	外部快取群組名稱必須符合 Servlet 或 JavaServer Pages (JSP) cachespec.xml 檔中所定義的 ExternalCache 內容。當您啟用外部快取時，快取記憶體會比對頁面及其統一資源識別碼 (URI)，再將相符的頁面推送到外部快取記憶體中。之後，就可以從外部快取記憶體提供項目，而不需從應用程式伺服器提供。
`externalCacheGroupType`	指定外部快取群組類型。
otherAttribute清單	選擇性地以下列格式指定動態快取服務的其他配置選項: [[cacheProvider， myProvider] ， [diskCacheCleanupFrequency， 2] ， [flushToDiskOnStop， true]]

語法

AdminServerManagement.configureDynamicCache(nodeName, serverName, defaultPriority, 
    cacheSize, externalCacheGroupName, externalCacheGroupType,
    otherAttributeList)

範例用法

AdminServerManagement.configureDynamicCache("myNode", "myServer", 2, 5000, "EsiInvalidator",
   "SHARED", [["cacheProvider", "myProvider"], ["diskCacheCleanupFrequency", 2], ["flushToDiskOnStop","true"]])

configureEJBContainer

這個 Script 會在伺服器配置中配置 Enterprise JavaBeans (EJB) 儲存器。 EJB 儲存器為應用程式伺服器內的 Enterprise Bean 提供執行時期環境。該儲存器會處理應用程式伺服器內所有層面的 Enterprise Bean 作業，並作為 Bean 內使用者撰寫之商業邏輯和其餘應用程式伺服器環境之間的媒介。

表 4. configureEJBContainer 引數說明。使用節點名稱、伺服器名稱、取消目錄及預設資料來源「Java 命名和目錄介面 (JNDI)」名稱引數來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`passivationDirectory`	指定儲存器用來儲存取消的 Stateful Session Bean 的持續性狀態的目錄。這個目錄必須已經存在。它不會自動建立。
`defaultDatasourceJNDIName`	指定當應用程式部署期間沒有指定任何資料來源時，所要使用的資料來源之 JNDI 名稱。這項設定不適用於 EJB 2.x-compliant 儲存器管理持續性 Bean。

語法

AdminServerManagement.configureEJBContainer(nodeName, serverName, 
passivationDir, defaultDatasourceJNDIName)

範例用法

AdminServerManagement.configureEJBContainer(myNode, myServer, C:\temp\myDir, jndi1)

AdminServerManagement.configureEJBContainer(myNode, myServer, /temp/myDir, jndi1)

configureFileTransferService

此 Script 會配置應用程式伺服器的檔案傳送服務。檔案傳送服務會將檔案從部署管理程式傳送至個別遠端節點。

表 5. configureFileTransferService 引數說明。以節點名稱、伺服器名稱、重試檔案傳送的次數，以及重試檔案傳送之前等待的時間來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`retriesCount`	指定檔案傳送服務在通訊失敗之後，重新嘗試傳送或接收檔案的次數。預設值為 3。
`retryWait時間`	指定檔案傳送服務等多久之後（秒），要重試失敗的檔案傳送。預設值為 10。
`otherAttribute清單`	選擇性地以下列格式指定其他屬性: [[enable， true]]

語法

AdminServerManagement.configureFileTransferService(nodeName, serverName, retriesCount, retryWaitTime, otherAttributeList)

範例用法

AdminServerManagement.configureFileTransferService(myNode, myServer, 5, 600, [["enable", "true"]])

configureListenerPortForMessageListener服務

此 Script 會在伺服器配置中配置訊息接聽器服務的接聽器埠。訊息接聽器服務是 JMS 提供者之「Java 傳訊服務 (JMS)」功能的延伸。它提供一個接聽器管理程式來控制和監視一或多個 JMS 接聽器，每個 JMS 接聽器都代表部署的訊息驅動 Bean 來監視 JMS 目的地。

表 6. configureListenerPortForMessageListener服務引數說明。使用節點名稱、伺服器名稱、接聽器埠名稱、Connection Factory JNDI 名稱、目的地 JNDI 名稱、訊息數目上限、重試次數上限及階段作業引數數目上限來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`listenerPort名稱`	用來識別接聽器埠供管理使用的名稱。
`connectionFactoryJNDIName`	接聽器埠要用的 JMS Connection Factory 的 JNDI 名稱，比方說，`jms/connFactory1`。
`destinationJNDIName`	接聽器埠要使用之目的地的 JNDI 名稱; 例如， `jms/destn1`
`maxMessages`	接聽器在單一交易中，能夠處理的訊息數目上限。如果佇列是空的，每個訊息到達時，接聽器都會處理它。每個訊息都是在個別交易內處理的。
`maxRetries`	在接聽器停止之前，接聽器嘗試遞送訊息的次數上限，範圍為 0 到 2147483647。在接聽器停止之前，接聽器嘗試將訊息遞送至訊息驅動 Bean 實例的次數上限。
`maxSession`	指定接聽器可與 JMS 伺服器一起處理訊息的並行階段作業數上限。每個階段作業都對應於個別的接聽器執行緒，因此，可以控制同時處理的訊息數。當伺服器未完全使用機器的可用容量，且您不需要以特定訊息順序處理訊息時，請調整此參數。

語法

AdminServerManagement.configureListenerPortForMessageListener(nodeName, serverName,
 listenerPortName, connectionFactoryJNDIName,
     destinationJNDIName, maxMessages, maxRetries, maxSession)

範例用法

AdminServerManagement.configureListenerPortForMessageListener(myNode, myServer, myListenerPort,
 connJNDI, destJNDI, 5, 2, 3)

configureMessageListenerService

此 Script 會在伺服器配置中配置訊息接聽器服務。訊息接聽器服務是 JMS 提供者之「Java 傳訊服務 (JMS)」功能的延伸。它提供一個接聽器管理程式來控制和監視一或多個 JMS 接聽器，每個 JMS 接聽器都代表部署的訊息驅動 Bean 來監視 JMS 目的地。

表 7. configureMessageListenerService 引數說明。使用節點名稱、伺服器名稱、訊息接聽器重試次數上限、接聽器回復間隔、儲存區臨界值及儲存區逾時引數來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`maxListener重試`	指定此服務所管理的接聽器埠在放棄及停止之前嘗試從失敗中回復的次數上限。停止之後，相關聯的接聽器埠會改成停止狀態。
`listenerRecovery間隔`	指定接聽器埠重試從失敗中回復的間隔時間 (以秒為單位)。
`poolingThreshold`	指定儲存區中未用連線的數目上限。預設值為 10。
`poolingTimeout`	指定如果尚未使用儲存區中的連線，則在該連線毀損之前所經歷的毫秒數。 MQSimpleConnectionManager 會以最近使用為基礎來配置連線，以最近最少使用為基礎來毀損連線。依預設，如果連線沒有使用達 5 分鐘，就會將它毀損。
`otherAttribute清單`	選擇性地以下列格式指定其他訊息接聽器屬性: [[description， test message listener] ， [isGrowable， true] ， [maximumSize， 100] ， [minimumSize， 5]]

語法

AdminServerManagement.configureMessageListenerService(nodeName, serverName,
 maxListenerRetry, listenerRecoveryInterval,
     poolingThreshold, poolingTimeout, otherAttributeList)

範例用法

AdminServerManagement.configureMessageListenerService(myNode, myServer, 5, 120,
 20, 600000, myProp, myValue,
      [["description", "test message listener"], ["isGrowable", "true"], ["maximumSize", 100], ["minimumSize", 5]])

configureState可管理

這個 Script 會配置應用程式伺服器的起始狀態。當伺服器處理程序啟動時，起始狀態是指元件所需的狀態。

表 8. configureState可管理引數說明。使用節點名稱、伺服器名稱、母項類型及起始狀態引數來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`parentType`	指定要修改的元件類型。
`initialState`	指定伺服器程序啟動時所需要的元件狀態。有效值為 START 及 STOP。

語法

AdminServerManagement.configureStateManageable(nodeName, serverName,
 parentType, initialState)

範例用法

AdminServerManagement.configureStateManageable(myNode, myServer, "Server", "START")

configureCustom內容

此 Script 會在應用程式伺服器配置中配置自訂內容。您可以使用自訂內容來配置內部系統內容，部分元件會使用這些內容，例如，將資訊傳遞至 Web 儲存器。

表 9. configureCustom內容引數說明。使用節點名稱、伺服器名稱、母項類型、內容名稱及內容值引數來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`parentType`	指定要配置的元件類型。
`propertyName`	指定要配置的自訂內容。
`propertyValue`	指定要配置的自訂內容值。
`otherAttribute清單`	選擇性地以下列格式指定其他屬性: [[commTraceEnabled， true] ， [enable， true]]

語法

AdminServerManagement.configureCustomProperty(nodeName, serverName, parentType, propertyName, propertyValue, otherAttributeList)

範例用法

AdminServerManagement.configureCustomProperty(myNode, myServer, ThreadPool, myProp1, myPropValue,
    [[description, my property test], [required, false]])

configureCustom服務

此 Script 會在應用程式伺服器配置中配置自訂服務。每個自訂服務都會定義一個在每次伺服器啟動和關閉時，都會載入和起始設定的類別。每個這些類別都必須實作 com.ibm.websphere.runtime.CustomService 介面。建立好自訂服務之後，請利用管理主控台來配置應用程式伺服器的自訂服務。

表 10. configureCustom服務引數說明。以節點名稱、伺服器名稱及偏好連接器類型來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`classname`	指定服務實作的類別名稱。這個類別必須實作自訂服務介面。
`顯示名稱`	指定服務的名稱。
`類別路徑`	指定用來尋找這個服務的類別和 JAR 檔的類別路徑。
`otherAttribute清單`	選擇性地以下列格式指定其他屬性: [[description， test custom service] ， [enable， true]]

語法

AdminServerManagement.configureCustomService(nodeName, serverName, classname, displayname, classpath, otherAttributeList)

範例用法

AdminServerManagement.configureCustomService(myNode, myServer, myClass, myName, C:\temp\boo.jar,
     [[description, test custom service], [enable, true]])

AdminServerManagement.configureCustomService(myNode, myServer, myClass, myName, /temp/boo.jar,
     [[description, test custom service], [enable, true]])

configureEndPointsHost

表 11. configureEndPointsHost 引數說明。執行 Script 以配置伺服器端點的主機名稱。指定節點名稱、伺服器名稱及主機名稱引數。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`hostName`	指定相關主機的名稱。

語法

AdminServerManagement.configureEndPointsHost(nodeName, serverName, hostName)

範例用法

AdminServerManagement.configureEndPointsHost(myNode, AppServer01, myHostname)

configureJavaVirtualMachine

此 Script 會配置 Java 虛擬機器 (JVM)。應用程式伺服器是 Java 處理程序，需要 JVM 才能執行，並支援在其上執行的 Java 應用程式。

表 12. configureJavaVirtualMachine 引數說明。使用感興趣 JVM 的配置 ID、是否啟用除錯模式以及其他除錯引數來執行 Script。
引數	說明
`javaVirtualMachineConfigID`	指定您要變更之 Java 虛擬機器的配置 ID。
`debugMode`	指定是否要在除錯模式下執行 JVM。預設值是不啟用除錯模式支援。如果您將 debugMode 引數設為 true，則必須指定除錯引數。
`debugArgs`	指定要傳遞給啟動應用程式伺服器程序之 JVM 程式碼的除錯引數。如果您在相同節點上的多部應用程式伺服器上啟用除錯，請確定伺服器使用不同的位址引數，這些引數定義用於除錯的埠。例如，如果您在兩部伺服器上啟用除錯，並將每一部伺服器的預設除錯埠保留為 address=7777，則伺服器可能無法適當地啟動。
`otherAttribute清單`	選擇性地使用下列名稱/值配對格式來指定其他屬性: [[internalClassAccessMode， RESTRICT] ， [disableJIT， false] ， [verboseModeJNI， false]]

語法

AdminServerManagement.configureJavaVirtualMachine(javaVirtualMachineConfigID,
 debugMode, debugArgs, otherAttributeList)

範例用法

AdminServerManagement.configureJavaVirtualMachine
   ("(cells/WAS00Network/nodes/ndnode1/servers/server1|server.xml#JavaVirtualMachine_1208188803955)", "true",
   mydebug, [["internalClassAccessMode", "RESTRICT"], ["disableJIT", "false"], ["verboseModeJNI", "false"]])

configureORBService

這個 Script 會在伺服器配置中配置 Object Request Broker (ORB) 服務。 Object Request Broker (ORB) 會利用網際網路交互 ORB 通訊協定 (IIOP) 來管理用戶端和伺服器之間的互動。它可讓用戶端在分散式網路的環境下發出要求，並從伺服器接收回應。

表 13. configureORBService 引數說明。使用節點名稱、伺服器名稱、要求逾時、要求重試次數、要求重試延遲、連線快取上限、連線快取下限及尋找要求逾時引數來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`requestTimeout`	指定要求訊息逾時之前的等待秒數。
`requestRetries計數`	指定當伺服器失敗時， ORB 嘗試傳送要求的次數。重試有時會使暫時性網路復原失敗。在 z/OS® 平台上，會忽略這個欄位。
`requestRetries延遲`	指定要求重試之間的毫秒數。在 z/OS 平台上，會忽略這個欄位。
`connectionCache上限`	指定在 ORB 開始從快取中移除非作用中連線之前，可佔用 ORB 連線快取的項目數上限。在 z/OS 平台上，會忽略這個欄位。快取中的作用中連線數目，可能會暫時超出這個臨界值。必要的話，只要有資源可用，ORB 將繼續新增連線。
`connectionCache最小值`	指定 ORB 連線快取中的項目數下限。在 z/OS 平台上，會忽略這個欄位。當項目數小於此值時， ORB 不會移除非作用中連線。
`locateRequest逾時`	指定 LocateRequest 訊息逾時之前的等待秒數。在 z/OS 平台上，會忽略這個欄位。
`otherAttribute清單`	選擇性地以下列格式指定其他屬性: [[commTraceEnabled， true] ， [enable， true]]

語法

AdminServerManagement.configureORBService(nodeName, serverName, requestTimeout, requestRetriesCount, requestRetriesDelay,
   connectionCacheMax, connectionCacheMin, locateRequestTimeout, otherAttributeList)

範例用法

AdminServerManagement.configureMessageListenerService(myNode, myServer, 5, 120, 20, 600000, 20, 300, 
[["commTraceEnabled", "true"], ["enable", "true"]])

configureProcess定義

此 Script 會配置伺服器程序定義。透過定義用於啟動或起始設定應用程式伺服器處理程序的指令行資訊，來加強應用程式伺服器的作業。程序定義設定定義執行時期內容，例如要執行的程式、執行程式的引數及工作目錄。

如果要執行 Script ，請指定節點名稱和伺服器名稱引數，如下表中所定義:

表 14. configureProcess定義引數說明。使用節點名稱、伺服器名稱及其他參數 (視需要) 來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`otherParam清單`	以下列格式指定程序定義配置的其他參數: [[executableName， value1] ， [executableArguments， value2] ， [workingDirectory， value3]]

語法

AdminServerManagement.configureProcessDefintion(nodeName, serverName, otherParamList)

範例用法

AdminServerManagement.configureProcessDefinition(myNode, myServer,
   [[executableName, "value1"],["executableArguments"."value2"],["workingDirectory","value3"]])

configureRuntimeTransactionService

這個 Script 會配置伺服器配置的交易服務。交易服務是一個伺服器執行時期元件，可協調多個資源管理程式的更新，以確保資料的基本更新。交易由應用程式或部署應用程式的儲存器來啟動和結束。

表 15. configureRuntimeTransactionService 引數說明。使用節點名稱、伺服器名稱、交易生命期限逾時總計及用戶端閒置逾時引數來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`totalTranLifetimeTimeout`	指定在交易服務起始逾時完成之前，在這部伺服器上啟動的交易所容許的預設時間上限 (以秒為單位)。凡是在發生這項逾時前沒有開始完成處理程序的交易都會被回復。
`clientInactivityTimeout`	指定遠端用戶端最久間隔多少秒數即發出一次交易要求。用戶端閒置超出這個逾時值的任何期間，都會在這個應用程式伺服器中造成交易的回復。如果您將這個值設成 0，就沒有逾時限制。

語法

AdminServerManagement.configureRuntimeTransactionService(nodeName, serverName,
 totalTranLifetimeTimeout, clientInactivityTimeout)

範例用法

AdminServerManagement.configureRuntimeTransactionService(myNode, myServer, "600", "600")

configureThread儲存區

此 Script 會在伺服器配置中配置執行緒儲存區。執行緒儲存區可讓伺服器元件重複使用執行緒，因而不必在執行時期建立新執行緒。建立新執行緒會消耗時間和資源。

表 16. configureThread儲存區引數說明。使用節點名稱、伺服器名稱、母項類型、執行緒儲存區名稱、大小上限、大小下限及發生逾時之前的時間量來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`parentType`	指定要配置的元件類型。
`threadPool名稱`	指定感興趣的執行緒儲存區名稱。
`maximumSize`	指定預設執行緒儲存區所要維護的執行緒數目上限。如果您的「Tivoli ® 效能檢視器」顯示「上限百分比」度量值以兩位數保持一致，請考慮增加大小上限。「上限百分比」度量指出使用所配置之執行緒的時間量。
`minimumSize`	指定儲存區中所允許的執行緒數目下限。當啟動應用程式伺服器時，最初並不會將任何執行緒指派給執行緒儲存區。執行緒是在指派給應用程式伺服器的工作量需要它們時，才會新增到執行緒儲存區中，直到儲存區中的執行緒數目等於「大小下限」欄位所指定的數目為止。過了這個時間點之後，便會隨著工作量的變更而新增和移除其他執行緒。不過，即使部分執行緒閒置，儲存區中的執行緒數目絕不會小於「大小下限」欄位中指定的數目。
`inactivityTimeout`	指定在執行緒不作用多少毫秒之後，就要將它收回。值 0 表示不等待，負值 (小於 0) 表示永遠等待。
`otherAttribute清單`	以下列格式指定其他配置屬性: [[description， testing thread pool] ， [isGrowable， true] ， [name， myThreadPool]]

語法

AdminServerManagement.configureThreadPool(nodeName, serverName,
 parentType, threadPoolName, maximumSize,
 minimumSize, inactivityTimeout, otherAttributeList)

範例用法

AdminServerManagement.configureThreadPool
   ("acmeNode2", "server1", "ThreadPoolManager", "WebContainer", 15, 25, 60)

configureTransaction服務

此 Script 會配置應用程式伺服器的交易服務。您可以與應用程式一起使用交易來協調資源的多個更新項目作為基本單元 (作為不可分割的工作單元) ，以便所有更新項目都變成永久。

表 17. configureTransaction服務引數說明。使用節點名稱、伺服器名稱、總交易生命期限逾時、用戶端閒置逾時、最大交易逾時、探索性重試限制、探索性重試等待、propegate 或 BMT 交易生命期限逾時，以及非同步回應逾時引數來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關的伺服器名稱。
`totalTranLifetimeTimeout`	指定在交易服務起始逾時完成之前，在這部伺服器上啟動的交易所容許的預設時間上限 (以秒為單位)。凡是在發生這項逾時前沒有開始完成處理程序的交易都會被回復。只有在應用程式元件並未設定它自己的交易逾時值時，才使用這個逾時值。只有交易生命週期逾時總計和最大交易逾時有寬限期。您可以使用 DISABLE_TRANSACTION_TIMEOUT_GRACE_PERIOD 自訂內容來停用寬限期。
`clientInactivityTimeout`	指定遠端用戶端最久間隔多少秒數即發出一次交易要求。用戶端閒置超出這個逾時值的任何期間，都會在這個應用程式伺服器中造成交易的回復。如果您將這個值設成 0，就沒有逾時限制。
`maximumTransaction逾時`	指定在此伺服器中執行之交易的交易逾時上限 (以秒為單位)。此值應該大於或等於交易逾時總計。此逾時會限制所有其他交易逾時的上限。
`heuristicRetry限制`	指定應用程式伺服器重試完成信號（如：確定或回復）的次數。若有下列情況，即會進行重試：當資源管理程式或遠端友機發出暫時性異常狀況後，或者在所有「Web 服務原子交易 (WS-AT)」友機做出回應前，即過了所配置的非同步回應逾時時間。
`heuristicRetryWait`	指定在資源管理程式或遠端友機擲出暫時性異常狀況之後，應用程式伺服器在重試完成信號（如：確定或回復）之前所要等待的秒數。
`propogatedOrBMTTranLifetimeTimeout`	指定交易在回復之前保持非作用中的秒數。
`asyncResponse逾時`	指定伺服器在重傳前一個「Web 服務原子交易 (WS-AT)」通訊協定訊息前，等待入埠 WS-AT 通訊協定回應的時間量（秒）。
`otherAttribute清單`	選擇性地以下列格式指定其他屬性: [[LPSHeuristicCompletion， ROLLBACK] ， [WSTransactionSpecificationLevel， WSTX_10] ， [enable， true]]

語法

AdminServerManagement.configureTransactionService(nodeName, serverName, 
totalTranLifetimeTimeout, clientInactivityTimeout,
   maximumTransactionTimeout, heuristicRetryLimit, heuristicRetryWait, 
   propogatedOrBMTTranLifetimeTimeout, asyncResponseTimeout, otherAttributeList)

範例用法

AdminServerManagement.configureTransactionService(myNode, myServer, 
    120, 60, 5, 2, 5, 300, 30, 
    [["LPSHeuristicCompletion", "ROLLBACK"], ["WSTransactionSpecificationLevel", "WSTX_10"], ["enable", "true"]])

setJVMProperties

這個 Script 會設定 JVM 配置的其他內容。

表 18. setJVMProperties 引數說明。使用節點名稱、伺服器名稱、類別路徑、開機類別路徑、起始資料堆大小、資料堆大小上限、是否啟用除錯模式及除錯引數來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`classPath`	選擇性地指定 Java 虛擬機器程式碼在其中尋找類別的標準類別路徑。
`bootClasspath`	選擇性地指定 JVM 程式碼的引導類別和資源。這個選項只適用於支援引導類別和資源的 JVM 指示。
`initialHeap大小`	選擇性地指定 JVM 程式碼可用的起始資料堆大小 (MB)。增加資料堆大小下限可以改善啟動。記憶體回收發生次數會減少，並實現 10% 的效能增益。一般而言，增加 Java 資料堆的大小會增進傳輸量，直到資料堆不再位於實體記憶體中為止。在資料堆開始交換至磁碟之後， Java 效能會大幅降低。
`maxHeap大小`	選擇性地指定 JVM 程式碼可用的資料堆大小上限 (MB)。增加資料堆大小可以改善啟動。藉由增加資料堆大小，您可以減少記憶體回收發生次數，效能提高 10%。
`debugMode`	選擇性地指定是否以除錯模式執行 JVM。預設值是不啟用除錯模式支援。如果您將 debugMode 引數設為 true，則必須指定除錯引數。
`debugArgs`	選擇性地指定要傳遞至啟動應用程式伺服器程序之 JVM 程式碼的除錯引數。如果您在相同節點上的多部應用程式伺服器上啟用除錯，請確定伺服器使用不同的位址引數，這些引數定義用於除錯的埠。例如，如果您在兩部伺服器上啟用除錯，並將每一部伺服器的預設除錯埠保留為 address=7777，則伺服器可能無法適當地啟動。

語法

AdminServerManagement.setJVMProperties(nodeName, serverName, 
classPath, bootClasspath, initialHeapSize, 
maxHeapSize, debugMode, debugArgs)

範例用法

AdminServerManagement.setJVMProperties(myNode, myServer, "c:\a.jar", "", "”, "", "", "")

AdminServerManagement.setJVMProperties(myNode, myServer, "/a.jar", "", "”, "", "", "")

setTrace規格

這個 Script 會設定配置的追蹤規格。

表 19. setTrace規格引數說明。使用節點名稱、伺服器名稱及追蹤規格引數來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`traceSpecification`	指定要傳遞給啟動應用程式伺服器程序之 JVM 程式碼的除錯引數。如果您在相同節點上的多部應用程式伺服器上啟用除錯，請確定伺服器使用不同的位址引數，這些引數定義用於除錯的埠。例如，如果您在兩部伺服器上啟用除錯，並將每一部伺服器的預設除錯埠保留為 address=7777，則伺服器可能無法適當地啟動。
`持續保存 (persist)`	選擇性地指定追蹤規格要持續多久。預設值為 `-persist false` ，且僅在 JVM 執行時期套用。如果 JVM 重新啟動，則會自動移除追蹤規格。如果您即使在 JVM 重新啟動時也要繼續追蹤規格，請指定 `-persist true`。

語法

AdminServerManagement.setTraceSpecification(nodeName, serverName, traceSpecification, persist)

persist 的用法範例

AdminServerManagement.setTraceSpecification(myNode, myServer, "com.ibm.ws.management.*=all", "true")

configureCookieForServer

此 Script 會在應用程式伺服器配置中配置 Cookie。配置 Cookie 以追蹤階段作業。

表 20. configureCookieForServer 引數說明。使用節點名稱、伺服器名稱、Cookie 名稱、網域、Cookie 經歷時間上限以及是否保護 Cookie 來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`cookieName`	指定階段作業管理 Cookie 的唯一名稱。 Servlet 規格需要名稱 JSESSIONID。不過，為了彈性，可以配置此值。
`網域`	指定階段作業追蹤 Cookie 的網域欄位。此值控制瀏覽器是否將 Cookie 傳送至特定伺服器。比方說，如果您指定一個特定網域，階段作業 Cookie 就會送往這個網域中的主機。預設網域是伺服器。
`maximumAge`	指定 Cookie 將存在於用戶端瀏覽器中的時間量。請指定 Cookie 的存活時間只和現行瀏覽器階段作業相同，或指定為有效期限上限。如果您選擇有效期限選項，請指定有效期限（秒）。這個值對應於 Cookie 規格中所說明的「存活時間」(TTL) 值。預設值是現行瀏覽器階段作業，相當於將值設為 -1。
`安全`	指定階段作業 Cookie 是否包含安全欄位。啟用此特性會限制只將 Cookie 交換至 HTTP 階段作業。
`otherAttribute清單`	選擇性地以下列格式指定其他屬性: [[path， C: /temp/mycookie]]

語法

AdminServerManagement.configureCookieForServer(nodeName, serverName, cookieName, domain, maximumAge, secure, otherAttributeList)

範例用法

AdminServerManagement.configureCookieForServer(myNode, myServer, myCookie, "uk.kingdom.com", -1, "true", [["path", "C:/temp/mycookie"]])

configureHTTPTransportForWeb儲存器

這個 Script 會配置 Web 儲存器的 HTTP 傳輸。傳輸在 Web 伺服器的應用程式伺服器外掛程式與應用程式 Web 模組所在的 Web 儲存器之間提供要求佇列。當您在 Web 瀏覽器中要求應用程式時，會將要求傳遞給 Web 伺服器，再傳輸給 Web 儲存器。

表 21. configureHTTPTransportForWeb儲存器引數說明。使用節點名稱、伺服器名稱、是否要調整埠、是否要使用外部 Secure Socket Layer (SSL) 配置，以及是否要啟用 SSL 來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`adjustPort`	指定是否自動調整感興趣 Web 儲存器的埠。
`外部`	指定是否將 Web 儲存器的「HTTP 傳輸」設為外部。
`sslConfig`	指定 WebSphere Application Server 外掛程式與應用程式伺服器之間連線的 Secure Sockets Layer (SSL) 設定類型。選項包括一或多個定義在「安全中心」中的 SSL 設定；例如，DefaultSSLSettings、ORBSSLSettings 或 LDAPSSLSettings。
`sslEnabled`	指定是否使用 Secure Sockets Layer (SSL) 來保護 WebSphere Application Server 外掛程式與應用程式伺服器之間的連線。預設不會使用 SSL。

語法

AdminServerManagement.configureHTTPTransportForWebContainer(nodeName, serverName,
 adjustPort, external, sslConfig, sslEnabled)

範例用法

AdminServerManagement.configureHTTPTransportForWebContainer(myNode, myServer, "true", "true", mySSLConfig, "true")

configureSessionManagerForServer

這個 Script 會配置應用程式伺服器的階段作業管理程式。階段作業允許在 Web 儲存器中執行的應用程式追蹤個別使用者。

表 22. configureSessionManagerForServer 引數說明。使用節點名稱、伺服器名稱及階段作業持續性模式來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`sessionPersistenceMode`	指定階段作業持續性模式。有效值包括 DATABASE, DATA_REPLICATION, 及 NONE。
`otherAttribute清單`	選擇性地以下列格式指定其他屬性: [[accessSessionOnTimeout， true] ， [enabled， true]]

語法

AdminServerManagement.configureSessionManagerForServer(nodeName, serverName, 
sessionPersistenceMode, otherAttributeList)

範例用法

AdminServerManagement.configureSessionManagerForServer(myNode, myServer, "DATABASE", 
[["accessSessionOnTimeout", "true"], ["enabled", "true"]])

configureWeb儲存器

此 Script 會在應用程式伺服器配置中配置 Web 儲存器。 Web 儲存器負責處理 Servlet、JavaServer Pages (JSP) 檔及包含伺服器端程式碼的其他檔案類型的要求。 Web 儲存器會建立 Servlet 實例、載入和卸載 Servlet、建立和管理要求和回應物件，以及執行其他 Servlet 管理作業。

表 23. configureWeb儲存器引數說明。使用節點名稱、伺服器名稱、預設虛擬主機名稱，以及是否啟用 Servlet 快取來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`webContainer名稱`	指定屬意 Web 儲存器的名稱。
`defaultVirtualHostName`	請指定虛擬主機，這個虛擬主機可讓單一主機變成好像多個主機。虛擬主機所關聯的資源無法與另一虛擬主機所關聯的資源共用資料，即使它們共用相同的實體機器也一樣。有效的值包括： default_host 產品提供了一個預設虛擬主機以及一些通用別名，如機器的 IP 位址、簡短主機名稱和完整主機名稱。別名構成了 Servlet 這類資源之存取路徑的第一部分。例如，在要求 http://localhost:9080/myServlet中，它是 localhost:9080 。 admin_host 這是應用程式伺服器的另一個名稱; 在基本安裝架構中也稱為 server1 。這個程序支援使用管理主控台。 proxy_host 稱為 proxy_host 的虛擬主機包括預設埠定義（80 和 443 埠），通常會隨著 Proxy 伺服器一同起始設定。請適當地利用這個 Proxy 主機來搭配 Proxy 伺服器的相關遞送規則。
`enableServletCaching`	指定如果 Servlet 呼叫一次，且它產生要快取的輸出，則會建立一個快取項目，不僅包含輸出，還包含呼叫的負面影響。這些副作用可能包括呼叫其他 Servlet 或 JavaServer Pages (JSP) 檔，以及項目相關的 Meta 資料，其中包括逾時和項目優先順序資訊。 Portlet 片段快取需要啟用 Servlet 快取。因此，啟用 Portlet 片段快取會自動啟用 Servlet 快取。停用 Servlet 快取，會自動停用 Portlet 片段快取。
`otherAttribute清單`	選擇性地以下列格式指定其他屬性: [[allowAsyncRequestDispatching， true] ， [disablePooling， true] ， [sessionAffinityTimeout， 20]]

語法

AdminServerManagement.configureWebContainer(nodeName, serverName, 
defaultVirtualHostName, enableServletCaching, otherAttributeList)

範例用法

AdminServerManagement.configureWebContainer(myNode, myServer, myVH.uk.kingdom.com,
 "true", 
   [["allowAsyncRequestDispatching", "true"], ["disablePooling", "true"], ["sessionAffinityTimeout", 20]])

configureJavaProcessLogs

此 Script 會配置應用程式伺服器的 Java 處理程序日誌。系統會將 JVM 的 System.out 和 System.err 串流重新導向至獨立日誌檔，以建立 JVM 日誌。

表 24. configureJavaProcessLogs 引數說明。使用相關的 Java 處理程序定義及處理程序日誌的根目錄來執行 Script。
引數	說明
`javaProcessDefConfigID`	指定您屬意之「Java 程序定義」的配置 ID。
`processLog根目錄`	指定程序日誌的根目錄。
`otherAttribute清單`	選擇性地使用下列名稱/值配對格式來指定其他屬性: [[stdinFilename， /temp/mystdin.log]]

語法

AdminServerManagement.configureJavaProcessLogs(javaProcessDefConfigID, processLogRoot,
 otherAttributeList)

範例用法

AdminServerManagement.configureJavaProcessLogs
   ("(cells/WAS00Network/nodes/ndnode1/servers/server1|server.xml#JavaProcessDef_1184194176408)",
   C:\temp\myJavaLog, [[stdinFilename, c:\temp\mystdin.log]])

AdminServerManagement.configureJavaProcessLogs
   ("(cells/WAS00Network/nodes/ndnode1/servers/server1|server.xml#JavaProcessDef_1184194176408)", 
   	/temp/myJavaLog, [[stdinFilename, /temp/mystdin.log]])

configurePerformanceMonitoringService

這個 Script 會在您的配置中配置效能監視基礎架構 (PMI)。 PMI 使伺服器能夠收集各產品元件的效能資料。 PMI 會提供系統資源平均用量統計資料的相關資訊，不含跨越不同元件的資料間相關性。

表 25. configurePerformanceMonitoringService 引數說明。以節點名稱、伺服器名稱、是否啟用 PMI ，以及起始規格層次引數來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`啟用`	請指定應用程式伺服器是否要嘗試啟用效能監視基礎架構 (PMI)。如果在停用 PMI 時啟動應用程式伺服器，您必須重新啟動伺服器，才能啟用它。
`initialSpec層次`	請指定伺服器所有元件的效能監視基礎架構 (PMI) 統計資料的預先定義集合。無停用所有統計資料。基本提供應用程式伺服器資源和應用程式的基本監視作業。這包括 Java Platform Enterprise Edition (Java EE) 元件、HTTP 階段作業資訊、CPU 使用率資訊，以及前 38 個統計資料。這是預設的設定。延伸事項提供延伸監視，包括監視的基本層次，以及工作量監視器、效能顧問及 Tivoli 資源模型。 Extended 提供常用 WebSphere Application Server 元件的重要統計資料。全部啟用所有的統計資料。自訂提供啟用及停用個別統計資料的細部控制能力。
`otherAttribute清單`	選擇性地使用下列名稱/值配對格式來指定其他屬性: [[statisticSet， test statistic set] ， [synchronizedUpdate， true]]

語法

AdminServerManagement.configurePerformanceMonitoringService(nodeName, serverName, 
enable, initialSpecLevel, otherAttributeList)

範例用法

AdminServerManagement.configurePerformanceMonitoringService(myNode, myServer, "true", "Basic", 
[["statisticSet", "test statistic set"], ["synchronizedUpdate", "true"]])

configurePMIRequest度量

這個 Script 會在您的配置中配置 PMI 要求度量。要求度量提供每一個交易的相關資料，使各種產品元件之間的這項資訊產生關聯，以提供交易的端對端圖片。

表 26. configurePMIRequest度量引數說明。執行 Script 並指定是否啟用要求度量及追蹤層次。
引數	說明
`啟用`	指定是否開啟要求計量資料特性。如果它停用時，要求度量也會停用。
`traceLevel`	指定給定交易要累計多少追蹤資料。請注意，要檢測的追蹤層次和元件會一起運作，以控制是否要檢測要求。無無設備測試。中繼站只在程序界限上產生檢測資訊 (例如，來自瀏覽器或 Web 伺服器的 Servlet 要求，以及進入資料庫的 JDBC 要求)。 Performance_debug 產生「中繼站」層次的資料，以及程序內 Servlet 和 Enterprise JavaBeans (EJB) 呼叫的第一層資料 (例如，當入埠 Servlet 轉遞至 Servlet ，而入埠 EJB 呼叫另一個 EJB 時)。這個層次不會啟用其他程序內呼叫，例如命名和服務整合匯流排 (SIB)。除錯提供詳細的設備測試資料，其中包括所有程序內呼叫的回應時間。這個層次只會對於 Servlet 過濾器的要求進行設備測試。
`otherAttribute清單`	選擇性地使用下列名稱/值配對格式來指定其他屬性: [[armType， TIVOLI_ARM] ， [enableARM， true]]

語法

AdminServerManagement.configurePMIRequestMetrics(enable, traceLevel, otherAttributeList)

範例用法

AdminServerManagement.configurePMIRequestMetrics("true", "DEBUG", 
   [["armType", "TIVOLI_ARM"], ["enableARM", "true"]])

configureRASLogging服務

此 Script 會在應用程式伺服器配置中配置 RAS 記載。

表 27. configureRASLogging服務引數說明。使用 RAS 日誌的節點名稱、伺服器名稱及根目錄來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`serviceLog根目錄`	指定 RAS 記載服務日誌的根目錄。
`otherAttribute清單`	選擇性地使用下列名稱/值配對格式來指定其他屬性: [[enabled， true] ， [size， 500]]

語法

AdminServerManagement.configureRASLoggingService(nodeName, serverName,
 serviceLogRoot, otherAttributeList)

範例用法

AdminServerManagement.configureRASLoggingService(myNode, myServer, /temp/myRASLog, 
   [["enabled", "true"], ["size", "500"]])

configureServer日誌

此 Script 會為感興趣的應用程式伺服器配置伺服器日誌。

表 28. configureServerLogs 引數說明。使用伺服器日誌的節點名稱、伺服器名稱及根目錄來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`serverLog根目錄`	指定伺服器日誌的根目錄。
`otherAttribute清單`	選擇性地使用下列名稱/值配對格式來指定其他屬性: [[formatWrites， true] ， [messageFormatKind， BASIC] ， [rolloverType， BOTH]]

語法

AdminServerManagement.configureServerLogs(nodeName, serverName, 
serverLogRoot, otherAttributeList)

範例用法

AdminServerManagement.configureServerLogs(myNode, myServer, C:\temp\mylog, 
   [["formatWrites", "true"], ["messageFormatKind", "BASIC"], ["rolloverType", "BOTH"]])

AdminServerManagement.configureServerLogs(myNode, myServer, /temp/mylog, 
   [["formatWrites", "true"], ["messageFormatKind", "BASIC"], ["rolloverType", "BOTH"]])

configureTrace服務

此 Script 會配置應用程式伺服器的追蹤設定。配置追蹤以取得執行應用程式伺服器的詳細資訊。

表 29. configureTrace服務引數說明。使用節點名稱、伺服器名稱、追蹤規格及輸出類型引數來執行 Script。
引數	說明
`nodeName`	指定相關節點的名稱。
`serverName`	指定相關伺服器的名稱。
`startupTrace規格`	指定要針對感興趣元件啟用的追蹤規格。例如， com.ibm.ws.webservices.trace.MessageTrace=all 追蹤規格會追蹤 SOAP 訊息的內容，包括二進位附件資料。
`traceOutput類型`	指定追蹤輸出應該寫在哪裡。追蹤輸出可以直接寫入輸出檔，或儲存在記憶體中。
`otherAttribute清單`	選擇性地使用下列名稱/值配對格式來指定追蹤服務的其他屬性: [[enable， true] ， [traceFormat， LOG_ANALYZER]]

語法

AdminServerManagement.configureTraceService(nodeName, serverName, 
traceString, outputType, otherAttributeList)

範例用法

AdminServerManagement.configureTraceService(myNode, myServer, "com.ibm.ws.management.*=all=enabled", 
   SPECIFIED_FILE, [["enable", "true"], ["traceFormat", "LOG_ANALYZER"]])