RUSH RENDER QUEUE (C) Copyright 1995,2005 Greg Ercolano. All rights reserved. V 102.41 02/25/05 Strikeout text indicates features not yet implemented

Irush Overview

SECTION 1 Starting Up irush Animated Tutorial Selecting Jobs SECTION 2 Adding Frames Removing Frames Using Job Edit Adding Cpus, Removing Cpus Sorting Changing Priority Defining Hot Keys Creating Desktop Shortcuts to irush Windows   Mac OSX   Linux   Irix Running irush from the Command Line Changing irush defaults via $RUSH_DIR/etc/.irushrc You Are Not The Owner? ** NOTE: This tutorial is in progress *** Use the software's online help, which is fully functional. Just right click on any irush buttons or inputs for pop-up help.

Irush Startup Screen

To bring up the interface, just run 'irush' from the command line, or click on a desktop shortcut. When irush comes up, the screen looks like this:

Irush Startup Screen

Irush is a job control and monitoring tool. You supply irush a jobid to control, and its interface will let you manipulate that job easily. An important thing to remember is: the Jobid in the upper right corner of the irush screen is the current job being controlled.



By default, the Jobid is empty; you can either type in the jobid, pick it from a list of jobs, or invoke irush with the jobid on the command line.

The jobid affects most all buttons in the upper part of the window. There is a black border grouping these buttons together to indicate this association:



For instance, hitting 'Frames' or 'Cpus' (in the upper window) will list the frames or cpus for the current jobid. Same for 'Pause', 'Dump', and 'Job Edit' buttons in that button grouping.

The large, lower window is where reports are displayed. You can highlight data from these reports using the mouse, and use the controls to affect the items you selected. The large window and the controls are also grouped with a black border to indicate this association:



...this example shows a frame list with several frames highlighted. Hitting any of the controls to the left will affect the highlighted frames.

The controls change, depending on the report being displayed:



The controls are empty if the data being displayed in the window is not recognized by irush, such as occurs if you hit the CMD button to get a directory listing.

Animated Tutorial

Here's an animated tutorial that shows how to select jobs, requeue frames, and monitor your frames' error logs.

Short tutorial on how to use irush. This is a large gif; you may want to let it completely load before watching.

Selecting Jobs

To select a job, you can do any of the following:
• Supply the jobid on the irush command line.
• If irush is already up, just enter the jobid in the Jobid window.
• List all jobs, and pick one of them. This is sometimes the easiest.

Here are examples of each technique:

Entering a Jobid

If you already know the jobid, just type it in the Jobid window.

-- OR --

Picking a Job

Click on either 'Jobs' or 'All Jobs' to get a jobs report. Double Click the job you want to monitor. The jobid will appear in the 'Jobid' window, just as if you had typed it.

With a jobid set, the buttons in the upper window will affect this job. For instance, hit 'Frames' to see the job's frame list.

Frames Report

The frame list shows the status of each frame, the hostname it ran on, and the start time and elapsed time for each frame. Each time you hit the Frames button, you'll get an updated report. Use the Repeat button to have the report automatically update.

With a frame report on screen, you can select certain frames, then use the frame controls (that appear to the left of the report) to modify the frames. For instance, you can requeue frames with the 'Que' button.

RequeingFrames

Highlight some of the frames in the report by clicking them. You can also click and drag to select a range of frames, or hold down the Ctrl key to toggle-select. To select all frames in a particluar state, you can use the Select All... pulldown menu.

Click the 'Que' button under the frame controls. This will cause the selected frames to be requeued, and an updated report will be displayed.