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