Home
Log defaults for WebSphere MQ
Use the Default log settings WebSphere MQ properties page from the WebSphere MQ Explorer, or the LogDefaults stanza in the mqs.ini file to specify information about log defaults for all queue managers. The log attributes are used as default values when you create a queue manager, but can be overridden if you specify the log attributes on the crtmqm command. See crtmqm (create queue manager) for details of this command.
Once a queue manager has been created, the log attributes for that queue manager are taken from the settings described in Queue manager logs.
The default prefix (specified in All queue managers) and log path specified for the particular queue manager (specified in Queue manager logs) allow the queue manager and its log to be on different physical drives. This is the recommended method, although by default they are on the same drive.
For information about calculating log sizes, see Calculating the size of the log.
The limits given in the following parameter list are limits set by WebSphere MQ. Operating system limits might reduce the maximum possible log size.
- LogPrimaryFiles=3|2-254 (Windows)|2-510 (UNIX systems)
- The log files allocated when the queue manager is created.
The minimum number of primary log files we can have is 2 and the maximum is 254 on Windows, or 510 on UNIX systems. The default is 3.
The total number of primary and secondary log files must not exceed 255 on Windows, or 511 on UNIX systems, and must not be less than 3.
The value is examined when the queue manager is created or started. We can change it after the queue manager has been created. However, a change in the value is not effective until the queue manager is restarted, and the effect might not be immediate.
- LogSecondaryFiles=2|1-253 (Windows)|1-509 (UNIX systems)
- The log files allocated when the primary files are exhausted.
The minimum number of secondary log files is 1 and the maximum is 253 on Windows, or 509 on UNIX systems. The default number is 2.
The total number of primary and secondary log files must not exceed 255 on Windows, or 511 on UNIX systems, and must not be less than 3.
The value is examined when the queue manager is started. We can change this value, but changes do not become effective until the queue manager is restarted, and even then the effect might not be immediate.
- LogFilePages=number
- The log data is held in a series of files called log files. The log file size is specified in units of 4 KB pages.
In WebSphere MQ for UNIX systems, the default number of log file pages is 1024, giving a log file size of 4 MB. The minimum number of log file pages is 64 and the maximum is 65 535.
In WebSphere MQ for Windows, the default number of log file pages is 256, giving a log file size of 1 MB. The minimum number of log file pages is 32 and the maximum is 65 535.
The size of the log files specified during queue manager creation cannot be changed for a queue manager.
- LogType=CIRCULAR|LINEAR
- The type of log to be used. The default is CIRCULAR.
- CIRCULAR
- Start restart recovery using the log to roll back transactions that were in progress when the system stopped.
See Circular logging for a fuller explanation of circular logging.
- LINEAR
- For both restart recovery and media or forward recovery (creating lost or damaged data by replaying the contents of the log).
See Linear logging for a fuller explanation of linear logging.
If you want to change the default, you can either edit the LogType attribute, or specify linear logging using the crtmqm command. We cannot change the logging method after a queue manager has been created.
- LogBufferPages=0|0-4096
- The amount of memory allocated to buffer records for writing, specifying the size of the buffers in units of 4 KB pages.
The minimum number of buffer pages is 18 and the maximum is 4096. Larger buffers lead to higher throughput, especially for larger messages.
If you specify 0 (the default), the queue manager selects the size. In WebSphere MQ V6.0 this is 128 (512 KB).
If you specify a number between 1 and 17, the queue manager defaults to 18 (72 KB). If you specify a number between 18 and 4096, the queue manager uses the number specified to set the memory allocated.
The value is examined when the queue manager is created, and might be increased or decreased at either of these times. However, a change in the value is not effective until the queue manager is restarted.
- LogDefaultPath=directory_name
- The directory in which the log files for a queue manager reside. The directory resides on a local device to which the queue manager can write and, preferably, on a different drive from the message queues. Specifying a different drive gives added protection in case of system failure.
The default is:
- <DefaultPrefix>\log for WebSphere MQ for Windows where <DefaultPrefix> is the value specified on the DefaultPrefix attribute on the All Queue Managers WebSphere MQ properties page. This value is set at install time.
- /var/mqm/log for WebSphere MQ for UNIX systems
Alternatively, we can specify the name of a directory on the crtmqm command using the -ld flag. When a queue manager is created, a directory is also created under the queue manager directory, and this is used to hold the log files. The name of this directory is based on the queue manager name. This ensures that the log file path is unique, and also that it conforms to any limitations on directory name lengths.
If you do not specify -ld on the crtmqm command, the value of the LogDefaultPath attribute in the mqs.ini file is used.
The queue manager name is appended to the directory name to ensure that multiple queue managers use different log directories.
When the queue manager is created, a LogPath value is created in the log attributes in the configuration information, giving the complete directory name for the queue manager’s log. This value is used to locate the log when the queue manager is started or deleted.
- LogWriteIntegrity=SingleWrite|DoubleWrite|TripleWrite
- The method the logger uses to reliably write log records.
- SingleWrite
- Some hardware guarantees that, if a write operation writes a page and fails for any reason, a subsequent read of the same page into a buffer results in each byte in the buffer being either:
- The same as before the write, or
- The byte that should have been written in the write operation
On this type of hardware (for example, ssa write cache enabled), it is safe for the logger to write log records in a single write as the hardware assures full write integrity. This method provides the highest level of performance.
- DoubleWrite
- The DoubleWrite method was the default method used in WebSphere MQ V5.2 and is available for back-compatibility purposes only.
- TripleWrite
- This is the default method. Where hardware that assures write integrity is not available, write log records using the TripleWrite method because it provides full write integrity.
Parent topic:
Attributes for changing WebSphere MQ configuration information
fa12570_
Home