RESET CHANNEL

Use RESET CHANNEL to reset the message sequence number for a WebSphere MQ channel with, optionally, a specified sequence number to be used the next time that the channel is started.

Notes:

  1. On z/OS:

    1. This is valid only for channels used for distributed queuing without CICS. If you are using CICS for distributed queuing, see the WebSphere MQ Intercommunication manual.

    2. The command server and channel initiator must be running.

  2. This command can be issued to a channel of any type except SVRCONN and CLNTCONN channels, (including those that have been defined automatically). However, if it is issued to a sender, server or cluster-sender channel, then in addition to resetting the value at the end at which the command is issued, the value at the other (receiver, requester, or cluster-receiver) end is also reset to the same value the next time this channel is initiated (and resynchronized if necessary).

  3. If the command is issued to a receiver, requester, or cluster-receiver channel, the value at the other end is not reset as well; this must be done separately if necessary.

  4. Where there is both a locally defined channel and an auto-defined cluster-sender channel of the same name, the command applies to the locally defined channel. If there is no locally defined channel but more than one auto-defined cluster-sender channel, the command applies to the channel that was last added to the local queue manager's repository.

Synonym: RESET CHL 

RESET CHANNEL
 
                                .-CHLDISP(PRIVATE)-----. (1)
>>-RESET CHANNEL(channel-name)--+----------------------+-------->
                                |                 (2)  |
                                '-CHLDISP(SHARED)------'
 
   .-CMDSCOPE(' ')------------. (1)   .-SEQNUM(1)-------.
>--+--------------------------+-------+-----------------+------><
   |                     (2)  |       '-SEQNUM(integer)-'
   '-CMDSCOPE(qmgr-name)------'

Notes:

  1. Valid only on z/OS.

  2. Valid only on full function WebSphere MQ for z/OS when the queue manager is a member of a queue-sharing group.

 

Parameter descriptions

(channel-name)
The name of the channel to be reset. This is required.

CHLDISP
This parameter applies to z/OS only and can take the values of:

In conjunction with the various values of the CMDSCOPE parameter, this parameter controls two types of channel:

SHARED
A receiving channel is shared if it was started in response to an inbound transmission directed to the queue-sharing group.

A sending channel is shared if its transmission queue has a disposition of SHARED.

PRIVATE
A receiving channel is private if it was started in response to an inbound transmission directed to the queue manager.

A sending channel is private if its transmission queue has a disposition other than SHARED.

Note:
This disposition is not related to the disposition set by the disposition of the queue-sharing group of the channel definition.

The combination of the CHLDISP and CMDSCOPE parameters also controls from which queue manager the channel is operated. The possible options are:

The various combinations of CHLDISP and CMDSCOPE are summarized in Table 9

Table 9. CHLDISP and CMDSCOPE for RESET CHANNEL

CHLDISP CMDSCOPE( ) or CMDSCOPE (local-qmgr) CMDSCOPE (qmgr-name)
PRIVATE Reset private channel on the local queue manager Reset private channel on the named queue manager
SHARED Reset a shared channel on all active queue managers.

This might automatically generate a command using CMDSCOPE and send it to the appropriate queue managers. If there is no definition for the channel on the queue managers to which the command is sent, or if the definition is unsuitable for the command, the action fails there.

The definition of a channel on the queue manager where the command is entered might be used to determine the target queue manager where the command is actually run. Therefore, it is important that channel definitions are consistent. Inconsistent channel definitions might result in unexpected command behavior.

Not permitted

CMDSCOPE
This parameter applies to z/OS only and specifies how the command is executed when the queue manager is a member of a queue-sharing group.

If CHLDISP is set to SHARED, CMDSCOPE must be blank or the local queue manager.

' '
The command is executed on the queue manager on which it was entered. This is the default value.

qmgr-name
The command is executed on the queue manager you specify, providing the queue manager is active within the queue-sharing group.

You can specify a queue manager name only if you are using a queue-sharing group environment and if the command server is enabled.

SEQNUM(integer)
The new message sequence number, which must be in the range 1 through 999 999 999. This is optional.

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.