mcell

The mcell command starts a specified cell.

mcell syntax

The following figure shows the syntax for mcell.

mcell [-h|-?] [-z] [-q] [-d] [-r] [-n <cellName>] [-l <HomeLocation>] [-c <ConfigFile>] {-p <Var Value>}

Note

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

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

mcell options

Option

Description

-c

Specifies a configuration file other than the default. If -c is used, all configuration files are assumed to be in the directory in which the specified configuration file is located.

-d

Runs in foreground instead of as a service or daemon

-r

Runs in cell recovery mode

mcell examples

On UNIX or Linux, mcell can be started from a command prompt as a daemon (running in background) or as a terminal program (running in foreground).

On Microsoft Windows, mcell can be started from a command prompt as a service or as a terminal program.

You can start the cell by using any of the following methods:

  • To start the cell in the foreground rather than as a service or daemon on UNIX and Microsoft Windows platforms, run the following command:

    mcell -n <cellName> -d
  • To start the cell as a service on a Microsoft Windows platform, run the following command:

    net start mcell_<cellName>

    When started from the command prompt without the -d option, mcell contacts the Service Control Manager to start itself as a service. It uses mcell_cellName as the service name, with the cell name as specified with the -n option. Without the -n option, the host name is taken as cellName.

mcell return codes

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

mcell return codes

Code

Description

2

Bad home directory option usage

3

No home directory specified

4

Invalid home directory specification

5

Application system initialization failed

19

Logging facility initialization failed

29

Knowledge Base load failed

37

Message handling module initialization failed

39

Internal object initialization failed

47

Event processing module initialization failed

49

Save state reload failed

57

Query handling module initialization failed

59

Service activation failed

67

Internal event module initialization failed

69

Metrics initialization failed

77

Data processing module initialization failed

79

Metrics activation failed

97

Service setup failed

Was this page helpful? Yes No Submitting... Thank you

Comments