RESET TPIPE
Use the MQSC command RESET TPIPE to reset the recoverable sequence numbers for an IMS Tpipe used by the IBM® MQ - IMS bridge.
Using MQSC commands
For information on how you use MQSC commands, see Performing local administration tasks using MQSC commands.
IBM i | UNIX and Linux® | Windows | z/OS® |
---|---|---|---|
CR |
For an explanation of the symbols in the z/OS column, see Using commands on z/OS.
Usage notes
- This command is used in response to the resynchronization error reported in message CSQ2020E, and initiates resynchronization of the Tpipe with IMS.
- The command fails if the queue manager is not connected to the specified XCF member.
- The command fails if the queue manager is connected to the specified XCF member, but the Tpipe is open.
Parameter descriptions for RESET TPIPE
- ( tpipe-name )
- The name of the Tpipe to be reset. This is required.
- CMDSCOPE
-
This parameter specifies how the command is executed when the queue manager is a member of a queue-sharing group.
- ' '
- 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, other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled.
- ACTION
-
Specifies whether to commit or back out any unit of recovery associated with this Tpipe. This is required if there is such a unit of recovery reported in message CSQ2020E; otherwise it is ignored.
- COMMIT
- The messages from IBM MQ are confirmed as having already transferred to IMS ; that is, they are deleted from the IBM MQ - IMS bridge queue.
- BACKOUT
- The messages from IBM MQ are backed out; that is, they are returned to the IBM MQ - IMS bridge queue.
- SENDSEQ( integer )
-
The new recoverable sequence number to be set in the Tpipe for messages sent by IBM MQ and to be set as the partner's receive sequence number. It must be hexadecimal and can be up to 8 digits long, and can optionally be enclosed by
X' '
. It is optional; if omitted, the sequence number is not changed but the partner's receive sequence is set to the IBM MQ send sequence number. - RCVSEQ( integer )
-
The new recoverable sequence number to be set in the Tpipe for messages received by IBM MQ and to be set as the partner's send sequence number. It must be hexadecimal and can be up to 8 digits long, and can optionally be enclosed by
X' '
. It is optional; if omitted, the sequence number is not changed but the partner's send sequence is set to the IBM MQ receive sequence number. - XCFGNAME( group-name )
- The name of the XCF group to which the Tpipe belongs. This is 1 through 8 characters long. It is optional; if omitted, the group name used is that specified in the OTMACON system parameter.
- XCFMNAME( member-name )
- The name of the XCF member within the group specified by XCFGNAME to which the Tpipe belongs. This is 1 through 16 characters long, and is required.