Eclipse Installer only: Customizing TPF Toolkit startup

If your organization chooses to install TPF Toolkit by using the Eclipse Installer, you can customize the startup behaviors for your user instances of TPF Toolkit by adding Eclipse.ini tasks to your TPF Toolkit product catalog (com.ibm.tpf.toolkit.products.setup). Eclipse.ini tasks are used to set parameters in the TPFToolkit.ini file.

Before you begin

Install an administrator instance of TPF Toolkit by using the Eclipse Installer, and import the TPF Toolkit product catalog project.
Eclipse resources and documentation contains links to the Eclipse Installer and Oomph documentation. Use the links to understand the full capabilities of the Eclipse Installer.

About this task

TPF Toolkit startup is controlled by the options in the TPFToolkit.ini file in the TPF Toolkit installation directory. The TPFToolkit.ini file is a standard eclipse.ini file and renamed into TPFToolkit.ini. For more information about the eclipse.ini file, see the Eclipse wiki about eclipse.ini. For the complete list of eclipse.ini file options, see The Eclipse runtime options.

To change startup behaviors of your user instances of TPF Toolkit, you can add Eclipse.ini tasks to the com.ibm.tpf.toolkit.products.setup file and copy the product catalog file to the internal host to overwrite the existing file. The next time your users start TPF Toolkit, the custom startup behaviors will automatically be added to the TPFToolkit.ini file in their TPF Toolkit installation directory, and TPF Toolkit will be running with the custom behaviors applied.

Procedure

In the Project Explorer view, expand com.ibm.tpf.toolkit.eclipse.installer.
Right-click com.ibm.tpf.toolkit.products.setup, and click Open With > Setup Editor.
The com.ibm.tpf.toolkit.products.setup file is displayed in the editor view.
In the editor view, right-click the TPF Toolkit Products folder, and click New Child > Eclipse Ini.
An Eclipse.ini task is opened in the Properties window.
Complete the fields in the Properties window:
1. In the ID field, specify a unique ID for the Eclipse.ini task.
2. Optional: In the Description field, enter a description about the Eclipse.ini task.
3. In the Option field, specify the option name that you want to customize.
4. In the Value field, specify a custom value for the option.
5. In the VM field, specify whether the option is passed as an argument to the JVM.
If you want to add more custom startup options, repeat steps 3 and 4.
Save the com.ibm.tpf.toolkit.products.setup file.
Copy the com.ibm.tpf.toolkit.products.setup file to the internal host to overwrite the existing file.