Build Engine Reference - SMP/E

This section covers the SMP/E extensions to the Build Engine Reference. It describes IBM internal build engine 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 engine definition. Each section describes a build engine sub-element that can be specified within the createBuildEngine or updateBuildEngine element. These sub-elements are used to define information required by a build engine configuration element. Each build engine definition sub-element represents a corresponding build engine configuration element. Not all configuration elements are applicable to a type of engine. Refer to the Notes section of each build engine sub-element description to determine which configuration elements are valid for the engine 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.

Configuration Properties
Attribute Required Description
name Yes Name of the configuration property. Valid names are described in each of the following sections.
value Yes Value of the configuration property. Valid values and restrictions are described in each of the following sections. Restrictions on the valid values are noted in the value column. The restrictions noted are as follows:
Restriction: Description:
boolean This is a boolean value which must be specified as either true or false.
integer This must be an integer value.
JSON array A JSON formatted collection of string values.
true/false This is a boolean value which must be specified as either true or false.
value list One of the listed values must be specified. For example: ALWAYS, NO_ERRORS, or NO_WARNINGS.
asis No Valid values are: true and false. The default is false. Specifying this attribute will control how the property is resolved.
description No This attribute is ignored.
genericEditAllowed No This attribute is ignored.
kind No This attribute is ignored.
label No This attribute is ignored.
override No This attribute is ignored.
required No This attribute is ignored.
scheduleOverride No This attribute is ignored.
wellKnown No This attribute is ignored.

borcEngineProperty Element

Code borcEngineProperty elements to specify configuration details for a Build Orchestrator build engine. The borcEngineProperty 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 borcEngineProperty element attributes:

Build Orchestrator Engine Properties
name value Description
team.enterprise.smpe.build.orchestrator.engine.dedicated true
false 		Specifies whether or not this build engine is a dedicated Build Orchestrator engine. Dedicated engines process Primary and Secondary Build Orchestrator builds. Specify true if this is a dedicated engine.
team.enterprise.smpe.build.orchestrator.engine.general true
false 		Specifies whether or not this build engine is a general Build Orchestrator engine. General engines process Dependent and Housekeeping Build Orchestrator builds. Specify true if this is a general engine.

Example 

<xt:borcEngineProperty name="team.enterprise.smpe.build.orchestrator.engine.dedicated" value="true"/>

Notes