NAME

       qquota - shows current usage of Sun Grid Engine resource quotas

SYNTAX

       qquota  [  -h  wc_host|wc_hostgroup,...   ]  [  -help  ]  [  -l  resource_name,...  ] [ -u
       wc_user,...  ] [ -P wc_project,...  ] [ -pe wc_pe_name,...  ] [ -q wc_cqueue,...  ] [ -xml
       ]

DESCRIPTION

       qquota  shows  the  current  Sun Grid Engine resource quota sets. Only resource quota sets
       with a positive usage count or a static limit are printed.

       Selection options allow you to  filter  for  specific  hosts,  cluster  queues,  projects,
       parallel  environments (pe), resources or users.  Without any option qquota will display a
       list of all resource quota sets for the calling user.

OPTIONS

       -h wc_host|wc_hostgroup,...
              Display only resource quota sets that matches with the hosts in the given  wildcard
              host  or  hostgroup  list.  Find  the  definition  of  wc_host  and wc_hostgroup in
              sge_types(1).

       -help  Prints a listing of all options.

       -l resource_name,...
              Display only resource quota sets being matched with  the  resources  in  the  given
              resource list.

       -u wc_user,...
              Display only resource quota sets being matched with the users in the given wildcard
              user list. Find the definition of wc_user in sge_types(1).

       -P wc_project,...
              Display only resource quota sets being matched  with  the  projects  in  the  given
              wildcard project list. Find the definition of wc_project in sge_types(1).

       -pe wc_pe_name,...
              Display  only resource quota sets being matched with the parallel environments (pe)
              in the given wildcard pe list. Find the definition of wc_pe_name in sge_types(1).

       -q wc_cqueue,...
              Display only resource quota sets  being  matched  with  the  queues  in  the  given
              wildcard cluster queue list. Find the definition of wc_cqueue in sge_types(1).

       -xml   This  option  can be used with all other options and changes the output to XML. The
              schema used is referenced in the XML output. The output is printed to stdout.

OUTPUT FORMATS

       A line is printed for every resource quota  with  a  positive  usage  count  or  a  static
       resource.  The line consists of

       •  the resource quota - rule set name/rule name or number of rule in ruleset

       •  the limit - resource name, the number of used and available entities of that resource

       •  the effective resource quota set filter

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 qquota 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 for the service "sge_qmaster" instead to define that port.

FILES

       <sge_root>/<cell>/common/act_qmaster
                       Sun Grid Engine master host file
       <sge_root>/<cell>/common/sge_qquota
                       cluster qquota default options
       $HOME/.sge_qquota
                       user qquota default options

SEE ALSO

       sge_intro(1),  qalter(1),  qconf(1),  qhold(1), qmod(1), qstat(1), qsub(1), queue_conf(5),
       sge_execd(8), sge_qmaster(8), sge_shepherd(8).

COPYRIGHT

       See sge_intro(1) for a full statement of rights and permissions.