Exporting SCA composite definitions using scripting (deprecated)

You can export information about the definition of a Service Component Architecture (SCA) composite to a file of your choice.

Before you begin

An SCA composite must be a composition unit in a business-level application.

About this task

The composite definition provides data on the composite, such as component names and service references. You can view an SCA composite definition in the administrative console or by exporting it to a file using scripting. Exporting an SCA composite definition enables you to preserve information about the composite.

This topic describes how to export a composite definition using scripting.

You might export a composite definition before updating SCA business-level applications or before migrating to a later version of the product.

Procedure

Start the wsadmin scripting tool.
Optional: View online help for the exportSCDL command.
Using Jython:
```
print AdminTask.help('exportSCDL')
```
Using Jacl:
```
$AdminTask help exportSCDL
```

Export information about SCA composites in a domain to a file of your choice.

Use the exportSCDL command to export the information. The command has two parameters, cuName and -exportFile, both of type String. Both parameters are required.

Using Jython:

AdminTask.exportSCDL('[-cuName SCA_composition_unit_name -exportFile /my_file]')

AdminTask.exportSCDL('[-cuName SCA_composition_unit_name -exportFile C:/my_file]')

Using Jacl:

$AdminTask exportSCDL {-cuName SCA_composition_unit_name -exportFile /my_file}

$AdminTask exportSCDL {-cuName SCA_composition_unit_name -exportFile C:/my_file}

Table 1. exportSCDL command elements . Run the exportSCDL command with the -cuName and -exportFile parameters.
Variable	Description
`$`	is a Jacl operator for substituting a variable name with its value
`AdminTask`	is an object to run administrative commands with the wsadmin tool
`exportSCDL`	is an AdminTask command
`SCA_composition_unit_name`	is the name of an SCA composition unit whose information is exported
`/my_file`	is the name of the file to which the composite definition is written

Results

After the exportSCDL command runs, information about the composite definition in the SCA domain is written to the specified file. The product displays the following message:

The SCA Composite (SCDL) has been exported successfully.

You can view the same composite definition information in the administrative console. Click Applications > Application Types > Business-level applications > application_name > SCA_deployed_asset_name > View composite.

Example

Suppose the HelloWorldAsync business-level application provided as a sample with the product is installed. Run the exportSCDL command to export the composite definition information for the helloworldws composition unit:

Using Jython:

AdminTask.exportSCDL('[ -cuName helloworldws -exportFile /my_file ]')

AdminTask.exportSCDL('[ -cuName helloworldws -exportFile C:/my_file ]')

Using Jacl:

$AdminTask exportSCDL{ -cuName helloworldws -exportFile /my_file }

$AdminTask exportSCDL{ -cuName helloworldws -exportFile C:/my_file }

Running the exportSCDL command writes composite definition information resembling the following to the specified file:

<composite xmlns="https://www.osoa.org/xmlns/sca/1.0" targetNamespace="http://helloworld" 
    name="helloworldws">

    <component name="AsynchTranslatorComponent"> 
      <implementation.java class="helloworld.impl.AsynchTranslatorComponent" /> 
      <service name="AsynchTranslatorService">
        <interface.java interface="helloworld.AsynchTranslatorService"
                callbackInterface="helloworld.HelloWorldCallback"/>        
        <binding.ws/>
        <callback>
            <binding.ws/>
        </callback>      
      </service>
    </component>

</composite>

What to do next

Examine the exported file to ensure that it contains the intended information.