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 ../../../_images/create.gif
  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 ../../../_images/create.gif
  List all available message types and their current enabled status.
monitor / m bool ../../../_images/create.gif
  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 ../../../_images/create.gif
  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