mcontrol examples

mcontrol can be used as shown in the following examples.

Retrying pending propagations

To retry pending propagations for a cell named grace, type the following command:

mcontrol -n grace -v prop

The following example shows the possible output:

Command on server grace acknowledged 

Terminating a cell

To terminate a cell named grace, enter the following command:

mcontrol -n grace -v stop

The following example shows the possible output:

Command on server grace acknowledged 

Enabling and disabling cell tracing

To enable tracing for a cell named grace, enter the following command:

mcontrol -n grace tracerule on

To disable tracing for a cell named grace, enter the following command:

mcontrol -n grace tracerule off

Reconfiguring a cell

To reconfigure cell grace after mcell.dir has been modified, type the following command:

mcontrol -n grace reload dir

The following example shows the possible output:

Command on server grace acknowledged 

The cell grace reconfigures without stopping and restarting.

Reloading mcell.dir and tracing the configuration

To reconfigure cell grace after mcell.dir has been modified, type the following command:

mcontrol -n grace reload dir trace

An event of class MC_CELL_RELOADED is generated. To retrieve the generated reload event, enter the following:

mquery -n grace -a MC_CELL_RELOADED -s class,event_handle,msg,category -f BAROC MC_CELL_RELOADED;
event_handle=16;
msg='Reloaded configuration';
category=[DIR,TRACE];
END