Write a message to the server’s log file.
#include <jagpublic.h> JagStatus JagLog( JagBoolean use_date, SQLPOINTER logmsg)
Pass as JAG_TRUE to indicate that the message should be preceded by a timestamp in the log; pass as JAG_FALSE to log the message without a timestamp.
A null-terminated string containing the message to be logged. The message must include a newline at the end.
Return value |
To indicate |
---|---|
JAG_SUCCEED |
Success. |
JAG_FAIL |
Failure. JagLog fails if the log file can not be opened or if logmsg is NULL. If the log file cannot be opened, log messages are written to the server process’ standard error device. |
JagLog writes a message to the server’s log file.
By convention, errors that occur on the server are written to the log. C or C++ components should use JagLog to record error messages in the log rather than printing to the console.
You can call JagSendMsg to send error messages to the client. When a method invocation fails you should log any details that will help debug the cause of failure, then send a descriptive error to the client.
For information on configuring the log file used by the server, see Chapter 3, “Creating and Configuring Servers,” in the EAServer System Administration Guide.
Appendix C, “Creating C Components,” in the EAServer Programmer’s Guide.
Copyright © 2005. Sybase Inc. All rights reserved. |