rmdm - Remove drive manager

Purpose

Remove a drive manager (DM) object from the TSLM database. This allows the removal of DM entries that are no longer used. If the DM object to remove is currently referenced by a drive entry, the drive object first must be changed (see lsdrive - List drives and chdrive - Change drive attributes).

Syntax

rmdm [drivemanager_name [...] | -host host_name | -lib library_name | 
-regex pattern]

Parameters

drivemanager_name
Specifies the name of the drive manager to be removed. Multiple names must be separated with a blank character between each name.
-host host_name
Specifies the host for which all drive managers should be removed.
CAUTION:
Avoid accidental deletion of drive managers.
-lib library_name
Specifies the library for which all drive managers should be removed.
CAUTION:
Be careful to not accidentally delete drive managers.
-regex pattern
Specifies a regular expression that describes the name of the drive manager that should be removed.
Note: Quoting is required to ensure correct shell processing.

Results

Beyond the general error code, the following command-specific error codes are returned:

  • EMM1610E - if a drive manager could not be deleted because of existing references.
  • EMM1604E - in case the drive manager(s) specified by name, regex or match option could not be found.

Limitations

Deletion Semantics: DM objects cannot be deleted until all corresponding DRIVE objects no longer reference the DM object.

Examples

rmdm MyTS3500-256@127.0.0.1

Related commands