odbcSetAutoCommit           package:RODBC           R Documentation

_O_D_B_C _S_e_t _A_u_t_o-_C_o_m_m_i_t _M_o_d_e

_D_e_s_c_r_i_p_t_i_o_n:

     Set ODBC database connection's auto-commit mode.

_U_s_a_g_e:

     odbcSetAutoCommit(channel, autoCommit = TRUE)

     odbcEndTran(channel, commit = TRUE)

_A_r_g_u_m_e_n_t_s:

 channel: RODBC connection object returned by 'odbcConnect'.

autoCommit: logical.  Set auto-commit on?

  commit: logical.  Commit or rollback pending transaction?

_D_e_t_a_i_l_s:

     Auto-commit is a concept supported only by ODBC connections to
     transactional DBMSs.

     If a connection to a transactional DBMS is in auto-commit mode
     (the default), then all its SQL statements will be executed and
     committed as individual transactions.  Otherwise, its SQL
     statements are grouped into transactions that are terminated by an
     execution of 'commit' or 'rollback'.  Switching a connection to
     auto-commit mode commits the pending transaction.

     By default, new connections are in auto-commit mode.  If
     auto-commit mode has been disabled, a call to 'odbcEndTran' or an
     SQL 'commit' statement must be executed in order to commit
     changes; otherwise, pending database changes will not be saved.

_V_a_l_u_e:

     'odbcSetAutoCommit' stops if 'channel' is an invalid connection. 
     The function returns '-1' on error, '0' on success and '' on
     success with a message that would be returned by 'odbcGetErrMsg'.

_A_u_t_h_o_r(_s):

     Norman Yamada, Yasser El-Zein

