Modifying a Transition Script

The following procedure applies to transition scripts.

To modify a transition script:

1. In the Build Administration Console, click the Build Management tab.

2. Check out the build configuration containing the target whose transition script you wish to modify.

3. In the navigation tree, Select the target. The Transition Details section appears in the content pane.

4. Click the pencil icon next to the Transition Details title. The Script page of the Edit Target Wizard appears.

5. For Build Order enter a numerical value that specifies the order in which the transition is built.

- A value of 0 indicates no order.

- Transitions are ordered in the BRD (Build Request Definition) file from 1 to n regardless of where they appear in the tree in Dimensions Build. For example, all transitions with a value of 1 is built before those with a value of 2.

- This functionality allows you to manually set the order of build steps for unrelated items that Dimensions Build cannot order automatically.

- The build order of a nested transition cannot be higher than its parent. For example, assume that you have the transition COBOL(*) to OBJECT(*) to LOAD(*). OBJECT(*) can not have a build order of 2 if LOAD(*) has a build order of 1 as it does not make sense to build the LOAD before the OBJECT.

6. Select the Expand Wildcards checkbox to:

- Expand all the wildcard inputs and outputs for this transition at build time.

- Create an instance of the transition for each item that matches the wildcard.

For more details see Support for Wildcards in Build Configurations.

NOTE

- The default state of this checkbox is determined by the platform of the build configuration. For an MVS platform the default is ’expand’ (checked). For all other platforms, the default is ’no expand’ (not checked).

- If you have multiple targets in a build configuration you can use both settings (expand and not expand).

7. If you want to select a different build tool, use the pull down list to make a new selection for that field.

8. To modify the main part of the script, select one of the following four choices:

- input script content manually

If you select this choice, enter or modify the script in the Script Content text box. Select the Word Wrap checkbox if you want to have the text wrap.

- use a Dimensions-controlled file as a script

If you select this choice, enter or modify the location of the file, or click Browse to browse for it.

NOTE If you select a Dimensions-controlled file as a script, be aware that the file is 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.

- use a file in the build area as a script

If you select this choice, enter or modify the location of the file, or click Browse to browse for it.

- use the build configuration main script

If you select this choice, you need not enter any other information, as Dimensions CM knows where to find the main script.

9. If you added or selected a new script, and need to delete an existing script, do so now.

10. Click Finish to accept the changes.

11. Check in the modified build configuration by clicking the Check In icon.