chfolder

Modifies a UCM folder

APPLICABILITY

ClearCase UCM (cleartool subcommand)

SYNOPSIS

chfolder [ -c·omment comment | -cfi·le comment-file-pname |

-cq·uery | -cqe·ach |-nc·omment ]
{ [ -tit·le title ] [ -to to-folder-selector ] }
folder-selector ...

DESCRIPTION

The chfolder command modifies one or more UCM folders. Use it for these tasks:

• To change the title of a folder
• To move a folder to another location in the folder hierarchy of a project VOB. The RootFolder cannot be moved.

Note that changing a folder's title does not affect its name (its unique identifier). See rename for related information.

PERMISSIONS AND LOCKS

Permissions Checking: You must be the owner of the folder, the UCM project VOB owner, or a member of the ClearCase group.

Locks: An error occurs if there are locks on any of the following objects: the folder, the UCM project VOB.

Mastership: The folder must be locally mastered.

OPTIONS AND ARGUMENTS

EVENT RECORDS AND COMMENTS. Default: Creates one or more event records, with commenting controlled by your .clearcase_profile file (default: -nc). See CUSTOMIZING COMMENT HANDLING in 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.

ASSIGNING A NEW TITLE. Default: None.

-tit·le title

Specifies the new title for the folder. The title argument can be a character string of any length. Use double quotes to enclose a title with special characters.

MOVING A FOLDER. Default: None.

-to to-folder-selector

Specifies the new parent folder. The to-folder and the folder you are moving must belong to the same UCM project VOB.

folder-selector is of the form: [folder:]folder-name[@vob-selector] and vob is the folder's UCM project VOB.

SPECIFYING THE FOLDER TO CHANGE.

folder-selector ...

Specifies one or more folders to modify. RootFolder cannot be moved.

folder-selector is of the form: [folder:]folder-name[@vob-selector] and vob is the folder's UCM project VOB.

EXAMPLES

Examples including 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 command interpreter prompt. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace prompt.

• Assign a new title to the Parsers folder. Note the VOB component of the folder-specifier must be the folder's project VOB.

cmd-context chfolder -title "Team Parser Projects" Parsers@/vobs/core_projects
Changed folder "Parsers@\vobs\core_projects".

• Make the folder Core_Parsers a subfolder of RootFolder. Note that the folder's project VOB is given as the VOB component of the folder-specifier.

cmd-context chfolder -to RootFolder Core_Parsers@/vobs/core_projects
Changed folder "Core_Parsers@\vobs\core_projects".

SEE ALSO

lsfolder, mkfolder, rmfolder, rename