Home
Reference
Review reference information for the product.
HCL VersionVault command reference
HCL VersionVault and HCL VersionVault MultiSite provide a command-line interface that enables access to all product functions. The command line processor supports interactive use, and can also be driven by various scripting languages.
Administrator Commands (base VersionVault and UCM)
These commands are used by VersionVault administrators or any user who performs administrative tasks.
Managing VOBs and views
These commands are useful for creating and administering VOBs and views.
unlock
Unlocks an object

Reference
Review reference information for the product.
- HCL VersionVault command reference
  HCL VersionVault and HCL VersionVault MultiSite provide a command-line interface that enables access to all product functions. The command line processor supports interactive use, and can also be driven by various scripting languages.
  - Commands for developing software
    These commands are used by software developers and others who work with resources that are under HCL VersionVault control. Most of the cleartool commands used by developers who use the VersionVault local client are also available as rcleartool commands for users of the VersionVault remote client.
  - Commands for building software (base VersionVault and UCM)
    These commands are useful for building software, especially in a dynamic view.
  - Administrator Commands (base VersionVault and UCM)
    These commands are used by VersionVault administrators or any user who performs administrative tasks.
    - Importing assets from other configuration management systems
      VersionVault provides a number of utilities that enable you to import files, folders, and metadata from other configuration management systems.
    - Managing VOBs and views
      These commands are useful for creating and administering VOBs and views.
      - checkvob
        Finds and fixes inconsistencies within and between VOBs
      - chflevel
        Raises the feature level of a VOB
      - chpool
        Changes the storage pool to which an element is assigned
      - dospace
        Reports on VOB disk space used for shared derived objects
      - lock
        Locks an object
      - lsvob
        Lists VOB registry entries
      - lstype
        Lists a VOB's type objects.
      - mkpool
        Creates a VOB storage pool or modifies its scrubbing parameters
      - mkstgloc
        Creates a server storage location for views or VOBs
      - mkview
        Creates and registers a view
      - mkvob
        Creates and registers a versioned object base (VOB)
      - rmview
        Removes a view or removes view-related records from a VOB
      - rmvob
        Removes a VOB storage directory
      - msdostext_mode
        Enables or disables a VOB's interop text mode support
      - recoverview
        Recovers a dynamic view database
      - reformatview
        Updates the format of a view database
      - reformatvob
        Reformats a VOB database
      - relocate
        Moves elements and directory trees from one VOB to another
      - scrubber
        Removes data containers from VOB storage pools and removes DOs from VOB database
      - space
        Reports on disk space use for views, VOBs, or file-system files or directories
      - unlock
        Unlocks an object
      - view_scrubber
        Remove derived object data containers from dynamic view storage
      - vob_scrubber
        Remove event records, oplog entries, or both from VOB database
      - Access control for VOBs and versioned objects
        These commands enable you to control access to VOBs and the objects they contain.
      - Backing up and restoring VOBs
        Ensuring frequent, reliable backups of essential data is a critical task for any HCL VersionVault administrator. As with all databases, VOBs have special backup and restore requirements, which are supported by these commands.
    - Managing the HCL VersionVault registry
      The HCL VersionVault registry provides a central repository of information about VOB and view locations and also specifies default values for typical client host settings.
    - MVFS reporting
      These commands report on the HCL VersionVault Multiversion File System.
    - Miscellaneous administrator commands and information
      These commands provide administrative interfaces for tasks such as license management, deployment management, and job scheduling.
  - Commands for managing software development projects (base VersionVault and UCM)
    These commands are used by VersionVault project managers, who establish the development policies for software projects.
  - Alphabetical list of all commands
    All commands, listed alphabetically.
- HCL VersionVault MultiSite command reference
  All commands for HCL VersionVault MultiSite, listed alphabetically.

unlock

Unlocks an object

Applicability


Product	Command type
VersionVault	cleartool subcommand
VersionVault Remote Client	rcleartool subcommand


Platform
UNIX®
Linux®
Windows®

Synopsis

VersionVault:

unlock [ –c/omment comment | –cfi/le comment-file-pname | –cq/uery

| –cqe/ach | –nc/omment ] [ –ver/sion version-selector ]
{ [ –pna/me ] pname ... | object-selector ... }
VersionVault Remote Client:

unlock [ –c/omment comment | –cq/uery

| –cqe/ach | –nc/omment ] [ –ver/sion version-selector ]
{ [ –pna/me ] pname ... | object-selector ... }

Description

The unlock command removes an existing lock from an entire VOB, or from one or more objects, type objects, or VOB storage pools. For a description of locks, see the lock reference page.

Restrictions

For a description of restrictions, see the lock reference page.

Options and arguments

For a description of the options to the unlock command, see the lock reference page.

Examples

The UNIX system and Linux examples in this section are written for use in csh. If you use another shell, you may need to use different quoting and escaping conventions.

The Windows examples that include wildcards or quoting are written for use in cleartool interactive mode. If you use cleartool single-command mode, you may need to change the wildcards and quoting to make your command interpreter process the command appropriately.

In cleartool single-command mode, cmd-context represents the UNIX system and Linux shells or Windows command interpreter prompt, followed by the cleartool command. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt.

Unlock the label types REL1 and REL2.
cmd-context unlock lbtype:REL1 lbtype:REL2
Unlocked label type "REL1". Unlocked label type "REL2".
Unlock the v3_bugfix branch.
cmd-context unlock cmd.h@@/main/v3_bugfix

See also

lock, lshistory, lslock, protect

Have feedback?
Google Analytics is used to store comments and ratings. To provide a comment or rating for a topic, click Accept All Cookies or Allow All in Cookie Preferences in the footer of this page.