SE_log_open

Obsolete. Opens a logfile for processing on the given table.

Usage syntax

LONG SE_log_open (SE_CONNECTION connection, const CHAR *logfile, CHAR *table, LONG mode, LONG type, SE_LOG *log);

Parameters
connection The connection handle
logfile The logfile name. The name must be a simple logfile name.
table The table name
mode The mode to use when the file is opened
type The logfile type (SE_LOG_PERSISTENT or SE_LOG_TEMPORARY)
log The file handle to use when referencing this logfile
Description

SE_log_open opens the named logfile in the specified mode on the ArcSDE server. This call is required to get a valid logfile handle for subsequent logfile operations. The following logfile MODES are supported:

SE_INPUT_MODE Opens an existing log file for READ ONLY access. If the logfile does not exists, returns an SE_LOG_NOEXIST error.

SE_OUTPUT_MODE Creates and opens a new logfile if one does not exist; otherwise, opens the existing logfile. Any entries in an existing logfile are deleted.

SE_EXTEND_MODE Opens an existing logfile and appends to it. The logfile must exist. Pass in NULL or a null pointer for the table argument because SE_log_open will return the table name.

SE_OUTPUT_NO_DELETE_MODE Creates and opens a new logfile. If the logfile already exists, returns an SE_LOG_IO_ERROR error.

The following logfile TYPES are supported:

SE_LOG_PERSISTENT The logfile remains on disk after the ArcSDE server process is terminated.

SE_LOG_TEMPORARY The logfile is deleted when the ArcSDE server process is terminated.

Returns

SE_SUCCESS
SE_FAILURE

SE_INVALID_POINTER

SE_LOG_IO_ERROR

SE_LOG_NOACCESS

SE_LOG_NOEXIST

SE_NET_FAILURE

SE_SDE_NOT_STARTED

Notes

• Due to operating system limitations, it may be possible for two ArcSDE sessions of the same username to simultaneously open the same logfile. Therefore, it is possible that the edits of one session may overwrite those of another. You can avoid this by using SE_log_make_name.