About Build Options

Build options can be a single value or an array.

- Single value options appear in the BRD (Build Request Definition) file with the name and value for the attribute.

- Array value options appear in the BRD with the name and an array of values (except for the attribute).

For details of the templating language build options that you can add to build tools, see Dimensions Build Predefined Symbols in The Templating Language and Processor chapter of the Developer’s API Reference.

Defining User Attributes in Build Options

If you define a build option value on a transition as %option_name%, Dimensions Build looks up the user attribute assigned to that transition input in Dimensions and passes the attribute value as the value for that option. You can define user attributes for single-value and multi-value attributes. Multi-line and block attributes are not supported.

Examples:

- A source item has a single-value user attribute named "source_opts" with a value of "LIST,XREF,SOURCE". In the build options for a transition, you define an option called "COMPILE_OPTS" and set the value to "%source_opts%". The BRD file has an option called "COMPILE_OPTS" with a single value of "LIST,XREF,SOURCE" that you can reference in a build template.

- A source item has a multi-value user attribute named "source_opts" with the values "LIST", "XREF", and "SOURCE". In the build options for a transition, you define an option called "COMPILE_OPTS" and set the value to "%source_opts%". The BRD file has an option called "COMPILE_OPTS" with multiple values of "LIST", "XREF", and "SOURCE" that you can reference in a build template.

Build Tool Examples

- IBM COBOL compiler v1.4

  Build Option | Description | Possible Values and Descriptions
  --- | --- | ---
  INTDATE | Specifies the starting date for integer dates used with date intrinsic functions. | INTDATE(ANSI): Uses the Standard COBOL 85 starting date. Day 1 is Jan 1, 1601. INTDATE(LILIAN): Uses the Language Environment Lilian starting date. Day 1 is Oct 15, 1582
  MAP | Produces a listing of the items defined in the DATA DIVISION. | MAP: produces a listing. NOMAP: does not produce a listing.

- Microsoft C++ Compiler

  Build Option | Description | Possible Value
  --- | --- | ---
  INCLUDE | Specifies an INCLUDE directory. | C:\Program Files\Microsoft Visual Studio .NET 2003\Vc7\include
  LINK | Passes one or more linker options to the linker. | /COMMENT:"For Payroll Project" /DEBUG

Related Topics

Viewing Build Tools and Options

Adding Build Tools

Adding Options to Build Tools

Importing Build Tools

Modifying Build Tools

Modifying Build Tool Options

Deleting Build Tools

Deleting Build Tool Options