gdmci

Checks in files and registers unmanaged files

Applicability

Product

Command type

VersionVault integration with Cadence Virtuoso

Integration-specific command

Platform

UNIX

Linux

Synopsis

gdmci [ –cdslib filename ] [–recurse ] [ –xtra string ] [ –initial ]
[ –description string | –dfile filename ] [ –help ]

[ –lib lib.cell:view/file ] [–file filename ] ...

Description

This command checks in checked-out files or registers and checks in unmanaged files to the repository so that the files can be shared. Co-managed files in a view are always checked in as a group. Co-managed set behavior applies only when directories or files are specified as library elements; that is, with the -lib option. An atomic checkin operation is the default; however the VOB must be enabled for atomic checkin for that operation to succeed (see the protectvob reference page).

Check-in polling (replicated VOBs)

If synchronous request for mastership (SRFM) is enabled (by the protectvob command), then you can set the following environment variables to control check-in polling:
  • CCASE_CDS_POLL_CI EV enables check-in polling when set to TRUE
  • CCASE_CDS_POLL_CI_TIMEOUT sets the poll timeout in seconds (default: 90)
  • CCASE_CDS_POLL_CI_INTERVAL sets the polling interval in seconds (default: 30)

If the value of CCASE_CDS_POLL_CI_TIMEOUT is less than the value of CCASE_CDS_POLL_CI_INTERVAL, then  CCASE_CDS_POLL_CI_TIMEOUT is set to the value of CCASE_CDS_POLL_CI_INTERVAL, with the result that a single check-in attempt is made after CCASE_CDS_POLL_INTERVAL seconds have elapsed.

Cancelling checkouts that would result in identical versions if checked in

When set to TRUE, the environment variable CCASE_CDS_CANCEL_IDENTICAL causes a checkin operation to cancel the checkout of a version that would be identical to its predecessor if it were to be checked in. Default: FALSE.

Options and arguments

–cdslib filename
Specifies the library definition file that maps library names to library directories.
–recurse
If a non-library specification is a directory name, the entire directory hierarchy is selected. (By default, only files and directories immediately below the specified directory are selected.)
–xtra string
Specifies arguments that are to be passed to cleartool checkin (–nwarn, –keep | -rm, –ptime, –identical) or to cleartool mkelem (–eltype , –master). The string argument must be enclosed in quotation marks if there is a space in the string.
  • –nwarn
  • –keep | -rm
  • –ptime
  • –identical
  • –eltype (specify only with –initial)
  • –master (specify only with –initial)
–initial
Checks in all specified files and registers files that were previously unmanaged. If unspecified, new or unmanaged files that are members of a registered co-managed set are checked in.
–description string
Specifies a comment for the checkin operation.
–dfile file
Use this option to enter a multiline comment for the checkin operation.
–help
Displays the command synopsis.
–lib lib.cell:view/file
Library elements to check in. Names listed without -lib or -file are treated as -file arguments.
–file file
Files and directories (nonlibrary elements) to be checked in.