Provided by: gridengine-qmon_6.2~beta2-2_i386 bug

NAME

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

SYNTAX

       qmon [options]

DESCRIPTION

       Qmon  allows  administrators  and  users  to manipulate the Grid Engine
       system from an X-Window environment.  Qmon provides  various  dialogues
       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:

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

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

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

       ·  While  navigating  through  a  certain  dialogue  and  its  dialogue
          subhierarchy, 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.

OPTIONS

       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.

       -nologo
              Startup without logo.

DIALOGUES

   Job Control
       The Job Control 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 Submit dialogue  in  order  to
       submit  new  jobs  or  to  change  attributes  of  pending jobs (Qalter
       button). The shown displayed fields in the tabular display and the jobs
       displayed  can  be  customized  by  pressing the Customize button. This
       customization can be saved to the ~/.qmon_preferences file and is  used
       on  following startups for the initial configuration of the Job Control
       dialogue.

   Queue Control
       The Queue Control 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 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
       configuring 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
       configuration sub-dialogue contains in the upper section the queue name
       and a list of hosts or hostgroups for which  this  queue  contains  the
       configuration.    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 Configuration, Execution Methods, Checkpointing,  Load/Suspend
       Thresholds, Limits, Complexes, User Access, Project Access, Subordinate
       Queues, Owners) 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  registered  with  ge_qmaster(8).   The  Queue  Control
       dialogue  can  be  customized  in  a  similar  way  as  the Job Control
       dialogue.   The   settings   applied   here   are   also    saved    in
       ~/.qmon_preferences.

   Submit
       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
       dialogue  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
       specification 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.

       Closing the Requested Resources sub-dialogue with the done button books
       the specified requirement for the job. Pushing the Submit button on the
       top level Submit dialogue submits the job.

   Complex Config
       The  Complex  Config  allows  the  administrator  to  add  new  complex
       attributes or to modify or delete existing ones (see complex(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 Add button updates the tabulated list with a new
       attribute.  The Modify button changes  a  highlighted  existing  entry.
       The  Delete  button  removes  the highlighted attributes.  The Load and
       Save buttons allow saving or reloading the whole attribute list  to  or
       from  file.  The Ok button registers the additional or modified complex
       attributes with ge_qmaster(8).

   Host Config
       Four types of host related lists can be maintained via the Host  Config
       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
       respectively.   The  host  group  list  allows the manipulation of host
       groups. Host groups can reference either other host  groups  or  hosts.
       The  execution  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  running  jobs can be scaled in addition and the relative
       performance of a host can be define with the Resource Capability Factor
       (see host_conf(5)).

   Cluster Config
       This  dialogue  maintains  the  cluster global configuration as well as
       host specific derivatives (see ge_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
       configuration.  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 Grid Engine  scheduler  thread  part  of  ge_qmaster(8)
       process.   The  dialogue  contains  a  representation for all scheduler
       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
       registers any changes with ge_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
       allows  to  create  new calendars or which provides the means to change
       the existing ones. The Ok button registers the additional  or  modified
       calendar with ge_qmaster(8).

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

              Configuration of Manager accounts.
              Configuration of Operator accounts.
              Definition of Usersets.
              Definition of User 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 user_lists and xuser_lists
       host,  queue,  project  and  cluster  configuration   parameters   (see
       queue_conf(5), project(5) and ge_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
       identified 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
       below).

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

       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
       dialogue.  PE interfaces are necessary to describe the way how parallel
       programming  environments  like  PVM  (Parallel  Virtual  Machine), MPI
       (Message 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 ge_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
       configuration sub-dialogue. After applying  the  changes  and  quitting
       this  sub-dialogue with the OK button, the new or modified PE interface
       is registered with ge_qmaster(8).

   Checkpoint Config
       Checkpointing  environment  interfaces  can  be  configured  with  this
       dialogue.   Checkpointing  environments  are  necessary to describe the
       attributes  which  the  different  checkpointing  methods   and   their
       derivatives  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 configuration (see checkpoint(5)) of the selected checkpointing
       environment. To add new checkpointing environment or to modify existing
       ones,  an  Add  and  a  Modify  button  is  available  which  opens   a
       checkpointing  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 ge_qmaster(8).

   Ticket Conf
       This dialogue offers an overview  and  editing  screen  for  allocating
       tickets   to   the  share-based,  functional  and  override  scheduling
       policies.

       The Deadline Job button opens  the  User  Conf  dialogue  box.   Please
       change  to  the  Userset  sub-dialogue  and  select  the  userset named
       "deadlineusers".  Only users of this userset may submit deadline  jobs.

       The  Share  Tree  Policy  button  opens  the  dialogue for creating and
       editing  the  Grid   Engine   share   tree   (see   share_tree(5)   and
       schedd_conf(5) for a description of the configuration parameters).

       The  Functional  Policy  button  opens  the  dialogue  for creating and
       editing the allocation of the  functional  shares  (see  sched_conf(5),
       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
       displays  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
       dialogue, 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 modified project with ge_qmaster(8).

   Browser
       The Object Browser dialogue’s purpose is manifold: First of  all,  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  Grid Engine objects as the mouse pointer moves over
       their representation as icons or table entries in other qmon dialogues.
       Currently,  only  the  display  of the configuration of two Grid Engine
       objects in two separate dialogues is supported:

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

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

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

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

RESOURCES

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

ENVIRONMENTAL VARIABLES

       GE_ROOT        Specifies  the  location  of  the  Grid  Engine standard
                      configuration files.

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

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

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

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

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

RESTRICTIONS

       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.

FILES

       <ge_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

SEE ALSO

       ge_intro(1),  ge_conf(5),  access_list(5),  ge_pe(5), calendar_conf(5),
       complex(5),   project(5),   queue_conf(5),   sched_conf(5),    user(5),
       ge_qmaster(8).

COPYRIGHT

       See     ge_intro(1)     and     the     information     provided     in
       <ge_root>/3rd_party/qmon  for  a  statement  of  further   rights   and
       permissions  and  for credits to be given to public domain and freeware
       widget developers.