Share via


3.1.1.2 TIP Connection Object

A TIP connection object MUST contain the following data fields:

  • Partner Transaction Manager Address: This field contains a transaction manager address (as specified in section 2.2) used to identify the transaction manager that the TIP connection connects to. This field MAY be null.

  • Enlistment: This field references an enlistment object associated with the TIP connection. This field MAY be null.

  • Transport Connection: This field references the TCP connection that the TIP connection uses to send TIP commands.

  • Connection Type: An enumeration that indicates whether the TIP connection will be used for either sending or receiving requests. This field MUST be set to one of the following values:

    • Primary: This value is set to indicate that the TIP connection will be sending requests.

    • Secondary: This value is set to indicate that the TIP connection will be receiving requests.

  • State: An enumeration that indicates what state the TIP connection is in. This field MUST be set to one of the following values or one of the values of an extension to the TIP connection object:

    • Initial: The TIP connection has not yet identified its partner transaction manager.

    • Initial Identify: The TIP connection is waiting for a reply to an IDENTIFY TIP command sent while in the initial state.

    • Idle: The TIP connection has identified its partner transaction manager but has no associated transaction.

    • Error: The TIP connection has sent or received an ERROR TIP command.