QMON(1)                    Grid Engine User Commands                   QMON(1)



NNAAMMEE
       qmon - X-Windows OSF/Motif graphical user's interface for Grid Engine

SSYYNNTTAAXX
       qqmmoonn [options]

DDEESSCCRRIIPPTTIIOONN
       _Q_m_o_n allows administrators and users to manipulate the Grid Engine sys-
       tem from an X-Window  environment.   _Q_m_o_n  provides  various  dialogues
       linked  together  in  multiple  ways.  For each task the user wishes to
       accomplish via _q_m_o_n a corresponding dialogue  is  provided.  There  are
       multiple ways to address the proper dialogue for a certain task:


       +o  The  _q_m_o_n  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  TTaasskk  pulldown  menu  button appears in the _q_m_o_n main window menu
          bar. Clicking on it opens a list of available tasks.  Selecting  one
          of them opens the corresponding dialogue.

       +o  The  TTaasskk 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.

OOPPTTIIOONNSS
       The supported options are the standard X Toolkit options  as  described
       in _X(1) section OOppttiioonnss. Furthermore, _q_m_o_n supports:

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

       --ffoonnttFFaammiillyy {{bbiigg||mmeeddiiuumm||ssmmaallll}}
              Notifies _q_m_o_n to use different sized font families for different
              resolution sizes.

       --hheellpp  Displays usage information.

       --nnoollooggoo
              Startup without logo.

DDIIAALLOOGGUUEESS
   JJoobb CCoonnttrrooll
       The JJoobb CCoonnttrrooll dialogue provides a folder of tabulated  lists  of  the
       still  pending  jobs,  already running jobs and recently finished jobs.
       The dialogue allows for detailed information on the jobs as well as for
       the  deletion  and  suspension of jobs being selected.  In addition the
       job control dialogue offers links to the SSuubbmmiitt dialogue  in  order  to
       submit  new  jobs  or to change attributes of pending jobs (QQaalltteerr but-
       ton). The shown displayed fields in the tabular display  and  the  jobs
       displayed can be customized by pressing the CCuussttoommiizzee button. This cus-
       tomization can be saved to the _~_/_._q_m_o_n___p_r_e_f_e_r_e_n_c_e_s file and is used  on
       following  startups  for  the  initial configuration of the JJoobb CCoonnttrrooll
       dialogue.


   QQuueeuuee CCoonnttrrooll
       The QQuueeuuee CCoonnttrrooll dialogue with its sub-dialogue hierarchy enables  the
       user  to  control  the  status of the Grid Engine queues being actually
       configured in the system and allows the administrator to add new queues
       or  to  modify  or delete already existing ones. The QQuueeuuee CCoonnttrrooll dia-
       logue shows a tabbed view of  Cluster  Queues  or  their  corresponding
       Queue Instances in a tabular way.

       By  pushing the AAdddd, CClloonnee or MMooddiiffyy button, a sub-dialogue for config-
       uring 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
       _q_u_e_u_e___c_o_n_f(5)) are subdivided in different categories (GGeenneerraall CCoonnffiigguu--
       rraattiioonn, EExxeeccuuttiioonn MMeetthhooddss, CChheecckkppooiinnttiinngg, LLooaadd//SSuussppeenndd TThhrreesshhoollddss, LLiimm--
       iittss,  CCoommpplleexxeess,  UUsseerr AAcccceessss, PPrroojjeecctt AAcccceessss,, SSuubboorrddiinnaattee QQuueeuueess,, OOwwnn--
       eerrss)) wwhhiicchh aarree sseelleeccttaabbllee bbyy tthhee ttaabb wwiiddggeett aarreeaa pprreesseenntteedd iinn tthhee lloowweerr
       rreeggiioonn  ooff tthhee qquueeuuee ccoonnffiigguurraattiioonn ssuubb--ddiiaalloogguuee..  TThhee aaddmmiinniissttrraattoorr mmaayy
       sseelleecctt pprreevviioouussllyy ccoonnffiigguurreedd  sseettttiinnggss  ffrroomm  aallrreeaaddyy  eexxiissttiinngg  qquueeuueess
       ((CClloonnee  bbuuttttoonn))..  BByy  ppuusshhiinngg tthhee OOkk bbuuttttoonn,, tthhee ddeeffiinniittiioonnss aarree rreeggiiss--
       tteerreedd wwiitthh _s_g_e___q_m_a_s_t_e_r(8).  The QQuueeuuee  CCoonnttrrooll  dialogue  can  be  cus-
       tomized  in  a  similar  way  as the JJoobb CCoonnttrrooll dialogue. The settings
       applied here are also saved in _~_/_._q_m_o_n___p_r_e_f_e_r_e_n_c_e_s.

   SSuubbmmiitt
       The JJoobb SSuubbmmiissssiioonn dialogue serves for submitting batch and interactive
       jobs  and is also invoked when changing attributes of pending jobs from
       the JJoobb CCoonnttrrooll dialogue explained above  (QQaalltteerr  button).  To  toggle
       between  batch  and  interactive  jobs please use the BBaattcchh//IInntteerraaccttiivvee
       button at the top of the button column on the right  side  of  the  JJoobb
       SSuubbmmiissssiioonn 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  GGeenneerraall page. A job script has to be
       defined, all other fields are optional. If the job demands for specifi-
       cation of advanced requirements, the AAddvvaanncceedd tab can be used to switch
       to an enhanced parameter display.

       If resource  requirements  are  mandatory  for  the  job,  the  RReeqquueesstt
       RReessoouurrcceess  icon button has to be used to pop up the RReeqquueesstteedd RReessoouurrcceess
       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 AAvvaaiillaabbllee RReessoouurrcceess  are  constituted
       by  those complex attributes being declared _r_e_q_u_e_s_t_a_b_l_e (see _c_o_m_p_l_e_x(5)
       for details). Resource requirements can be made HHaarrdd, i.e. they must be
       met  before  a  job  can  be started in a queue, or SSoofftt, i.e. they are
       granted on an as available basis.

       Closing the RReeqquueesstteedd RReessoouurrcceess sub-dialogue with the done button books
       the specified requirement for the job. Pushing the SSuubbmmiitt button on the
       top level SSuubbmmiitt dialogue submits the job.

   CCoommpplleexx CCoonnffiigg
       The  CCoommpplleexx  CCoonnffiigg  allows  the  administrator  to  add  new  complex
       attributes  or to modify or delete existing ones (see _c_o_m_p_l_e_x(5)).  The
       complex configuration dialogue provides a tabulated list of the complex
       attribute  entries  and  an  input region for the declaration of new or
       modified entries. The AAdddd button updates the tabulated list with a  new
       attribute.   The  MMooddiiffyy  button  changes a highlighted existing entry.
       The DDeelleettee button removes the highlighted  attributes.   The  LLooaadd  aanndd
       SSaavvee  buttons  allow saving or reloading the whole attribute list to or
       from file.  The OOkk button registers the additional or modified  complex
       attributes with _s_g_e___q_m_a_s_t_e_r(8).

   HHoosstt CCoonnffiigg
       Four  types of host related lists can be maintained via the HHoosstt CCoonnffiigg
       dialogue:

              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  _c_o_m_p_l_e_x(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  RReessoouurrccee  CCaappaabbiilliittyy  FFaaccttoorr  (see
       _h_o_s_t___c_o_n_f(5)).

   CClluusstteerr CCoonnffiigg
       This dialogue maintains the cluster global  configuration  as  well  as
       host specific derivatives (see _s_g_e___c_o_n_f(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 AAdddd//MMooddiiffyy 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.

   SScchheedduulleerr CCoonnffiigg
       The SScchheedduulleerr CCoonnffiigguurraattiioonn dialogue provides the means to  change  the
       behavior  of  the Grid Engine scheduler daemon _s_g_e___s_c_h_e_d_d(8).  The dia-
       logue contains a representation for all scheduler configuration parame-
       ters  as  described in _s_c_h_e_d___c_o_n_f(5).  It is subdivided in the two sec-
       tions GGeenneerraall PPaarraammeetteerrss and LLooaadd AAddjjuussttmmeennttss which can be selected via
       the  corresponding  tabs.   The  OOkk  button  registers any changes with
       _s_g_e___q_m_a_s_t_e_r(8).

   CCaalleennddaarr CCoonnffiigg
       The CCaalleennddaarr CCoonnffiigg allows the administrator to add new calendars or to
       modify  or  delete  existing ones (see _c_a_l_e_n_d_a_r___c_o_n_f(5)).  The dialogue
       offers a selection list for the existing  calendars  and  displays  the
       configuration  of the one being selected. By pushing the DDeelleettee button,
       the selected calendar is deleted from the  configuration.  Pushing  the
       AAdddd/MMooddiiffyy  button  will  open a calendar configuration dialogue, which
       allows to create new calendars or which provides the  means  to  change
       the  existing  ones. The OOkk button registers the additional or modified
       calendar with _s_g_e___q_m_a_s_t_e_r(8).

   UUsseerr CCoonnffiigg
       User permissions are controlled via the UUsseerr CCoonnffiigg dialogue.  The  tab
       widget in the left section of the dialogue allows for selecting between

              Configuration of MMaannaaggeerr accounts.
              Configuration of OOppeerraattoorr accounts.
              Definition of UUsseerrsseettss.
              Definition of UUsseerr accounts.

       Those user accounts added to the list of manager or  operator  accounts
       are  given permission to act as managers or operators respectively when
       accessing Grid Engine under their own account.

       The userset lists are used together with the uusseerr__lliissttss and xxuusseerr__lliissttss
       host,   queue,   project  and  cluster  configuration  parameters  (see
       _q_u_e_u_e___c_o_n_f(5), _p_r_o_j_e_c_t(5) and _s_g_e___c_o_n_f(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 UUsseerrsseett definition dialogue.

       Usersets  can  be used as AAcccceessss LLiisstt and/or as DDeeppaarrttmmeenntt required for
       the so called FFuunnccttiioonnaall PPoolliiccyy and OOvveerrrriiddee PPoolliiccyy (see TTiicckkeett  CCoonnffiigg
       below).

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

       The TTiicckkeettss button in the button list on the right side of the dialogue
       opens the TTiicckkeett CCoonnffiigg dialogue (see below).

   PPEE CCoonnffiigg
       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 _s_g_e___p_e(5)) of the selected
       PE  interface.  To add new PE interfaces or to modify existing ones, an
       AAdddd and a MMooddiiffyy button is available which opens a PE interface config-
       uration sub-dialogue. After applying the changes and quitting this sub-
       dialogue with the OOKK button, the new or modified PE interface is regis-
       tered with _s_g_e___q_m_a_s_t_e_r(8).

   CChheecckkppooiinntt CCoonnffiigg
       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  Grid  Engine
       have.  When  the  dialogue  is  opened a list of the already configured
       checkpointing environments is displayed together with the current  con-
       figuration  (see  _c_h_e_c_k_p_o_i_n_t(5)) of the selected checkpointing environ-
       ment. To add new checkpointing environment or to modify existing  ones,
       an  AAdddd  and  a  MMooddiiffyy button is available which opens a checkpointing
       environment configuration sub-dialogue. After applying the changes  and
       quitting  this  sub-dialogue  with  the  OOKK button, the new or modified
       checkpointing environment is registered with _s_g_e___q_m_a_s_t_e_r(8).

   TTiicckkeett CCoonnff
       This dialogue offers an overview  and  editing  screen  for  allocating
       tickets  to  the  share-based, functional and override scheduling poli-
       cies.

       The DDeeaaddlliinnee JJoobb button opens  the  UUsseerr  CCoonnff  dialogue  box.   Please
       change  to the Userset sub-dialogue and select the userset named "dead-
       lineusers".  Only users of this userset may submit deadline jobs.

       The SShhaarree TTrreeee PPoolliiccyy button opens the dialogue for creating and  edit-
       ing  the  Grid  Engine share tree (see _s_h_a_r_e___t_r_e_e(5) and _s_c_h_e_d_d___c_o_n_f(5)
       for a description of the configuration parameters).

       The FFuunnccttiioonnaall PPoolliiccyy button opens the dialogue for creating and  edit-
       ing  the  allocation  of  the  functional  shares  (see  _s_c_h_e_d___c_o_n_f(5),
       _a_c_c_e_s_s___l_i_s_t(5), _p_r_o_j_e_c_t(5), _q_u_e_u_e___c_o_n_f(5) and _u_s_e_r(5) for a description
       of  the  different  types  of  functional  shares  and the configurable
       weighting parameters).

       The OOvveerrrriiddee PPoolliiccyy button opens the dialogue for creating and  editing
       the  allocation  of  override  tickets (see _a_c_c_e_s_s___l_i_s_t(5), _p_r_o_j_e_c_t(5),
       _q_u_e_u_e___c_o_n_f(5) and _u_s_e_r(5) for a description of the different  types  of
       override tickets).

   PPrroojjeecctt CCoonnff
       This button opens a dialogue 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
       DDeelleettee  button, the selected project is deleted from the configuration.
       Pushing the AAdddd/MMooddiiffyy 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 UUsseerr CCoonnff above
       as well as _p_r_o_j_e_c_t(5)).  The Ok button registers the additional or mod-
       ified project with _s_g_e___q_m_a_s_t_e_r(8).

   BBrroowwsseerr
       The  OObbjjeecctt  BBrroowwsseerr dialogue's purpose is manifold: First of all, Grid
       Engine and _q_m_o_n messages such as notification of error or success  con-
       cerning  a  previously  taken action can be displayed in the dialogue's
       output window.  Also the standard output and the standard error  output
       of _q_m_o_n can be diverted to the OObbjjeecctt BBrroowwsseerr output window.

       Additionally  the  OObbjjeecctt  BBrroowwsseerr  can  be  used to display continuous
       information about Grid Engine objects as the mouse pointer  moves  over
       their representation as icons or table entries in other _q_m_o_n dialogues.
       Currently, only the display of the configuration  of  two  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  QQuueeuuee  CCoonnttrrooll  dialogue  (see
          above).  This  facility  is activated by pushing the QQuueeuuee button in
          the OObbjjeecctt BBrroowwsseerr dialogue.

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

       +o  Additionally job scheduling information is displayed in the  browser
          if  the WWhhyy ?? button in the JJoobb CCoonnttrrooll dialogue is pressed. In this
          case the Browser dialogue is opened implicitly  and  any  scheduling
          related information is displayed.

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

RREESSOOUURRCCEESS
       The available resources, their meaning and the syntax to be followed in
       order  to  modify  them are described in the default _q_m_o_n resource file
       (see the section FFiilleess below for the location of the resource file).

EENNVVIIRROONNMMEENNTTAALL VVAARRIIAABBLLEESS
       SSGGEE__RROOOOTT       Specifies the location of the Grid Engine standard  con-
                      figuration files.

       SSGGEE__CCEELLLL       If  set,  specifies  the  default  Grid  Engine cell. To
                      address a Grid Engine cell _q_m_o_n uses (in  the  order  of
                      precedence):

                             The name of the cell specified in the environment
                             variable SGE_CELL, if it is set.

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


       SSGGEE__DDEEBBUUGG__LLEEVVEELL
                      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.

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

RREESSTTRRIICCTTIIOONNSS
       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.

FFIILLEESS
       _<_s_g_e___r_o_o_t_>_/_q_m_o_n_/_Q_m_o_n           _Q_m_o_n sample resources file
       _/_u_s_r_/_l_i_b_/_X_1_1_/_d_e_f_a_u_l_t_s_/_Q_m_o_n     _Q_m_o_n system resources file
       _$_H_O_M_E_/_Q_m_o_n                     _Q_m_o_n user resources file
       _$_H_O_M_E_/_._q_m_o_n___p_r_e_f_e_r_e_n_c_e_s        _Q_m_o_n job/queue customization file


SSEEEE AALLSSOO
       _s_g_e___i_n_t_r_o(1), _s_g_e___c_o_n_f(5), _a_c_c_e_s_s___l_i_s_t(5), _s_g_e___p_e(5), _c_a_l_e_n_d_a_r___c_o_n_f(5),
       _c_o_m_p_l_e_x(5),    _p_r_o_j_e_c_t(5),   _q_u_e_u_e___c_o_n_f(5),   _s_c_h_e_d___c_o_n_f(5),   _u_s_e_r(5),
       _s_g_e___q_m_a_s_t_e_r(8).

CCOOPPYYRRIIGGHHTT
       See    _s_g_e___i_n_t_r_o(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
       developers.



GE 6.0                   $Date: 2004/04/19 10:52:01 $                  QMON(1)
