Changing import targets

Changing the target of a reference provides applications with the flexibility of taking advantage of advances in components as they happen without recompiling and reinstalling the application.

Before you begin

Before changing the target for a reference you must:

Make sure the new target uses the same data object type
Know whether the module is synchronously or asynchronously invoking the target
Know whether the reference targets a single or multiple services

About this task

Change the target of an import from a module when another service with the same interface as the original target provides new or improved functionality that your module can use.

Procedure

Stop the module that contains the reference that you are changing.
1. Using the administrative console, display the Service Component Architecture (SCA) modules.
  Navigate to this panel using Applications > SCA Modules
2. Select your module and press Stop. The display updates to show the application as stopped.

Change the target destination of the reference.

How you make the change depends on how the module invokes the target.

Type of invocation	How to change
Single target service	Using the administrative console, display the SCA Modules. Navigate to the panel using Applications > SCA Modules. From the displayed list, select the module that contains the import that references the target to change. Expand the list of imports by clicking the plus sign (+) next to Imports. Select the import to change from the list. In the Target area, select the Module from the list. After the Export list refreshes, select the export for the new target. Save the change by clicking OK.
Multiple target services	Display the buses on the system on which the module resides. Navigate to the panel using Service Integration > Buses. Select the SCA.System.`cellname`.Bus Display the destination targets for the bus by clicking Destinations. Select the destination that represents the import that connects the calling module to the targets. This identifier will contain the word import. Display the list of properties by clicking Context properties. Select the property to change by clicking on the targets property in the list. Change the Context value field to the new destination targets. Return to the Context properties panel by clicking OK. Save the change by clicking OK.

Type of invocation

How to change

Single target service

Using the administrative console, display the SCA Modules. Navigate to the panel using Applications > SCA Modules.
From the displayed list, select the module that contains the import that references the target to change.
Expand the list of imports by clicking the plus sign (+) next to Imports.
Select the import to change from the list.
In the Target area, select the Module from the list.
After the Export list refreshes, select the export for the new target.
Save the change by clicking OK.

Multiple target services

Display the buses on the system on which the module resides. Navigate to the panel using Service Integration > Buses.
Select the SCA.System.cellname.Bus
Display the destination targets for the bus by clicking Destinations.
Select the destination that represents the import that connects the calling module to the targets. This identifier will contain the word import.
Display the list of properties by clicking Context properties.
Select the property to change by clicking on the targets property in the list.
Change the Context value field to the new destination targets.
Return to the Context properties panel by clicking OK.
Save the change by clicking OK.

Save your changes. Click Save when prompted.

What to do next

Start the module and make sure the module receives the expected results.