Open topic with navigation
Sets the message level for the script execution.
function lr.set_debug_message( message_level, on_off )
Function lr.set_debug_message( message_level, on_off )
|Example: Debug Message Levels||Message Functions|
|message_level||One of the Message Log Run-Time Settings.|
|on_off||A switch to activate or deactivate a specific message level setting. Use one of the On-Off Constants.|
The lr.set_debug_message function sets the debug message level, message_lvl, for the script execution. By setting a message level, you determine which information is sent. The setting is enabled by passing LR_SWITCH_ON as on_off, and disabled with LR_SWITCH_OFF.
The messages are sent to the log or Vuser output.
Message levels are generally set in the script's Run-time Settings dialog box. The value can be changed from the current Run-time Settings value. For example, if the script's current message level in the Run-time Settings is set at "Brief" mode, the value can be increased to "Extended log" (LR_MSG_CLASS_EXTENDED_LOG):
and later decreased to "Brief" once again:
To enable logging that is disabled in the Run-time Settings, set the message level to another level. For example:
lr.set_debug_message (lr.MSG_CLASS_EXTENDED_LOG, lr.SWITCH_ON)
After enabling the logging, return to the disabled state by setting the debug level to zero (0) and activating the option using the lr.SWITCH_ON switch as the second parameter.
The message levels Result Data, Parameter Substitution, and Full Trace, are specific details, or sub-settings, of the Extended log setting. To set one of these sub-settings you can use logical Or's in your message_level argument.
Using LR_SWITCH_DEFAULT as on_off sets the on/off status of message_level to the default value regardless of previous calls to lr.set_debug_message. Use LR_SWITCH_DEFAULT with a single message_level argument. It does not work with ORed message_level settings.
Returns 0 on success and -1 on failure.
Standard parameterization is not available for this function.