You can receive transfer packages that were generated for
this database, saved offline, or that are broadcast packages. You
can specify which packages to receive by specifying the generating
database or transfer set, or generating database and transfer set.
By default, packages generated for this database by any other database
and with any transfer set are received. Packages are received in the
same time order they are generated.
Before you begin
The current database must be initialized to use DCM.
You
must be an administrator to use the -receive option.
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.
You can set the database_spec to 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 of these checks fail, the operation will
ignore them and continue:
- 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
will ignore the condition and continue.
By default,
if the release delimiter in the generate database is not the same
as that in the receiving database, the receive will fail. All databases
in a DCM cluster should 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 will fail if this condition is detected. This
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 that in the
receive database, the receive will fail.
- -im|-ignore_missing
- Tells DCM to ignore missing transfer packages.
Note: This option
might result in empty directory entries or missing relationships.
- -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
is the default.
- -noirdc|-noignore_release_delimiter_check
- Specifies to report an error and fail to continue if the release
delimiter check fails. This 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 will fail if this condition
is detected. This 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.
- -noivdc|-noignore_version_delimiter_check
- Specifies to report an error and fail to continue if the version
delimiter check fails. This is the default. See DCM restrictions for details on version delimiter
restrictions.
- -nowait
- Specifies that the receive should not 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 will receive 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. You can set the transfer_set_spec to
a single transfer set. For details, see Transfer set specification.
- -wait
- Specifies that the receive should wait until the receiving database
has completed receiving other transfer packages. If you need to cancel
this operation, use CTRL+c.
This
is the default.