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


dbmessage([file=string], [list=boolean], [monitor=boolean], [type=string])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

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) boolean 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 have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

cmds.dbmessage( m='on' )                  # Enable monitoring of all messages
cmds.dbmessage( l=True )                  # Print all available messages and monitoring state
cmds.dbmessage( f='msgs.txt' )            # Redirect all message output to the file "msgs.txt"
cmds.dbmessage( t='dgNodeAdded', m='on' ) # Turn on monitoring for the "dgNodeAdded" message