SE_state_save_to_base

Saves changes to the base state

Usage syntax

LONG SE_state_save_to_base (SE_CONNECTION connection, LONG high_state_id, BOOL commit_each_table);

Parameters
connection The connection handle
high_state_id The high state ID
commit_each_table Flag to indicate if function commits after each table is saved to base.
Description

This function is similar to the trimming-to-base operation. There are only two differences between these two operations:
1. Saving changes to base only affects base-save enabled tables;
2. Walking back to the base state from the specified high state, only those states before one of: a branch point, state not owned by the current user (unless the current user is DBA), or state with version will be deleted.

Also, if the commit_each_table parameter is TRUE, this function will commit after each table is saved to base; otherwise, all tables are saved to base within a single transaction.

Returns

SE_SUCCESS
SE_DB_IO_ERROR

SE_INVALID_STATE_ID

SE_LOCK_CONFLICT

SE_NET_FAILURE

SE_NO_PERMISSIONS

SE_OUT_OF_LOCKS

SE_STATE_NOEXIST

SE_TABLE_NOEXIST