The scripting library provides multiple script procedures to automate your application server configurations. Use the scripts in this topic to create, query, and manage your business-level applications. You can run each script individually or combine procedures to create custom automation scripts.
The AdminBLA script procedures are located in the app_server_root/scriptLibraries/application/V70 directory.
When invoked, as intended, with the Jython wsadmin interface, these commands properly display output to the console.
gotchaThis script adds assets, shared libraries, or additional business-level applications as composition units to the empty business-level application. A composition unit represents an asset in a business-level application. A configuration unit enables the asset contents to interact with other assets in the application. It also enables the product run time to load and run asset contents.
Argument | Description |
---|---|
blaName | Specifies the name of the business-level application to which the system adds the composition unit. |
compUnitID | Specifies the name of the composition unit to add to the business-level application of interest. |
deployableUnit | Optionally specifies the name of the deployable unit for the asset. A deployable unit is the smallest portion of an asset that can be individually chosen for deployment |
compUnitName | Optionally specifies the name for the composition unit to add. |
compUnitDescription | Optionally specifies a description for the new composition unit. |
startingWeight | Optionally specifies the starting weight of the composition unit. |
target | Optionally specifies the target to which the composition unit is mapped. |
activationPlan | Optionally specifies the activation plan for the composition unit. |
Syntax
AdminBLA.addCompUnit(blaName, compUnitID, deployableUnit, compUnitName,
compUnitDescription, startingWeight, target, activationPlan)
Example usage
AdminBLA.addCompUnit("bla1", "asset1.zip", "default", "myCompositionUnit", "cu description", "1",
"server1", "specname=actplan1")
This script creates a new business-level application in your environment. Create an empty business-level application and then add assets, shared libraries, or business-level applications as composition units to the empty business-level application.
Argument | Description |
---|---|
blaName | Specifies the name to assign to the new business-level application. |
description | Optionally specifies a description for the business-level application. |
Syntax
AdminBLA.createEmptyBLA(blaName, description)
Example usage
AdminBLA.createEmptyBLA("myBLA", "bla to control transactions")
This script removes a registered asset from your configuration.
Argument | Description |
---|---|
assetID | Specifies the name of the asset to delete. |
Syntax
AdminBLA.deleteAsset(assetID)
Example usage
AdminBLA.deleteAsset("asset.zip")
This script removes a business-level application from your configuration.
Argument | Description |
---|---|
blaName | Specifies the name of the business-level application to delete. |
Syntax
AdminBLA.deleteBLA(blaName)
Example usage
AdminBLA.deleteBLA("myBLA")
This script removes a composition unit from a specific business-level application configuration.
Argument | Description |
---|---|
blaName | Specifies the name of the business-level application of interest. |
compUnitID | Specifies the identifier of the composition unit to delete. |
Syntax
AdminBLA.deleteCompUnit(blaName, compUnitID)
Example usage
AdminBLA.deleteCompUnit("myBLA", "asset.zip")
This script edits the metadata of a specific registered asset.
Argument | Description |
---|---|
assetID | Specifies the name of the asset to edit. |
assetDescription | Optionally specifies the new description of the asset of interest. |
assetDestinationURL | Optionally specifies the new destination URL for the asset of interest. |
assetTypeAspects | Optionally specifies the new type aspects for the asset of interest. |
assetRelationships | Optionally specifies the new asset relationship configurations. |
filePermission | Optionally specifies the new file permission configuration for the asset of interest. |
validateAsset | Optionally specifies whether the command validates the asset. |
Syntax
AdminBLA.editAsset(assetID, assetDescription, assetDestinationURL,
assetTypeAspects, assetRelationships, filePermission, validateAsset)
Example usage
AdminBLA.editAsset("asset1.zip", "asset for testing", "c:/installedAssets/asset1.zip",
"WebSphere:spec=sharedlib", "", ".*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755", "true")
This script edits a specific composition unit within a business-level application.
Argument | Description |
---|---|
blaName | Specifies the name of the business-level application to which the composition unit is associated. |
compUnitID | Specifies the name of the composition unit to edit. |
compUnitDescription | Optionally specifies a new description for the composition unit. |
startingWeight | Optionally specifies a new starting weight for the composition unit. |
target | Optionally specifies a new target to which the composition unit is mapped. |
activationPlan | Optionally specifies a new activation plan for the composition unit. |
Syntax
AdminBLA.editCompUnit(blaName, compUnitID, compUnitDescription,
startingWeight, target, activationPlan)
Example usage
AdminBLA.editCompUnit("bla1", "asset1.zip","cu description", "1", "server1", "specname=actplan1")
This script exports a registered asset to a file on your system.
Argument | Description |
---|---|
assetID | Specifies the identifier of the asset to export. |
fileName | Specifies the fully qualified file path to which the system exports the asset. |
Syntax
AdminBLA.exportAsset(assetID, fileName)
Example usage
AdminBLA.exportAsset("asset.zip", "c:\temp\a.zip")
AdminBLA.exportAsset("asset.zip", "/temp/a.zip")
This script imports and registers an asset to a management domain in your configuration.
Argument | Description |
---|---|
assetID | Specifies the asset to import. |
displayDescription | Optionally specifies whether the script displays the description of the asset. |
dispDeployableUnit | Optionally specifies whether the script displays the deployable units for the asset to import. |
Syntax
AdminBLA.importAsset(assetID, displayDescription, dispDeployableUnit)
Example usage
AdminBLA.importAsset("asset.zip", "true", "true")
This script starts the business-level application process in your configuration.
Argument | Description |
---|---|
blaName | Specifies the name of the business-level application to start. |
Syntax
AdminBLA.startBLA(blaName)
Example usage
AdminBLA.startBLA("myBLA")
This script stops the business-level application process in your configuration.
Argument | Description |
---|---|
blaName | Specifies the name of the business-level application to stop. |
Syntax
AdminBLA.stopBLA(blaName)
Example usage
AdminBLA.stopBLA("myBLA")
Argument | Description |
---|---|
script | Specifies the name of the script of interest. |
Syntax
AdminBLA.help(script)
Example usage
AdminBLA.help("createEmptyBLA")
This script displays the registered assets in your configuration.
Argument | Description |
---|---|
assetID | Optionally specifies the group ID for which to display authorization groups. |
displayDescription | Optionally specifies whether the command displays a description for each asset. Specify true to display descriptions. |
displayDeployUnits | Optionally specifies whether the command displays the deployable units that are associated with the assets. Specify true to display the deployable units. |
Syntax
AdminBLA.listAssets(assetID, displayDescription, displayDeployUnits)
Example usage
AdminBLA.listAssets("asset.zip", "true", "true")
This script displays each or specific business-level applications in your configuration.
Argument | Description |
---|---|
blaName | Optionally specifies the name of a business-level application of interest. |
displayDescription | Optionally specifies whether the command displays a description for each business-level application. Specify true to display descriptions. |
Syntax
AdminBLA.listBLAs(blaName, displayDescription)
Example usage
AdminBLA.listBLAs("", "true")
This script displays composition units within a business-level application.
Argument | Description |
---|---|
blaName | Specifies the name of the authorization group of interest. |
displayDescription | Optionally specifies whether the command displays a description for each composition unit. Specify true to display descriptions. |
Syntax
AdminBLA.listCompUnits(blaName, displayDescription)
Example usage
AdminBLA.listCompUnits("myBLA", "true")
This script displays the name and description of the business-level application of interest.
Argument | Description |
---|---|
blaID | Specifies the configuration ID of the business-level asset of interest. |
Syntax
AdminBLA.viewBLA(blaID)
Example usage
AdminBLA.viewBLA("bla01.zip")
This script displays the configuration attributes for a specific registered asset.
Argument | Description |
---|---|
assetID | Specifies the name of the asset of interest. |
Syntax
AdminBLA.viewAsset(assetID)
Example usage
AdminBLA.viewAsset("asset.zip")
This script displays the configuration attributes for a specific composition unit within a business-level application.
Argument | Description |
---|---|
blaName | Specifies the name of the business-level application of interest. |
compUnitID | Specifies the identifier for the composition unit of interest. |
Syntax
AdminBLA.viewCompUnit(blaName, compUnitID)
Example usage
AdminBLA.viewCompUnit("myBLA", "asset.zip")