IBM Support

About ucmutil

Technote (FAQ)


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)

Usage: help [command-name]
    Print this usage statement.
    Specifying command-name restricts output to the usage of that subcommand

Usage: lspvar {-pvar pvar_name | -all} ucm_object_selector ...
    List the value of a Process Variable.
    Process Variables are UCM internal implementation objects.

Usage: setpvar -pvar pvar_name [-add] {-value pvar_value | -file file-name | -none} ucm_object_selector ...
    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.
Usage: cleanup_crm {vob_selector | project_selector}
    Remove all integration links from a UCM project to a removed user database of IBM Rational ClearQuest

Usage: link_pvob [-fix] [-verbose] -from vob_selector -to vob_selector
    Associate an existing UCM project VOB to an external AdminVOB.
    Restrictions apply!.
    Contact IBM Rational Client Support. to get full instructions.

    CAUTION: Restrictions apply!.
    • "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.
    Before using this utility with "-fix" use it WITHOUT "-fix" to check for blocking conditions.
    If in doubt, Contact IBM Rational Client Support. to get full instructions.

Usage: sync_changeset [-fix] [-verbose] ucm_object_selector...
    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.

Usage: rm_stream_cspec [-update [-force]] [-recurse] ucm_stream_selector...
    Remove the cached config spec information from a UCM stream object.
    The config spec information can be regenerated with "chstream -generate".
    Usage: reset_deliver [-fix] ucm_stream_selector
      ClearCase 7.0.0 and later
      Clear some  problem conditions where a deliver operation can be neither completed nor canceled.

    Usage: reset_rebase [-fix] ucm_stream_selector
      ClearCase 7.0.0 and later
      Clear some problem conditions where a rebase operation can be neither completed nor canceled.

    Usage: dump_timeline [-act] -stream stream_selector -comp component_selector
      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:


    Related information

    Japanese technote 1418466
    A Japanese translation is available
    A simplified Chinese translation is available

    Cross reference information
    Segment Product Component Platform Version Edition
    Software Development Rational ClearCase Utilities and Tools
    Software Development Rational ClearCase UCM

    Document information

    More support for: Rational ClearCase
    Utilities and Tools

    Software version: 7.0, 7.0.1, 7.1, 7.1.1, 7.1.2, 8.0

    Operating system(s): AIX, HP-UX, IRIX, Linux, Solaris, Windows

    Reference #: 1237620

    Modified date: 20 September 2012