The Recording History
All information recorded when the execution analysis of an application encounters user-defined recording markers is held in the Record & Analyze window.
Analyzer | Recorder
The columns in the 'Record & Analyze' window are:
- Sequence - The unique sequence number
- Threads - The operating system thread ID
- Delta - The elapsed thread CPU time since the start of the sequence
- Method - There are two Method columns: the first shows the caller for a call or for a current frame if a return; the second shows the function called or the function it is returning to
- Direction - Stack Frame Movement, can be Call, Return, State, Breakpoint or Escape (Escape is used internally when producing a Sequence diagram, to mark the end of an iteration)
- Depth - The stack depth at the time of a call; used in the generation of Sequence diagrams
- State - The state between sequences
- Source - There are two Source columns: the first shows the source filename and line number of the caller for a call or, if a return, for a current frame; the second shows the source filename and line number of the function called or function returning
- Instance - There are two Instance columns, which only have values when the Sequence diagram produced contains State Transitions; the values consist of two items separated by a comma - the first item is a unique number for the instance of the Class that was captured, and the second is the actual instance of the Class
For example: supposing a Class CName has an internal value of 4567 and the program created two instances of that Class; the values might be:
The first entry shows the first instance of the Class and the second entry shows the second instance
The Record & Analyze window toolbar provides a range of facilities for controlling the recording of the execution of an Analyzer script.
You can perform a number of operations on the results of a recording, using the Record & Analyze window context menu, once the recording is complete.
Working With Recording History
- The checkbox against each operation is used to control whether or not this call can be used to create a Sequence, Test Domain Class or Collaborative Class diagram from this history
- In addition to enabling or disabling the call using the checkbox, you can use context menu options to enable or disable an entire call, all calls to a given method, or all calls to a given Class