Add New Build Configuration Dialog Box

The Add New Build Configuration dialog box lets you define a new build configuration.

Use the Properties Tab to set the project details and time out details.

Use the Pre-Script tab to select or specify the details of the script, if any, that is to be executed before the build is launched, but after the source files have been transferred into the build area.

Use the Main Script when you have many targets that can use the same script. You select Use build configuration main script when creating the target, and define the script on the Main Script tab of the build configuration. Note that if there is a transition script for the individual target, it will take precedence over the main script.

Use the Post-Script tab to select or specify the details of the script, if any, that is to be executed after the build is launched.

Use the Clean-Up Script tab to select or specify the details of the script, if any, that is to be executed before the controlled source files are transferred into the build area. The primary purpose of this script is to clean up the build area before the build.

Related Topics

Properties Tab

Pre-/Main/Post-/Clean-Up Script Tab

Properties Tab

The Properties tab lets you specify which Dimensions project shall be associated with the build configuration, time out values, and other project-related details.

Field | Description | Rules and Guidelines
Parent Project | Select the Dimensions project to associate with the build configuration. |
Name | Enter a name for the build configuration. |
Description | Enter a description for the build configuration. |
Project Relative Path | Enter a path that is relative to the Dimensions project root directory. | On MVS, use ".". This is then ignored. Restricts the build to the sub-directory that you specify. For example, if the project root directory is C:\Projects\Qlarius and you specified a relative path of Java the build will be restricted to C:\Projects\Qlarius\Java.
Project for Targets | Select a Dimensions project to receive the target, or accept the default. | The default value is the same as Parent Project.
Platform | Specify the platform (Win32, Linux, and so on) for the build configuration. |
Launch Timeout | Select Default, None, or Custom. This value represents an interval in seconds before Dimensions CM will abandon a build job that is stalled in its launch attempt. | If you select Custom, an additional field appears, letting you enter a value in seconds. Note: On MVS, be careful about selecting any value other than None.
Execution Timeout | Select Default, None, or Custom. This value represents an interval in seconds before Dimensions CM will abandon a build job that is stalled during the execution of the build script. | If you select Custom, an additional field appears, letting you enter a value in seconds.
Type | Select Default or Openmake. |
Reset Type | Useful only if Type is changed from Default to Openmake. Causes settings required for an Openmake build configuration to be restored. |

Pre-/Main/Post-/Clean-Up Script Tab

The fields for the Pre-Script, Main Script, Post-Script, and Clean-Up Script tabs are identical. The differences are in what the scripts are used for, and when they are executed:

- A Pre-Script executes before the build is launched, but after the source files have been transferred into the build area.

- A Main Script is used when you have many targets that can use the same script. You select Use build configuration main script when creating the target, and define the script on the Main Script tab of the build configuration. Note that if there is a transition script for the individual target, it will take precedence over the main script.

- A Post-Script executes after the build is launched.

- A Clean-Up Script executes before the controlled source files are transferred into the build area. The primary purpose for this script is to clean up a build area before the build.

In each case, you should specify whether you will enter the script manually, or whether it will come from a file.

Field | Description | Rules and Guidelines
Select the kind of script you want to use | Choose from: n input script content manually n use a Dimensions-controlled file as a script n use a file in the build area as a script | If you select a Dimensions-controlled file as a script, be aware that the file will be pushed to the build area if you are using a work area. If you are using a deployment area, Dimensions Build assumes that the script has already been deployed to that area.
Script Content | Enter the text for the build script into this field. | Appears with input script content manually only.
Browse | Click Browse to display the Select File From Dimensions dialog box. | Accompanies text field for use a Dimensions-controlled file as a script.
Word Wrap | Check this box to have the script text wrap. | Appears with input script content manually only.