Use the same independent SCLMBuild or CCBuild record used to attempt
to promote a build to repromote a failed promote operation.
Before you begin
Before you can repromote an independent
Rational® ClearCase® or
SCLM build, the build record used must be in the PromoteFailed state.
Procedure
- Run a Rational ClearQuest® query
on SCLMBuild or CCBuild records.
- From the Results page, select the SCLMBuild
or CCBuild record with which to repromote the build. The State field
shows that the record is in the PromoteFailed state
- From the toolbar in the Details window, click
the arrow next to the Change State button
, and click RePromote. The State field changes from the PromoteFailed
to the PromotePending state.
- Click the Apply button
to accept the state changes.
- From the toolbar in the Details window, click
the Menu button
and click Refresh to
refresh the build record in the database.
- Do
one of the following:
- If the repromote operation succeeds, the State field
changes to the PromoteCompleted state. For Rational ClearCase builds,
this change means either that the promote command specified in the CCBuildConfig
record ran successfully without success keywords or that a success keyword
was found in the output of the promote. If you run a Rational ClearCase promote
operation without specifying success keywords, you can still verify that the Rational ClearCase artifacts
were promoted successfully by clicking the Apply button
and checking the log file <rational_root>\ClearQuest\cpscm.log.
You can also verify that the files promoted successfully, based on the command
that was run.
- If the repromote operation fails, the State field
changes to the PromoteFailed state. . Review the error messages in <rational_root>\ClearQuest\cpscm.log .
See additional information about SCLM communications in <rational_root>\ClearQuest\cpscm_communications.log
- Note that, if you promote a large SCLM job in batch mode, the steps
for refreshing and modifying might not move the record from the PromotePending
state because the build might never have actually been promoted. If this situation
occurs, it usually means that there is an error in the JCL code. Either delete
the record or, if you are a member of the Rational ClearQuest restricted
group, move it to the PromoteFailed state manually and fix the problem. (For
more information about this group, see Optional: Create a "restricted" Rational ClearQuest user group.)