\@TRANSACTION

  • Article

You can use the @TRANSACTION processing directive to indicate that the script should be treated as a transaction. If a script is treated as a transaction, Component Services creates a transaction to coordinate the updating of resources.

Syntax

<%@ TRANSACTION = value %>

Parameters
  • Value
    A string that indicates the type of transaction support. Possible values include the following:
    Value Meaning
    Required Always initiates a new transaction.
    Requires_New Always participates in a transaction and initiates a transaction, if one does not currently exist.
    Supported Participates in a transaction if one exists but does not require a transaction.
    Not_Supported Never participates in a transaction. If called from a script that is using transactions, the script containing the @TRANSACTION processing directive still runs but outside of the context of the transation.
Remarks

If a script contains the @TRANSACTION directive, it must be the very first line in the .asp file, otherwise an error is generated. You must add the directive to each page that should be run under a transaction. The current transaction ends when the script finishes processing.

If the script containing the @TRANSACTION directive has been called by either the Server.Transfer or Server.Execute method, and the value is specified as Required, the script continues the transaction of the calling ASP page, if the calling ASP page was transacted. If the calling ASP page was not transacted, the called ASP page creates a new transaction.

For example, the following two scripts would be considered one transaction:

  <%@ TRANSACTION=Required %>
<%
  Server.Transfer("/asp/asp2.asp")
%>
ASP2
<%@ TRANSACTION=Required%>
<%
  Server.CreateObject("Mytransactedcomponent.Closeout")
%>