Procedure
- In
a shell or command prompt window, change directory to a view that is attached
to a stream that contains the components whose elements you want to relocate.
- If the view is a snapshot view, update it.
- Set the view to an activity that you reserve for this operation.
- Run the script and specify the source path and target path for
the relocation. For example:
cleartool mkact -head "Move XML utility code to libks" my-app-xml-move
On the UNIX
system:
devops-home-dir/common/bin/ratlperl ccase-home-dir/etc/utils/mkelem_cpver.pl \
/vobs/app/xml /vobs/lib/ks
On
Linux and the Windows
system:
devops-home-dir/common/ratlperl.exe ccase-home-dir/etc/utils/mkelem_cpver.pl ^
/vobs/app/xml /vobs/lib/ks
The xml directory
and all its contents are copied to the new location under the ks directory.
If the script encounters a hard link, it creates a separate element.
Results
After the relocation, if developers try to deliver or rebase operations
that involve a relocated element, they see warning messages that the element
is not visible. Any changes that are made to the source elements must be
manually merged from the source location to the target elements in the new
location.