Running and rerunning transformations

Before you can run a transformation, you create a transformation configuration. When you apply a transformation configuration, an instance of the transformation is created and the transformation runs with the properties that the configuration defines.

To run a transformation, depending on the view that you are working in, complete one of the following steps:

In the navigation view, right-click a transformation configuration (.tc) file; then click Transform and click a transformation.
In the Pattern Explorer view, right-click a transformation; then click Run Transformation. In the Select configuration dialog box, specify the transformation configuration to run, and click OK.

Tip: You can also run a transformation from the transformation configuration editor. On the Main page, click Run.

Tip: To run this transformation again, click Modeling > Transform > Run Last. The transformation uses the same source elements from when you last ran the transformation.

To run a transformation from a command line, use the following syntax:
```
eclipse -data workspace-path -application com.ibm.xtools.transform.core.transformationRunner -transformConfigs "[-R]transformation-configuration-path1,[-R]transformation-configuration-path2,..." 
```
In the -transformConfigs parameter, you must specify the complete workspace path and configuration file name, not the file-system path name, of one or more transformation configurations.

Running a transformation from a command line suppresses all dialog boxes that the transformation generates.
As an example, a transformation configuration called MyConfig.tc is in a project called MyProject in a workspace called MyWorkspace. This transformation configuration specifies the configuration information for a transformation called MyTransformation, and for a corresponding reverse transformation called MyReverseTransformation.To invoke MyTransformation, you can run the MyConfig.tc configuration by typing the following text at the command line:
```
eclipse -data /MyWorkspace -application com.ibm.xtools.transform.core.transformationRunner -transformConfigs "MyProject/MyConfig.tc"  
```
To run the reverse transformation, specify the -R option at the beginning of the transformation configuration path, as in this example:
```
eclipse -data /MyWorkspace -application com.ibm.xtools.transform.core.transformationRunner -transformConfigs "-RMyProject/MyConfig.tc"
```
To run multiple transformations, in the -transformConfigs parameter, specify a comma-separated list of transformation configurations, including the workspace path name for each configuration. You can run forward or reverse transformations, as in this example:
```
eclipse -data /MyWorkspace -application com.ibm.xtools.transform.core.transformationRunner -transformConfigs "MyProject/MyConfig.tc, -RMyProject/MyConfig.tc"
```

To run the transformation as part of an application, you can invoke the transformation API, as in the following example:

IFile file = ResourcesPlugin.getWorkspace().getRoot().getFile(new Path("/MyWorkspace/MyConfig.tc"));
try {
			ITransformConfig config = TransformConfigUtil.loadConfiguration(file);
			IStatus status = TransformController.getInstance().execute(config, null, false, null);
}
catch (IOException e) {
// The config file could not be read.
}