rc, errObj = ll_bind(res_id, job_list, bind_op) rc, errObj = ll_remove_reservation(res_id_list, res_user_list, res_host_list, res_group_list) rc, errObj = ll_make_reservation(start_date, period, res_type, res_data, users_list, groups_list, group_owner) rc, errObj = ll_change_reservation(res_IDs, param_dict)
The LoadLeveler Reservation API via PyLoadL has the following functions:
The ll_bind routine enables you to bind job steps to a reservation. The ll_bind routine can also be used to unbind a list of job steps from the reservations to which they are currently bound to, or whichever reservation they have requested to bind to in the event that the bind has not yet occurred.
rc = ll_bind(res_id, job_list, bind_op)
Parameters
String of reservation ID in form host.rid.
List of users to perform control operation on.
Numeric, 1 to unbind and 0 to bind jobs to reservation.
Function to enable you to cancel one or more reservations.
rc, errObj = ll_remove_reservation(res_id_list, res_user_list, res_host_list, res_group_list)
Parameters
List of reservation IDs in format: "host.rid.r".
List of reservation owners.
List of machine names.
List of Loadleveler groups.
Function to enable you to create a reservations.
rc, errObj = ll_make_reservation(start_date, period, res_type, res_data, users_list, groups_list, group_owner)
Parameters
String : Start time of reservation in the format of "[mm/dd[/[cc]yy] ]HH:MM".
Numeric : Duration of reservation in minutes.
Constant : Indicates how the nodes should be reserved.
Reservation Data Type | How nodes are reserved | Data Type |
---|---|---|
RESERVATION_BY_NODE | By number of nodes | string |
RESERVATION_BY_HOSTLIST | By specifying a hostlist | list |
RESERVATION_BY_JOBSTEP | By specifying a jobstep | string |
RESERVATION_BY_JCF | By specifying a job command file | string |
RESERVATION_BY_BG_CNODE | By number of Blue Gene c-nodes | numeric |
RESERVATION_BY_HOSTFILE | By specifying a host file | string |
To Modify | RES_OP | OP_VALUE |
---|---|---|
start_time | RESERVATION_START_TIME | string |
start_time | RESERVATION_ADD_START_TIME | string |
duration | RESERVATION_DURATION | numeric |
number_of_nodes | RESERVATION_BY_NODE | numeric |
number_of_nodes | RESERVATION_ADD_NUM_NODE | numeric |
hostlist | RESERVATION_BY_HOSTLIST | list |
hostlist | RESERVATION_ADD_HOSTS | list |
hostlist | RESERVATION_DEL_HOSTS | list |
jobstep | RESERVATION_BY_JOBSTEP | string |
job_command_file | RESERVATION_BY_JCF | string |
userlist | RESERVATION_USERLIST | list |
userlist | RESERVATION_ADD_USERS | list |
userlist | RESERVATION_DEL_USERS | list |
grouplist | RESERVATION_GROUPLIST | list |
grouplist | RESERVATION_ADD_GROUPS | list |
grouplist | RESERVATION_DEL_GROUPS | list |
shared mode | RESERVATION_MODE_SHARED | numeric |
remove on idle | RESERVATION_MODE_REMOVE_ON_IDLE | numeric |
owner | RESERVATION_OWNER | string |
group | RESERVATION_GROUP | string |
hostfile | RESERVATION_BY_HOSTFILE | string |
number_of_bg_cnodes | RESERVATION_BY_BG_CNODE | numeric |