MA

Causes the debugger to be entered on all active statement lines in a named code module, by adding the module to the list of monitored modules.

Syntax

MA {module_name}

Syntax elements

module-name The name of a code module; if none is specified, the current code module is assumed.

Operation

The module name and the monitor type (A) are added to a list of monitored modules. If the module is not already present in the list, the command returns Added. If the module is already present but with a different monitor code, the command returns Changed.

If the module is already present in the list with the A monitor type, the command does nothing.

Thereafter, at run time, the debugger is entered:

  • With a reason of Called Module, at the first line of code, if the code module is entered via a CALL statement.

  • With a reason of Entered Module, at the first line of code, if the code module is entered via an ENTRY statement.

  • With a reason of Return To Module, at the first line after the CALL statement, if the code module is entered via a RETURN statement.

  • With a reason of Execution Count, at every active statement line in the code module.

Comments

A code module can be any single DataBasic code item; that is, a program, an external subroutine or an external function.

The monitored list can contain any number of modules, but the longer the list the greater the potential performance impact.

The monitored list is unique to a single context and is reset on return to TCL.