[AIX, Linux, Windows]

Changing your queue manager log from circular to linear

You can change your queue manager log type from circular to linear by using the migmqlog command.

Before you begin

Decide whether you want to use linear or circular logging by reviewing Types of logging.

Decide whether you want to change your log type in place, or move the log to a new location. When you move the log to a new location by using the migmqlog command, the log path in the qm.ini file is updated so that when you start your queue manager it uses the changed log. You can specify a new location by using the -ld option. If you are moving your queue manager from an old disk to a new Advanced Format disk, it might be convenient to use the -ld option.

About this task

Attention: After you have changed your log, a media image will not have been recorded when the queue manager starts. Plan how you intend to record media images, either automatically by setting the attributes:
  • IMGSCHED
  • IMGINTVL
  • IMGLOGLN
  • IMGRCOVO
  • IMGRCOVQ
in ALTER QMGR, or manually by periodically running rcdmqimg.

Procedure

  1. Login as a member of the mqm group.
  2. Ensure that you have enough space to change your log. The space that is used by a linear log increases continuously as data is logged.
  3. If you have already not done so, stop the queue manager by using the endmqm -w command.
  4. If you have not already done so, take a backup of your queue manager.
    For more information, see Backing up queue manager data, and Backing up configuration files after creating a queue manager.
  5. Run the migmqlog command. Note that migmqlog might take some minutes to complete if your log is very large. However, the command outputs progress messages from time to time.
    • If you choose to change your log type without changing the location of the log, use the following command:
      migmqlog -m QMgrName -ll
    • If you choose to change your log type and move the log to a new location, use the following command:
      migmqlog -m QMgrName -ll -ld NewLogLocation
      where NewLogLocation is an absolute file path that specifies the new location for the log file. Do not use a relative file path with the -ld parameter.
    For more information, see migmqlog.
    If, for any reason, for instance due to a power outage, migmqlog command stops before it has completed the process, rerun the same migmqlog command on the partially changed logs to complete the changes.
  6. Start the queue manager, and set the appropriate image recovery and queue attributes for your environment.
  7. Consider when to record manual images for objects that are recoverable.