Business-level application configuration scripts
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.
문제점 방지: The commands, viewBLA, viewAsset, and
viewCompUnit only display output to the console and do not return data to the calling Jython
script. These commands are not intended to be used as part of a script to store the output of the
command to a string variable. By using these commands in a Jython script to store the output to a
string variable, the string variable will only contain the value "Operation Successful!".When invoked, as intended, with the Jython wsadmin interface, these commands properly display output to the console.
gotchaaddCompUnit
This 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")
createEmptyBLA
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")
deleteAsset
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")
deleteBLA
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")
deleteCompUnit
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")
editAsset
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")
editCompUnit
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")
exportAsset
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
![[Windows]](../images/windows.gif)
AdminBLA.exportAsset("asset.zip", "c:\temp\a.zip")
![[AIX]](../images/aixlogo.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
AdminBLA.exportAsset("asset.zip", "/temp/a.zip")
importAsset
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")
startBLA
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")
stopBLA
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")
help
| Argument | Description |
|---|---|
| script | Specifies the name of the script of interest. |
Syntax
AdminBLA.help(script)
Example usage
AdminBLA.help("createEmptyBLA")
listAssets
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")
listBLAs
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")
listCompUnits
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")
viewBLA
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 application of interest. |
Syntax
AdminBLA.viewBLA(blaID)
Example usage
AdminBLA.viewBLA("bla01.zip")
viewAsset
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")
viewCompUnit
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")
참조 주제