3.3.5.3.1 Receiving a TXUSER_DTCLURMENLISTMENT_MTAG_CREATE Message

  • Article

When the Transaction Manager Communicating with an LU 6.2 Implementation Facet receives a TXUSER_DTCLURMENLISTMENT_MTAG_CREATE (section 2.2.3.3.1) message, it MUST perform the following actions:

  • If the connection state is Idle:

    • Set the connection state to Processing Enlistment Request.

    • Attempt to find the LU Pair object keyed by the value of the first cbLength bytes of the rgbBlob field of the DTCLU_VARLEN_BYTEARRAY structure (contained in the LuNamePair field) of the message in the LU Pair Table.

    • If the LU Pair object is not found:

    • Otherwise:

      • Set the LU Pair field of the connection object to the found LU Pair object.

      • If the LU Pair Recovery State field of the found LU Pair object is set to Recovery Process Not Attached:

      • Otherwise, if the LU Pair Recovery State field of the found LU Pair object is set to Not Synchronized:

      • Otherwise, if the LU Pair Recovery State field of the found LU Pair object is set to either Synchronizing No Remote Name or Synchronizing Have Remote Name:

      • Otherwise, if the LU Pair Recovery State field of the found LU Pair object is set to Inconsistent:

      • Otherwise:

        • Attempt to find the Transaction object keyed by the value of the guidTx field of the message in the Transaction table of the Core Transaction Manager Facet.

        • If the Transaction object is not found:

        • Otherwise:

          • Attempt to find an LUW object with its LUW Identifier field set to the value of the first cbLength bytes of the rgbBlob field of the DTCLU_VARLEN_BYTEARRAY structure (contained in the LuTransId field) of the message in the LUW List of the found LU Pair object.

          • If an LUW object is found:

          • Otherwise:

            • Create a new Enlistment object that is initialized as follows:

              • Set the Transaction Manager Facet field to the Transaction Manager Communicating with an LU 6.2 Implementation Facet.

              • Set the Transaction field to the found Transaction object.

              • Set the Resource Manager Identifier field to the resource manager identifier field of the found LU Pair object.

              • Set the Connection field to the connection object.

            • Create a new LUW object that is initialized as follows:

              • Set the Transaction Identifier field to the guidTx field of the message.

              • Set the LUW Identifier field to the first cbLength bytes of the rgbBlob field of the DTCLU_VARLEN_BYTEARRAY structure (contained in the LuTransId field) of the message.

              • Set the Enlistment field to the new Enlistment object.

              • Set the Recovery Sequence Number For LUW field to the Recovery Sequence Number field of the found LU Pair object.

              • Set the Local LU LUW State field to Active.

              • Set the LUW Recovery State field to Recovery Not Needed.

              • Set the Is Conversation Lost Flag to FALSE.

            • Set the LUW field on the connection to refer to the new LUW object.

            • Add the new LUW object to the LUW List of the found LU Pair Object.

            • Signal the Create Subordinate Enlistment event (as specified in [MS-DTCO] section 3.2.7.11) on the Core Transaction Manager Facet with the following argument:

              • The new Enlistment object.

  • Otherwise, if the connection state is Ended:

    • Ignore the message.

  • Otherwise, the message MUST be processed as an invalid message, as specified in [MS-DTCO], section 3.1.6.