mdelcell

Use mdelcell to delete a specified cell on the local computer. Deleting a cell by using the mdelcell command removes the cell and its entry in the mcell.dir file. You can use this command only locally on the computer where the cell resides. Running this command results in the following actions: 

• Removes the entry in the mcell.dir file 
• Deletes the etc\cellName directory 

• Removes the entry from the services on Microsoft Windows or the startup scripts on UNIX

  Note

  Cell names are case-sensitive for UNIX operating systems. When you run the mdelcell command on a UNIX operating system, ensure that you enter the cell name by using the correct case. If the cell name entered with mdelcell is not the same case as the cell name that you want to delete, mdelcell will not remove the cell entries from mcell.dir.

mdelcell syntax

mdelcell -n <cellName> [-z]
[-h|?] [-k] [-w <TimeOut>]

The following table lists the command-specific options for mdelcell. For a list of common command options that apply to all CLI commands, see Event management common command options.

mdelcell options

mdelcell example

The following example deletes a cell named grace.

Deleting a cell using mdelcell

mdelcell -n grace

If grace is not currently running, this command produces output similar to the example shown in the following figure on Microsoft Windows platforms:

Output for mdelcell if cell is not running

Service successfully removed

On UNIX platforms, the command does not produce output when it runs successfully.

If grace is currently running, this command produces output similar to the example shown in the following figure.

Output for mdelcell if cell is running

Warning! Cell grace was running and mdelcell tries to terminate it.
Service successfully removed.

mdelcell return codes

The following table lists the command-specific return codes for mdelcell. For a list of common return codes that apply to all CLI commands, see Event management return codes.

mdelcell return codes