Reset MQ Channel (RSTMQMCHL)
- Where allowed to run
- All environments (*ALL)
- Threadsafe
- Yes
The Reset MQ Channel (RSTMQMCHL) command resets the message sequence number for an MQ channel to a specified sequence number for use the next time that the channel is started.
You are recommended to uset this command for Sender(*SDR), Server (*SVR) and Cluster-sender (*CLUSSDR) channels only.
If we use this command for a Receiver (*RCVR), Requester (*RQSTR) or Cluster-receiver (*CLUSRCVR) channel, the value at the other end of the channel is NOT reset. We must reset the values separately.
The command does not work for Server-connection (*SVRCN) channels.
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| CHLNAME | Channel name | Character value | Required, Positional 1 |
| MSGSEQNUM | Message sequence number | 1-999999999, 1 | Optional, Positional 2 |
| MQMNAME | Message Queue Manager name | Character value, *DFT | Optional, Positional 3 |
Channel name (CHLNAME)
>Specifies the name of the channel definition.
The possible values are:
- channel-name
- Specify the channel name.
Message sequence number (MSGSEQNUM)
>Specifies the new message sequence number.
The possible values are:
- 1
- The new message sequence number is 1.
- message-sequence-number
- Specify the new message sequence number ranging from 1 through 999999999.
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.
Examples
>None
Error messages
>Unknown
Parent topic: CL commands reference for IBM i