Using the Set Browser and Set Viewer

Navigation of Sets

You can interact with the Set Browser navigation by single clicking on set choices and expand/contract controls. This single clicking interaction only affects the Set Browser navigation panel and the context within that navigation. You are only interacting with that navigation control panel. You must double click on a specific set to cause the Set Viewer panel to make that set the subject of its view.

When you double click on a given set, that set becomes the subject of the Set Viewer panel.

Note: You must click the refresh button to cause the Set Viewer panel display to be updated to show the current and full report about nodes in the set, based on the selection rules for the set. The refresh uses the set selection rules to identify all the nodes that currently match the rules to belong to the set.

The mode of display showing the nodes in the subject set can be modified by selecting a particular view of the set. You can view the detailed nodes in the set in three different ways, or you can view a summary report on attributes of the set. When viewing the nodes in the set, you can view them as a dependency graph from two different perspectives, showing the nodes and their dependency arcs, or you can just simply view the nodes without any information about their dependency.

Move Backwards and Forwards to Viewed Sets

As you click on sets in the Set Browser to view them in the Set Viewer, you can move back to the previous set you had in view by clicking on the Backwards icon in the upper left, in the command row. After moving backwards, you can then move forward by clicking Forwards icon .

At any time you can hold down the left mouse click on either the Backwards or Forwards icon to pop-up a navigation list of sets visited. You can click on any of the sets in the list to switch to making that set the subject of the Set Viewer.

Vertical Graph View of a Set

This view displays the nodes in the set as a graph showing their dependency relationship as arcs between the nodes. The graphical relationship has a vertical perspective. The earliest dependencies in the graph are shown at the top of the graph, with latest dependencies shown at the bottom of the graph.

Open the Vertical Graph view by clicking the Vertical Graph icon or by using the keyboard shortcut shift-G.

In the Set Viewer:

Hover the mouse over a node; a pop-up dialog appears that describes that node.
Left-clicking on a node selects it. A yellow border around the node indicates that it is selected.
Right-clicking on a node displays a context menu. This menu provides options so you can perform selected operations on that node.
Double-clicking the left button on a node opens the Node Editor in a separate window to show the properties of the current node.
When the Node Editor dialog opens, it provides a set of tabbed pages. The default view for Job Nodes (rectangles) is the Job Info tab. The default view for File Nodes (circles) is the File tab.

Choose the Execution & Impact tab for a Job Node to see a report on the downstream impact of this job running.

The Why tab is available for both a Job Node and a File Node. This tab shows an explanation for the current state of the node.

Horizontal Graph View of a Set

This view displays the nodes in the set as a graph showing their dependency relationship as arcs between the nodes. The graphical relationship has a horizontal perspective. The earliest dependencies in the graph are shown on the left of the graph, with latest dependencies shown on the right of the graph.

Open the Horizontal Graph view by clicking on the Horizontal Graph icon button

or by using the keyboard shortcut shift-H.

The interaction with this view is the same as in the Vertical Graph view.

Hover the mouse over a node; a pop-up dialog appears that describes that node.
Left-clicking on a node selects it. A yellow border around the node indicates that it is selected.
Right-clicking on a node displays a context menu. This menu provides options so you can perform selected operations on that node.
Double-clicking the left button on a node opens the Node Editor in a separate window to show the properties of the current node.
When the Node Editor dialog opens, it provides a set of tabbed pages. The default view for Job Nodes (rectangles) is the Job Info tab. The default view for File Nodes (circles) is the File tab.

Grid View

This view displays the nodes of a set in a tight grid without regard to their location in the dependency graph. This is a graphical representation for the dependency graph in which arcs are not shown and the nodes are compactly arranged in a non-overlapping grid.

This display is effective when watching hundreds or thousands of jobs because it shows the changes of state in each node in a way that is easy to monitor. A node that fails has a distinct color that sticks out from the grid display. Progress through the nodes can be seen easily by setting the console preference in the General tab to enable "Move jobs to the bottom of the grid mode when they start". This shows the starting jobs accumulating along the bottom of the grid so that it is easy to monitor them starting, and noting their outcome.

You can switch to the Grid view by clicking the Grid icon

or use the keyboard shortcut shift-Q.

While the appearance of the nodes in the window is different, the behavior is the same as the graph view:

Mouse over a node; a descriptive label pops-up
Right-clicking on a node displays a context menu
Double-clicking on a node opens the Node Edit dialog.

Stat View

This view of the sets provides a tabular report on set attributes rather than showing the nodes that are members of the set.

Switch to the Stat view by clicking the Stat icon or use the keyboard shortcut shift-S.

The Stat view offers a summary representation of the nodes in the selected set. This view is effective when you are working with millions of nodes and can only monitor a summary of them.