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