START QMGR on z/OS

Use the MQSC command START QMGR to initialize the queue manager.


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 source C. For an explanation of the source symbols, see Use commands on z/OS®.

Synonym: STA QMGR

START QMGR

START QMGR ENVPARM(jcl-substitution)1
  • PARM(CSQZPARM)PARM(member-name)
  • QMGRPROD(MQ)QMGRPROD(VUE)
  • QMGRPROD(ADVANCEDVUE)
  • AMSPROD(AMS)AMSPROD(VUE)
  • AMSPROD(ADVANCEDVUE)
  • 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.

    New startup parameters QMGRPROD and AMSPROD have been added to 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 type of 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. This is the default value if the IBM MQ for z/OS Value Unit Edition (VUE) is not installed.

        VUE
        The queue manager is a stand-alone VUE product, with product ID 5655‑VU9. This is the default value if the IBM MQ for z/OS Value Unit Edition (VUE) is installed.

        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 type of 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.