NAME

rschedule - User interface for perl Schedule::Load configuration and status

SYNOPSIS

rschedule [ --help ] [ --port=port ] [ --dhost=host ] [ --version ]

rschedule top rtop

rschedule hosts rhosts

rschedule loads rloads

rschedule [ --host=host --override] reserve

rschedule [ --host=host ] release

rschedule [ --host=host ] allow_class class

rschedule [ --host=host ] deny_class class

rschedule --class=class best

rschedule --class=class best_or_none

rschedule [ --load=load ] fixed_load pid

DESCRIPTION

rschedule will report or set status for load distribution using the perl Schedule::Load package.

If symbolically linked to the name "rtop" rschedule will by default produce a listing of each host and the top loads on those hosts. Similarly, a link to "rhosts" will show the host report by default, and a link to "rloads" will show the load report.

COMMANDS

classes

Displays a listing of the classes of jobs each host can run.

hosts

Displays a listing of each host being monitored along with its load and system type.

loads

Displays a longer command line of top jobs, along with any fixed_load jobs.

top

Displays a listing of top processes across all hosts being monitored.

allow_class hostname class

Sets the hostname to allow the specified class of jobs.

deny_class hostname

Sets the hostname to deny the specified class of jobs.

reserve hostname

Reserves a host for dedicated use. To be reservable the reservable flag must be set when that host's slreportd is invocated. This is indicated on the top report by a "R" in the column next to the command. To override a existing reservation you need to release the reservation first.

release hostname

Releases a host from dedicated use.

best

Returns the best host for a new job.

best_or_none

Returns the best host if there are free CPUs laying around, else fails.

fixed_load pid

Sets the given process ID to have that process count as one host load, even if it is using less CPU time then that due to high disk activity or other sleeps.

cmnd_comment pid

Sets the command comment for the given process ID. In rschedule top (rtop) displays, this will be shown rather then the name of the command. Command comments are inherited by children of commented parents.

ARGUMENTS

--help

Displays this message and program version and exits.

--port <portnumber>

Specifies the port number that slchoosed uses.

--dhost <hostname>

Specifies the host name that slchoosed uses. May be specified multiple times to specify backup hosts. Defaults to SLCHOOSED_HOST environment variable, which contains colon separated host names.

--load <load>

Specifies the load value for the fixed_load command, defaults to 1.

--comment <comment>

Specifies the command comment for the cmnd_comment command.

--class <class>

Specifies the job class for the best command.

--version

Displays program version and exits.

SEE ALSO

Schedule::Load

DISTRIBUTION

This package is distributed via CPAN.

AUTHORS

Wilson Snyder <wsnyder@world.std.com>