File controls upon server deliveries

If you are an administrator, you can use the Rational Team Concert™ control features to ensure that the files that are delivered to the server do not cause errors.

About this task

Two controls, which correspond to preconditions, can be selected:
  • Control of the source code synchronization.

    This precondition controls that the COBOL files that are about to be delivered are synchronized with all the design files that were involved in its generation locally. This precondition applies only to the COBOL files to be delivered. Moreover, if a developer delivers its COBOL files only, without delivering the associated design files, the Rational Team Concert stream will contain errors.

  • Quality control.

    This precondition controls that the COBOL and design files that are about to be delivered do not contain serious Rational® Programming Patterns quality control errors.

Procedure

  1. From the Team Artifacts view of the Rational Team Concert Work Items perspective, right-click a project area. Select Open.
  2. Open the Process Configuration tab.
  3. In the Configuration part, expand the Team Configuration line and select Operation Behavior.
  4. In the Operations table, locate the Deliver (client) line under Source Control. On this line, click the Everyone column. This column contains an icon that indicates that preconditions are available for this operation.

    The line Preconditions and follow-up actions are configured for this operation becomes available and is selected.

  5. Click the Add button that is associated with the Preconditions table.
  6. In the selection box that appears, select one or the two available preconditions, depending on the controls that you cant to implement:
    • RPP - Team deliver quality control advisor client
    • RPP - Team deliver source code synchronization advisor client
  7. Click OK.

    The precondition name is displayed in the Name field and a brief description appears in the Description field.

  8. If you check the Fail if not installed box, only the developers who installed the plug-in that contains the precondition will be able to deliver files to the server. This plug-in is automatically installed upon the standard installation of the Rational Programming Patterns client part.
  9. If you check the User may override box, the developers will be able to ignore an error that is related to a failure to respect a precondition. They will then be able to deliver all their files, even if these files are not synchronized with the corresponding design or contain serious quality control errors.
  10. You can limit a precondition to one or more components. To do so, click the Add button that is associated with the Scope table. Select components and click OK.
  11. Save.

Results

If developers try to deliver a file that does not meet the selected preconditions, they cannot get through and an error is displayed in the Team Advisor view. The error indicates the failed precondition and includes an active link to the erroneous file.

If you checked the User may override box, the developers will be able to right-click the error in the Team Advisor view and ignore it. They will then be able to deliver their updates.

If you did not check the User may override box, the developers must correct the error before delivering
  • To correct a synchronization error, the COBOL code must be generated again.
  • To correct a quality control error, a solution can be, for example, to restore the generated code from the Generated Structure Code view.

Feedback