migmqlog (migrate IBM MQ logs)
The migmqlog command migrates logs, and can also change the type of your queue manager logs from linear to circular or from circular to linear.
migmqlog is not supported on IBM i or z/OS .
Usage notes
On Windows, running migmqlog enables you to move your queue manager logs to an Advanced Format disk
migmqlog can only run when the queue manager is inactive.
If the running of migmqlog is interrupted by, for example, a power failure, we should be rerun the same command until it completes normally.
A partially migrated log can not be used to start a queue manager, and the result of attempting to do so is not well defined.
migmqlog migrates logs 'in place', or migrates logs to a new location. When logs are migrated to a new log location, no change is made to any existing log files and all valid recovery log files in the old location are migrated to the new location.
migmqlog updates the qm.ini file to reflect the new log configuration, that is, LogType and LogPath, as needed.
Following any log migration, the log is configured such that all future log writes occur with 4096 byte alignment, at minimum.
For further information on migrating logs on Windows to be Advanced Format, see Migrating logs to an Advanced Format disk.
See Types of logging for more information about linear and circular logging.
Syntax
Required parameters
- -m QMgrName
- The name of the queue manager on which to migrate logs.
Optional parameters
- -ld New log path
- If you specify -ld and do not point to the existing log location, migration will be to a new log location.
- -ll
- If you pass -ll to the command, and the queue manager is currently defined to be using circular logging, the queue manager will be reconfigured to use linear logging.
- -lc
- If you pass -lc to the command, and the queue manager is currently defined to be using linear logging, the queue manager will be reconfigured to use circular logging.
Parent topic: IBM MQ control commands reference
Related information
- Migrating the log of our queue manager from linear to circular
- Migrating the log of our queue manager from circular to linear