pymel.core.system.dbmessage¶

dbmessage(*args, **kwargs)¶

The dbmessagecommand 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.

Flags:

Long Name / Short Name		Argument Types	Properties
file / f		unicode
	Destination file of the message monitoring information. Use the special names stdoutand stderrto redirect to your command window. As well, the special name msdevis available on NT to direct your output to the debug tab in the output window of Developer Studio. Default value is stdout.
list / l		bool
	List all available message types and their current enabled status.
monitor / m		bool
	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		unicode
	Monitor only the messages whose name matches this keyword (default is all). Flag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.dbmessage

Example:

import pymel.core as pm

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