
			How to use qmon ?
			-----------------

qmon is a graphical user interface (GUI) to DQS based on X and Xt. 
The top module has menus for executing DQS commands and other utility 
functions. An icon window displays the current states of the queues and,
finally a text output window to record the response of DQS commands 
launched from qmon.

General: For all the modules - Exec, Clear, and Close are common and
	they function the same way.
	Exec - builds and executes the DQS command based on the text input
	and toggle button options (True/False). A succesfull command build
	is displayed in the output window at the bottom.
	Clear - Clears all the toggle buttons and text inputs to default state.
	Close - Closes the moudle but does not clear the module input fields.

New Features: Multi-cell display and user Preferences menu.

Preferences: Use this to set up commonly needed options in DQS. You can
	also change the cell being displayed by using the cell menu.

Qusage: On clicking this button qusage program is launched.
	
Qconf: Has several popup moudles in it.

Configure Complex - To add, delete, list, or modify a queue complex.

Configure Cluster - To modify the cluster configuration file.
			(Not yet implemented in DQS)

Configure Queue - Performs some functions on DQS queues. The following
	are the submenus
	
	Show Queue List - Outputs a list of all DQS queues into the output
			  window.
	Add Queue - Adds a DQS queue to the cluster. The popup contains the
		    sample queue configuration file and it can be modified 
		    to launch a new queue.
	Modify Queue - Modify the configuration file of an existing queue. First			input the queue name in the text widget provided and
			then press this button. If the text widget doesn't 
			contain any queue name, then it gives the default
			output of "qconf -sq".
	Clean Queue - To clean a queue - type the name of queue, click this
		      button and execute using 'Exec'. 
	Delete Queue - To delete a queue - type the name of queue, click this
		      button and execute using 'Exec'. 
	Show Queue - To display a queue's configuration file - type the name of 
	     	     queue, click this button and execute using 'Exec'. 

Configure Manager - To add or delete a manager and to get the list of
		    managers on the system.
Configure Operator - To add or delete a operator and to get the list of
		    operators on the system.
Configure Hosts - To add or delete a host and to get the list of
		    hosts on the system.
Configure User - To add or delete a user and to get the list of
		    users on the system.

Qstat: pops up qstat options
       Also, clicking the push button under the queue icon will generate
       the command: qstat3 -cell <cell-name> -q <queue-name> -u <user-name> &

Qdel: pops up a dialog to input job id

Qmod: Has toggle buttons and text widegts to build a command for qmod. Use
      any one of the options, to change the status of the queues.

Qsub: Module to build the qsub command for submitting DQS jobs.

Qsh:  Moudle to get an interactive shell window for DQS queuing system.

Qacct: Module to build the command qacct, which reports and accounts
       for DQS usage.

Cwd:  To change the current working directory. Just type the absolute 
      or relative path and execute.

Shell: Type in a shell command and execute. Convenient to execute
       DQS commands without opening modules.

Setup: Module to setup the icon window and to control what queue complexes
       you would like to see and what not to be displayed.

	Compact: Use this to for compact display of the icon window.
	All the other toggle buttons when activated will remove those partic-
	ular queue icons from the display. The default state is to display all
	the queues in the system.

	Example: If you just want to see all the Running queues, you would
	toggle 'Idle', and, 'Suspended' buttons. If you find non running
	queues don't be surprised, this is because the states 'Alarm' and 
	'Unknown' take precedence over 'Running', 'Idle', and 'Suspended'.
	The same example can be repeated for 'Show Complexes', where the display
	can be controlled based on the queue complexes instead of queue states.

Refresh: To get the current status of DQS system.

Redisplay: It is needed for some X-Terminals when the qmon window is 
	   resized so that the icons can be remapped. This button is
	   not neccessary for workstations.

The legend is shown by the labels 'Running', 'Idle', 'Suspended', and 
'Suspended on Completion', which give the colors for those states.


Note:

1.The icon window can be scrolled using the scroll bar to the left.
2.To find out info about a command, use 'Help' button and execute 
the command, DQS will give you the commands usage.
3.Unsupported menus in the present release - qhold, qmove, qmsg, qrerun,
  qrls, qselect, and qsig.
4. Set up a file .qmomgrpcf in your $HOME directory which contains
   list of complexes you want to display when the program is launched.
   
	Example:
	
	Suppose, your file (.qmomgrpcf) contains -

			arc.eq.RIOS
			mem.eq.BIG

	and the list of complexes are 

			arc.eq.RIOS
                        mem.eq.BIG
			arc.eq.alpha
			mem.eq.SMALL

	then qmon will display only the queues with complexes contained in the
	startup file and will hide the others. You can display them by using
	the Setup menu.


Know Bugs:
	1. Some of the menus described here may be unavailable as them are
	   not yet developed in DQS.
Send:-
Questions, comments, criticisms, etc, about qmon to - raju@scri.fsu.edu
Qmon URL http://www.scri.fsu.edu/~raju/qmon.html

- Raju R. Lakhamraju
			--------------------------
