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
mdelcell syntax
[-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
Option | Description |
---|---|
-k | Keeps tmp, var, and log directories of the cell |
-wTimeOut | Specifies the length of time, in seconds, for the command to wait before terminating the cell. |
mdelcell example
The following example deletes a cell named grace.
Deleting a cell using mdelcell
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
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
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
Code | Description |
---|---|
-1 | Uname command failed |
31 | No installationDirectory/pw/server environment variable is defined |
40 | Working directory is inside a directory to be removed |