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.
Access control for VOBs and versioned objects
These commands enable you to control access to VOBs and the objects they contain.
rmpolicy
Lists policies

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.
        chpolicy
        Changes the definition of a policy
        chrolemap
        Changes the contents of a rolemap
        cppolicy
        Copies a policy
        cprolemap
        Copies a rolemap
        credmap
        Displays username/UID and group name/GID on Windows®, UNIX®, and Linux®
        creds
        Displays user and group information
        lspolicy
        Lists policies
        lsrolemap
        Lists rolemaps
        mkpolicy
        Creates or updates a policy
        mkrolemap
        Creates or updates a rolemap object
        permissions
        Identity checking
        protect
        Changes permissions or ownership of a VOB object
        protectvob
        Changes various properties of a VOB
        rmpolicy
        Lists policies
        rmrolemap
        Removes rolemaps
        vob_sidwalk, vob_siddump
        Reads or changes security identifiers in a schema version 54 or schema version 80 VOB database
      - 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.

rmpolicy

Lists policies

Applicability


Product	Command type
VersionVault	cleartool subcommand


Platform
UNIX®
Linux®
Windows®

Synopsis

rmpolicy [ –c/omment comment | –cfi/le pname | –cq/uery | –cqe/ach | –nc/omment ]: policy-selector ...

Description

The rmpolicy removes policies from the current VOB.

Restrictions

Authorization

The principal must have the following permissions:

read-info on VOB object
read-name on policy
delete on policy

Locks

An error occurs if one or more of these objects are locked: VOB, policy.

Mastership

(Replicated VOBs only). The policy must be mastered by the VOB at which this command is issued.

Additional restriction

A policy cannot be removed if it is implemented by a rolemap.

Options and arguments

Event records and comments

Default: Creates one or more event records, with commenting controlled by your .versionvault_profile file (default: –cqe). See the comments reference page. Comments can be edited with chevent.
–c/omment comment | –cfi/le comment-file-pname |–cq/uery | –cqe/ach | –nc/omment: Overrides the default with the option you specify. See the comments reference page.

Specifying the policy

Default: None.

policy-selector: The policy that is to be removed.

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.

Remove a policy; do not prompt for confirmation.
cmd-context cleartool rmpolicy -force DeveloperVobPolicy

See also

chpolicy, chrolemap, cppolicy, cprolemap, lspolicy, lsrolemap, mkrolemap , rmrolemap

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.