Build Definition Reference - SMP/E

This section covers the SMP/E extensions to the Build Definition Reference. It describes IBM internal build definition resources and their characteristics. These items are selectively enabled as noted. They are available to IBM internal teams only.

Configuration Properties

The following sections describe how to define the various configuration properties in a build definition. Each section describes a build definition sub-element that can be specified within the createBuildDefinition or updateBuildDefinition element. These sub-elements are used to define information required by a build configuration element. Each build definition sub-element represents a corresponding build configuration element. Not all configuration elements are applicable to a type of build. Refer to the Notes section of each build definition sub-element description to determine which configuration elements are valid for the build you are defining.

All build configuration properties support the standard property attributes, but most attributes are ignored as the values for the attributes are set internally and can not be overridden. The following table describes the attributes and what affect, if any, specifying the attributes has on the build property itself.

borcBuildProperty Element

Code borcBuildProperty elements to specify configuration details for the Build Orchestrator. The borcBuildProperty element accepts two attributes, name and value, which are both required. Other build properties can be referenced when specifying a value using the ${propertyName} format. The following table describes the valid values for the borcBuildProperty element attributes:

Actions Array

The actions array is a JSON object that is used to identify Build Orchestrator actions and the details associated with those actions. Each array item represents a Build Orchestrator action item that has been converted to a string value. The following table describes an action item - the JSON objects and name/value pairs in the item:

Example

<xt:borcBuildProperty name="team.enterprise.smpe.build.orchestrator.actions">[
{
    "action": "COPY",
    "argument1": "_SujqEKoaEei-B83tQ0tP2g",
    "argument2": "_YaLJEKoaEei-B83tQ0tP2g",
    "fetch": "true",
    "postBuild": "false",
    "preBuild": "false"
},
{
    "action": "COPY",
    "argument1": "_YaLJEKoaEei-B83tQ0tP2g",
    "argument2": "_SujqEKoaEei-B83tQ0tP2g",
    "fetch": "true",
    "postBuild": "false",
    "preBuild": "false"
}
]</xt:borcBuildProperty>
    

Builds Array

The builds array is a JSON object that is used to identify Build Orchestrator builds and the details associated with them. Each array item represents a Build Orchestrator build item that has been converted to a string value. The following table describes a build item; the JSON objects, the name/value pairs, in the item:

Example

<xt:borcBuildProperty name="team.enterprise.smpe.build.orchestrator.builds">[
{
    "buildDefinition": "_bDJuwKogEeipE4uUDmmpzQ",
    "buildEngines": [
        "_rpfO4KogEeipE4uUDmmpzQ"
    ],
    "dependent": "false",
    "dependsOn": [
    ],
    "enabled": "true",
    "housekeeping": "false",
    "primary": "true",
    "secondary": "false"
},
{
    "buildDefinition": "_jM75UKogEeipE4uUDmmpzQ",
    "buildEngines": [
        "_rpfO4KogEeipE4uUDmmpzQ"
    ],
    "dependent": "false",
    "dependsOn": [
    ],
    "enabled": "false",
    "housekeeping": "false",
    "primary": "false",
    "secondary": "false"
}
]</xt:borcBuildProperty>
    

Notes

• This configuration element is enabled for the following builds:
  • z/OS Dependency Build

orcbBuildProperty Element

Code orcbBuildProperty elements to specify configuration details for an orchestrated build. The orcbBuildProperty element accepts two attributes, name and value, which are both required. Other build properties can be referenced when specifying a value using the ${propertyName} format. The following table describes the valid values for the orcbBuildProperty element attributes:

Notes

• This configuration element is enabled for the following builds:
  • Ant Build
  • Ant with Enterprise Extensions Build
  • Command Line Build
  • z/OS Dependency Build
  • Rational Build Forge Build
  • Hudson/Jenkins Build
  • IBM i Command Line Build
  • IBM i Dependency Build
  • Microsoft Visual Studio Solution Build
  • Maven Build
  • z/OS Command Line Build
• The exportInternal attribute needs to be set to true to export these properties.