Creating a CrossPlatformBuild record

Before you begin

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. Do one of the following:
    • To populate the fields of the CrossPlatformBuild window with saved defaults, click the Template list, select the CrossPlatformBuild record you want, and click the Load button. You can then edit the newly populated fields as needed. For example, you might edit the Headline and Description fields on the Main page or click the Build Records tab and add or remove an SCLMBuild or CCBuild child record. When you finish creating the new record, proceed to step 19.
    • If you do not want to populate the fields in the CrossPlatformBuild window with defaults, proceed to step 3.
  3. 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.
  4. Optional: You can save your Headline and Description entries as defaults for creating future CrossPlatformBuild 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 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.
  5. Click the Build Records tab.
  6. Optional: To create an SCLMBuild record, click the New button in the SCLMBuild pane, and do one of the following:
    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.
    • To populate the fields in the SCLMBuild window with saved defaults, select the name of the template that contains the defaults from the Templates list and click the Load button. You can then edit the newly populated fields as needed. For example, you might edit at least the Headline and Description fields to distinguish the new record from existing SCLMBuild records. When you finish editing this new record, proceed to step 9.
    • If you do not want to populate the fields in the SCLMBuild window with the defaults, proceed to the step 7.
  7. 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.
  8. 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.
  9. Optional: You can save the entries in this SCLMBuild record as defaults 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 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.
  10. Click OK to create the SCLMBuild record. The record appears in the SCLMBuild pane.
  11. Do one of the following:
    • To create another SCLMBuild child record, return to step 6.
    • To finish creating the CrossPlatformBuild parent record, proceed to step 19.
    • To create a CCBuild record, proceed to step 12.
  12. Optional: To create a CCBuild record, click the New button in the CCBuild pane, and do one of the following:
    • To populate the fields in the CCBuild window with saved defaults, select the name of the template that contains the defaults from the Templates list and click the Load button. You can then edit the newly populated fields as needed. For example, you might edit at least the Headline and Description fields to distinguish the new record from existing CCBuild records. When you finish editing this new record, proceed to step 16.
    • If you do not want to populate the fields in the CCBuild window with the defaults, proceed to step 13.
  13. 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.
  14. Click the ClearCase tab.
  15. 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.
  16. Optional: You can save the entries in this CCBuild record as defaults 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.
  17. Click OK to create the CCBuild record. The record appears in the CCBuild pane.
  18. Do one of the following:
    • To create another CCBuild child record, return to step 12.
    • To finish creating the CrossPlatformBuild parent record, proceed to step 19.
  19. 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.
  20. In the CrossPlatformBuild window, click OK to complete the parent record.

What to do next


Feedback