Initializing help system before first use

XSLPsetcbmessage

Purpose
Set a user callback to be called whenever Xpress NonLinear outputs a line of text according to XSLP_ECHOXPRSMESSAGES.
Topic areas
Callback, Logging
Synopsis
int XPRS_CC XSLPsetcbmessage(XSLPprob prob, void (XPRS_CC *message) (XSLPprob cbprob, void *cbdata, char *msg, int msglen, int msgtype), void *data);
Arguments
prob 
The current SLP problem.
message 
The function to be called whenever Xpress NonLinear outputs a line of text. message does not return a value.
cbprob 
The problem passed to the callback function.
cbdata 
The user-defined object passed as data to XSLPsetcbmessage.
msg 
Character buffer holding the string to be output.
msglen 
Length in characters of msg excluding the null terminator.
msgtype 
Type of message. The following are system-defined:
1 
Information message
3 
Warning message
4 
Error message

A negative value indicates that the Optimizer is about to finish and any buffers should be flushed at this time.

data 
Address of a user-defined object, which can be used for any purpose by the function. data is passed to message as cbdata.
Example
The following example creates a log file into which all messages are placed. System messages are also printed on standard output: 
FILE *logfile;
logfile = fopen("myLog","w");
XSLPsetcbmessage(prob, CBMessage, logfile);
A suitable callback function could resemble the following: 
void XPRS_CC CBMessage(XSLPprob prob, void *Obj,
                       char *msg, int msglen, int msgtype) {
  FILE *logfile;
  logfile = (FILE *) Obj;
  if (msgtype < 0) {
    fflush(stdout);
    if (logfile) fflush(logfile);
    return;
  }
  switch (msgtype) {
    case 1: /* information */
    case 3: /* warning */
    case 4: /* error */
      printf("%s\n",msg);
    default: /* user */
      if (logfile)
        fprintf(logfile,"%s\n",msg);
      break;
  }
  return;
}
Further information

If a user message callback is defined then screen output is automatically disabled.

Output can be directed into a log file by using XSLPsetlogfile.


Related topics
XSLPsetlogfile

Parent Topic Library functions

© 2001-2025 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.