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.

SGE 6.2u5                                            $Date$                                            QQUOTA(1)