Argument	Default	Description
augment	0	Augment the set of nodes already selected (1 is true)
stayInWin	1	Follow only those arcs to nodes inside the active window (1 is true)

Description:

This command is applied to all nodes in the active window. For a given node, &quotalpha", in the window, every arc (both incoming and outgoing) of the current arc type (see rcl_set_current_arctype), is traversed to its remote node. This set of remote nodes is then reviewed. Any node that is connected by the current arc type to the remote node, with the exception of node &quotalpha", are added to the selection set provided that it meets the threshold selection criteria. This process is repeated for each node in the window. This command is a combination of the rcl_select_common_client and rcl_select_common_supplier commands.

The low and high threshold settings are used as criteria for selecting the nodes (see rcl_set_low_thresholds and rcl_set_high_thresholds). If a candidate for the selection set is a client to a remote supplier node and if that supplier exports services to nodes whose number is bounded inclusively by the low and high threshold, then the candidate is added to the selection set. Similarly, if a candidate for the selection set is a supplier to a remote client node and if that client imports services from nodes whose number of nodes is bounded inclusively by the low and high threshold, then the candidate is added to the selection set.

If the augment parameter is set to false, any nodes previously selected are deselected before the command executes.

If stayInWin is set to false, arcs extending to nodes beyond the window are traversed, not simply those within the window.

Return Value:

The number of nodes selected is returned.

Exceptions:

If the current arc type is "composite", a pop-up dialog box displays an error.

Example:

# Assume that the list demo has been run and that there is an open
# window showing all of the functions and data types. Set the arc
# type to "any", the low threshold to "0" and the high threshold
# to "1". Then select the set of common clients and suppliers.

rcl_set_current_arctype any
rcl_set_low_thresholds 0
rcl_set_high_thresholds 1
rcl_select_client_supplier

# All nodes except "main" are selected.

Back to RCL Command Index