商業層次應用程式配置 Script

Scripting 程式庫提供多項 Script 程序,來自動執行您的應用程式伺服器配置。請利用這個主題中的 Script,來建立、查詢和管理您的商業層次應用程式。您可以個別執行每一個 Script,或是合併一些程序,來建立自訂自動化 Script。

AdminBLA Script 程序位於 app_server_root/scriptLibraries/application/V70 目錄中。

請利用下列 Script 程序,來配置和管理您的商業層次應用程式:
請利用下列 Script 程序,來查詢您的商業層次應用程式配置:
避免困難 避免困難: viewBLAviewAssetviewCompUnit 指令只會將輸出顯示在主控台中,並不會傳回資料給呼叫端 Jython Script。這些指令並非作為 Script 的一部分,而將指令的輸出儲存到字串變數。當您在 Jython Script 中使用這些指令,以便將輸出儲存到字串變數時,字串變數只會包含值 "Operation Successful!"。

當依照預期用法,使用 Jython wsadmin 介面進行呼叫時,這些指令能適當地將輸出顯示在主控台中。

gotcha

addCompUnit

這個 Script 會將資產、共用程式庫或其他商業層次應用程式當成組合單元,新增至空的商業層次應用程式。組合單元代表商業層次應用程式中的資產。配置單元可讓資產內容與應用程式中的其他資產互動。此外,也可讓產品執行時期載入和執行資產內容。

如果要執行 Script,請指定商業層次應用程式名稱和組合單元來源等引數,如下表中的定義所示:
表 1. addCompUnit 引數說明. 執行 Script,將組合單元新增至商業層次應用程式。
引數 說明
blaName 指定商業層次應用程式的名稱,讓系統在其中新增組合單元。
compUnitID 指定要新增至屬意之商業層次應用程式的組合單元名稱。
deployableUnit (選用)指定資產的可部署單元名稱。可部署單元是資產的最小部分,可讓您個別選擇來部署。
compUnitName (選用)指定要新增之組合單元的名稱。
compUnitDescription (選用)指定新組合單元的說明。
startingWeight (選用)指定組合單元的起始加權。
target (選用)指定組合單元的對映目標。
activationPlan (選用)指定組合單元的啟動計劃。

語法

AdminBLA.addCompUnit(blaName, compUnitID, deployableUnit, compUnitName,
 compUnitDescription, startingWeight, target, activationPlan)

範例用法

AdminBLA.addCompUnit("bla1", "asset1.zip", "default", "myCompositionUnit", "cu description", "1", 
"server1", "specname=actplan1")

createEmptyBLA

這個 Script 會在您的環境中建立新的商業層次應用程式。建立空的商業層次應用程式,然後將資產、共用程式庫或商業層次應用程式當成組合單元,新增至空的商業層次應用程式。

如果要執行 Script,請指定商業層次應用程式名稱引數,如下表中的定義所示:
表 2. createEmptyBLA 引數說明. 執行 Script,以建立商業層次應用程式。
引數 說明
blaName 指定要指派給新商業層次應用程式的名稱。
description (選用)指定商業層次應用程式的說明。

語法

AdminBLA.createEmptyBLA(blaName, description)

範例用法

AdminBLA.createEmptyBLA("myBLA", "bla to control transactions")

deleteAsset

這個 Script 會將已登錄的資產從配置移除。

如果要執行 Script,請指定資產 ID 引數,如下表中的定義所示:
表 3. deleteAsset 引數說明. 執行 Script,以刪除資產。
引數 說明
assetID 指定要刪除的資產名稱。

語法

AdminBLA.deleteAsset(assetID)

範例用法

AdminBLA.deleteAsset("asset.zip")

deleteBLA

這個 Script 會將商業層次應用程式從配置移除。

如果要執行 Script,請指定商業層次應用程式名稱引數,如下表中的定義所示:
表 4. deleteBLA 引數說明. 執行 Script,以刪除商業層次應用程式。
引數 說明
blaName 指定要刪除的商業層次應用程式名稱。

語法

AdminBLA.deleteBLA(blaName)

範例用法

AdminBLA.deleteBLA("myBLA")

deleteCompUnit

這個 Script 會將組合單元從特定商業層次應用程式配置移除。

如果要執行 Script,請指定商業層次應用程式名稱和組合單元等引數,如下表中的定義所示:
表 5. deleteCompUnit 引數說明. 執行 Script,將組合單元從商業層次應用程式刪除。
引數 說明
blaName 指定您屬意之商業層次應用程式的名稱。
compUnitID 指定要刪除之組合單元的 ID。

語法

AdminBLA.deleteCompUnit(blaName, compUnitID)

範例用法

AdminBLA.deleteCompUnit("myBLA", "asset.zip")

editAsset

這個 Script 用來編輯特定已登錄資產的 meta 資料。

如果要執行 Script,請指定引數,如下表中的定義所示:
表 6. editAsset 引數說明. 執行 Script,以變更資產。
引數 說明
assetID 指定要編輯的資產名稱。
assetDescription (選用)指定您屬意之資產的新說明。
assetDestinationURL (選用)指定您屬意之資產的新目的地 URL。
assetTypeAspects (選用)指定您屬意之資產的新類型層面。
assetRelationships (選用)指定新資產關係配置。
filePermission (選用)指定您屬意之資產的新檔案許可權配置。
validateAsset (選用)指定指令是否要驗證資產。

語法

AdminBLA.editAsset(assetID, assetDescription, assetDestinationURL, 
assetTypeAspects, assetRelationships, filePermission, validateAsset)

範例用法

AdminBLA.editAsset("asset1.zip", "asset for testing", "c:/installedAssets/asset1.zip", 
"WebSphere:spec=sharedlib", "", ".*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755", "true")

editCompUnit

這個 Script 用來編輯商業層次應用程式內的特定組合單元。

如果要執行 Script,請指定商業層次應用程式名稱和組合單元 ID 等引數,如下表中的定義所示:
表 7. editCompUnit 引數說明. 執行 Script,以變更組合單元。
引數 說明
blaName 指定組合單元相關聯的商業層次應用程式名稱。
compUnitID 指定要編輯的組合單元名稱。
compUnitDescription (選用)指定組合單元的新說明。
startingWeight (選用)指定組合單元的新起始加權。
target (選用)指定組合單元的新對映目標。
activationPlan (選用)指定組合單元的新啟動計劃。

語法

AdminBLA.editCompUnit(blaName, compUnitID, compUnitDescription, 
startingWeight, target, activationPlan)

範例用法

AdminBLA.editCompUnit("bla1", "asset1.zip","cu description", "1", 
"server1", "specname=actplan1")

exportAsset

這個 Script 會將已登錄的資產匯出至您系統上的檔案。

如果要執行 Script,請指定資產 ID 和檔名等引數,如下表中的定義所示:
表 8. exportAsset 引數說明. 執行 Script,以匯出資產。
引數 說明
assetID 指定要匯出之資產的 ID。
fileName 指定系統匯出資產時的完整目標檔案路徑。

語法

AdminBLA.exportAsset(assetID, fileName)

範例用法

[Windows]
AdminBLA.exportAsset("asset.zip", "c:\temp\a.zip")
[AIX][Linux][Solaris][HP-UX][IBM i][z/OS]
AdminBLA.exportAsset("asset.zip", "/temp/a.zip")

importAsset

這個 Script 會匯入和登錄資產到您配置中的管理網域。

如果要執行 Script,請指定 assetID、displayDescription 和 deployableUnit 引數,如下表中的定義所示:
表 9. importAsset 引數說明. 執行 Script,以匯入資產。
引數 說明
assetID 指定要匯入的資產。
displayDescription (選用)指定 Script 是否顯示資產的說明。
dispDeployableUnit (選用)指定 Script 是否顯示所要匯入之資產的可部署單元。

語法

AdminBLA.importAsset(assetID, displayDescription, dispDeployableUnit)

範例用法

AdminBLA.importAsset("asset.zip", "true", "true")

startBLA

這個 Script 會啟動您配置中的商業層次應用程式程序。

如果要執行 Script,請指定商業層次應用程式名稱引數,如下表中的定義所示:
表 10. startBLA 引數說明. 執行 Script,以啟動商業層次應用程式。
引數 說明
blaName 指定要啟動的商業層次應用程式名稱。

語法

AdminBLA.startBLA(blaName)

範例用法

AdminBLA.startBLA("myBLA")

stopBLA

這個 Script 會停止您配置中的商業層次應用程式程序。

如果要執行 Script,請指定商業層次應用程式名稱引數,如下表中的定義所示:
表 11. stopBLA 引數說明. 執行 Script,以停止商業層次應用程式。
引數 說明
blaName 指定要停止的商業層次應用程式名稱。

語法

AdminBLA.stopBLA(blaName)

範例用法

AdminBLA.stopBLA("myBLA")

說明

這個 Script 會顯示 AdminBLA Script 程式庫支援的 Script 程序。如果要顯示特定 Script 的詳細說明,請指定您屬意之 Script 的名稱,如下表中的定義所示:
表 12. help 引數說明. 執行 Script,以顯示說明。
引數 說明
script 指定您屬意之 Script 的名稱。

語法

AdminBLA.help(script)

範例用法

AdminBLA.help("createEmptyBLA")

listAssets

這個 Script 會列出您配置中的已登錄資產。

如果要執行 Script,您可以選擇指定資產 ID、顯示說明,以及顯示可部署單元等引數,如下表中的定義所示:
表 13. listAssets 引數說明. 執行 Script,以列出資產。
引數 說明
assetID (選用)指定群組 ID,以顯示其授權群組。
displayDescription (選用)指定指令是否顯示每一個資產的說明。指定 true,則會顯示說明。
displayDeployUnits (選用)指定指令是否顯示資產相關聯的可部署單元。指定 true,則會顯示可部署單元。

語法

AdminBLA.listAssets(assetID, displayDescription, displayDeployUnits)

範例用法

AdminBLA.listAssets("asset.zip", "true", "true")

listBLAs

這個 Script 顯示您配置中每一個或特定的商業層次應用程式。

如果要執行 Script,您可以選擇指定商業層次應用程式名稱和顯示說明等引數,如下表中的定義所示:
表 14. listBLAs 引數說明. 執行 Script,以列出商業層次應用程式。
引數 說明
blaName (選用)指定您屬意之商業層次應用程式的名稱。
displayDescription (選用)指定指令是否顯示每一個商業層次應用程式的說明。指定 true,則會顯示說明。

語法

AdminBLA.listBLAs(blaName, displayDescription)

範例用法

AdminBLA.listBLAs("", "true")

listCompUnits

這個 Script 會顯示商業層次應用程式內的組合單元。

如果要執行 Script,請指定商業層次應用程式名稱引數,如下表中的定義所示:
表 15. listCompUnits 引數說明. 執行 Script,以列出組合單元。
引數 說明
blaName 指定您屬意之授權群組的名稱。
displayDescription (選用)指定指令是否顯示每一個組合單元的說明。指定 true,則會顯示說明。

語法

AdminBLA.listCompUnits(blaName, displayDescription)

範例用法

AdminBLA.listCompUnits("myBLA", "true")

viewBLA

這個 Script 會顯示您屬意之商業層次應用程式的名稱和說明。

如果要執行 Script,請指定您屬意之商業層次應用程式的配置 ID 引數,如下表中的定義所示:
表 16. viewBLA 引數說明. 執行 Script,以檢視商業層次應用程式的相關資訊。
引數 說明
blaID 指定您屬意之商業層次應用程式的配置 ID。

語法

AdminBLA.viewBLA(blaID)

範例用法

AdminBLA.viewBLA("bla01.zip")

viewAsset

這個 Script 會顯示特定已登錄資產的配置屬性。

如果要執行 Script,請指定資產 ID 引數,如下表中的定義所示:
表 17. viewAsset 引數說明. 執行 Script,以檢視資產的相關資訊。
引數 說明
assetID 指定您屬意之資產的名稱。

語法

AdminBLA.viewAsset(assetID)

範例用法

AdminBLA.viewAsset("asset.zip")

viewCompUnit

這個 Script 會顯示商業層次應用程式內之特定組合單元的配置屬性。

如果要執行 Script,請指定商業層次應用程式和組合單元 ID 等引數,如下表中的定義所示:
表 18. viewCompUnit 引數說明. 執行 Script,以檢視組合單元的相關資訊。
引數 說明
blaName 指定您屬意之商業層次應用程式的名稱。
compUnitID 指定您屬意之組合單元的 ID。

語法

AdminBLA.viewCompUnit(blaName, compUnitID)

範例用法

AdminBLA.viewCompUnit("myBLA", "asset.zip")

指出主題類型的圖示 參照主題



時間戳記圖示 前次更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_7libbla
檔名:rxml_7libbla.html