ILOG CPLEX 11.0 User's Manual

more calls to the message handling routines of the Callable Library. In other words, thedestination list of each channel is initially empty.Messages from multiple channels may be sent to one destination. All predefinedILOG CPLEX channels can be directed to a single file by a call to CPXsetlogfile.Similarly, all predefined ILOG CPLEX channels except cpxlog can be directed to thescreen by the CPX_PARAM_SCRIND parameter. For a finer level of control, or to definedestinations for application-specific messages, use the following message handling routines,all documented in the ILOG CPLEX Reference Manual:◆◆◆◆◆◆◆◆CPXmsg writes a message to a predefined channel;CPXflushchannel flushes a channel to its associated destination;CPXdisconnectchannel flushes a channel and clears its destination list;CPXdelchannel flushes a channel, clears its destination list, frees memory for thatchannel;CPXaddchannel adds a channel;CPXaddfpdest adds a destination file to the list of destinations associated with achannel;CPXdelfpdest deletes a destination from the destination list of a channel;CPXaddfuncdest adds a destination function to a channel;◆ CPXdelfuncdest deletes a destination function to a channel;Once channel destinations are established, messages can be sent to multiple destinations bya single call to a message-handling routine.Figure 6.1User-writtenapplicationCPXaddchannelCPXmsgChannel(s)(CPXdelchannel)CPXaddfpdest(CPXdelfpdest)CPXaddfuncdest(CPXdelfuncdest)Destination File(s)Destination Function(Figure 6.1 ILOG CPLEX Message Handling RoutinesExample: Callable Library Message ChannelsThis example shows you how to use the ILOG CPLEX message handler from the CallableLibrary. It captures all messages generated by ILOG CPLEX and displays them on screen152 ILOG CPLEX 11.0 — USER’ S MANUAL