Creating an independent SCLMBuild record

Before you begin
About this task
An SCLMBuild record is a stateful, nonreusable record that you use to build and promote a single SCLM project on a given host. You can create an SCLMBuild record to run in batch or online mode. An SCLMBuild record is used in conjunction with an SCLMBuildConfig record.
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.
  1. Click ClearQuest > Create > youruseridanddbname > Create SCLMBuild.
  2. In the SCLMBuild window, do one of the following:
    • 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 5.
    • If you do not want to populate the fields in the SCLMBuild window with the defaults, proceed to the step 3.
  3. 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.
  4. 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.
  5. 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.
  6. Click OK to finish creating the record.
Results
What to do next

Feedback