Question & Answer
Question
What is the IBM Rational ClearCase Unified Change Management (UCM) utility named ucmutil on Microsoft Windows, UNIX and Linux® and what is it used for?
Answer
ABOUT UCMUTIL:
The ucmutil tool was created to help resolve problems or errors in Rational ClearCase UCM environments.
IMPORTANT NOTE: The use of this utility is only supported when directed by IBM Rational Client Support, and is not intended for general use without explicit guidance.
LOCATION:
This tool is found in the following directory:
Windows: <ClearCase Install Directory>\etc\utils
UNIX & Linux: /opt/rational/clearcase/etc/utils
USAGE:
Usage: quit
- Exit from "interactive" use of ucmutil (entered by "ucmutil" without arguments)
- Print this usage statement.
Specifying command-name restricts output to the usage of that subcommand
- List the value of a Process Variable.
Process Variables are UCM internal implementation objects.
- Change the value of a Process Variable.
Process Variables are UCM internal implementation objects.
Never use this unless specifically instructed by IBM Rational Client Support.
Invalid values will cause failures in UCM.
Note: Running this command requires VOB Admin (or Root on Unix/Linux) privileges on the VOB server.
- Remove all integration links from a UCM project to a removed user database of IBM Rational ClearQuest
- Associate an existing UCM project VOB to an external AdminVOB.
- "link_pvob" can be run only ONCE on a PVOB. It is not restartable after a "partial success".
- "link_pvob" requires MultiSite mastership of all streams in the PVOB.
- " link_pvob" utility establishes an adminvob relationship between VOBs, This means it should never be undone.
Restrictions apply!.
Contact IBM Rational Client Support. to get full instructions.
CAUTION: Restrictions apply!.
If in doubt, Contact IBM Rational Client Support. to get full instructions.
- Verify that the changeset map of an activity correctly matches to its Change hyperlinks.
This provides a check that is not currently part of "checkvob -ucm",
for a condition where the changeset map was not updated during a checkin.
- Remove the cached config spec information from a UCM stream object.
The config spec information can be regenerated with "chstream -generate".
- ClearCase 7.0.0 and later
Clear some problem conditions where a deliver operation can be neither completed nor canceled.
- ClearCase 7.0.0 and later
Clear some problem conditions where a rebase operation can be neither completed nor canceled.
- ClearCase 7.0.0 and later
Display the rebase / mkbl / deliver history for a component in the context of one stream
APPROVED USE OF UCMUTIL:
The following technotes contain approved uses of this tool without the need of support assistance:
- Technote 1117451 - Error after running the ucmutil cleanup_crm command
- Technote 1179696 - Rebase fails with integration activity change set is not empty
- Technote 1286573 - How to generate a running list of delivers and rebases on a stream
- Technote 1146614 - cleartool: Error: Rebase in progress on stream
- Technote 1125214 - cleartool: Warning: Activity has checkouts
Related Information
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21237620