A builder in a build specification associates inputs
and a command set together to define the objects that need to be created
or updated. You can also use builders that do not create objects but
perform tasks such as set up or packaging.
A builder consists of these sections:
- Inputs
- Inputs provide values to the variables that are defined in a command
set. Inputs to a builder can specify either the component objects
that make up a more complex object, for example, the modules in a
program; or they can specify the sources over which the command sets
will be repeated, such as the members of a source file with a particular
source type. In the latter case, the command set is applied to each
member in the list of members. There can be only one such list specified
in the set of inputs.
- Resource Dependencies
- Resource dependencies are references to other objects on the system
that might cause this builder to run. If any of these dependencies
are newer than any output object in this builder, then the whole builder
will be rerun. An example of such a dependency would be the copy members
included from a COBOL or RPG source member.
- Prerequisite Builders
- This is a list of other builders that must be checked and possibly
run before this particular builder can be run. Builders are normally
run in the order they are defined, but you can use prerequisite builders
refine the order in which the objects in your project are built. If
the output objects in the prerequisite builders are already up-to-date
then they are not rebuilt. For example, a builder that builds a program
could depend on a display file. If the DDS source defining that file
has been changed, rebuilding the file is required before compiling
a program that references the file; if the DDS source for that file
has not been changed, it is already up-to-date and will not be rebuilt.
- Command Set References
- A builder may reference one or more command sets. When a builder
is run these command sets are executed in the order in which they
are specified here. The command sets used in a builder may have substitution
variables. You provide values for those variables when you use a command
set inside a builder. The values of the substitution variables can
be inherited from the project or builder variables, set to a particular
literal value, or can be set to a list of resources determined when
the builder is run.
Please refer to Jazz™.net for
more information.