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
The following controls, which correspond to preconditions,
can be selected:
- Prevent the override of the Data Elements, Meta Entities, or all
the design artifacts (except the Data Structures).
These preconditions
control, according to the selected line, that the Data Elements, Meta
Entities or all the design artifacts (except the Data Structures)
that are about to be delivered, and that have been created, do not
override artifacts in the same projects hierarchy. These controls
do not apply to the overridden and modified artifacts. These controls
are not active upon the Pacbase migration
and do not apply to the migrated instances that were overridden in Pacbase.
- Control 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 their local generation.
This precondition applies only to the COBOL files to be delivered.
Moreover, if a developer delivers COBOL files only, without delivering
the associated design files, the Rational Team Concert stream
will contain errors.
- Prevent unresolved design references.
This precondition controls
that all the references of the design files that are about to be delivered
are resolved.
References are not resolved in the following
cases:
- Local modifications are delivered partially. References are not
resolved, for example, if a new Data Element is called in a new Segment
but if only the Segment is delivered.
- An instance that is used by other instances is deleted. References
are not resolved, for example, if a Data Element that is called in
a Segment is deleted but if only this deletion is delivered.
This precondition applies to the contents of the change
sets that are about to be delivered, and to the indexed content of
the server. You must then deliver all the related changes simultaneously,
or, if not, you must ensure that the server content is indexed again
before you deliver your remaining changes.
Note: This precondition
is a first way to control that the references between design files
are resolved. However, to detect the unresolved references in the
delivered change sets automatically and globally, it is advised to
create nightly builds on the Rational Team Concert server.
You can then use all the tools to go back in the changes history and
to correct the origin of an error.
- 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
- From the Team Artifacts view of
the Rational Team
Concert Work Items perspective, right-click
a project area. Select Open.
- Open the Process Configuration tab.
- In the Configuration part, expand
the Team Configuration line and select Operation
Behavior.
- 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.
Note: Preconditions can
be applied according to the roles that are defined in Rational Team Concert. For
more information, refer to the Rational Team Concert documentation.
The line Preconditions and follow-up actions
are configured for this operation becomes available and
is selected.
- Click the Add button that is associated
with the Preconditions table.
- In the selection box that appears, select one or more preconditions,
depending on the controls that you want to implement:
- RPP - Prevent Data Element override
- RPP - Prevent Meta Entity override
- RPP - Prevent design artifact override
- RPP - Prevent unresolved design references
- RPP - Team deliver quality control advisor client
- RPP - Team deliver source code synchronization advisor
client
- Click OK.
The
precondition name is displayed in the Name field
and a brief description appears in the Description field.
- 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.
- 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 do not meet the precondition.
- You can limit the preconditions RPP - Team deliver
quality control advisor client and RPP - Team
deliver source code synchronization advisor client to
one or more components. To do so, click the Add button
that is associated with the Scope table. Select
components and click OK.
- 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.