QQUOTA(1)						   Sun Grid Engine User Commands						 QQUOTA(1)

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.  With-
       out 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 defini-
	      tion 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

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

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

       o  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  prece-
		      dence):

			     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 infor-
		      mation 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)