Inserts a new memory usage snapshot into the current recording and identifies this snapshot with the snapshotTag provided.

Return type: VOID

Access: PUBLIC STATIC

Applies to: Progress.Profiler.MemoryProfiler class

Syntax

TakeSnapshot( snapshotTag AS CHARACTER )
snapshotTag
A string of type CHARACTER used to identify the snapshot in the memory profile recording.
Note: OpenEdge reserves tags beginning with the underscore character (_). If you supply a tag beginning with an underscore, the AVM issues an error message and no snapshot recording is generated.

Example

USING Progress.Profiler.MemoryProfiler.
VAR HANDLE h.

MemoryProfiler:TakeSnapshot("pre").

RUN persproc.p PERSISTENT SET h.
MemoryProfiler:TakeSnapshot("post").

DELETE PROCEDURE h.
MemoryProfiler:TakeSnapshot("done").

An analysis of the snapshots shows that an ABL procedure object named persproc.p was created between snapshots "pre" and "post" and that the ABL procedure object was deleted between snapshots "post" and "done".