Receiving a transfer package

You can receive DCM transfer packages that were generated for this database or that are broadcast packages. You can also receive save offline packages created by Save offline and delete.

Before you begin

The current database must be initialized to use DCM.

You must have the ccm_admin role available to perform a DCM receive.

About this task

ccm dcm -rec|-receive [-dbid|-database_id database_spec]
        [-ts|-transfer_set transfer_set_spec] [-a|-all] [-im|-ignore_missing]
        ([-wait] | [-nowait]) ([-ic|-ignore_checks] |
        [-noic|-noignore_checks]) ([-ivdc|-ignore_version_delimiter_check] |
        [-noivdc|-noignore_version_delimiter_check])
        ([-irdc|-ignore_release_delimiter_check] |
        [-noirdc|-noignore_release_delimiter_check])
        ([-itsc|-ignore_time_sync_check] |
        [-noitsc|-noignore_time_sync_check]) [-dir|-directory receive_dir]
-a|-all
Specifies to receive all transfer packages for all transfer sets. This option cannot be used with -database_id or -transfer_set.
-database_id database_spec
Specifies to receive packages only from the specified database. The database_spec must specify a single database definition. See Database specification for details.
-dir|-directory receive_dir
Specifies that the transfer packages are in the specified receive_dir on the server. By default, packages are received from the dcm/receive directory under the current database path. The receive_dir represents a server path. For UNIX servers, use an absolute path. For Windows servers, use a UNC path.
-ignore_checks
Specifies that if any checks fail, the operation ignores them and continues with the following checks.
  • Version delimiter check
  • Release delimiter check
  • Time synchronization check

The option is equivalent to specifying the -ignore_version_delimiter_check, -ignore_release_delimiter_check, and -ignore_time_sync_check options.

-irdc|-ignore_release_delimiter_check
Specifies that if the release delimiter check fails, the operation ignores the condition, and continues.

By default, if the release delimiter in the generate database is not the same as in the receiving database, the receive operation fails. Make sure that all databases in a DCM cluster use the same release delimiter.

-itsc|-ignore_time_sync_check
If the transfer package appears to have been generated in the future, specifies to ignore the condition and continue.

By default, the receive operation fails if this condition is detected. Failure usually happens when either the computer that generated the package or the one receiving it or both have an incorrect time zone or time setting. Correcting the time allows DCM to work properly across time zones.

-ivdc|-ignore_version_delimiter_check
If the version delimiter check fails, specifies to ignore the condition and continue.

By default, if the version delimiter in the generate database is not the same as in the receive database, the receive operation fails.

-im|-ignore_missing
Tells DCM to ignore missing transfer packages. If a transfer package was regenerated to fill in the missing package, use this option to receive that regenerated package only. If the predecessor package is unexpectedly missing, see About missing transfer packages for details of the correct procedure to recover from this error.
Note: If you use this option to receive a package whose predecessor is missing, objects, relationships, directory entries, or project memberships might be missing important updates. Ignoring a missing predecessor can lead to empty directory entries.
-noic|-noignore_checks
Specifies to report a warning and fail to continue if any of these checks fail:
  • Version delimiter check
  • Release delimiter check
  • Time synchronization check

This option is equivalent to specifying the -noignore_version_delimiter_check, -noignore_release_delimiter_check, andnoitsc|-noignore_time_sync_check options. This option is the default.

-noirdc|-noignore_release_delimiter_check
Specifies to report an error and fail to continue if the release delimiter check fails. This option is the default. See the release command for details on release delimiter settings.
-noitsc|-noignore_time_sync_check
If the transfer package appears to have been generated in the future, specifies to report an error and fail to continue.

By default, the receive operation fails if this condition is detected. This condition happens when either the computer that generated the package or the one receiving it or both have an incorrect time zone or time setting. Correcting the time allows DCM to work properly across time zones.

-noivdc|-noignore_version_delimiter_check
Specifies to report an error and fail to continue if the version delimiter check fails. This option is the default. See DCM restrictions for details on version delimiter restrictions.
-nowait
Specifies the receive operation not to wait until the receiving database has completed receiving other transfer packages.
Note: It is not safe to receive multiple transfer packages in a database concurrently. By default, DCM receives one package at a time into a database. Use this option only if you are certain that the transfer packages do not contain overlapping objects. For example, if the same task object is present in two packages each generated from a different transfer set, these packages have an overlapping object. In this situation, use -wait, the default
-ts|-transfer_set transfer_set_spec...
The transfer_set_spec specifies the transfer set to use for the DCM receive. Set the transfer_set_spec to a single transfer set. For details, see Transfer set specification.
-wait
Specifies for the receive operation to wait until the receiving database has completed receiving other transfer packages. This option is the default. To cancel this operation, type CTRL+c.

Example

Receive a transfer package from a source database.

ccm dcm -receive -ts "Entire Database" -dbid USIRJA


Feedback