SPRIO(1)							  SLURM commands							  SPRIO(1)

NAME

       sprio - view the factors that comprise a job's scheduling priority

SYNOPSIS

       sprio [OPTIONS...]

DESCRIPTION

       sprio  is  used to view the components of a job's scheduling priority when the multi-factor priority plugin is installed.  sprio is a read-
       only utility that extracts information from the multi-factor priority plugin.  By default, sprio returns information for all pending  jobs.
       Options exist to display specific jobs by job ID and user name.

OPTIONS

       -h, --noheader
	      Do not print a header on the output.

       --help Print a help message describing all options sprio.

       -j <job_id_list>, --jobs=<job_id_list>
	      Requests a comma separated list of job ids to display.  Defaults to all jobs.

       -l, --long
	      Report more of the available information for the selected jobs.

       -M, --clusters=<string>
	      The cluster to issue commands to. Only one cluster name may be specified.

       -n, --norm
	      Display the normalized priority factors for the selected jobs.

       -o <output_format>, --format=<output_format>
	      Specify the information to be displayed, its size and position (right or left justified).  The default formats when all factors have
	      been assigned non-zero weights are

	      default	     "%.7i %.10Y %.10A %.10F %.10J %.10P %.10Q"

	      -l, --long     "%.7i %.8u %.10Y %.10A %.10F %.10J %.10P %.10Q %.6N"

	      The format of each field is "%[.][size]type".

	      size    is the minimum field size.  If no size is specified, whatever is needed to print the information will be used.

	       .      indicates the output should be left justified.  By default, output is right justified.

	      Valid type specifications include:

	      %a  Normalized age priority

	      %A  Weighted age priority

	      %f  Normalized fair-share priority

	      %F  Weighted fair-share priority

	      %i  Job ID

	      %j  Normalized job size priority

	      %J  Weighted job size priority

	      %N  Nice adjustment

	      %p  Normalized partition priority

	      %P  Weighted partition priority

	      %q  Normalized quality of service priority

	      %Q  Weighted quality of service priority

	      %u  User name for a job

	      %Y  Job priority

	      %y  Normalized job priority

       -u <user_list>, --user=<user_list>
	      Request jobs from a comma separated list of users.  The list can consist of user names or user id numbers.

       --usage
	      Print a brief help message listing the sprio options.

       -v, --verbose
	      Report details of sprios actions.

       -V , --version
	      Print version information and exit.

       -w , --weights Display the configured weights for each
	      factor.  This is for information purposes only.  Actual job data is suppressed.

ENVIRONMENT VARIABLES

       If no corresponding commandline option is specified, sprio will use the value of the following environment variables.

       SLURM_CLUSTERS	   Same as --clusters

EXAMPLES

       Print the list of all pending jobs with their weighted priorities
       > sprio
	 JOBID	 PRIORITY	 AGE  FAIRSHARE    JOBSIZE  PARTITION	     QOS
	 65539	    62664	   0	  51664       1000	10000	       0
	 65540	    62663	   0	  51663       1000	10000	       0
	 65541	    62662	   0	  51662       1000	10000	       0

       Print the list of all pending jobs with their normalized priorities
       > sprio -n
	 JOBID PRIORITY   AGE	     FAIRSHARE	JOBSIZE    PARTITION  QOS
	 65539 0.00001459 0.0007180  0.5166470	1.0000000  1.0000000  0.0000000
	 65540 0.00001459 0.0007180  0.5166370	1.0000000  1.0000000  0.0000000
	 65541 0.00001458 0.0007180  0.5166270	1.0000000  1.0000000  0.0000000

       Print the job priorities for specific jobs
       > sprio --jobs=65548,65547
	 JOBID	 PRIORITY	 AGE  FAIRSHARE    JOBSIZE  PARTITION	     QOS
	 65547	    62078	   0	  51078       1000	10000	       0
	 65548	    62077	   0	  51077       1000	10000	       0

       Print the job priorities for jobs of specific users
       > sprio --users=fred,sally
	 JOBID	   USER  PRIORITY	AGE  FAIRSHARE	 JOBSIZE  PARTITION	QOS
	 65548	   fred     62079	  1	 51077	    1000      10000	  0
	 65549	  sally     62080	  1	 51078	    1000      10000	  0

       Print the configured weights for each priority component
       > sprio -w
	 JOBID	 PRIORITY	 AGE  FAIRSHARE    JOBSIZE  PARTITION	     QOS
	 Weights		1000	 100000       1000	10000	       1

COPYING

       Copyright (C)  2009  Lawrence  Livermore  National  Security.   Produced  at  Lawrence  Livermore  National  Laboratory	(cf,  DISCLAIMER).
       CODE-OCEC-09-009. All rights reserved.

       This file is part of SLURM, a resource management program.  For details, see <http://www.schedmd.com/slurmdocs/>.

       SLURM is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free
       Software Foundation; either version 2 of the License, or (at your option) any later version.

       SLURM is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY	or
       FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

SEE ALSO

       squeue(1), sshare(1)

sprio 2.3							     May 2011								  SPRIO(1)