When you create a new transformation scenario or edit an existing one, a configuration dialog box is displayed that allows you to customize the transformation with various options in several tabs.
The Options tab allows you to specify the following options:
- Working directory
- The path of the current directory of the Ant external process. You can
specify the path by using the text field, the
Insert Editor
Variables button, or the 
Browse button. - Build file
- The Ant script file that is the input of the Ant external process. You can
specify the path by using the text field, the Insert Editor
Variables button, or the Browse button.
- Build target
- Optionally, you can specify a build target for the Ant script file. If no target is specified, the Ant target that is specified as the default in the Ant script file is used.
- Additional Ant arguments
- You can specify additional Ant-specific command-line arguments (such as
-diagnostics). - Ant Home
- You can choose between the default or custom Ant installation to run the transformation.
- Java Home
- You can choose between the default or custom Java installation to run the transformation. The default path is the Java installation that is used by Oxygen XML Author Eclipse plugin.
- JVM Arguments
- This parameter allows you to set specific parameters for the Java Virtual Machine used by Ant. When performing a large transformation, you may want to increase the memory allocated to the Java Virtual Machine. This will help avoid Out of Memory error messages (OutOfMemoryError). For example, if it is set to -Xmx2g, the transformation process is allowed to use a maximum 2 gigabytes of memory. If you do not specify an -Xmx value in this field, by default, the application will use a maximum of about a quarter of the total memory available on the machine.
- Libraries
- By default, Oxygen XML Author Eclipse plugin adds libraries (as high priority) that are not
transformation-dependent and also patches for certain DITA Open Toolkit bugs. You can
use this button to specify additional libraries (JAR files or additional class paths) to be used by the
transformer.Tip: You can specify the path to the additional libraries using wildcards (for example,
${oxygenHome}/lib/*.jar).