NAME

Schedule::Load::Hosts::Host - Return information about a host

SYNOPSIS

See Schedule::Load::Hosts

DESCRIPTION

This package provides accessors for information about a specific host obtained via the Schedule::Load::Host package.

classes_match

Passed an array reference. Returns true if this host's class matches any class in the array referenced.

eval_match

Passed a subroutine reference that takes a single argument of a host reference. Returns true if the subroutine returns true. It may also be passed a string which forms a subroutine ("sub { my $self = shift; ....}"), in which case the string will be evaluated in a safe container.

fields

Returns all information fields for this host.

exists (key)

Returns if a specific field exists for this host.

get (key)

Returns the value of a specific field for this host.

ACCESSORS

A accessor exists for each field returned by the fields() call. Typical elements are described below.

adj_load

Total number of processes in run or on processor state, adjusted for any jobs that have a specific fixed_load or hold time, and adjusted for jobs that have not yet scheduled but are collecting resources for a new run. This is the load used for picking hosts.

archname

Architecture name from Perl build.

cpus

Number of CPUs.

holds

Returns list of Schedule::Load::Hosts::Hold objects, sorted by age.

hostname

Name of the host.

max_clock

Maximum clock frequency.

load_limit

Limit on the loading that a machine can bear, often set to the number of CPUs to not allow overloading of a machine. Undefined if no limit.

osname

Operating system name from Perl build.

reservable

If true, this host may be reserved for exclusive use by a user.

reserved

If true, this host is reserved, and this field contains a username and start time comment.

systype

System type from Perl build.

top_processes

Returns a reference to a list of top process objects, Schedule::Load::Hosts::Proc to access the information for each process. In an array context, returns a list; In a a scalar context, returns a reference to a list.

total_load

Total number of processes in run or on processor state.

total_pctcpu

Total CPU percentage used by all processes.

SEE ALSO

Schedule::Load, Schedule::Load::Hosts, Schedule::Load::Hosts::Proc

DISTRIBUTION

The latest version is available from CPAN.

AUTHORS

Wilson Snyder <wsnyder@wsnyder.org>