qmon [options]

       Qmon allows administrators and  users  to  manipulate  the  Univa  Grid
       Engine system from an X-Window environment.  Qmon provides various dia-
       logues linked together in multiple ways.  For each task the user wishes
       to  accomplish via qmon a corresponding dialogue is provided. There are
       multiple ways to address the proper dialogue for a certain task:

       o  The qmon main window that comes up first on start-up  contains  icon
          buttons for all major administrative and user tasks. A functionality
          tooltip is displayed when pointing at the different icons.

       o  A Task pulldown menu button appears in the  qmon  main  window  menu
          bar.  Clicking  on it opens a list of available tasks. Selecting one
          of them opens the corresponding dialogue.

       o  The Task pulldown menu also contains the key accelerators which  can
          be  used  to invoke the task dialogues directly from the main window
          by pressing a certain button sequence on the keyboard.

       o  While navigating through a certain dialogue and  its  dialogue  sub-
          hierarchy,  links  to  other  dialogues  occur whenever a connection
          between both dialogues is obvious. Pushing the buttons that identify
          the links opens up the other dialogues.

       The  supported  options are the standard X Toolkit options as described
       in X(1) section Options. Furthermore, qmon supports:

       -cmap  Installs a private color map for qmon.  This is sometimes useful
              if  other applications have already allocated lots of colors and
              if qmon, therefore, prints corresponding error  messages.  Note,
              however, that using a private color map will result in color map
              switches whenever you enter or leave qmon windows.

       -fontFamily {big|medium|small}
              Notifies qmon to use different sized font families for different
              resolution sizes.

       -help  Displays usage information.

              Startup without logo.

   Job Control
       The  Job  Control  dialogue provides a folder of tabulated lists of the
       still pending jobs, already running jobs and  recently  finished  jobs.
       ally  configured  in the system and allows the administrator to add new
       queues or to modify or delete already existing ones. The Queue  Control
       dialogue  shows  a tabbed view of Cluster Queues or their corresponding
       Queue Instances in a tabular way.

       By pushing the Add, Clone or Modify button, a sub-dialogue for  config-
       uring Univa Grid Engine queues is opened.  A queue needs to be selected
       to use the clone and modify operation. The  configuration  sub-dialogue
       allows  for definition of the queue and its attributes.  The configura-
       tion sub-dialogue contains in the upper section the queue  name  and  a
       list  of hosts or hostgroups for which this queue contains the configu-
       ration.  The lower section contains a list of hosts  or  hostgroups  at
       the left, where the default attributes are shown when the "@/" entry is
       highlighted.  These default attributes can be overruled on a  hostgroup
       or  host  basis  by enabling attributes and changing their values after
       this hostgroup or host entry has been  added  in  the  "Attributes  for
       Host/Hostgroup"  listbox.   The  queue  configuration  parameters  (see
       queue_conf(5)) are subdivided in different categories (General Configu-
       ration, Execution Methods, Checkpointing, Load/Suspend Thresholds, Lim-
       its, Complexes, User Access, Project Access, Subordinate  Queues,  Own-
       ers) which are selectable by the tab widget area presented in the lower
       region of the queue configuration sub-dialogue.  The administrator  may
       select  previously  configured  settings  from  already existing queues
       (Clone button). By pushing the Ok button, the  definitions  are  regis-
       tered  with  sge_qmaster(8).   The  Queue  Control dialogue can be cus-
       tomized in a similar way as the  Job  Control  dialogue.  The  settings
       applied here are also saved in ~/.qmon_preferences.

       The Job Submission dialogue serves for submitting batch and interactive
       jobs and is also invoked when changing attributes of pending jobs  from
       the  Job  Control  dialogue  explained above (Qalter button). To toggle
       between batch and interactive jobs  please  use  the  Batch/Interactive
       button  at  the  top  of the button column on the right side of the Job
       Submission screen.

       The dialogue consists of a folder containing two job  preparation  dia-
       logue pages. The most frequently used parameters in the course of a job
       submission are offered on the General page. A  job  script  has  to  be
       defined, all other fields are optional. If the job demands for specifi-
       cation of advanced requirements, the Advanced tab can be used to switch
       to an enhanced parameter display.

       If  resource  requirements  are  mandatory  for  the  job,  the Request
       Resources icon button has to be used to pop up the Requested  Resources
       sub-dialogue.   This  sub-dialogue allows for selection of the required
       resources of the job and for definition of the quantities in which this
       resources  are  to be provided. The Available Resources are constituted
       by those complex attributes being declared requestable (see  complex(5)
       for details). Resource requirements can be made Hard, i.e. they must be
       met before a job can be started in a queue,  or  Soft,  i.e.  they  are
       granted on an as available basis.
       from  file.  The Ok button registers the additional or modified complex
       attributes with sge_qmaster(8).

   Host Config
       Four types of host related lists can be maintained via the Host  Config

              Administration Hosts
              Submit Hosts
              Host Groups
              Execution Hosts

       The  host list to be manipulated is selected via clicking at one of the
       tabs named correspondingly. The first two host lists only  provide  for
       adding  or  deleting entries, thereby allowing administrative or submit
       permission for the hosts on the lists, or denying it otherwise  respec-
       tively.   The  host  group list allows the manipulation of host groups.
       Host groups can reference either other host groups or hosts.  The  exe-
       cution  host  list  entries  in  addition provide the ability to define
       scaling factors for the load sensors, consumable complex attributes and
       access   attributes   (access,  xaccess  and  projects,  xprojects)  as
       described in complex(5).  CPU, memory and I/O usage reported  for  run-
       ning  jobs  can be scaled in addition and the relative performance of a
       host  can  be  define  with  the  Resource   Capability   Factor   (see

   Cluster Config
       This  dialogue  maintains  the  cluster global configuration as well as
       host specific derivatives (see sge_conf(5)).  When opened, the dialogue
       displays  a  selection  list  for  all hosts which have a configuration
       assigned. The special name "global" refers to the cluster  global  con-
       figuration.  By pushing the Add/Modify button a sub-dialogue is opened,
       which allows for modification of the cluster  configuration.  For  host
       specific configurations the 'global' host specific configuration fields
       are set insensitive and only the allowed parameters can be manipulated.

   Scheduler Config
       The  Scheduler  Configuration dialogue provides the means to change the
       behavior of the Univa Grid Engine scheduler thread  part  of  sge_qmas-
       ter(8)  process.  The dialogue contains a representation for all sched-
       uler configuration parameters as described  in  sched_conf(5).   It  is
       subdivided  in the two sections General Parameters and Load Adjustments
       which can be selected via the corresponding tabs.  The Ok button regis-
       ters any changes with sge_qmaster(8).

   Calendar Config
       The Calendar Config allows the administrator to add new calendars or to
       modify or delete existing ones (see  calendar_conf(5)).   The  dialogue
       offers  a  selection  list  for the existing calendars and displays the
       configuration of the one being selected. By pushing the Delete  button,
       the  selected  calendar  is deleted from the configuration. Pushing the
       Add/Modify button will open a calendar  configuration  dialogue,  which
       are given permission to act as managers or operators respectively  when
       accessing Univa Grid Engine under their own account.

       The userset lists are used together with the user_lists and xuser_lists
       host,  queue,  project  and  cluster  configuration   parameters   (see
       queue_conf(5),  project(5)  and sge_conf(5)) to control access of users
       to hosts, queues, projects and the entire cluster.  A userset is just a
       collection  of user names and UNIX group names. Group names are identi-
       fied by prefixing them with a "@" sign. The  already  defined  usersets
       are  displayed in a selection list. These lists can be modified and new
       lists can be created using the Userset definition dialogue.

       Usersets can be used as Access List and/or as Department  required  for
       the  so called Functional Policy and Override Policy (see Ticket Config

       User names can be added to the system as  entries  to  the  Univa  Grid
       Engine user database (see user(5)), This can be done with the User sub-

       The Tickets button in the button list on the right side of the dialogue
       opens the Ticket Config dialogue (see below).

   PE Config
       Parallel  environment  (PE) interfaces can be configured with this dia-
       logue.  PE interfaces are necessary to describe the  way  how  parallel
       programming environments like PVM (Parallel Virtual Machine), MPI (Mes-
       sage Passing Interface) or shared memory parallel  systems  are  to  be
       instantiated  and  to impose access restrictions onto the PEs. When the
       dialogue is opened a list of the already configured  PEs  is  displayed
       together with the current configuration (see sge_pe(5)) of the selected
       PE interface.  To add new PE interfaces or to modify existing ones,  an
       Add and a Modify button is available which opens a PE interface config-
       uration sub-dialogue. After applying the changes and quitting this sub-
       dialogue with the OK button, the new or modified PE interface is regis-
       tered with sge_qmaster(8).

   Checkpoint Config
       Checkpointing environment interfaces can be configured with  this  dia-
       logue.   Checkpointing  environments  are  necessary  to  describe  the
       attributes which the different checkpointing methods and their  deriva-
       tives  on  various  operating  system platforms supported by Univa Grid
       Engine have. When the dialogue is opened a list of the already  config-
       ured  checkpointing environments is displayed together with the current
       configuration (see checkpoint(5)) of the selected  checkpointing  envi-
       ronment.  To  add  new  checkpointing environment or to modify existing
       ones, an Add and a Modify button is available which opens a checkpoint-
       ing  environment configuration sub-dialogue. After applying the changes
       and quitting this sub-dialogue with the OK button, the new or  modified
       checkpointing environment is registered with sge_qmaster(8).

   Ticket Conf
       access_list(5), project(5), queue_conf(5) and user(5) for a description
       of the different  types  of  functional  shares  and  the  configurable
       weighting parameters).

       The  Override Policy button opens the dialogue for creating and editing
       the allocation of override  tickets  (see  access_list(5),  project(5),
       queue_conf(5)  and  user(5) for a description of the different types of
       override tickets).

   Project Conf
       This button opens a dialog for creating projects.
       The dialogue offers a selection list for the existing projects and dis-
       plays  the  configuration  of  the  one  being selected. By pushing the
       Delete button, the selected project is deleted from the  configuration.
       Pushing  the  Add/Modify  button will open a project configuration dia-
       logue, which allows to create new projects or which provides the  means
       to  change  the  existing  ones. Project configuration in essence means
       giving or denying access to a project for usersets (see User Conf above
       as well as project(5)).  The Ok button registers the additional or mod-
       ified project with sge_qmaster(8).

       The Object Browser dialogue's purpose is manifold: First of all,  Univa
       Grid  Engine and qmon messages such as notification of error or success
       concerning a previously taken action can be displayed in the dialogue's
       output  window.  Also the standard output and the standard error output
       of qmon can be diverted to the Object Browser output window.

       Additionally the Object Browser  can  be  used  to  display  continuous
       information  about Univa Grid Engine objects as the mouse pointer moves
       over their representation as icons or table entries in other qmon  dia-
       logues.  Currently,  only the display of the configuration of two Univa
       Grid Engine objects in two separate dialogues is supported:

       o  Queue configurations are displayed as  soon  as  the  mouse  pointer
          enters  a  queue  icon  in the top level Queue Control dialogue (see
          above). This facility is activated by pushing the  Queue  button  in
          the Object Browser dialogue.

       o  Detailed  job  information  is printed as soon as the user moves the
          mouse pointer over a line in the Job Control  dialogue  (see  above)
          being assigned to a running or pending job.

       o  Additionally  job scheduling information is displayed in the browser
          if the Why ? button in the Job Control dialogue is pressed. In  this
          case  the  Browser  dialogue is opened implicitly and any scheduling
          related information is displayed.

       The Exit icon button is not linked with a dialogue. Its sole purpose is
       to close all active qmon dialogues and to exit the application.

                             variable SGE_CELL, if it is set.

                             The name of the default cell, i.e. default.

                      If set, specifies that debug information should be writ-
                      ten to stderr. In addition the level of detail in  which
                      debug information is generated is defined.

                      If  set,  specifies the tcp port on which sge_qmaster(8)
                      is expected to listen for communication requests.   Most
                      installations  will  use a services map entry instead to
                      define that port.

       If the line to be entered in an editing window is longer than the width
       of the window, then the text just runs off the end of the window.

       <sge_root>/qmon/Qmon           Qmon sample resources file
       /usr/lib/X11/defaults/Qmon     Qmon system resources file
       $HOME/Qmon                     Qmon user resources file
       $HOME/.qmon_preferences        Qmon job/queue customization file

       sge_intro(1), sge_conf(5), access_list(5), sge_pe(5), calendar_conf(5),
       complex(5),   project(5),   queue_conf(5),   sched_conf(5),    user(5),

       See     sge_intro(1)     and     the     information     provided    in
       <sge_root>/3rd_party/qmon for a statement of further rights and permis-
       sions  and for credits to be given to public domain and freeware widget

UGE 8.0.0                $Date: 2008/05/05 09:03:33 $                  QMON(1)

Man(1) output converted with man2html