START QMGR (start queue manager) on z/OS

Use the MQSC command START QMGR to initialize the queue manager. You can also use this command to prepare its data for backwards migration using the BACKMIG parameter.

Using MQSC commands on z/OS

For information on how you use MQSC commands on z/OS®, see Sources from which you can issue MQSC and PCF commands on IBM® MQ for z/OS.

You can issue this command from sources C. For an explanation of the source symbols, see Sources from which you can issue MQSC and PCF commands on IBM MQ for z/OS.

Syntax diagram for START QMGR
Usage notes for START QMGR
Parameter descriptions for START QMGR

Syntax diagram for START QMGR

Synonym: STA QMGR

START QMGR

Notes:

¹ MSTR is accepted as a synonym for ENVPARM

Usage notes for START QMGR

When the command has been completed, the queue manager is active and available to CICS®, IMS, batch, and TSO applications, unless you specify the BACKMIG parameter. If you specify the BACKMIG parameter, the queue manager shuts down and is ready for backwards migration, before becoming available to any applications.

If you specify the BACKMIG parameter, together with a value for backward-migration-target-vrm that is not valid, the queue manager ends abnormally.

The startup parameters QMGRPROD and AMSPROD indicate against which product that component should have its usage recorded.

You can specify the attribute for the queue manager:

As a parameter on the START QMGR command
As a part of the PARM on the EXEC PGM statement in the MSTR JCL procedure
As part of the compiled queue manager ZPARMS, using the CSQ6USGP macro
As a default value if not specified elsewhere.

If you specify the attribute by more than one of the above mechanisms, the order of the items in the preceding list defines the order of precedence from highest to lowest. The default value is used if you do not explicitly specify an attribute.

If you specify an attribute that is not valid, an error message is issued and queue manager startup ends.

Parameter descriptions for START QMGR

These are optional.

ENVPARM( jcl-substitution )

The parameters and values to be substituted in the JCL procedure (xxxxMSTR, where xxxx is the queue manager name) that is used to start the queue manager address space.

jcl-substitution

One or more character strings of the form:

keyword=value

enclosed in single quotation marks. If you use more than one character string, separate the strings by commas and enclose the entire list in single quotation marks, for example ENVPARM('HLQ=CSQ,VER=520').

MSTR is accepted as a synonym for ENVPARM

PARM( member-name )

The load module that contains the queue manager initialization parameters. member-name is the name of a load module provided by the installation.

The default is CSQZPARM, which is provided by IBM MQ.

QMGRPROD

Specifies the product ID against which the queue manager usage is to be recorded. The value can be one of the following:

MQ: The queue manager is a stand-alone IBM MQ for z/OS product, with product ID 5656-MQA.; This is the default value.
VUE: The queue manager is a stand-alone VUE product, with product ID 5656-VUA.
ADVANCEDVUE: The queue manager is part of an IBM MQ Advanced for z/OS Value Unit Edition product, with product ID 5656-AVA.

AMSPROD

Specifies the product ID against which the queue manager usage is to be recorded. The value can be one of the following:

ADVANCED: AMS is part of an IBM MQ Advanced for z/OS product, with product ID 5656-ADA. This is the default value, unless the attribute for the queue manager indicates IBM MQ Advanced for z/OS Value Unit Edition.
ADVANCEDVUE: AMS is part of an IBM MQ Advanced for z/OS Value Unit Edition product, with product ID 5656-AVA. This is the default value, if the attribute for the queue manager is also ADVANCEDVUE.

BACKMIG( backward-migration-target-vrm )

The queue manager is to start up and perform backward migration actions such that it can be restarted at the backward-migration-target-vrm, and then the queue manager is to shut down without ever being available to any applications.

backward-migration-target-vrm: The version, release and modification number for the target version for backward migration, for example 930. Backward migration to this release must be allowed.; The release, if any, to which backward migration is allowed, is indicated in the CSQY039I message at queue manager start up. If the CSQY039I message is not emitted, backward migration is not supported to any release.
Attention: Follow the process documented in Reverting a queue manager to a previous version on z/OS when using the BACKMIG parameter.