About this task
ccm co|checkout -p|-project [-purpose purpose] [-platform platform]
[-release (release_spec|as_is)] [-subprojects] ([-t|-to version] |
[(-versions old_version:new_version,old_version:new_version...)...])
([-u|-update] | [-no_u|-no_update]) ([-cb|-copy_based] |
[-lb|-link_based|-ncb|-not_copy_based])
([-rel|-relative] | [-nrel|-not_relative])
[-set|-path|-setpath absolute_path] ([-mod|-modifiable] |
[-nmod|-not_modifiable]) ([-tl|-translate|-translation] |
[-ntl|-no_translate|-no_translation]) ([-wa|-maintain_wa] |
[-nwa|-no_wa]) ([-wat|-wa_time] | [-nwat|-no_wa_time])
[-c|-comment comment_string] [-ce|-commentedit]
[-cf|-commentfile file_path] project_spec...
- -c|-comment comment_string
- Specifies to append a comment on all baseline projects and their
members when they are checked in to the released state.
The comment_string 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.
- -cb|-copy_based
- Specifies that a work area is copy based.
- -ce|-commentedit
- Specifies to start 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.
- -lb|-link_based|-ncb|-not_copy_based
- Makes the work area link-based. This option is available to UNIX
users only. You must use this option with the -p option.
- 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.
- -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 -not_modifiable_wa.
- -no_u|-no_update
- Specifies that the checked-out project is not updated when it
is copied. The default is -no_update.
- -ntl|-no_translate
- Specifies that ASCII files in the work area are copied between
Windows and UNIX without newline translation. The default is -translate.
- -nrel|-not_relative
- Specifies that any work area is located on an absolute path. By
default, a new project uses the same relative setting as the project
being checked out.
- -nwa|-no_wa
- Specifies that the project does not have a maintained work area.
The default is -maintain_wa.
- -nwat|-no_wa_time
- Specifies that the files in the work area for the project use
timestamps. The timestamps show the modification time rather than
the time they were copied to the work area. The default is no_wa_time.
- -platform platform
- Specifies the platform to be used for the new checked out project.
The platform must be the name of a valid platform. The platform choices
are listed in the CCM_HOME\etc\om_hosts.cfg file (Windows)
or $CCM_HOME/etc/om_hosts.cfg file (UNIX) in your
installation. If the option is not specified, the default is to use
the same platform value as the project being checked out.
- project_spec
- Specifies the project to copy. See Project specification for details.
- -purpose purpose
- Specifies
the purpose for the new copied project. The purpose must be the name
of a valid defined purpose and valid for the release of the project.
See project_purpose command for details.
- If this option is not specified, and you are in the developer role,
the default is Insulated Development. If this option is not specified,
and you are in the build_mgr or ccm_admin role,
the default is Integration Testing.
- -rel|-relative
- Specifies that a work area is located on a path relative to the
parent project path. The default is for the new project to use the
same relative setting as the project being checked out.
- -release release_spec(|as_is)
- Specifies the release to use for the new copied project. If the
keyword "as_is" is specified, or the option is not
specified, the default is to use the release of the project being
checked out. You can set the release_spec to a release
defined in the current database.
- -set|-path|-setpath absolute_path
- Specifies the work area path to use for the copied project. If
not specified, a default work area path is determined using the current
Work Area Path Template and Project Subdirectory Template.
- -subprojects
- Specifies to copy all subprojects in the specified project hierarchy.
- -t|-to version|file_spec
- Specifies the version of the checked out project. If you do not
specify -t|-to or -versions, the
default next version is computed automatically using a built-in algorithm.
- -tl|-translate|-translation
- Specifies that ASCII files in the work area to copy between Windows
and UNIX with newline translation. The default is -translation.
- -u|-update
- Specifies that the checked-out project is updated when it is copied. The
specified project is checked out without a work area and is updated
according to the setting for the project grouping that indicates whether
to refresh the baseline and tasks. If the project has a maintained
work area, the project is synchronized. The default is
-no_u|-no_update.
- -versions old_version:new_version,old_version:new_version,...
- Specifies the new versions to use for copying a project or project
hierarchy. Each mapping applies to all projects in the hierarchy that
currently have that value. If new_version is NoCheckOut,
projects with the corresponding old_version are not
copied.
- If neither -t|-to or -versions are
specified, the default next version is computed using a built-in algorithm.
- -wa|-maintain_wa
- Specifies that the project has a maintained work area. The default
is -maintain_wa.
- -wat|-wa_time
- Specifies that the files in the project work area use timestamps
that show the time they were copied into the work area. The default
is -no_wa_time.