dc_log_notify_open - Start message log reception

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

id

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 valueReturn value (numeric)Meaning
DC_OK0Normal termination.
DCLOGER_PARAM_ARGS-1900An incorrect value is specified as the argument.
DCLOGER_PROTO-1999The 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-1904The system definition is invalid.
DCLOGER_MEMORY-1902The memory became insufficient.
DCLOGER_COMM-1901Initialization of the communication path failed.