Initializing help system before first use

XPRS_ge_setcbmsghandler

XPRS_ge_setcbmsghandler

Purpose
This function is deprecated and may be removed in future releases. Please use XPRS_ge_addcbmsghandler instead. Declares an output callback function, called every time a line of message text is output by any object in the library.
Synopsis
int XPRS_CC XPRS_ge_setcbmsghandler(int (XPRS_CC *f_msghandler)(XPRSobject vXPRSObject, void * vUserContext, void * vSystemThreadId, const char * sMsg, int iMsgType, int iMsgNumber), void * p);
Arguments
f_msghandler 
The callback function which takes six arguments, vXPRSObject, vUserContext, vSystemThreadId, sMsg, iMsgType and iMsgNumber. Use a NULL value to cancel a callback function.
vXPRSObject 
The object sending the message. Use XPRSgetobjecttypename to get the name of the object type.
vUserContext 
The user-defined object passed to the callback function.
vSystemThreadId 
The system id of the thread sending the message caste to a void *.
sMsg 
A null terminated character array (string) containing the message, which may simply be a new line. When the callback is called for the first time sMsg will be a NULL pointer.
iMsgType 
Indicates the type of output message:
1 
information messages;
2 
(not used);
3 
warning messages;
4 
error messages.
A negative value means the callback is being called for the first time.
iMsgNumber 
The number associated with the message. If the message is an error or a warning then you can look up the number in the section Optimizer Error and Warning Messages for advice on what it means and how to resolve the associated issue.
p 
A user-defined object to be passed to the callback function.
Further information
To send all messages to a log file the built in message handler XPRSlogfilehandler can be used. This can be done with: 
XPRS_ge_setcbmsghandler(XPRSlogfilehandler, "log.txt");

Related topics
XPRSgetobjecttypename.

Parent Topic Console and Library Functions

© 2001-2020 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.