Go to: Synopsis. Return value. Keywords. Flags. MEL examples.


dbmessage [-file string] [-list] [-monitor boolean] [-type string]

dbmessage is NOT undoable, NOT queryable, and NOT editable.

The dbmessage command is used to install monitors for certain message types, dumping debug information as they are sent so that the flow of messages can be examined.

Return value



debug, message, filter


file, list, monitor, type
Long name (short name) Argument types Properties
-monitor(-m) boolean create
Set the monitoring state of the message type ('on' to enable, 'off' to disable). Returns the list of all message types being monitored after the change in state.
-type(-t) string create
Monitor only the messages whose name matches this keyword (default is all).
-list(-l) create
List all available message types and their current enabled status.
-file(-f) string create
Destination file of the message monitoring information. Use the special names stdout and stderr to redirect to your command window. As well, the special name msdev is available on NT to direct your output to the debug tab in the output window of Developer Studio. Default value is stdout.

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can be used more than once in a command.

MEL examples

dbmessage -m "on";                  // Enable monitoring of all messages
dbmessage -l;                       // Print all available messages and monitoring state
dbmessage -f "msgs.txt";            // Redirect all message output to the file "msgs.txt"
dbmessage -t "dgNodeAdded" -m "on"; // Turn on monitoring for the "dgNodeAdded" message