Create a CrossPlatformBuild record

Before you begin

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.

About this task

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.

Procedure

  1. Click ClearQuest > Create > youruseridanddbname > Create CrossPlatformBuild.
  2. 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.
  3. 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.
  4. Click the Build Records tab.
  5. 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.
  6. 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.
  7. 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.
  8. 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.
  9. Click OK to create the SCLMBuild record. The record appears in the SCLMBuild pane.
  10. To create a CCBuild record, click the New button in the CCBuild pane.
  11. 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.
  12. Click the ClearCase tab.
  13. 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.
  14. 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.
  15. Click OK to create the CCBuild record. The record appears in the CCBuild pane.
  16. 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.
  17. In the CrossPlatformBuild window, click OK to complete the parent record.

Results

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.

What to do next


Feedback