START QMGR on z/OS

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


Use MQSC commands

For information on how we use MQSC commands, see Performing local administration tasks using MQSC commands.

We can issue this command from sources C. For an explanation of the source symbols, see Sources from which we can issue MQSC commands on z/OS .

Synonym: STA QMGR


START QMGR

START QMGR ENVPARM(jcl-substitution)1PARM(CSQZPARM)PARM(member-name)QMGRPROD(MQ)QMGRPRODQMGRPRODVUE)QMGRPROD(ADVANCEDVUE)AMSPROD(AMS)AMSPROD(VUE)AMSPROD(ADVANCEDVUE)BACKMIG(backward-migration-target-vrm)Notes:

  • 1 MSTR is accepted as a synonym for ENVPARM


Usage notes

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.

We 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 we 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 we 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 5655‑MQ9.
      Prior to Version 9.1.3, this is the default value if the SCUEAUTH library is not part of the queue manager STEPLIB.
      From Version 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 Version 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.
      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.

Parent topic: MQSC commands