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
- *YES
- Start the channel initiator, command server, listeners and services when the queue manager is started.
- *NO
- Do not start the channel initiator, command server, listeners or services when the queue manager is started.
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