CLI operation

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.

Example


Feedback