imsimta cache (Sun Java System Messaging Server 6.3 Administration Reference)

Sun Java System Messaging Server 6.3 Administration Reference

imsimta cache

The MTA maintains an in-memory cache of all the messages currently stored in its queues. This cache is called the queue cache. The purpose of the queue cache is to make dequeue operations perform more efficiently by relieving master programs from having to open every message file to find out which message to dequeue and in which order.

Syntax

imsimta cache -change -parameter | -sync | -view [channel]

Options

The options for this command are:

Option	Description
`-change –global –debug=integer`	Allows debugging for the job controller on the fly.
`-change –global –max_messages=integer`	Allows setting the maximum number of messages for the job controller on the fly.
`-change –channel_template=name` `master_job=command`	Allows changing the channel template for the job controller on the fly. Changing parameters for a channel template (e.g., tcp_*) changes that parameter for all channels derived from that template.
`-change –channel_template=name` `slave_job=command`	Allows changing the channel template for the job controller on the fly. Changing parameters for a channel template (e.g., tcp_*) changes that parameter for all channels derived from that template.
`-change –channel=name` `master_job=command`	Allows changing the master job for the job controller on the fly.
`-change –channel=name` `slave_job=command`	Allows changing the slave job for the job controller on the fly.
`-change –channel=name` `thread_depth=integer`	Allows setting the thread depth for the job controller on the fly.
`-change –channel=name` `job_limit=integer`	Allows setting the job limit for the job controller on the fly.
`-sync`	Updates the active queue cache by updating it to reflect all non-held message files currently present in the `/msg-svr-base/imta/queue/` subdirectories. Note that the `-sync` option does not remove entries from the queue cache. The queue cache entries not corresponding to an actual queued message are silently discarded by channel master programs.
`-view` [`channel`]	Shows the current non-held entries in the MTA queue cache for a channel. channel is the name of the channel for which to show entries. This is a potentially expensive command if you have a large backlog of messages.
`-walk [-debug=xxx]`	Used to diagnose potential problems with the job controller. Each time this command is run, the internal state of the message queues and job scheduling information is written to the `job_controller.log` file. In addition, the job controller debug mask is set to the value given. You should not run this command unless you are instructed to do so by support.

Examples

To synchronize the queue cache:

imsimta cache -sync

To view entries in the queue cache for the tcp_local channel, execute the command:

imsimta cache -view tcp_local