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

Synopsis

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

None

Keywords

debug, message, filter

Flags

file, list, monitor, type
Long name (short name) Argument types Properties
-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.
-list(-l) create
List all available message types and their current enabled status.
-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).
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