mkfolder

Creates a folder for a UCM project

APPLICABILITY

ClearCase UCM (cleartool subcommand),

SYNOPSIS

mkfolder [ -c·omment comment | -cfi·le pname | -cq·uery | -cqe ach| -nc omment ]

[ -title title ] -in parent-folder-selector [ folder-selector ... ]

DESCRIPTION

The mkfolder command creates a folder for a UCM project. Folders have these characteristics:

• They can contain projects or other folders.
• They must reside in a UCM project VOB.
• Each folder must have a parent folder.

The parent folder for a top-level folder is named RootFolder, a predefined ClearCase object.

PERMISSIONS AND LOCKS

Permissions Checking: No special permissions are required.

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

Mastership: There are no mastership requirements.

OPTIONS AND ARGUMENTS

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

-title title

Specifies a descriptive name displayed in output and the graphical interface. The title argument can be a character string of any length. Use double quotes to enclose titles with spaces or special characters. A folder name is generated if no folder-selector is specified.

-in parent-folder-selector

Specifies a parent folder for the new folder. To create a top-level folder, you must specify the predefined folder object RootFolder as its parent folder.

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

folder-selector ...

Names one or more new folders.Each folder must reside in the same UCM project VOB as its paroent folder and is created in the folder specified by the -in option. A folder name is generated if no folder-selector is specified.

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.

• Creates a top-level folder whose parent is the predefined ClearCase object RootFolder.

cmd-context  cleartool mkfolder -title toplevel -in RootFolder@\vobs\mypvob

Created folder "toplevel_12345".

SEE ALSO

chfolder, lsfolder, mkproject, rmfolder