dc_log_notify_send - Send user-kept message logs

OpenTP1 Version 7 Programming Reference C Language

dc_log_notify_send - Send user-kept message logs

Format

ANSI C, C++

#include <dclog.h>
DCLONG  dc_log_notify_send (char *msg, DCLONG msglen,
                            DCLONG flags)

K&R C

#include <dclog.h>
DCLONG  dc_log_notify_send (msg, msglen, flags)
char       *msg;
DCLONG     msglen;
DCLONG     flags;

Description

The function dc_log_notify_send() sends a message log kept optionally by the user to the application programs waiting for message logs from OpenTP1. The function is used for requesting termination of the application programs waiting for message logs.

Arguments whose values are set in the UAP

msg

Specify the area containing a send message log.

msglen

Specify the length of the area specified in msg. Here, specify length shorter than or equal to that specified in DCLOG_NOTIFY_MSG_LEN.

flags

Specify DCNOFLAGS.

Return values

Return value	Return value (numeric)	Meaning
DC_OK	0	Normal termination.
DCLOGER_PROTO	-1999	The function dc_log_notify_open() has already been called. Therefore, the applicable application program cannot call the function dc_log_notify_send().
DCLOGER_PARAM_ARGS	-1900	An incorrect value is specified as the argument.
DCLOGER_COMM	-1901	Initialization of the communication path failed.