![[z/OS]](ngzos.gif)
START QMGR (start queue manager) on z/OS
Use the MQSC command START QMGR to initialize the queue manager. From IBM® MQ 9.2.0, you can also use this command to prepare its data for backwards migration using the BACKMIG parameter.
Using MQSC commands
For information on how you use MQSC commands, see Performing local administration tasks using MQSC commands.
You can issue this command from sources C. For an explanation of the source symbols, see Sources from which you can issue MQSC commands on z/OS®.
Usage notes
![[MQ 9.2.0 Jul 2020]](ng920.gif)
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.
- 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
- 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:
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').keyword=valueMSTR 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
5655-MQ9. ![[Long Term Support]](nglts.gif)
Prior to IBM MQ for z/OS 9.1.3, this is the
default value if the SCUEAUTH library is not part of the queue manager STEPLIB.- From IBM MQ for z/OS 9.1.3 this is the default
value.
- VUE
- The queue manager is a stand-alone VUE product, with product ID
5655‑VU9. - Prior to IBM MQ for z/OS 9.1.3, this is the
default value if the SCUEAUTH library is part of the queue manager STEPLIB
- ADVANCEDVUE
- The queue manager is part of an IBM MQ Advanced for z/OS Value Unit Edition
product, with product ID
5655‑AV1.
- AMSPROD
- Specifies the product ID against which the queue manager usage is to be recorded. The value can
be one of the following:
- AMS
- Advanced Message Security (AMS) is a stand-alone Advanced Message Security for z/OS product, with product ID
5655-AM9. - This is the default value, unless the attribute for the queue manager indicates
IBM MQ Advanced for z/OS Value Unit Edition.
- ADVANCED
- AMS is part of an IBM MQ Advanced for z/OS product, with
product ID
5655‑AV9. - ADVANCEDVUE
- AMS is part of an IBM MQ Advanced for z/OS Value Unit Edition product, with
product ID
5655‑AV1. 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 910. Backward migration to this release must be allowed.