Start Message Queue Manager (STRMQM)

    Where allowed to run
    All environments (*ALL)

    Threadsafe
    Yes

The Start Message Queue Manager (STRMQM) command starts the local queue manager.


Parameters

Keyword Description Choices Notes
MQMNAME Message Queue Manager name Character value, *DFT Optional, Positional 1
RDEFSYS Redefine system objects *YES, *NO Optional, Positional 2
FIXDIRS Fix directories *YES, *NO Optional, Positional 3
STRSTSDTL Startup Status Detail *ALL, *MIN Optional, Positional 4
STRSVC Service startup *YES, *NO Optional, Positional 5
REPLAY Perform replay only *YES, *NO Optional, Positional 6
ACTIVATE Activate backup *YES, *NO Optional, Positional 7
STANDBY Permit Standby Queue Manager *YES, *NO Optional, Positional 8


Message Queue Manager name (MQMNAME)

>

Specifies the name of the message queue manager.

The possible values are:

    *DFT
    Use the default queue manager.

    queue-manager-name
    Specify the name of the queue manager. The name can contain up to 48 characters. The maximum number of characters is reduced if the system is using a double byte character set (DBCS).


Redefine system objects (RDEFSYS)

>

Specifies whether the default and system objects are redefined.

    *NO
    Do not redefine the system objects.

    *YES
    Starts the queue manager, redefines the default and system objects, then stops the queue manager. Any existing system and default objects belonging to the queue manager are replaced if you specify this flag.


Fix directories (FIXDIRS)

>

Specifies whether missing or damaged queue manager directories are re-created.

    *NO
    Do not re-create any missing queue manager directories. If any damaged or missing directories are encountered during startup, the startup attempt will report an error and the STRMQM command will end immediately.

    *YES
    Starts the queue manager and if required re-creates any damaged or missing directories. This option should be used when performing media recovery of a queue manager.


Startup Status Detail (STRSTSDTL)

>

Specifies the detail of status messages that are issued while starting the queue manager.

    *ALL
    Display all startup status messages. This level of detail includes periodically displaying messages detailing transaction recovery and log replay. This level of detail can be useful in tracking queue manager startup progress following the abnormal termination of a queue manager.

    *MIN
    Displays a minimum level of status messages.


Service startup (STRSVC)

>

Specifies whether the additional following QMGR components are started when the queue manager is started:

  • The Channel Initiator
  • The Command Server
  • Listeners with CONTROL set to QMGR or STARTONLY
  • Services with CONTROL set to QMGR or STARTONLY


Perform replay only (REPLAY)

>

Whether the queue manager is being started to perform replay only. This enables a backup copy of a queue manager on a remote machine to replay logs created by the corresponding active machine, and to allow the backup queue manager to be activated in the event of a disaster on the active machine.

    *NO
    The queue manager is not being started to perform replay only.

    *YES
    The queue manager is being started to perform replay only. The STRMQM command will end when replay is complete.


Activate backup (ACTIVATE)

>

Specifies whether to mark a queue manager as active. A queue manager that has been started with the REPLAY option is marked as a backup queue manager and cannot be started before it has been activated.

    *NO
    The queue manager is not to be marked as active.

    *YES
    The queue manager is to be marked as active. Once a queue manager has been activated then it can be started as a normal queue manager using the STRMQM command without the REPLAY and ACTIVATE options.


Permit Standby Queue Manager (STANDBY)

>

Specifies whether the queue manager can start as a standby instance if an active instance of the queue manager is already running on another system. Also specifies whether this instance of the queue manager will permit standby instances of the same queue manager on other systems in preparation for failover.

    *NO
    The queue manager is started normally.

    *YES
    The queue manager is permitted to start as a standby instance, and it permits other standby instances of the same queue manager to be started.


Examples

>

None


Error messages

>

Unknown

Parent topic: CL commands reference for IBM i