This environment provides the ability to build, package, and install SCA sample applications in a single server configuration.
The WAS_HOME/samples/SCA environment relies upon ws_ant.bat|sh to execute ant. Each sample directory provides a build.xml which defines appropiate targets for that sample, to be used together with the specific README instructions for each sample.
These samples are written to be used in conjunction with the specification and other documents. However, the most important function that these samples provide is a place to begin experimenting with the SCA API and programming model. Developers are encouraged to extend and experiment with the current set of samples.
SCA specifications are hosted by the Open Service Oriented Architecture collaboration.
Specific to your environment:
From any of the sample directories located under the WAS_HOME/samples/SCA:
Throughout the samples a variety of custom ANT tasks are used for code generation or application installation. The following section provides a brief overview of these options and usage:
Description: | Installs BLA (jar file packaging for service) |
---|---|
Task: | createBLA |
Arguments: |
|
Example: |
|
Description: | Installs Ear |
---|---|
Task: | installEAR |
Arguments: |
|
Example: |
|
SCA services are packaged in jar files and can be installed as BLA jar files. This is typically done using wsadmin. The following is a simple set of example wsdadmin commands that can be used to manage BLA applications. Note three commands are required for the full installation and full deletion of the BLA.
$AdminTask createEmptyBLA {-name scabla1}
$AdminTask importAsset {-source C:/WebSphere/AppServer02/bin/sca/SCAModuleSample1.jar -storageType FULL}
$AdminTask addCompUnit {-blaID scabla1 -cuSourceID SCAModuleSample1.jar}
$AdminConfig save
$AdminTask listBLAs
$AdminTask startBLA {-blaID scabla1}
$AdminTask stopBLA {-blaID scabla1}
$AdminTask deleteCompUnit {-blaID scabla1 -cuID cuName} *The cuName should match the specified config unit name outputed from addCompUnit command
$AdminTask deleteAsset {-assetID SCAModuleSample1.jar}
$AdminTask deleteBLA {-blaID scabla1}
$AdminConfig save
Possible problems and workarounds:
Description: | Invoking ws_ant targets which use the wsadmin task fail for the z/OS operating system. These tasks include install, start, stop, and so on. |
---|---|
Symptom: |
|
Solution: | This error is corrected in Version 8 Fix Pack 1 of the product. |
Workaround(s): |
|