The ccm migrate -incremental command performs
an incremental migrate from a plain file system location using a specified
project as a reference. It produces an import package compressed file
that might be imported later using the ccm import command.
About this task
ccm migrate -p|-project project_spec -inc|-incremental
[-task task_spec] [-dt|-default_type default_type]
[-rules file_path] [-results results_file] [-s|-sh|-show]
[-f|-format format] [-nf|-noformat]
([-ch|-column_header] | [-nch|-nocolumn_header])
[-sep|-separator separator]
([-sby|-sortby sortspec] | [-ns|-nosort|-no_sort])
[-gby|-groupby groupformat] [-output compressedfile]
directory_path
- -ch|-column_header
- Specifies to use a column header in the output format. See -ch|-column_header for details.
- directory_path
- Specifies a client file system directory containing the data to
be migrated.
- -dt|-default_type default_type
- Specifies the default Rational® Synergy
type that is used if no mapping
rules define the type of the object. If not specified, the
default is ascii.
- -f|-format format
- Specifies the command output format. See -f|-format for details.
- -gby|-groupby groupformat
- Specifies how to group the command output. See -gby|-groupby for details.
- -nch|-nocolumn_header
- Specifies not to use a column header in the output format. See -nch|-nocolumn_header for details.
- -nf|-noformat
- Specifies not to use a column alignment. See -nf|-noformat for details.
- -ns|-no_sort
- Specifies not to sort the output. See -ns|-nosort for details.
- -output compressedfile
- Specifies the client path and name of the compressed file to be
created containing the import package. The compressedfile must
have a .zip suffix. If this option is not specified,
a compressed file is created in the current working directory. The
default name of the compressed file is constructed by using the name
of the project, an underscore, and a date string in the form "YYYYMMDD."
The YYYY is a four-digit year, MM is a two-digit month, and DD is
a two-digit day.
If a file of that name exists, an additional underscore
and a unique integer number are appended. For example, on 16th June
2010, the first default compressed file name for migrating a project
named example would be example_20100616.zip. The
second one performed on that date from the same project name would
be example_20100616_1.zip.
- project_spec
- Specifies the project to be used as a reference and updated when
the import package is imported. See Project specification for details.
- -rules file_path
- Specifies to use a mapping
rule instead of the default rules.
- -results results_file
- Specifies a results file that contains the migrate preview results.
If not specified, the preview results are written to the stdout stream.
- -sep|-separator separator
- Specifies a different separator character. See -sep|-separator for details.
- -sby|-sortby sortspec
- Specifies how to sort the command output. See -sby|-sortby for details.
- -s|-sh|-show
- Specifies that the objects contained in the import package are
shown in the results file or the command output.
- -task task_spec
- Specifies the task that is associated with all of the directories
and files created when the import package is imported. If not specified,
the current task is used by default.