Queue Viewer (QViewer) Version 1.1 (D29.0.2)

Users' Guide

Table of Contents


General Information:

Introduction
How do I start the application?
What should I enter at the login screen?
How do I know what version of QViewer I'm running?
How do I exit the program?
Data Tables:
How often will the tables refresh?
What is the Requests Table?
How do I know what rules are associated with the request?
Why are some of the requests in color and some are not?
What is the Job Descriptions Table?
How do I know what predict parameters are associated with the job?
Why are some of the jobs in color and some are not?
What is the Active Jobs Table?
How do I sort the tables?
Request and Job Management:
How do I create a new request?
How do I confirm a request?
How do I modify a request?
How do I modify a job?
How do I modify a job configuration?
How do I abort, suspend, or resume a request?
How do I suspend or resume a job?
How do I run the administrative tools?
Problem Solving:
Why don't I see the request I expect?
Why don't I see the job I expect?
Why don't I see the request I expect in the Confirm Request window?
Why don't I see the request I expect in the Modify Request window?
Why don't I see the job I expect in the Modify Job window?

GENERAL INFORMATION

Introduction

Queue Viewer (QViewer) is a Java application with a graphical user interface that allows the users to review, modify, and manage the requests and jobs created by the other components of CDRS.
 

How do I start the application?

QViewer runs on a Sun Solaris machine. At the xterm, type in the following two lines:
% select t
% java jpl.mipl.cassini.CDRS.qviewer.gui.QViewerApp

Note: You may want to create an alias so that you don't have to type a long line everytime you run qviewer. To create an alias, type in the following line:
% alias qviewer java jpl.mipl.cassini.CDRS.qviewer.gui.QViewerApp

And then when you run the application, you just type the following:
% qviewer
 

What should I enter at the login screen?

You must enter in all four fields in the login screen to run qviewer successfully:

  1. User Name -- this is the user name that you would you to access the database via dbView.
  2. Password -- the password that goes with the above specified user name.
  3. Database name -- the default is devCassini.
  4. Server name -- the default is miplDev.
After typing in the four fields, you may either hit return while the cursor is in any one of the textfields, or click "OK" to proceed.

If you decide to quit at this point, click "Exit".
 

How do I know what version of QViewer I'm running?

  1. Click on the Help menu
  2. Select "Version"

 

How do I exit the program?

  1. Click on the File menu
  2. Select "Exit"

DATA TABLES

How often will the tables refresh?

By default, the tables refresh every 10 seconds. However, you may change the number by typing in a new one in the Refresh Period textfield under the User Configurable Options section. The value entered must be an integer from 1-600. Click "Update NOW"  for the change to take effect.
 

What is the Requests Table?

The Requests Table displays the following information on a request:


You have control over what requests are displayed by changing three parameters under the User Configurable Options section.

The default Requests Time is the current time. The default window is 14 days. So, using the default values as an example, the requests displayed will be all those that have an estimated request completion time 14 days prior to and 14 days after the current time.
 

How do I know what rules are associated with the request?

You can click on the request to popup the Rules Table that displays the following information:

Why are some of the requests in color and some are not?

Requests are divided into four categories base on what status they are in.

What is the Job Descriptions Table?

The Job Descriptions table displays the following information on a job:

You have control over what jobs are displayed by changing three parameters in the User Configurable Options section.

The default JobsTime is the current time. The default window is 12 hours. So, using the default values as an example, the jobs displayed will be all those that have an earliest start time 12 ours prior to and 12 hours after the current time. Note that either the days or hours must be a non-zero number.
 

How do I know what predict parameters are associated with the job?

You may click on the job to popup the Predict Parameters Table that displays the following information:
 

Why are some of the jobs in color and some are not?

Jobs are divided into four categories base on what status they are in.

What is the Active Jobs Table?

The active jobs are all those jobs that are currently running.
 

How do I sort the tables?

You may sort on any column in any table by clicking on the header name. For example, if you want to sort on the Request ID, then click on the word "Request ID". If you want to sort in a descending order, then shift-click on the word "Request ID", i.e., hold down the shift button while you click on the word.

REQUEST AND JOB MANAGEMENT

How do I create a new request?

  1. Click on the Options menu
  2. Select "Create New Request"
  1. Select a Job Type
  2. Select an Instrument
  3. Enter in the values for the Start and Stop SCET, Start and Stop SCLK, Beginning and End of Track Times (BOT, EOT), Description, SCLK Count Partition, and Request Source.
  4. Click "OK"

How do I confirm a request?

  1. Click on the Options menu
  2. Select "Confirm Request"
  1. Select a Request ID
  2. Verify that the information for Job Type, Instrument ID, Start and Stop SCET, Start and Stop SCLK, Beginning and End of Track Times (BOT, EOT), Description, SCLK Count Partition, and Request Source is correct.
  3. If correct, click "Confirm".
  4. If not, click "Modify"
  5. Edit the values for the given parameters as needed, click "Apply" when finished.
  6. Go to step 2.

How do I modify a request?

  1. Click on the Options menu
  2. Select "Modify Request"
  1. Select a Request ID
  2. Edit the information for Job Type, Instrument ID, Start and Stop SCET, Start and Stop SCLK, Beginning and End of Track Times (BOT, EOT), Description, SCLK Count Partition, and Request Source as necessary.
  3. Click "OK" to apply changes and close window, or click "Apply" to apply changes and leave the window opened.

How do I modify a job?

  1. Click on the Options menu
  2. Select "Modify Job"
  1. Select a Request/Job ID pair.
  2. Edit the information for Earliest Start Time, the Telemetry Processor Algorithm, and the FSW Version ID as necessary.
  3. Click "OK" to apply changes and close window, or click "Apply" to apply changes and leave the window opened.

How do I modify a job configuration?

  1. Click on the Options menu
  2. Select "Modify Job Configuration Parameters"
  1. Select a Job Type.
  2. Edit the information for Group ID, SFDU Source, TDS Host, TDS Port, SFDU File, Telemetry Log File Location, Working Directory, PROM File, Band Bin File, DN to EU Coefficient File, DB Predict Matching Tolerance, JEDI On/Off, JEDI Host, JEDI Port, TlmProc Logging Level, Product Output Directory, Quality Report Config File, LDAP Filter, FEI On/Off, Catalog On/Off, and User Name as necessary.
  3. Click "OK" to apply changes and close window, or click "Apply" to apply changes and leave the window opened.


    4. Note: The following parameters are not editable: Database Name, Database Server, and JEDI Class Path.

How do I suspend, resume, or abort a Request?


 
  1. Click on the Options menu
  2. Select "Request/Job Management"

 
  1. Click on the "Request ID(s)" checkbox.
  2. Select one or more request ID.
  3. Click "Suspend", "Abort", or "Resume".
  4. When done, click "Cancel" to close the window.
  5. If you do not see the request you are interested in, click "Refresh" to get the most updated list from the database.

How do I suspend, or resume a Job?


 
  1. Click on the Options menu
  2. Select "Request/Job Management"

 
  1. Click on the "Request/Job Pair(s)" checkbox.
  2. Select one or more request/job ID pairs.
  3. Click "Suspend", or "Resume". You may not abort a job. You may not resume a job which request has been suspended.
  4. When done, click "Cancel" to close the window.
  5. If you do not see the request you are interested in, click "Refresh" to get the most updated list from the database.

How do I run the administrative tools?

  1. Click on the Options menu
  2. Select "Run Administrative Tools"
  1. The application will pop up in a new window. Make changes.
  2. When done, click on "Exit".


PROBLEM SOLVING

Why don't I see the request I expect?

There are several reasons why you don't see the request you expected:
  1. The request does not fall into the time range that the application is filtering on. To fix this problem, make sure that you have entered in a correct value for the Requests Time textfield. This is the Estimated Request Completion time that the application uses to anchor on the filter. For the Requests Window (+ and -), enter in a larger number (largest accepted value is 255) to get a bigger range.
  2. If the numbers for the Requests Time and Windows are acceptable, but you still don't see the request, make sure that you have clicked the "Update NOW" button for the change to take effect.
  3. Make sure that there is a rule defined in the Rules Table for this job type. If not, then the requests will not be shown because the Estimated Request Completion time cannot be calculated.

Why don't I see the job I expect?

There are several reasons why you don't see the job you expected:
  1. The job does not fall into the time range that the application is filtering on. To fix this problem, make sure that you have entered in a correct value for the Jobs Time textfield. This is the Earliest Start Time that the application uses to anchor on the filter. For the Jobs Window (+ and -), enter in a larger number (largest accepted value is 255) to get a bigger range.
  2. If the numbers for the Jobs Time and Windows are acceptable, but you still don't see the job, make sure that you have clicked the "Update NOW" button for the change to take effect.
  3. Check the Earliest Completion Time of the Completed jobs. They must be in the following range:
      4. (Jobs Time - Jobs Window Prior) <= Earliest Start Time <= Jobs Time
  4. Check the Earliest Completion Time of the non-completed jobs. They must be in the following range:
      5. Jobs Time <= Earliest Start Time <= (Jobs Time + Jobs Window After)

Why don't I see the request I expect in the Confirm Request window?

There are two reasons why you don't see the request you expected:
  1. The request does not have a "Review" status. Only requests that are in the "Review" state can be confirmed.
  2. You popped up the Confirm Request window before the request has been created. Click on the "Refresh" button to see the most updated list of requests.
       

Why don't I see the request I expect in the Modify Request window?

There are two reasons why you don't see the request you expected:
  1. The request does not have a "Review" or "Pending" status. Only requests that are in the "Review" or "Pending" state can be modified.
  2. You popped up the Modify Request window before the request has been created. Click on the "Refresh" button to see the most updated list of requests.

Why don't I see the job I expect in the Modify Job window?

There are two reasons why you don't see the request you expected:
  1. The request does not have a "Not Scheduled" status. Only jobs that are in the "Not Scheduled" state can be modified.
  2. You popped up the Modify Job window before the job has been created. Click on the "Refresh" button to see the most updated list of jobs.


Cecilia S. Cheng x4-1452 
cecilia.cheng@jpl.nasa.gov 

Last Modified: September 4, 2002
Copyright 2002, California Institute of Technology.