SE_log_open

Obsolete; superseded by SE_log_open_log

Opens a log file for processing on the given layer 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 log file name; the name must be a simple log file 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 log file
Description

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

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

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

SE_EXTEND_MODE—Opens an existing log file and appends to it. The log file 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 log file. If the log file already exists, returns an SE_LOG_IO_ERROR error.

The following log file TYPES are supported:

SE_LOG_PERSISTENTThe log file remains on disk after the ArcSDE server process is terminated.

SE_LOG_TEMPORARYThe log file 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 user name to simultaneously open the same log file. 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.