Start Channel Initiator
The Start Channel Initiator (MQCMD_START_CHANNEL_INIT) command starts a WebSphere MQ channel initiator.
| HP Integrity NonStop Server | UNIX and Linux® | Windows |
|---|---|---|
| X | X |
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. You can specify one of the following:
- blank (or omit the parameter altogether). The command is executed on the queue manager on which it was entered.
- a queue manager name. The command is executed 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, you 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:
- MQRCCF_MQCONN_FAILED
- MQCONN call failed.
- MQRCCF_MQGET_FAILED
- MQGET call failed.
- MQRCCF_MQOPEN_FAILED
- MQOPEN call failed.