IBM::LoadLeveler 1.05

IBM::LoadLeveler is a Perl module that allows access to IBM LoadLeveler API.

SYNOPSIS

use IBM::LoadLeveler;

$version = ll_version();

# Workload Management API

$rc=ll_control($control_op,@host_list,@user_list,@job_list,@class_list,$priority);

$rc=llctl(LL_CONTROL_START|LL_CONTROL_STOP|LL_CONTROL_RECYCLE|
LL_CONTROL_RECONFIG|LL_CONTROL_DRAIN|LL_CONTROL_DRAIN_SCHEDD|
LL_CONTROL_DRAIN_STARTD|LL_CONTROL_FLUSH|LL_CONTROL_PURGE_SCHEDD|
LL_CONTROL_SUSPEND|LL_CONTROL_RESUME|LL_CONTROL_RESUME_STARTD|
LL_CONTROL_RESUME_SCHEDD,@host_list,@class_list);

$rc=llfavorjob(LL_CONTROL_FAVOR_JOB|LL_CONTROL_UNFAVOR_JOB,@job_list);

$rc=llfavoruser(LL_CONTROL_FAVOR_USER|LL_CONTROL_UNFAVOR_USER,@user_list);

$rc=llhold(LL_CONTROL_HOLD_USER|LL_CONTROL_HOLD_SYSTEM|LL_CONTROL_HOLD_RELEASE,@host_list,@user_list,@job_list);

$rc=llprio(LL_CONTROL_PRIO_ABS|LL_CONTROL_PRIO_ADJ,@job_list,$priority);

$rc=ll_start_job($cluster,$proc,$from_host,@node_list);
$rc=ll_terminate_job($cluster,$proc,$from_host,$msg);
($rc,$err_obj)=ll_preempt($job_step_id, PREEMPT_STEP|RESUME_STEP);

($rc,$err_obj)=ll_modify(EXECUTION_FACTOR|CONSUMABLE_CPUS|CONSUMABLE_MEMORY|WCLIMIT_ADD_MIN|JOB_CLASS|ACCOUNT_NO,$value,$job_step);

# Error API

ll_error($errObj,1 | 2 );

# Submit API function

($job_name,$owner,$groupname,$uid,$gid,$submit_host,$numsteps,$ref)=llsubmit($job_cmd_file,$monitor_program,$monitor_args);

# Data Access API functions

$query = ll_query( JOBS|MACHINES|CLUSTER|WLMSTAT|MATRIX|RESERVATIONS );

$return = ll_set_request( $query,QUERY_ALL|QUERY_JOBID|QUERY_STEPID|
QUERY_GROUP|QUERY_CLASS|QUERY_HOST|QUERY_STARTDATE|
QUERY_ENDDATE|QUERY_PROCID|QUERY_RESERVATION_ID,
@filter,ALL_DATA|Q_LINE|STATUS_LINE );

$object = ll_get_objs( $query, LL_STARTD|LL_SCHEDD|LL_CM|LL_MASTER|
LL_STARTER|LL_HISTORY_FILE, $hostname, $number_of_objs, $error_code);

$return = ll_reset_request( $object );

$next_object = ll_next_obj ( $object );

$return = ll_free_objs ( $object );

$return = ll_deallocate ( $object );

$result = ll_get_data( $object, $LLAPI_Specification );

# Reservation API

($result,$object) = ll_make_reservation($start_time,$duration,RESERVATION_BY_NODE|RESERVATION_BY_HOSTLIST|RESERVATION_BY_JOBSTEP|RESERVATION_BY_JCF,$data,$options,@users,@groups,$group);

($result,$error) = ll_change_reservation($ID,%param);

($result,$error) = ll_bind(@jobsteplist,$ID,$unbind)

($result,$error) = ll_remove_reservation(@IDs,@user_list,@host_list,@group_list)

# Query API functions ( deprecated )

my ($version_num,$numnodes,$noderef)=ll_get_nodes();

my ($version_num,$numjobs,$ref)=ll_get_jobs();