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 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 will have 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 will have 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.

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