public final class StartTransactionMessageTypeV1_1 extends StartTransactionMessageType
This message has the following fields :
|USERID||STRING||The name of the user starting the transaction. Can be the zero-length string, but if not, it must be a name that appears in some tuple of the USER relvar.|
|AUTHBYCLIENT||INTEGER||1||1 if the client has authenticated the user, 0 otherwise.|
|AUTHALGORITHM||STRING||The name of the signing algorithm used to compute SIGNATURE. Can be the zero-length string.|
|SIGNATURELENGTH||INTEGER||2||The number of bytes in SIGNATURE. Can be zero, in which case the SIGNATURE field is omitted from the message.|
|SIGNATURE||BYTES||The signature as computed by the signature algorithm identified by AUTHALGORITHM, using the user's private key corresponding to the public key that is registered for the user in the USERCERTIFICATE relvar, and applied to the USERID field.|
|READONLYTRANSACTION||INTEGER||1||1 if the transaction will not be doing any updates, and can therefore operate in read-only mode,
0 if the transaction is to perform updates on the database.
|AUTOCOMMIT||INTEGER||1||1 if the server is required to commit every individual command sent to the transaction,
0 if the server is to commit this transaction only at the client's explicit request.
|Modifier and Type||Method and Description|
Factory method for getting a StartTransactionMessage of this MessageType's version, holding the given data
message, message, message
public StartTransactionMessage message(java.lang.String userID, boolean userAuthenticatedByClient, java.lang.String signatureAlgorithm, byte signature, boolean readOnlyTransaction, boolean autoCommit, DDLCapture captureDDL, SnapShotIsolationMode snapShotIsolationMode)
userID- The identification of the user owning the new transaction
userAuthenticatedByClient- indicates whether the user owning the new transaction has been authenticated by the client
signatureAlgorithm- name of the user authentication algorithm to be used by the server if the decides that it will do user authentication itself
signature- The signature to be verified by the server if the decides that it will do user authentication itself
readOnlyTransaction- flag indicating whether or not the new transaction is a read-only one, i.e. whether it will or will not attempt updates to the database. Must be false if this message is sent to a server prior to 1.2
autoCommit- flag indicating whether each individual statement is automatically committed (meaning, for a read-only transaction, that locks will immediately be released when the statement completes)
captureDDL- flag indicating whether any DDL executed in this transaction should be captured by the server in a script. If set, a script file will be created by the server holding all the DDL executed in this transaction. For anonymous transactions, the file will be written in the server's user.home directory, and will be given the name of the internal transaction ID, followed by "DDL.SPS". For non-anonymous transactions, a directory will be created in the server's user.home directory, named after the user owning the transaction, and the script file will be written in that directory.
snapShotIsolationMode- The snapshot isolation mode that this readonly transaction is to run under (snapshot isolation does not apply to update transactions. Update transactions always run in SnapShotIsolatinMode.OFF).