Cache -change utility

Change Job Controller option effective values  for the currently running Job Controller  process.

Syntax
imsimta cache -change

Parameters
None.

Description
(New in MS 6.2.) The  utility is  used to change various  Job Controller option effective values  "on the fly"  (that is, without requiring a  restart of the Job Controller in order to  take effect) for the currently running  Job Controller process.

Exactly one of,  , or    must be specified. is for changing the behavior or definition of a  particular channel: changing  its effective     or    , or its      or. is for adding a new type of channel, or for  changing the definition of all channels of that type: (re)defining its      and/or. is for setting certain global Job Controller options:  ,    , or (6.2p2  and later?).

Note that restarting the Job Controller is very much to be avoided on a  production MTA that has messages already in its queues. So for certain sorts of Job Controller configuration changes that one might want to  make on a running MTA, especially configuration changes to trace down  problems (debugging) or re-deploy resources at times of heavy load  (change channel    via   or  channel    via , or  define new channels which  one has added to the configuration to deal with additional load), it is  desirable to make such changes "on the fly". This utility exists to allow making those changes that are both desirable, and  feasible without too much disruption to existing Job Controller data  structures.

Change a configuration setting for an existing channel, or inform the  Job Controller of the name of a new channel (of a valid,  already defined type)  that has been added to the configuration.

Set a debug level for Job Controller operation. must be specified in order to use.

Set certain global Job Controller options.

,
directs the Job Controller to rebuild the message list in order. The  switch must be specified in order to use. (the default) means to not rebuild the queues in order: to simply insert messages into the queue cache in whatever order they are encountered while scanning the queue area.

The  switch must be specified in order to use   ; override the effective  /   for the specified  channel.

Override the effective  value,  or any previously set    value. must be specified in order to use.

Specify the command to execute (channel program to run) for the master  direction of a channel. This switch may be used either with the   switch, to set the value for a  particular channel,  or with the   switch, to set the value for a  class of channels.

Specify the command to execute (channel program to run) for the  slave direction of a channel. This switch may be used either with the   switch, to set the value for a  particular channel,  or with the   switch, to set the value for a  class of channels.

Override the value of the   Job Controller option. must be specified in order to use.

Define a new type of channel, or redefine an existing type of channel. If redefining an existing type, all channels derived from that template are affected. The argument to   should be a channel pattern; e.g.,.

The   switch must be specified  in order to use   ; override the  effective    for  the specified channel.

Examples
The above (UNIX) command turns on Job Controller debugging, at level 7.: This command informs the Job Controller of a new  channel  that has been added to the configuration (in Unified Configuration, added using    via an   command or via appropriate   commands; in legacy configuration, added to the   file). That is, this   command does not in and of itself define the channel -- definition of the channel must be performed as normal; however, this command informs the Job Controller of the new channel, so that the Job Controller will know to begin running the channel, as needed.
 * 1) imsimta cache -change -global -debug=7
 * 1) imsimta cache -change -channel=tcp_special

See also:
 * Job Controller options
 * Job Controller
 * Channels
 * channel_class
 * debug Option