Build maps provide information about build inputs and outputs.
When you run a dependency build, a build map is created for each source file. During the build
process, build maps and files are compared to determine whether inputs and outputs are synchronized
or if something changed since the last update. If something changed, a rebuild is required.
Build maps are stored on Jazz Team Server, not in the file system of the build systems.
During builds, a time stamp is based on one of these conditions:
- For source files in source control, time stamps are based on time stamps.
- For z/OS® outputs, which are not program objects, time
stamps are based on modified time in ISPF statistics. For more information about ISPF statistics,
see Using ISPF Statistics in Ant-based z/OS builds.
- For z/OS program objects, time stamps are based on values
that are stored in SSI.
- For IBM® i outputs, time stamps are based on time stamps
that are stored in the file system.
During promotions, time stamps in build maps are verified and the build maps are also
You can open the build map from the dependency build results. Use the build map to view build
dates and times, all of the components in a build, such as copybooks and source modules, and how
those components are related.
To open a build map, double-click the icon for the source file in the Build
column of the build report. For the build maps to be linked in the build report, the
Publish build map links
option must be selected on the build definition. By
default, the option is not selected.
Note: A personal build does not generate a build map.
The Overview tab of the build map editor
The build map opens in the build map editor on the Overview
other tabs for the inputs, outputs, and details for the build map. You can click the links to the
related artifacts to view the repository workspace, language definition, build definition, build
result, and snapshot.
Clicking Browse Build Map Versions
in the Overview
tab opens a dialog that displays the build labels of each version. If the build result is not
available, the label ends with -deleted
The number of displayed versions is controlled by the ccm advanced property Maximum
build map states to display
. It defaults to -1
, which means that
the number of versions displayed is not limited. If you hover over the property label, you can see
its explanatory text.
In the following example, only 100 of the 115 build map versions are displayed because the value
of the Maximum build map states to display
property was set to 100.
The Inputs tab
tab displays each input file that is in the build map, the path
to the build source file, the type of the output file, and the version ID of the source file, which
indicates the version of the file in the source control management system. Parenthetical information
under the Dependency Resource
column of the Additional Files from
the build machine
section of the build map indicates the origin of the file.
Beside the Files from the build machine produced by other builds
the build map, you can click Retrieve File Details to get more information about the files. The
Progress tab of the client displays the retrieved information. When you right-click a resource in
the Source Location
column to open a context menu, you can select to open
either the local or remote version of the file.
The Outputs tab
tab displays the output file location and the associated
Click the link for a resource definition to open the resource definition in an editor.
When publishing is enabled for a DD, the PDS information is stored in the build map. A link to
the PDS can be found on the Logs tab of the build map editor. When IBM Developer for z Systems®
integrated with Engineering Workflow Management
, the value
in the File Location
column is a link that opens the remote member.
The Details tab
tab displays a textual overview of the build map