Start Channel Initiator

The Start Channel Initiator (MQCMD_START_CHANNEL_INIT) command starts an IBM MQ channel initiator.


Required parameters

    InitiationQName (MQCFST)
    Initiation queue name (parameter identifier: MQCA_INITIATION_Q_NAME).

    The name of the initiation queue for the channel initiation process. That is, the initiation queue that is specified in the definition of the transmission queue.

    This parameter is not valid on z/OS .

    The maximum length of the string is MQ_Q_NAME_LENGTH.


Optional parameters

    CommandScope (MQCFST)
    Command scope (parameter identifier: MQCACF_COMMAND_SCOPE). This parameter applies to z/OS only. Specifies how the command is executed when the queue manager is a member of a queue sharing group. We can specify one of the following:

    • blank (or omit the parameter altogether). The command is processed on the queue manager on which it was entered.
    • a queue manager name. The command is processed on the queue manager you specify, providing it is active within the queue sharing group. If you specify a queue manager name other than the queue manager on which it was entered, we must be using a queue sharing group environment, and the command server must be enabled.

    The maximum length is MQ_QSG_NAME_LENGTH.

    EnvironmentInfo (MQCFST)
    Environment information (parameter identifier: MQCACF_ENV_INFO).

    The parameters and values to be substituted in the JCL procedure (xxxxCHIN, where xxxx is the queue manager name) that is used to start the channel initiator address space. This parameter applies to z/OS only.

    The maximum length of the string is MQ_ENV_INFO_LENGTH.


Error codes

This command might return the following error codes in the response format header, in addition to the values shown in Error codes applicable to all commands.

    Reason (MQLONG)
    The value can be any of the following values:

      MQRCCF_MQCONN_FAILED
      MQCONN call failed.

      MQRCCF_MQGET_FAILED
      MQGET call failed.

      MQRCCF_MQOPEN_FAILED
      MQOPEN call failed.

Parent topic: Definitions of the Programmable Command Formats