| Contents | Index | JAMS Home | Support |
| ||||
|
| Previous | Contents | Index |
This chapter describes the JAMS DECwindows/Motif Interface.
8.1 Starting the JAMS DECwindows/Motif Interface
When JAMS is installed, JAMS is added as a Session Manager/FileView menu item. If you have not customized your Applications pull-down menu, the JAMS menu item will be automatically added to your Applications Menu.
If the JAMS menu item does not appear in your Applications Menu, pull-down the Options Session Manager menu and select Menus.... This will display a dialog box which lets you customize your menus. Add the JAMS menu item to one of your menus and click on the Ok button.
Once the JAMS menu option is available on one of your menus, you can select it to activate the JAMS DECwindows/Motif interface.
You can also activate the JAMS DECwindows/Motif interface by
running the JAMS_MASTER_MOTIF.EXE executable which is in
JAMS_EXE:.
8.1.1 Remote Connections
You can define the logical name JAMS_REMOTE_CONNECTIONS to be a list of remote node specifications JAMS will connect to when the DECwindows/Motif interface starts. The remote node specifications should be in the standard DECnet format as in the following example:
$ DEFINE JAMS_REMOTE_CONNECTIONS GRAPE, TRAFIC"MYPROXY" |
In this example, when JAMS_MASTER_MOTIF starts up, connections will be
established to the remote node GRAPE using the current users default
DECnet proxy and to the remote node TRAFIC using the MYPROXY
username/proxy.
8.2 Submit Window
The Submit Window is used to select and submit JAMS Jobs which are run on demand. The window consists of a default or user defined menu hierarchy. The default hierarchy shows all of the JAMS Systems, expanding a System displays all of the Jobs and Setups for the selected System.
If you want to specify a user defined menu, define the logical name JAMS_DEFAULT_MENU to be the name of the menu which you want to use as the top level menu.
Figure 8-1 is an example of the Submit Window.
Figure 8-1 DECwindows Submit Window
The Submit Window displays a menu hierarchy. A sub-menu is denoted with a triangle to the left of the menu name. If the triangle points to the right, the menu is not expanded. If the triangle points down, the menu is expanded. To expand a menu, you can double click on the menu or, click on the menu (to select it) and then pull down the Action menu and select Expand. You can also press MB3 while the cursor is on the menu you want to expand and then select Expand from the pop-up menu.
You can submit a Job or Setup by double clicking on the Job or Setup. You can also select Submit from the pull-down or pop-up menu.
You can activate the JAMS History window and display a Jobs
history by selecting Show History from a pull-down or
pop-up menu.
8.2.2 File menu
The File pull-down menu is used to control the Submit window.
This menu option activates a dialog box which allows you to connect to a remote JAMS Server. Once connected, you can submit Jobs on that server.
This menu option lets you disconnect from one of the remote JAMS Servers which you are connected to.
This menu option activates a dialog box which allows you to select which windows will be opened when the JAMS DECwindows/Motif interface is started.
This menu option will save the current size and position of the JAMS windows. These sizes and positions will be used the next time you start the JAMS DECwindows interface.
This menu option will close the Submit window. If there are no other JAMS windows open, the image will exit.
This menu option will close all of the JAMS windows and exit.
8.2.3 Action menu
The Action menu is used to perform an action on the Submit window or the selected line in the Submit window. The items in the Action menu are also available from a pop-up menu. Press MB3 to display the pop-up menu. The options on the Action menu include:
This option will expand the selected line. This option is only active when the selected line is a menu line.
You can also expand or collapse a menu by double clicking on the menu line.
This option will collapse the selected menu line. This option is only active when the selected line is a menu line.
You can also expand or collapse a menu by double clicking on the menu line.
This option will collapse all expanded menus.
This option activates the JAMS History Window, clears the current history list and performs a search for history of the selected Job.
This option will submit the selected Job or Setup. A dialog box which
contains the jobs parameters will be displayed. If the Job has defined
reports, you can click on the Reports... button to display and possibly
override the report printing information.
8.2.4 Window menu
The Window menu is used to activate other portions of
the JAMS DECwindows/Motif interface. From the Submit window,
you can activate the History window, the Monitor window or the
Definitions window.
8.3 Submitting a Job
When you submit a job, a dialog box which contains the jobs parameters
will be displayed. If the Job has defined reports, you can click on the
Reports... button to display and possibly override the report printing
information.
8.4 Monitor Window
The Monitor Window is used to monitor and manage the batch jobs which
are known by the JAMS. The JAMS Job Monitor is a high
performance, continuously updated display of all batch jobs scheduled
or submitted by end-users. This display also provides comprehensive job
management capabilities.
8.4.1 The Monitor Display
The Monitor Window includes two types of display lines, top level categories and Jobs. A top level category line includes an icon which shows whether or not the line is expanded, the number of jobs in the category, the name of the category and detail headings. You can expand or collapse a category line by double clicking on the line.
Figure 8-2 is an example of the Monitor Window.
Figure 8-2 DECwindows Monitor Window
When a Job is executing, the Monitor includes the following information:
This is the JAMS entry number for the job.
This is the name of the job as specified in the JAMS Job definition.
This is the name of the node on which this job is running.
This column shows the CPU utilization percentage for this job during the most recent update interval.
This column shows the average number of direct I/O's per second which this job performed during the most recent update interval.
If this job is registered in the JAMS database, we can compute the completion percent based on the Job's past performance. This percentage is an estimate of how close to completion the Job is. This can be a useful monitoring tool. If an operator sees a Job which shows a completion percentage of 200%, they know that the Job has used twice the resources which it normally takes and they may want to take corrective action.
This percentage is calculated using the Jobs current and average CPU usage and Direct I/O count so running the a Job on a heavily loaded system will not affect this calculation.
If this Job is registered in the JAMS database, we can calculate how much longer the Job is going to run based on the Job's past performance. This calculation is based on the Job's current CPU utilization and direct I/O per second count. We extrapolate this data to determine how much longer the job will run before reaching its average CPU usage and direct I/O count.
This shows how long the Job has been executing, in hours and minutes.
This shows how much CPU time the Job has accumulated, in hours and minutes.
This shows the number of direct I/O operations performed by the Job.
8.4.3 File menu
The File pull-down menu is used to control the Monitor window.
This menu option activates a dialog box which allows you to connect to a remote JAMS Server. Once connected, you can monitor Jobs on that server.
This menu option lets you disconnect from one of the remote JAMS Servers which you are connected to.
This menu option activates a dialog box which allows you to select which windows will be opened when the JAMS DECwindows/Motif interface is started.
This menu option will save the current size and position of the JAMS windows. These sizes and positions will be used the next time you start the JAMS DECwindows interface.
This menu option will close the Monitor window. If there are no other JAMS windows open, the image will exit.
This menu option will close all of the JAMS windows and exit.
8.4.4 Action menu
The Action menu is used to perform an action on the Monitor window or the selected line in the Monitor window. The items in the Action menu are also available from a pop-up menu. Press MB3 to display the pop-up menu. The options on the Action menu include:
This option will expand the selected line. All current and future jobs in this category will be displayed. This option is only active when the selected line is a top level line.
You can also expand or collapse a category by double clicking on the category line.
This option will collapse the selected line. The jobs in this category will no longer be displayed. This option is only active when the selected line is a top level line.
You can also expand or collapse a category by double clicking on the category line.
This option will collapse all of the top level categories.
You can also expand or collapse a category by double clicking on the category line.
This option will display a window which shows detailed information about the selected Job. This information will be updated as the Job executes.
You can also display a Jobs detail window by double clicking on the Job.
This option activates the JAMS History Window, clears the current history list and performs a search for history of the selected Job.
Jobs can be in a pending or holding state for many different reasons. When you elect to release a job, a window will appear showing all the reasons this particular job is not running. You can then decide to remove some, or all of the constraints which are keeping the job from executing.
The selected job is held until released.
This option is used to change the scheduling attributes of a job which is not executing. A dialog box is displayed which allows you to change the attributes of the job.
This option is used to abort and restart an executing job. A window is displayed which allows you to specify where the job should execute as well as the hold status. If you complete the form and click on the Ok button, the job is aborted and either restarted or placed on hold.
If the selected job is currently executing it is aborted. Otherwise the
job is deleted from the schedule.
8.4.5 Window menu
The Window menu is used to activate other portions of
the JAMS DECwindows interface. From the Monitor window, you
can activate the Submit window, the History window or the Definitions
window.
8.5 History Window
The History Window is used to search and examine batch job execution history.
Figure 8-3 is an example of the History Window.
Figure 8-3 DECwindows History Window
The History display window contains one line for each history record which matched your selection criteria. Each line shows the Job Name, final status and, submit, start and completion time. You can double click on a line to display a detail window.
You can sort the list by Job Name, Start Time or End Time. To sort the list, pull down the Action menu, move to Sort and then select one of the sort options from the cascade menu.
Each time you use the Search... option, the records
which match your selection criteria are added to the existing records.
You can clear the list by selecting Clear List from
the Action menu.
8.5.2 File menu
The File pull-down menu is used to control the History window.
This menu option activates a dialog box which allows you to connect to a remote JAMS Server. Once connected, you can search History on that server.
This menu option lets you disconnect from one of the remote JAMS Servers which you are connected to.
This menu option activates a dialog box which allows you to select which windows will be opened when the JAMS DECwindows/Motif interface is started.
This menu option will save the current size and position of the JAMS windows. These sizes and positions will be used the next time you start the JAMS DECwindows interface.
This menu option will close the History window. If there are no other JAMS windows open, the image will exit.
This menu option will close all of the JAMS windows and exit.
8.5.3 Action menu
The Action menu is used to perform an action on the History window or the selected line in the History window. The options on the Action menu include:
This option will display a window which shows detailed information about the selected Job. From this detail window, you can also view the Jobs log file.
You can also display a Jobs detail window by double clicking on the Job.
This option displays a dialog box in which you enter your selection criteria. When you click on the Ok button, the search starts and a work in progress box is displayed. The work in progress box has a Cancel button which can be used to cancel a long search. If you cancel a search, all of the records located thus far will be included in the list.
The number of records which a single search will add to the list can be limited. Define the logical name JAMS_HISTORY_LIMIT to be the desired limit. If this logical name is not defined, the limit defaults to 500 records.
Each time you use the Search... option, the records which match your selection criteria are added to the existing records. You can clear the list by selecting Clear List from the Action menu.
The option allows you to sort the current list by Job Name, Start time or End time.
This option clears all of the history lines from the list. Each time
you perform a search, the lines which match the search are added to the
current list.
8.5.4 Window menu
The Window menu is used to activate other portions of
the JAMS DECwindows interface. From the History window, you
can activate the Submit window, the Monitor window or the Definitions
window.
8.5.5 History Search Window
The Search window is displayed to obtain search selection criteria. You can enter:
Enter a System ID to limit the history records to Jobs from the specified System. Leave this field blank to display Jobs from any System.
Enter Job Name with wildcards. The wildcard characters are * which matches any set of characters and % which matches any single character.
Enter the beginning and ending date and time range. Only Jobs submitted within this range will be included in the list. If you leave the times blank, they default to midnight for the start time and 23:59:59.99 for the end time.
You can limit your search to only Jobs with a specific final status
severity. Select the severities which you want to include in your list.
8.6 Definitions Window
The Definitions Window is used to maintain the JAMS database.
Figure 8-4 is an example of the Definitions Window.
Figure 8-4 DECwindows Definitions Window
The Definitions window includes a button bar which includes:
The Definitions display window contains one line for each record which
matched your selection criteria. You can double click on a line to
display a detail window.
8.6.3 File menu
The File pull-down menu is used to control the Definitions window.
This menu option is disabled in the Definitions window.
This menu option is disabled in the Definitions window.
This menu option activates a dialog box which allows you to select which windows will be opened when the JAMS DECwindows/Motif interface is started.
This menu option will save the current size and position of the JAMS windows. These sizes and positions will be used the next time you start the JAMS DECwindows interface.
This menu option will close the Definitions window. If there are no other JAMS windows open, the image will exit.
This menu option will close all of the JAMS windows and exit.
8.6.4 Action menu
The Action menu is used to perform an action on the Definitions window or the selected line in the Definitions window. The options on the Action menu include:
Pops up the search dialog box for the current view. When you click on the Ok button, the search starts and a work in progress box is displayed. The work in progress box has a Cancel button which can be used to cancel a long search. If you cancel a search, all of the records located thus far will be included in the list.
Clears the list for the current view.
Displays the detail of the currently selected line.
Pops up the JAMS History window and performs a search based upon the currently selected line in the Definitions window.
Displays the detail of the currently selected line and allows modification.
Submits the currently selected line in the Definitions window.
Copies the currently selected item to a new name.
Adds a new item. This is a cascading menu which allows you to add a System, Trigger, Variable or Menu.
Deletes the currently selected item. A confirmation dialog box is
displayed to confirm the delete.
8.6.5 Window menu
The Window menu is used to activate other portions of
the JAMS DECwindows interface. From the Definitions window,
you can activate the Submit window, the Monitor window or the History
Window.
8.6.6 Management menu
The Management menu is used to view or modify various JAMS management objects. The options on this menu include:
Used to specify special dates used for scheduling or date parameters.
Used to define Access Control Lists which control access to various JAMS options.
Used to define remote nodes which are also running JAMS. These nodes may be used for remote job dependencies.
Used to define groups of remote nodes which may be used to define job dependencies. Defining a dependency on a job at a remote node group is the same as defining a dependency for the job on each node in the node group.
Used to define JAMS configuration options.
Used to define special date types.
8.6.7 Search Criteria
When you initially select a category of definitions, or when you press the Search button, you are presented with a search criteria dialog box.
Only records which match the criteria entered will be displayed in the
Definitions window. You can also choose to clear the list before
performing the new search.
8.7 Connect Dialog
When you select Connect to Server from the
File menu, a dialog box is displayed which has three
fields, Server Name, Username and Password. The Server Name is the
DECnet node name of the server you want to connect to. You can leave
the Username and Password fields blank to access the server via a
DECnet proxy. You can also enter a Username and leave the Password
blank to use a specific DECnet proxy.
8.8 Using Help
There are three ways to obtain help from within the JAMS DECwindows interface:
The Help menu has a number of options. If you select On Context, the cursor changes to a question mark and you can click on the component of the window on which you would like help.
The On Window option will provide help on the entire window.
The Tutorial option provides a tutorial on JAMS. This is a good place to start if you are new to JAMS.
The Using Help option displays the text you are now reading.
The On Version option displays a dialog box which contains version and support information.
If you press the [Help] key, JAMS will provide help on the item in which the cursor is located. If this item does not have any specific help, help will be displayed on the next higher item (such as the window which contains the item).
Some dialog boxes have a Help button which will provide help which is specific to the dialog box. In some cases, a dialog box will have a Help button but it will not be active. This means that the dialog box is capable of providing help but there is no help available for the specific message being displayed by the dialog box.
| Previous | Next | Contents | Index |
 | Copyright © 2000, MVP Systems, Inc. All rights reserved. |