You can modify the specified database definitions from
the command-line interface.
Before you begin
The current database must be initialized to use DCM.
You
must have the dcm_mgr or ccm_admin role
available to you to modify a DCM database definition.
About this task
ccm dcm -m|-modify -dbid|-database_id [-desc|-description description]
[-tm|-transfer_mode ((manual|manual_copy) | direct |
(cp|copy|local_copy) | (rcp|remote_copy) |
(ftp|file_transfer_protocol) | (user|user_defined))]
([-ar|-automatic_receive] | [-noar|-noautomatic_receive])
([-rb|-run_in_background] | [-norb|-norun_in_background]) [-host host] [-os|-operating_system (unix | (windows|windows_nt))]
[-path path] [-tp|-transfer_path path] [-ccm_home path]
([-zip] | [-nozip]) ([-ga|-generate_allowed] |
[-noga|-nogenerate_allowed]) ([-handover_allowed] |
[-nohandover_allowed]) ([-hidden] | [-nohidden])
[-location location] [-admin_info admin_info]
[-new_dbid|-new_database_id new_dbid] database_spec...
- -admin_info admin_info
- Specifies to modify the contact information for the specified
database. The admin_info value can be any string
that does not contain newline characters. For example, phone numbers
and email addresses are valid entries.
- -ar|-automatic_receive
- Specifies to automatically receive transfer packages for the specified
databases.
- -ccm_home path
- For the specified databases, modify the Rational® Synergy $CCM_HOME installation
path to be used to perform an automatic receive. Enter an absolute
path if a UNIX server hosts
the corresponding database. Enter a UNC path if a Windows server hosts it.
- database_spec
- Specifies the database definitions to be modified. See Database specification.
- -desc|-description description
- Specifies to modify the specified database description. The description
cannot contain newline characters.
- -ga|-generate_allowed
- Specifies to modify the database definitions so DCM generate can
use them.
- -handover_allowed
- Specifies to modify the database definitions to allow hand over
of control of objects to them.
- -hidden
- Specifies to mark specified database definitions as hidden so
that they do not appear in dialogs that list database identifiers.
This option is useful when you want to retire a database definition
without deleting it.
- -host host
- Specifies to modify the host for the specified database definitions.
This option is required for the remote copy and file transfer protocol
transfer modes. Be sure that the host a valid host
name or IP address for the databases..
- -location location
- Specifies to modify the geographic location of the specified database.
The location can be any string not containing newline characters.
- -new_dbid|-new_database_id new_dbid
- Specifies the new database ID that you want to assign to the specified
database definition. To learn about restricted characters and why
they are restricted, see Naming and formatting.
- -noar|-noautomatic_receive
- Specifies not to receive the transfer package automatically. Packages
must be received manually.
- -nohandover_allowed
- Specifies to modify the database definitions to disallow hand
over of control of objects to them.
- -nohidden
- Specifies to show the specified database definition in dialogs
that list database identifiers.
- -noga|-nogenerate_allowed
- Specifies to modify the database definitions so DCM generate cannot
use them.
- -norb|-norun_in_background
- Specifies not to run automatic receive in the background, if it
is being used.
If you are using automatic receive,
when DCM generate completes generating and transferring the package,
it starts a session on the destination database to start receiving
the package. If you are using -norun_in_background,
the generate operation waits for completion of the receive operation
and shows the results of the receive operation in the destination
database.
- -nozip
- Specifies not to compress the transfer packages for the specified
database. This option is the default for the direct transfer
mode. You cannot use this option with the file transfer protocol transfer
mode.
- -os|-operating_system (unix|(windows|windows_nt))
- Specifies to modify the operating system for the machine hosting
the database for the specified database definitions.
- -path path
- Specifies to modify the database path for the specified database
definitions. Use an absolute path for UNIX servers;
use a UNC path for Windows servers.
You must enter a database path value if you use a transfer mode other
than manual.
- -rb|-run_in_background
- Specifies to run automatic receive in the background, if it is
being used.
If you are using automatic receive,
when DCM generate completes generating and transferring the package,
it starts a session on the destination database to start receiving
the package. If you are using -run_in_background,
the generate option does not wait for completion of the receive option
and immediately returns. You do not have to wait for the transfer
package to be received to continue using your session, but the status
of the receive option is unavailable. You can view details of the
receive option later, in the DCM event log in the destination database.
- -tm|-transfer_mode value
- Specifies the transfer mode to be modified for the specified database
definition. The transfer mode defines the way transfer packages are
transferred to the destination database:
The -transfer_modeoption
must have one of these values:
- manual | manual_copy
The package is not copied by DCM and must be transferred
manually.
- cp | copy | local_copy
The package is generated and then copied to the destination
database transfer path.
- direct
The package
is generated directly into the destination database transfer path.
- ftp | file_transfer_protocol
The package is generated and then transferred to the
destination database transfer path using ftp.
- rcp | remote_copy
The
package is generated and then remote copied to the destination database
transfer path using rcp.
- user | user_defined
The
package is generated and then transferred by starting a user-customized
shell script (UNIX) or batch
file (Windows).
- -tp|-transfer_path transfer_path
- Specifies to modify the transfer path to the database for the
specified database definitions. The transfer path is the location
where Synergy places transfer packages. The path is an absolute path
for UNIX servers, and a UNC
path for Windows servers.
If you leave a transfer path blank, Synergy places the packages under
the dcm/receive directory under the database
path.
- -zip
- Specifies to compress the transfer packages for the specified
database. This option is the default for the file transfer protocol
transfer mode. You cannot use this option with direct.