[IBM i]

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 you 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. You 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 you 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.