Command Reference > pmrep Command Reference > CreateFolder
  

CreateFolder

Creates a folder in the repository.
The CreateFolder command uses the following syntax:
createfolder

-n <folder_name>

[-d <folder_description>]

[-o <owner_name>]

[-a <owner_security_domain>]

[-s (shared_folder)]

[-p <permissions>]

[-f <active | frozendeploy | frozennodeploy>]
The following table describes pmrepCreateFolder options and arguments:
Option
Argument
Description
-n
folder_name
Required. Folder name.
-d
folder_description
Optional. Description of the folder that appears in the Repository Manager. If the folder description contains spaces or other non-alphanumeric characters, enclose it in quotation marks.
-o
owner_name
Optional. Owner of the folder. Any user in the repository can be the folder owner. Default owner is the user creating the folder.
-a
owner_security_domain
Required if you use LDAP authentication. Name of the security domain that the owner belongs to. Default is Native.
-s
-
Optional. Makes the folder shared.
-p
permissions
Optional. Access rights for the folder. If omitted, the Repository Service assigns default permissions.
-f
active
frozendeploy
frozennodeploy
Optional. Changes the folder status to one of the following statuses:
  • - active. This status allows users to check out versioned objects in the folder.
  • - frozendeploy (Frozen, Allow Deploy to Replace). This status prevents users from checking out objects in the folder. Deployment into the folder creates new versions of the objects.
  • - frozennodeploy (Frozen, Do Not Allow Deploy to Replace). This status prevents users from checking out objects in the folder. You cannot deploy objects into this folder.

Assigning Permissions

You can assign owner, group, and repository permissions by entering three digits when you use the -p option. The first digit corresponds to owner permissions, the second corresponds to the permissions of the group that the user belongs to, and the third corresponds to all other permissions.
Enter one number for each set of permissions. Each permission is associated with a number. Designate 4 for read permission, 2 for write permission, and 1 for execute permission. To assign permissions, you enter 4, 2, 1, or the sum of any of those numbers.
For example, if you want to assign default permissions, use the following command syntax:
-p 764
This gives the folder owner read, write, and execute permissions (7 = 4+2+1). The owner’s group has read and write permissions (6 = 4+2). All others have read permission.
The command returns “createfolder successfully completed” or returns “createfolder failed” message. The creation might fail for the following reasons: