Provided by: gridengine-qmon_6.2u5-1ubuntu1_i386 bug

NAME

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

SYNTAX

       qmon [options]

DESCRIPTION

       Qmon allows administrators and users to manipulate the Sun 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:

       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
          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 Sun 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  Sun  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  sge_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 sge_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 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
       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 Sun Grid Engine scheduler thread part of sge_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 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
       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 sge_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 Sun 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
       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 Sun 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 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
       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 sge_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 Sun 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
       sge_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  Sun  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 sge_qmaster(8).

   Browser
       The  Object  Browser  dialogue's purpose is manifold: First of all, Sun
       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 Sun 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  Sun
       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.

   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

       SGE_ROOT       Specifies the location of the Sun Grid  Engine  standard
                      configuration files.

       SGE_CELL       If  set,  specifies the default Sun Grid Engine cell. To
                      address a Sun Grid Engine cell qmon 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. default.

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

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

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

       <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

SEE ALSO

       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),
       sge_qmaster(8).

COPYRIGHT

       See    sge_intro(1)     and     the     information     provided     in
       <sge_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.