Module: VisualDebug

Support for the visualization tool “chplvis”

This module provides access to and enables hooks to dump out task and communication information for post-run visualization of the tasks and communication.

proc startVdebug(rootname: string)

Start logging events for VisualDebug. Open a new set of data files, one for each locale, for chplvis. This routine should be called only once for each program. It creates a directory with the rootname and creates the files in that directory. The files are named with the rootname and “-n” is added where n is the locale number.

Arguments:rootname – Directory name and rootname for files.
proc tagVdebug(tagname: string)

Add a tag to the data for chplvis to allow “view points” in the data.

Arguments:tagname – name of the tag
proc stopVdebug()

Stop collecting VisualDebug data and close the data files.

proc pauseVdebug()

Suspend collection of VisualDebug data.

proc resumeVdebug(tagname: string)

Resume collection of VisualDebug data for chplvis after a pauseVdebug(). This also generates a tag record visible by chplvis.

Arguments:tagname – name of the tag