geLoadProbe

geLoadProbe( 
[ w_windowId ] 
[ p_port ] 
[ s_prop ] 
[ s_cond ] 
[ g_value ] 
)
=> t / nil 

Description

Loads probes into a window.

The probes are recreated by reading the necessary information in the property list saved from a geSaveProbe call. This property list also allows the restoring of any user-defined or application-specific properties that might have been put on the probes.

The optional parameters s_prop, s_cond, and g_value conditionally load probes. s_prop is a symbol representing a property name. s_cond is a SKILL symbol representing the condition. g_value is the reference value. The probe is loaded only if s_prop is related to g_value by s_cond.

Arguments

w_windowId	Database ID of the window containing the probes you want loaded. If not specified, the current window is used.
p_port	Port to load the probe information through. If p_port is not specified, the probes are read from the file probe.out.
s_prop	Property to be examined in deciding whether to load probe.
s_cond	Condition that must be satisfied if the probe is to be loaded.
g_value	Value of the property tested against the condition to decide whether to load the probe.

Value Returned

t	A probe was found and loaded.
nil	A probe was not found and loaded.

Examples

Loads all probes in file /tmp/myProbes.out that have the user-defined property myProperty equal to the string critical.

m = infile( "/tmp/myProbes.out" )

geLoadProbe( window(3) m ’myProperty ’equal "critical")

Related Topics

Probe Functions

geUnRegCrossProbeTrigger

Probe File Format

Return to top