Artifact deletion

Command-line interface command: gdmdelete

Description

Use this command to delete managed and unmanaged design artifacts from the work area. The element history is preserved.

In a multisite scenario, the delete operation leverages the synchronous request for mastership (SRFM) feature if required. You must enable polling to delete artifacts automatically. For more information about polling, see Artifact check-ins.

-cdslib file

This option specifies the library definition file to use for mapping library names to library directories.

-local

This option is not supported in the integration. A delete operation always removes the elements for all the users who are working on the branch on which the delete operation was performed.

-help

This option displays information about this command and its arguments.

-keepunmanaged

This option filters unmanaged files from the deletion list. For example, if cell1 contains cellviews cv1 and cv2, which are managed, and cv3, which is unmanaged, then the gdmdelete –keepunmanaged –lib lib.cell1 command deletes cv1 and cv2 only.

-lib lib.cell:view/file

This option specifies which library elements to delete. Names that are listed without the -lib or –file option are treated as -file arguments.

-file file

This option specifies the files and directories (nonlibrary elements) to delete. Names that are listed without the -lib or –file option are treated as -file arguments.

-xtra str

This option allows additional arguments that are specific to the design management (VersionVault) delete command to be passed through the gdmdelete command.

Supported -xtra arguments

By default, a deletion comment is created. You can specify a comment option to override the default comment with this command:

–c/omment comment | –cfi/le comment-file-pname | –nc/omment

User interface actions for artifact deletion

In the user interface, you delete artifacts in two areas:

• File and category artifacts
• Library, cell, and view artifacts

You can delete the managed and unmanaged files and categories in a library whose DMTYPE assignment is vvault by using the Delete menu.

Both the Delete Local and Inactive from DM system and Delete Local Only options are treated alike. Both start the HCL VersionVault rmname (uncatalog) operation.

You can delete the managed and unmanaged cells, views, and the library itself. From the Library Manager window, open both the VersionVault Delete menu and the Delete menu from VersionVault Work Area Manager (WAM). In the VersionVault Delete dialog box that opens, two deletion modes are offered: Delete Name (Uncatalog) and Delete from VersionVault (Destroy).

• Delete Name (Uncataloged) starts a nondestructive deletion by using the HCL VersionVault rmname command.
• Delete From VersionVault (Destroy) starts a deletion and complete removal process. Before the operation starts, you must confirm that the deletion action of the operation is irreversible. After you confirm understanding, the HCL VersionVault rmelem runs on the specified context.