dc_log_notify_open - Start message log reception

OpenTP1 Version 7 Programming Reference C Language

Format

ANSI C, C++

#include <dclog.h>
DCLONG    dc_log_notify_open (DCLONG id, DCLONG flags)

K&R C

#include <dclog.h>
DCLONG  dc_log_notify_open (id, flags)
DCLONG     id;
DCLONG     flags;

Description

The function dc_log_notify_open() starts reception of the message logs reported by OpenTP1.

Arguments whose values are set in the UAP

Specify 0.

flags

DCNOFLAGS: Specify this value if you do not want to determine whether the use of the message log report facility operand is specified in the log service definition.

DCLOG_CHKRTN: Specify this value if you want to determine whether the use of the message log report facility operand is specified in the log service definition. If the use of the operand is not specified, DCLOGER_PROTO will return.

Return values

Return value	Return value (numeric)	Meaning
DC_OK	0	Normal termination.
DCLOGER_PARAM_ARGS	-1900	An incorrect value is specified as the argument.
DCLOGER_PROTO	-1999	The function dc_log_notify_open() has already been called. If DCLOG_CHKRTN is assigned to flags, the log service definition is specified so that the message log report facility will not be used.
DCLOGER_DEFFILE	-1904	The system definition is invalid.
DCLOGER_MEMORY	-1902	The memory became insufficient.
DCLOGER_COMM	-1901	Initialization of the communication path failed.