sedb.tbreak

Package: sedb

Set timed breakpoint in discrete-event simulation

Syntax

tbreak(t)
tbreak t
tid = tbreak(t)

Description

tbreak(t) or tbreak t, at the SimEvents® debugger command prompt, sets a breakpoint for time t. If you later enter cont, the simulation stops at the first operation at or after time t.

tid = tbreak(t) returns the identifier of the breakpoint.

Input Arguments

t

Numeric scalar or a string that represents a number. The number is the time of a timed breakpoint.

Output Arguments

tid

String that represents a breakpoint identifier.

Examples

Manipulate timed breakpoints and run the simulation until a breakpoint:

  1. Begin a debugger session for a particular model. At the MATLAB® command prompt, enter:

    sedebug('sedemo_timeout')
  2. Establish and view breakpoints. At the prompt, enter:

    tbreak 0.5
    tbreak 1
    tbreak 1.5
    breakpoints

    The output lists the breakpoints:

    Set b1 : Breakpoint for first operation at or after time 0.5
    Set b2 : Breakpoint for first operation at or after time 1
    Set b3 : Breakpoint for first operation at or after time 1.5
    
    List of Breakpoints:
    
     ID        Type        Value       Enabled
     b1        Timed       0.5         yes
     b2        Timed       1           yes
     b3        Timed       1.5         yes
    
  3. Delete, disable, and enable some of the breakpoints. View the resulting list:

    bdelete b2
    disable b3
    disable b1
    enable b3
    breakpoints

    The output is:

    Deleted b2 : Breakpoint for first operation at or after time 1
    Disabled b3 : Breakpoint for first operation at or after time 1.5
    Disabled b1 : Breakpoint for first operation at or after time 0.5
    Enabled b3 : Breakpoint for first operation at or after time 1.5
    
    List of Breakpoints:
    
     ID        Type        Value       Enabled
     b1        Timed       0.5         no
     b3        Timed       1.5         yes
    
  4. Run the simulation until the first enabled breakpoint:

    cont

    The partial output shows that b3 is the breakpoint at which the debugger stops. The debugger ignores the disabled breakpoint, b1, and does not consider the previously deleted breakpoint, b2.

    Hit b3 : Breakpoint for first operation at or after time 1.5
    
    %==============================================================================%
    Executing EntityGeneration Event (ev7)                Time = 1.500000000000000
    : Entity = <none>                                     Priority = 1
    : Block  = Time-Based Entity Generator
  5. End the debugger session. At the prompt, enter:

    sedb.quit
Was this topic helpful?