Creating a top-level project

You can create a new top-level project. When you create a project, a work area is created for it automatically. By default, the work area is formed by expanding the default work area path template.

The default setting is%HOMEPATH%\My Documents\Synergy\ccm_wa\databaseName\projectName-projectVersion on Windows and $HOME/ccm_wa/databaseName/projectName-projectVersion on UNIX.

To make a project a member in an existing project, use the ccm use -p command after you have created the project.

About this task

ccm create -t|-type project [-platf|-platform platform] 
        [-purp|-purpose purpose] [-rel|-release release_spec]
        ([-cb|-copy_based] | [-lb|-link_based|-ncb|-not_copy_based])
        [-set|-path|-setpath absolute_path] 
        [-wa|-maintain_wa] [-nwa|-no_wa] 
        [-task task_spec] [-c|-comment comment_string] [-ce|-commentedit] 
        [-cf|-commentfile file_path] new_project_spec...
-c|-comment comment
Specifies to append a comment on all baseline projects and their members when they are checked in to the released state. The comment can contain more than one line and accepts backslash encoded values.

You can use this option with -commentedit and -commentfile. If you use the -commentedit option, the comment displays in the default text editor.

-ce|-commentedit
Specifies to invoke the default text editor to compose and edit the comment. The result saved from the text editor is used as the final comment. You can use this option with the -comment and -commentfile options.
-cf|-commentfile file_path
Specifies to use the contents of the specified file for the comment. If you specified -comment, it is appended to that comment. You can use this option with the -commentedit option.
-cf|-commentfile file_path
Specifies to use the contents of the specified file for the comment. If you specified -comment, it is appended to that comment. You can use this option with the -commentedit option.
-cb|-copy_based
Specifies that a work area is copy based.
-lb|-link_based|-ncb|-not_copy_based
Makes the work area link-based. This option is available to UNIX users only.

See the work_area command for more information.

new_project_spec
Specifies the name and version (optional) of the project to be created. The new_project_spec must be in one of these forms:
  • A name

The new_project_spec option is not a general project specification. You cannot use forms such as an object name form or query selection set reference form.

-nwa|-no_wa
Specifies that the new project does not have a maintained work area. Use the work area command if you want the project to have a maintained work area later. By default, the project is created with a maintained work area.
-platf|-platform platform
Specifies the platform for the new project. The platform must be a valid platform name.
-purpose purpose
Specifies the purpose for the new project. Set the purpose to the name of a defined purpose that is valid for the specified release. Use the project_purpose -show command to list valid purposes.
-release release_spec
Specifies the release for the new project. You can set the release_spec to a single release that is defined and active. See Release specification for details.
-set|-path|-setpath absolute_path
Specifies the work area path for the project. Set the absolute_path to an absolute path that you can see and modify.
-task task_spec
Specifies the task to associate with the new project root directory. You can set thetask_spec to a single task. By default, the project root directory is associated with the current task. See Task specification for details.
-wa|-maintain_wa
Specifies that the new project has a maintained work area. The default is -wa|-maintain_wa if a work area option is not specified. The work area is updated with changes made to the new project. Use the work area command to turn off work area maintenance.

Example


Feedback