setmqsize (increase queue manager file system size)

Increase the size of the file system allocated to a queue manager.

Purpose

When a queue manager is created, it is allocated file system space. This is 64 GB by default, but you can specify a different value if required when you create the queue manager. If you subsequently require a larger file system for that queue manager, you can expand it by using the setmqsize command.

Note: If you want to reduce a queue manager's file system size, you can back up the queue manager, delete it, then restore it specifying a smaller file system. See mqbackup: back up queue manager and mqrestore: restore queue manager from back up.

Syntax

Read syntax diagramSkip visual syntax diagram setmqsize -m QMname -s size

Parameters

-m QMName
Specifies the name of the queue manager that you want to expand the file system for.
This parameter is required.
-s size
Specifies the new size of the file system. Specify a positive integer with an optional M or G suffix to indicate megabytes or gigabytes. The value is taken as gigabytes if you do not specify otherwise.
This parameter is required.

Usage notes

  • This command must be run from the IBM® MQ administration mode. If the system is in the IBM MQ administration mode the prompt includes mqa(mqcli)#. To enter the IBM MQ administration mode, enter mqcli on the command line. To exit the IBM MQ administration mode, enter exit on the command line.
  • This command cannot be run on a queue manager that belongs to a high availability (HA) or disaster recovery (DR) configuration. If you require to expand the file system of an HA or DR queue manager, you must remove it from the HA or DR configuration, expand the file system size, then re-add it to the HA or DR configuration.
  • The queue manager must be stopped before the command is run.
  • The new size of the file system must be greater than or equal to the current file system size.
  • Resizing file space for a queue manager does involve some I/O, and might degrade the performance of other queue managers while the resize is in progress.

Examples

  • The following command expands the file storage for the queue manager QM1 to 128 GB. 
    setmqsize -m QM1 -s 128G

Related commands