Home > Class Reference > ENSLIB namespace > %Studio.Debugger


class %Studio.Debugger extends %Library.RegisteredObject

This class is used internally by Caché. You should not make direct use of it within your applications. There is no guarantee made about either the behavior or future operation of this class.

Studio debugging interface.

Property Inventory (Including Private)

Method Inventory (Including Private)

Properties (Including Private)

property Breakpoints as %String;
Current breakpoint information for target process
Property methods: BreakpointsDisplayToLogical(), BreakpointsGet(), BreakpointsIsValid(), BreakpointsLogicalToDisplay(), BreakpointsLogicalToOdbc(), BreakpointsNormalize(), BreakpointsSet()
property CSPId as %String;
SessionId if attached to CSP process
Property methods: CSPIdDisplayToLogical(), CSPIdGet(), CSPIdIsValid(), CSPIdLogicalToDisplay(), CSPIdLogicalToOdbc(), CSPIdNormalize(), CSPIdSet()
property Debug as %Debugger.System;
System Debugger object
Property methods: DebugGet(), DebugGetSwizzled(), DebugIsValid(), DebugNewObject(), DebugSet()
property IO as %Boolean;
I/O redirection flag
Property methods: IODisplayToLogical(), IOGet(), IOIsValid(), IOLogicalToDisplay(), IONormalize(), IOSet()
property LastError as %Integer;
Last error
Property methods: LastErrorDisplayToLogical(), LastErrorGet(), LastErrorIsValid(), LastErrorLogicalToDisplay(), LastErrorNormalize(), LastErrorSet()
property Project as Project;
Property methods: ProjectGet(), ProjectGetObject(), ProjectGetObjectId(), ProjectGetSwizzled(), ProjectIsValid(), ProjectNewObject(), ProjectSet(), ProjectSetObject(), ProjectSetObjectId(), ProjectUnSwizzle()
property Watchpoints as %String;
Current watchpoint information for target process
Property methods: WatchpointsDisplayToLogical(), WatchpointsGet(), WatchpointsIsValid(), WatchpointsLogicalToDisplay(), WatchpointsLogicalToOdbc(), WatchpointsNormalize(), WatchpointsSet()
property trace as %Boolean [ InitialExpression = 0 ];
Property methods: traceDisplayToLogical(), traceGet(), traceIsValid(), traceLogicalToDisplay(), traceNormalize(), traceSet()

Methods (Including Private)

private method %OnClose() as %Status
Inherited description: This callback method is invoked by the %Close() method to provide notification that the current object is being closed.

The return value of this method is ignored.

private method %OnNew(initval As %CacheString = "") as %Status
Inherited description: This callback method is invoked by the %New() method to provide notification that a new instance of an object is being created.

If this method returns an error then the object will not be created.

It is passed the arguments provided in the %New call. When customizing this method, override the arguments with whatever variables and types you expect to receive from %New(). For example, if you're going to call %New, passing 2 arguments, %OnNew's signature could be:

Method %OnNew(dob as %Date = "", name as %Name = "") as %Status If instead of returning a %Status code this returns an oref and this oref is a subclass of the current class then this oref will be the one returned to the caller of %New method.

method Attach(pid As %String = "", project As Project = "") as %Status
Attach to another process having process id of pid.

Fails if already attached (use Unattach() first),or if pid is invalid.

On successful completion, process is attached and a break issued. The process will be in break mode upon completion of its current operation.

method AttachToCSP(id As %Integer, project As Project = "") as %Status
Attach to a CSP process, first you must call the GetCSPAttachID() to obtain the ID to pass to this method.
method Break() as %Boolean
Send a BREAK to the target process.

A successful return indicates the target will be in break mode on completion of the current command.

Issue IsStopped to determine if target is in break mode.

method ClearBreakpoints() as %Boolean
method DBGCommand(cmd As %String, IsSys As %Integer = 0) as %Boolean
Perform a debug command.
method DisableBreakpoint(routine As %String, offset As %Integer, condition As %String = "", counter As %Integer, label As %String = "") as %Boolean
method DisableWatchpoint(variable As %String, counter As %Integer) as %Boolean
private method Error(err As %String) as %Integer
error routine
method Eval(e