Previewing a transfer package

This content applies to version 7.2.1 or later. You can preview the generation of a transfer package for a specified transfer set and destination database.

Before you begin

The current database must be initialized to use DCM.

You must have the dcm_mgr or ccm_admin role available to preview a transfer package.

About this task

A DCM manager or an administrator can preview a transfer package.

ccm dcm -preview -gen|-generate -dbid|-database_id database_spec
        -ts|-transfer_set transfer_set_spec
        [-lg|-last_generated last_generated_value] [-f|-format format]
        [-nf|-noformat] ([-ch|-column_header] | [-nch|-nocolumn_header])
        [-sep|-separator separator] [-sby|-sortby sortspec]
        [-ns|-nosort|-no_sort] [-gby|-groupby groupformat]
-ch|-column_header
Specifies to use a column header in the output format. See -ch|-column_header for details.
-dbid|-database_id database_spec
Specifies the destination database for which the transfer package is generated. The database_spec must specify a single database definition. See Database specification for details.
-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.
-lg|-last_generated last_generated_value
Specifies the last time a generate operation occurred.
Note: This option is for advanced users only.

If not specified, the package is generated to use the time at which a transfer package for the specified transfer set and database was last generated. Use this option to generate a transfer package that includes earlier changes, such as when recovering from missing transfer packages.

The last_generated_value must have one of the following settings:

never— an integer index where 1 refers to the most recent generated transfer package.

If you select a timestamp that is not the most recent timestamp, the generated transfer package includes all objects that have changed or become members since that date. Also, the more recent timestamps are removed from the list.

Note: The never choice causes all previous time stamps to be removed from the list.

When last_generated_value is set to never, the transfer package is generated as if for the first time. The transfer package does not exclude an object regardless of when it was last modified or became a member of the transfer set.

-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 column alignment. See -nf|-noformat for details.
-ns|-no_sort
Specifies not to sort the output. See -ns|-nosort for details.
-preview
Specifies to generate a preview of a transfer package.
-sby|-sortby sortspec
Specifies how to sort the command output. See -sby|-sortby for details.
-sep|-separator separator
Specifies a different separator character. See -sep|-separator for details.
-ts|-transfer_set transfer_set_spec
Specifies the transfer set to be used for the DCM generate. The transfer_set_spec must specify a single transfer set.

Example

Examples

Preview a transfer package:

ccm dcm -preview -gen -dbid Any~1:dcmdbdef:1 -ts my_ts -lg

Generate Preview: Computing transfer package...
Computing transfer package for 'my_ts' going to database 'Any'...
Generate Preview: Computing transfer package..., 50%...
8 objects will be included in transfer package for 'my_ts' going to database 'Any'...
Generate Preview: Computing transfer package..., 100%
Displayname                          		Type             Instance
1.0                                  		releasedef       1
1.0:Collaborative Development        		process_rule     1
3D_Simulation~4                                 dir              h#1
3D_Simulation~Games_Package_1.0_20080703        project          h#1
3D_Simulation~int_3.0                           project          h#1
AbstractAccessTask.html~1                       html             h#1
h#20                                            folder           h
h#20                                            task             h

Feedback