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] [-release release_spec]
[-set|-path|-setpath absolute_path] [-wa|-maintain_wa] [-nwa|-no_wa]
([-cb|-copy_based] | [-lb|-link_based|-ncb|-not_copy_based])
([-rel|-relative] | [-nrel|-not_relative])
([-mod|-modifiable] | [-nmod|-not_modifiable])
([-wat|-wa_time] | [-nwat|-no_wa_time])
([-tl|-translate|-translation] | [-ntl|-no_translate|-no_translation])
[-c|-comment comment_string] [-ce|-commentedit]
[-cf|-commentfile file_path] [-task task_spec] 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.
- -mod|-modifiable_wa
- Specifies that files in the work area have permissions set so
they are modifiable even if they are not checked out. The default
is -nmod|-not_modifiable_wa.
- new_project_spec
- Specifies the name and version (optional) of the project to be
created. The new_project_spec must
be in one of the name forms:
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.
- -nmod|-not_modifiable_wa
- Specifies that files in the work area have permissions set so
they are modifiable by default only if they are in a writable state,
such as working. The default is -nmod|-not_modifiable_wa.
- -ntl|-no_translate|-no_translation
- Specifies that ASCII files in the work area are copied between Windows and UNIX without newline translation. The default
is -tl|-translate.
- -nrel|-not_relative
- Specifies that any work area is located on an absolute path. The
default is for the new project to use the same relative setting as
the project being checked out.
- -nwat|-no_wa_time
- 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. The default is -nwat|-no_wa_time.
- -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.
- -rel|-relative
- Specifies to locate the work area on a path relative to the parent
project path.
- -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 the task_spec to a
single task. By default, the project root directory is associated
with the current task. See Task specification for details.
- -tl|-translate|-translation
- Specifies to perform newline translation of ASCII files when the
files are copied between a Windows client
and UNIX server, or between
a UNIX client and a Windows server.
- -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.
- -wat|-wa_time
- Specifies that the files in the project work area use timestamps.
The timestamps show the time the files were copied into the work area,
rather than their modification time. The default is -nwat|-no_wa_time.
Example
- Create an initial
project called proj1 in the work area.
ccm
create -t project proj1
- Create an initial project and maintain a work area.
ccm create -t project -c "test" -wa -set "/tmp"
testwa-1.0
- Create MainPrj-1 and SubPrj-1 with -wa.
Use SubPrj-1 inside the MainPrj-1 root
directory:
ccm create -t project MainPrj-1
-release 1.0 -task 11 -purp "Integration Testing" -wa
ccm create -t project SubPrj-1 -release 1.0
-task 12 -purp "Integration Testing" -wa
cd
WAPATH\MainPrj-1\MainPrj (Windows) OR cd WAPATH/MainPrj-1/MainPrj
(Unix)
ccm use -p SubPrj-1 -task
13
- Create MainPrj-1 and SubPrj-1 with -nwa.
Use SubPrj-1 inside the MainPrj-1 root
directory:
ccm create -t project MainPrj-1
-release 1.0 -task 11 -purp "Integration Testing" -nwa
ccm create -t project SubPrj-1 -release 1.0
-task 12 -purp "Integration Testing" -nwa
ccm
use -task 13 -p SubPrj-1 -dir MainPrj@MainPrj-1