RESET TPIPE on z/OS

Use the MQSC command RESET TPIPE to reset the recoverable sequence numbers for an IMS Tpipe used by the IBM MQ - IMS bridge.


Use MQSC commands

For information on how we use MQSC commands, see Performing local administration tasks using MQSC commands.

We can issue this command from sources CR. For an explanation of the source symbols, see Use commands on z/OS®.

Synonym: There is no synonym for this command.

RESET TPIPE

RESET TPIPE ( tpipe-name ) XCFMNAME ( member-name ) ACTION(COMMITBACKOUT
  • )
  • CMDSCOPE(' ')CMDSCOPE(qmgr-name)
  • 1
  • SENDSEQ(integer)
  • RCVSEQ(integer)
  • XCFGNAME(group-name)
  • Notes:

    • 1 Valid only when the queue manager is a member of a queue sharing group.


    Usage notes

    1. This command is used in response to the resynchronization error reported in message CSQ2020E, and initiates resynchronization of the Tpipe with IMS.
    2. The command fails if the queue manager is not connected to the specified XCF member.
    3. 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 runs when the queue manager is a member of a queue sharing group.

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

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

        We 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.