ME

Causes the debugger to be entered on entry to the start of a named code module, by adding the module to the list of monitored modules.

Syntax

ME {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 (E) 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 stop directive, the command returns Changed.

If the module is already present in the list with the E 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.

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.