skip to main content
IP API Reference for Java : Connection-level Methods for Java : sqlipStartTransaction
 

sqlipStartTransaction

This connection-level method starts a new transaction on the specified connection in response to a request for an explicit start transaction by the client. This method is not called for an implied transaction that is always open on a connection after a connection is opened or after a commit on a top-level transaction. The IP must insure that a transaction is always active on a connection.
If nested transactions are supported, then this method will be called when the client has made a start transaction API call. If you don’t want to support nested transactions, then return a OADS_ERROR when this method is called. When COMMIT is called, you must commit on the current nested level and set the current transaction to the previous level. If a COMMIT is called for the top level transaction, then you must commit and then start a new high-level transaction, because a call to sqlip_start_transaction will not be made.
If you do not want to support transactions, always return OADS_SUCCESS.
int sqlipStartTransaction(
int iExplicitFlag,
String pCmdArgs);
 
Table 77: Parameters for sqlipStartTransaction 
Parameter
Type
Description
INPUT
 
 
iExplicitFlag
int
For future use – always set to 1 in this version.
pCmdArgs
String
Isolation level for this transaction - ’%d’ where d is an integer value corresponding to the isolation level as defined in the ipdef.h file.
RETURN
 
 
 
int
OADS_SUCCESS
OADS_ERROR