IBM Support

About ucmutil

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)

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

    [{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Utilities and Tools","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF015","label":"IRIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.0;7.0.1;7.1;7.1.1;7.1.2;8.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Utilities and Tools","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"UCM","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

    Document Information

    Modified date:
    16 June 2018

    UID

    swg21237620

    Page Feedback