General Options
|
Description
|
INTERFACE_ADDRESS=adapter
|
Specifies the IP address interface to which the Job Controller should bind.
The value specified (adapter) can be one of ANY, ALL, LOCALHOST, or an IP address. By default the Job Controller binds to all
addresses (equivalent to specifying ALL or ANY).
Specifying INTERFACE_ADDRESS=LOCALHOST means that the Job Controller
only accepts connections from within the local machine. This does not affect normal
operation, since no inter-machine operation is supported by the Job Controller. However,
this may be inappropriate in an HA environment where an HA agent may be checking if
the Job Controller is responding. If the machine on which the Messaging Server is
running is in an HA environment, has an “internal network” adapter and
an “external network” adapter, and you are not confident of your firewall’s
ability to block connections to high port numbers, you should consider specifying
the IP address of the “internal network” adapter.
|
MAX_MESSAGES=integer
|
The Job Controller keeps information about messages in an in-memory structure.
In the event that a large backlog builds, it may need to limit the size of this structure.
If the number of messages in the backlog exceeds the parameter specified here, information
about subsequent messages is not kept in memory. Mail messages are not lost because
they are always written to disk, but they are not considered for delivery until the
number of messages known by the Job Controller drops to half this number. At this
point, the Job Controller scans the queue directory mimicking an imsimta
cache -sync command.
The default is 100000.
|
SECRET=file_spec
|
Shared secret used to protect requests sent to the Job Controller.
|
SYNCH_TIME=time_spec
|
The Job Controller occasionally scans the queue files on disk to check for missing
files. By default, this takes place every four hours, starting four hours after the
Job Controller is started. The format of the time_spec is HH:MM/hh:mm or /hh:mm. The variable hh.mm is the interval
between the events in hours (h) and minutes (m). The variable HH:MM is the first time in a day the even should take place. For example
specifying, 15:45/7:15 starts the event at 15:45 and every seven hours and fifteen
minutes from then.
|
TCP_PORT=integer
|
Specifies the TCP port on which the Job Controller should listen for request
packets. Do not change this unless the default conflicts with another TCP application
on your system. If you do change this option, change the corresponding IMTA_JBC_SERVICE option in the MTA tailor file, msg_svr_base/config/imta_tailor, so that it matches. The TCP_PORT option
applies globally and is ignored if it appears in a [CHANNEL] or
[POOL] section.
|
Pool Option
|
Description
|
JOB_LIMIT=integer
|
Specifies the maximum number of processes that the pool can use simultaneously
(in parallel). The JOB_LIMIT applies to each pool individually;
the maximum total number of jobs is the sum of the JOB_LIMIT parameters
for all pools. If set outside of a section, it is used as the default by any [POOL] section that doesn’t specify JOB_LIMIT. This
option is ignored inside of a [CHANNEL] section.
|
Channel Option
|
Description
|
MASTER_COMMAND=file_spec
|
Specifies the full path to the command to be executed by the UNIX system process
created by the Job Controller to run the channel and dequeue messages outbound on
that channel. If set outside of a section, it is used as the default by any [CHANNEL] section that doesn’t specify a MASTER_COMMAND.
This option is ignored inside of a [POOL] section.
|
MAX_LIFE_AGE=integer
|
Specifies the maximum life time for a channel master job in seconds. If this
parameter is not specified for a channel, then the global default value is used. If
no default value is specified, 14400 (240 minutes) is used.
|
MAX_LIFE_CONNS=integer
|
In addition to the maximum life age parameter, the life expectancy of a channel
master job is limited by the number of times it can ask the Job Controller if there
are any messages. If this parameter is not specified for a channel, then the global
default value is used. If no default value is specified, 300 is used.
|
SLAVE_COMMAND=file_spec
|
Specifies the full path to the command to be executed by the UNIX system process
created by the Job Controller in order to run the channel and poll for any messages
inbound on the channel. Most MTA channels do not have a SLAVE_COMMAND. If that is the case, the reserved value
NULL should be specified. If set outside of a section, it is used as the default by
any [CHANNEL] section that doesn’t specify a SLAVE_COMMAND. This option is ignored inside of a [POOL] section.
|