In the previous two steps, you learned how to create configuration
records. The next step is to learn how to create a build record, specifically,
a CrossPlatformBuild record.
A CrossPlatformBuild record is a stateful, nonreusable,
parent record that runs a coordinated build and promote operation in any SCLM
projects and
Rational® ClearCase® views
specified by its SCLMBuild and CCBuild child records.
A CrossPlatformBuild
record must have at least one SCLMBuild or CCBuild child record associated
with it, but it can have more. Before you create a CrossPlatformBuild record,
you need at least one SCLMBuildConfig or CCBuildConfig configuration record
to use with the SCLMBuild or CCBuild records you create.
- Click .
- In the CrossPlatformBuild window, click the Main tab:
- ClearQuest ID
- This uneditable field displays the Rational ClearQuest® ID
of the CrossPlatformBuild record you are creating.
- State
- This uneditable field displays the build state of the record you are creating.
New records are created in the Submitted state.
- Headline
- Enter a meaningful headline for this parent build record.
- Description
- Enter a meaningful description for this parent build record.
- Optional: You can save your Headline and Description entries
as defaults for creating future CrossPlatformBuild records by clicking the
arrow next to the Load button and selecting New.
You then name the template in the New Record Template window and click OK.
In the CrossPlatformBuild window, click the arrow next to the Load button
and select Save as Default. By saving these entries,
you can populate the fields of CrossPlatformBuild records you create in the
future by selecting the template that contains the defaults from the Template list
and clicking the Load button.
- Click the Build Records tab.
- To create an SCLMBuild record, click the New button
in the SCLMBuild pane.
Note: Except
for the Headline and Description fields,
the editable fields of this record can accept only ASCII characters, regardless
of the character set in use. This limitation is due to a restriction with
the server component of the SCLM integration running on z/OS.
- In the SCLMBuild window, click the Main tab:
- ClearQuest ID
- This uneditable field displays the Rational ClearQuest ID
of the SCLMBuild record you are creating.
- State
- This uneditable field displays the build state of the SCLMBuild record
you are creating. New records are created in the Submitted state.
- Headline
- Enter a meaningful headline for this SCLMBuild record.
- Description
- Enter a meaningful description for this SCLMBuild record.
- Click the SCLM tab.
- CrossPlatformBuild Parent
- This uneditable field displays the Rational ClearQuest IDs
of any parent records with which the SCLMBuild record being created is associated.
However, the IDs do not appear until you finish creating the parent record.
- Configuration
- From the Configuration field, select the name of
the SCLMBuildConfig record to use with this SCLMBuild record.
- Batch
- Check Batch if you want to
create this record to run in batch mode. Leave the field clear to create a
record that runs in online mode. Use batch mode for building large sets of
files or for running long builds.
- Group
- Enter the name of the SCLM group or groups containing the modified application
data. To enter multiple groups in a hierarchy, enter the names in their order
from low to high, separating each group name by a comma. Note that these are
groups being promoted "from" not "to". Therefore, you do not need to enter
the name of the highest group in the hierarchy.
For example, if your group
hierarchy contains the groups DEV1, TEST, and RELEASE, you could enter "DEV1,
TEST" into this field to track build and promote operations on an SCLM artifact
to the top of the project hierarchy.
- Type
- Enter the name of the SCLM type that specifies the type of the SCLM package
member.
- Member
- Enter the name of the SCLM package member that is the target of the action.
- Optional: You can save the entries
for this SCLMBuild record as defaults by selecting the arrow next to the Load button
and selecting New. You then name the template in the
New Record Template window and click OK. In the SCLMBuild
window, click the arrow next to the Load button and
select Save as Default. By saving these entries, you
can populate the fields of SCLMBuild records you create in the future by
selecting the template that contains the defaults from the Template list
and clicking the Load button.
- Click OK to create the SCLMBuild
record. The record appears in the SCLMBuild pane.
- To create a CCBuild record, click the New button
in the CCBuild pane.
- In the CCBuild window, click the Main tab:
- ClearQuest ID
- This uneditable field displays the Rational ClearQuest ID
of the CCBuild record you are creating.
- State
- This uneditable field displays the build state of the CCBuild record you
are creating. New records are created in the Submitted state.
- Owner
- Select an owner for this CCBuild record.
- Headline
- Enter a meaningful headline for this CCBuild record.
- Description
- Enter a meaningful description for this CCBuild record.
- Click the ClearCase tab.
- In the CCBuild window, click the ClearCase tab:
- CrossPlatformBuild Parent
- This uneditable field displays the Rational ClearQuest IDs
of any parent records with which the CCBuild record being created is associated.
However, the IDs do not appear until you finish creating the parent record.
- Configuration
- From the Configuration field, select the CCBuildConfig
record to use with this CCBuild record.
- Optional: You can save the entries
in this CCBuild record as defaults for creating future CCBuild records by
selecting the arrow next to the Load button and clicking New.
You then name the template in the New Record Template window
and click OK. In the CCBuild window, click the arrow
next to the Load button and select Save
as Default. By saving these entries, you can populate the fields
of CCBuild records you create in the future by selecting the template that
contains the defaults from the Template list and clicking
the Load button.
- Click OK to create the CCBuild
record. The record appears in the CCBuild pane.
- Optional: You can save the entries in
this parent record as defaults. Note, however, that when you save the defaults
of a parent record that is associated with child records, any new parent records
created from those defaults remain linked to the child records associated
with the original parent record. Because you cannot reuse build records (including
child build records), you might prefer not to save defaults after you have
associated a new parent record with child records. Alternatively, you could
save the defaults now, use them to create a new parent record in the future,
and then edit the parent record to associate it with new child build records.
- In the CrossPlatformBuild window, click OK to
complete the parent record.
This topic completes the procedure for creating a CrossPlatformBuild
parent record that includes one SCLMBuild and one CCBuild child record. The
next step is to use the parent record to run a build.