End MQ Channel (ENDMQMCHL)
- Where allowed to run
- All environments (*ALL)
- Threadsafe
- Yes
The End MQ Channel (ENDMQMCHL) command closes an MQ channel, and the channel is no longer enabled for automatic restarts.
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| CHLNAME | Channel name | Character value | Required, Positional 1 |
| OPTION | Option | *CNTRLD, *IMMED, *ABNORMAL | Optional, Positional 2 |
| MQMNAME | Message Queue Manager name | Character value, *DFT | Optional, Positional 3 |
| STATUS | Channel status | *STOPPED, *INACTIVE | Optional, Positional 4 |
| CONNAME | Connection name | Character value, *NONE | Optional, Positional 5 |
| RQMNAME | Remote queue manager | Character value, *NONE | Optional, Positional 6 |
Channel name (CHLNAME)
>Specifies the name of the channel definition.
The possible values are:
- channel-name
- Specify the channel name.
Option (OPTION)
>Specifies whether processing for the current batch of messages is allowed to finish in a controlled manner.
The possible values are:
- *CNTRLD
- Allows processing of the current batch of messages to complete. No new batch is allowed to start.
- *IMMED
- Ends processing of the current batch of messages immediately. This is likely to result in 'in-doubt' situations.
- *ABNORMAL
- Ends processing of the current batch of messages immediately and terminates the channel thread or job. This is likely to result in 'in-doubt' situations.
Message Queue Manager name (MQMNAME)
>Specifies the name of the message queue manager.
The possible values are:
- *DFT
- The default queue manager is used. If we do not have a default queue manager defined on the system, the command fails.
- message-queue-manager-name
- The name of a message queue manager.
Channel status (STATUS)
>Specifies the required status of the channel after succesful completion of the command.
The possible values are:
- *STOPPED
- The channel status is set to STOPPED.
- *INACTIVE
- The channel status is set to INACTIVE.
Connection name (CONNAME)
>Specifies the connection name of the channel instance that we want to end.
Remote queue manager (RQMNAME)
>Specifies the name of the remote queue manager of the channel instance that we want to end.
Examples
>None
Error messages
>Unknown
Parent topic: CL commands reference for IBM i