SQLEndTran--Solicitar COMMIT o ROLLBACK

Finalidad

SQLEndTran() solicita una operación de COMMIT o ROLLBACK para todas las operaciones activas de todas las sentencias asociadas a una conexión.

Sintaxis

SQLRETURN   SQLEndTran       (SQLSMALLINT        HandleType,
                              SQLHANDLE         Handle,
                              SQLSMALLINT        Completion Type);

Argumentos de la función

Tabla 42. Argumentos de SQLEndTran

Uso

HandleType

Identificador de tipo de descriptor de contexto. Sólo se permite SQL_HANDLE_DBC (descriptor de conexión).

Handle

Descriptor de contexto, del tipo indicado por HandleType.

CompletionType

Uno de los dos valores siguientes:

• SQL_COMMIT

• SQL_ROLLBACK

En modalidad de comprometer de forma manual, SQLEndTran() debe invocarse antes de invocar SQLDisconnect(). Si no se llama a SQLEndTran() antes que a SQLDisconnect(), se retrotraen las operaciones que han actualizado la base de datos (desde que se inició la última transacción).

Cuando se ejecuta una operación de ROLLBACK, se borran todos los descriptores de contexto de sentencia.

Si la aplicación se interrumpe o termina prematuramente durante su utilización en la modalidad manual, se pierden las actualizaciones realizadas a partir del último COMMIT. SQLEndTran() debe invocarse antes de invocar SQLDisconnect().

Códigos de retorno

• SQL_SUCCESS
• SQL_SUCCESS_WITH_INFO
• SQL_ERROR
• SQL_INVALID_HANDLE

Diagnósticos

Tabla 43. SQLSTATEs de SQLEndTran

Restricciones

Ninguna.

Consulta relacionada

• Clave para las descripciones de funciones de CLI de DB2
• Resumen de las funciones de CLI de DB2
• SQLSetConnectAttr--Establecer opciones referentes a una conexión