When you choose Help > About IRIXView, the program displays the window shown in Figure 6-3, which contains version and copyright information. To dismiss this window, click the OK button or double-click the control menu bar in the upper left hand corner.

Figure 6-3. About IRIXview Window

When you choose Options > Context Graph, the program displays the window shown in Figure 6-4, which provides useful control over all active Context View graphs.

Figure 6-4. Context Graph Options Window

To display the kernel thread ID number in the interrupt and process buttons of all active Context View graph windows, check mark the Kthread ID box. To display process or thread priorities, check mark the Priority box. To remove the default process ID number, uncheck mark the Process ID box. The effect is immediate.

The scrolling list of this window contains a list of all interrupts and processes shown in the Context View window. By default, all items in the list are check marked. You can uncheck them all by clicking the None button, or uncheck mark individual items in the scrolling list. The All button check marks all items again. To change the display of items in the Context View graph, click the Apply button.

For events that print qual[0-3] data, especially user-defined events, choosing the Options > Data Format menu item allows you to change the output data format from decimal (default) to octal, hexadecimal, or ASCII.

This icon is located in the icon bar of a Context or CPU View graph, which are displayed with the “New Graph” choices in the Windows menu.

Figure 6-5. Display Events/States Icon

When you click this icon, IRIXview displays the Display Events/States window, as shown in Figure 6-6. This window contains commands that let you change which events are displayed within the graph subwindow, and how they are treated.

Figure 6-6. Display Events/States Window

To control which elements are displayed in the Context View or CPU View graph, toggle these event or state types on (or off) and click Apply. When you bring up a Display Events/States window from a CPU View graph, some of the items are grayed out. From a Context View graph, some event or state types are not displayed by default.

---

Note: This is different from the Target window, which controls event logging, rather than event display; see “Target Window”.

---

The following list describes the event or state types you can display:

Syscall		If toggled on, system call icons are displayed.
VM		If toggled on, virtual memory event icons are displayed.
Signals		If toggled on, signal event icons are displayed.
Interrupts		If toggled on, interrupt event icons (intEnt and intExit) are displayed.
Dispatches		If toggled on, dispatch event icons are displayed
User Defined		If toggled on, user-defined event icons are displayed.
Allocate		If toggled on, memory allocation event icons are displayed.
Frame Sched.		If toggled on, frame scheduler (FRS) event icons are displayed?
Profile		If toggled on, profiler event icons are displayed?
Disk		If toggled on, disk I/O event icons are displayed?
Net		If toggled on, network event icons are displayed?
Processes		If toggled on, process event icons are displayed. Note: Not all listed process events can be displayed (for example, the processSpawn event cannot be displayed).
Nonexecuting States		If toggled on, process states besides executing state (for example, pended state and ready state) are displayed.
Transition Lines		If toggled on, vertical lines connecting a previous context to the current context are displayed.
Interrupt Transitions		If toggled on, vertical lines to or from an interrupt context are displayed.
Annotate Events		If toggled on, number are placed alongside event icons.

This choice is located in the Windows menu, and displays the Event Inspector window, as shown in Figure 6-7.

Figure 6-7. Event Inspector Window

To use this window:

The Legend Window icon is located in the icon bar of the Context View or CPU View windows, which may be displayed by choosing Windows > New...Graph.

Figure 6-8. Legend Window Icon

Click this icon to display a scrollable Legend window, showing what each event icon and stipple means. Legend windows for the Context View and CPU View are different; both are shown in Figure 6-9.

Figure 6-9. Legend Windows (Context and CPU)

This choice is located in the Windows menu and displays a Context View graph window where you can examine event data, as shown in Figure 6-10.

Figure 6-10. Context View Graph Window

The Context View is a window into the event data; in most cases, it does not show the entire event log. Instead, what is shown is a time interval. Use your window manager to resize the Context View window, if needed. You can refresh the Context View graph at any time by moving the cursor into the window and clicking the right mouse button.

The first Context View window that you display is labeled View 1. You can display up to 16 Context View windows at a time, which can be useful for looking at different portions of the same event log. Each one is numbered in the order that it is displayed; the second graph would be labeled Context View 2, and so on. When you display auxiliary windows (for example, by clicking the V icon to display the View Options window; see “View Options Window”), auxiliary windows are numbered to match the Context View from which they were invoked. For example, if you click the V icon from View 3, the resulting window is labeled View Options 3.

This choice is located in the Windows menu and displays a CPU View graph window where you can examine processor data, as shown in Figure 6-11.

Figure 6-11. CPU View Graph Window

The CPU View is a window into the processor data; in most cases, it does not show the entire event log. Instead, what is shown is a time interval. Use your window manager to resize the CPU View window, if needed. You can refresh the CPU View graph at any time by moving the cursor into the window and clicking the right mouse button.

The first CPU View window that you display is labeled View 1. You can display up to 16 CPU View windows at a time, which can be useful for looking at different portions of the same event log. Each one is numbered in the order that it is displayed; the second graph would be labeled CPU View 2, and so on. When you display auxiliary windows (for example, by clicking the V icon to display the View Options window; see “View Options Window”), auxiliary windows are numbered to match the CPU View from which they were invoked. For example, if you click the V icon from View 3, the resulting window is labeled View Options 3.

When you choose File > Open, IRIXview displays the Open Event File window, as shown in Figure 6-12. This window lets you open an event log created with the Save Event File window; see “Save Event File Window”.

Figure 6-12. Open Event File Window

The current working directory is displayed in the Filter and Selection fields by default. As you move to other directories, the Directories and Files subwindows automatically resize to show as much information as possible.

To use this window, follow these steps:

If the event log is successfully opened, a message like the following appears in the Main window message area:

Connected to host localhost.
4 CPUs on localhost, 4 selected CPUs
TSTAMP_EV_CONFIG: 
      Cpu   0: revision 19970320 
      cputype R4400- tstampfreq 47619047 
      Event types : 
          -Tasks-Intr ...

Then, if a Context View graph is displayed, the event log is displayed there; see “New Context Graph Menu”. (Note that you can display the Context Graph either before or after you have opened an event log.)

At any time, you can click the Cancel button to dismiss the Open Event File window from the screen, or click the Help button to display information on this window.

These icons are located in the icon bar of the Context View or CPU View windows, which may be displayed by choosing Windows > New...Graph.

Figure 6-13. Pan Left/Pan Right Icons

Pan Left and Pan Right move the time interval one page to the left or right, where a page is defined by the width of the current time interval.

These icons are located in the icon bar of the Context View or CPU View windows, which may be displayed by choosing Windows > New...Graph.

Figure 6-14. Push/Pop/Exchange Icons

The Push icon saves the current time interval. You can later move back to this time interval with the Pop or Exchange icon. You can push up to 16 time intervals— if you push more than 16, the oldest intervals are discarded in FIFO order.

The Pop icon causes the most recently pushed time interval to be displayed.

The Exchange icon swaps the currently displayed time interval with the most recently pushed time interval. For example, find an interval that is of interest to you and save it with the Push icon. Then click the Exchange icon repeatedly to move between that interval and the current interval.

To exit IRIXview, choose File > Quit. The IRIXview main window and all its related windows are removed from the screen.

---

Note: When you exit IRIXview, you are not prompted to save your event data. To save event data before exiting, see “Save Event File Window”.

---

This choice is located in the File menu, and displays the Save Event File window, as shown in Figure 6-15. This window lets you save event logs that you can later with the Open Event File window; see “Open Event File Window”.

Figure 6-15. Save Event File Window

The current directory is displayed in the Filter and Selection fields. As you move to other directories, the Directories and Files subwindows are automatically resized to show as much information as possible.

When an event log is saved, its filename usually has an irv suffix, for example: filename.irv.

At any time, you can click the Cancel button to remove the Save Event File window from the screen, or click the Help button to display information on the window.

When you choose Windows > Scheduler Summary from the main menu of IRIXview, the Scheduler Summary window appears, as shown in Figure 6-16. This window shows status information for all processors, the run queue length, and scheduler status.

Figure 6-16. Scheduler Summary Window

The Search Accelerator icons are located in the icon bar of the Context View or CPU View windows, which may be displayed by choosing Windows > New...Graph.

These icons find the next or previous occurrence of the currently selected event.

Figure 6-17. Search Accelerator Icons

An event may have been selected because it was found by a previous search request, or you may have selected it with the middle mouse button (see “Selecting Event Data”).

The underlined arrows find the next (or previous) occurrence of the currently selected event in the same context, that is, in the same process, interrupt level, or idle thread context.

The middle arrows without underlines search for the next or previous occurrence of the currently selected event, regardless of context.

The Search Window icon is located in the icon bar of the Context and CPU graphs. To open a graph window, choose Windows > New Context Graph or New CPU Graph.

Figure 6-18. Search Window Icon

When you click the Search Window icon, a Search window displays, as shown in Figure 6-19. (The number 1.1 in the title indicates that this is the first search window for the corresponding first View window.)

Figure 6-19. Search Window

You can search for a particular event, the next or previous event in a particular context, or the next or previous event of any type in any context. Context entries can be the context name only, the process ID (PID), or the kernel thread ID (KID). Follow these steps to use the Search window:

When the next (or previous) occurrence of the event is found, the Context View graph displays the time interval in which it occurs, and indicates the occurrence that it found by placing a vertical line through it. Timing information is displayed in the Detailed Information field (see “Using the Context View Graph”).

The CPU Search window works the same way, but note that event symbols are not normally displayed in the CPU View graph window. You have to enable symbol display by check marking events in the Display Events/States window. For more information, see “Display Events/States Window”.

To search for another occurrence of the event, you can use the Search window again, or you can use the Search Accelerator icons in the Context Graph. For information on these icons, see “Search Accelerator Icons”.

---

Note: You can display multiple Search windows for a graph. Each Search window is labeled sequentially. The first number represents the graph window from which you invoked the Search window, and the second number represents which Search window it is, relative to all Search windows currently displayed for this Context graph. For example, if you have two Context graphs open, the second window you opened is labeled Context View 2. Clicking the S button in this window launches the Search dialog labeled 2.1, the first search for View 2. The next Search window for Context View 2 would be labeled Search 2.2. The maximum number of Search windows for each Context View graph is 16.

---

Before using this window, you need to collect system call information, not collected by default. First run irixview as superuser. In the Target window, select Syscall, and collect event data from the local host.

Choosing Windows > System Call Summary then shows system calls that occurred during the collection period, as shown in Figure 6-20.

Figure 6-20. System Call Summary Window

This choice is located in the Windows menu, and displays the Target window, as shown in Figure 6-21. This window lets you do the following:

This icon is located in the icon bar of a View Graph, which can be displayed with choices New Context Graph or New CPU Graph in the Windows menu.

Figure 6-22. Time Units Menu Icon

If you click and hold the left mouse button over this menu icon, you can choose the unit of time displayed in the Timeline and the Detailed Time Information field (see “Using the Context View Graph” for information on these locations). The choices are:

This icon is located in the icon bar of a Context or CPU View graph, which are displayed with the “New Graph” choices in the Windows menu.

Figure 6-23. View Control Window Icon

When you click this icon, IRIXview displays the View Control window, as shown in Figure 6-24. This window contains commands that let you change how the event log is treated within the graph subwindow.

Figure 6-24. View Control Window

To use this window, follow these steps:

These icons are located in the icon bar of the Context View or CPU View windows, which may be displayed by choosing Windows > New...Graph.

Figure 6-25. Zoom In/Zoom Out Icons

The capital Z (Zoom In) icon lets you focus on details; the lowercase z (Zoom Out) icon lets you focus on a bigger picture. Keyboard shortcuts are available: you can press the Z key to zoom in or the z key to zoom out.

Zoom In halves the time interval displayed, preserving the screen's midpoint. If a sub-interval is selected, the boundaries of the sub-interval become the time interval's boundaries.

Zoom Out doubles the current time interval (or a selected sub-interval), preserving the midpoint, if possible.

For information on selecting a sub-interval, see “Selecting Event Data”.