ls_loadadj

Sends a load adjustment request to LIM after the execution host or hosts have been selected outside the LIM by the calling application.

ls_loadadj sends a load adjustment request to LIM after the execution host or hosts have been selected outside the LIM by the calling application. Use this call only if a placement decision is made by the application without calling ls_placereq (for example, a decision based on the load information from an earlier ls_load call). This request keeps LIM informed of task transfers so that the potential load increase on the destination host() provided in placeinfo are immediately taken into consideration in future LIM placement decisions. listsize gives the total number of entries in placeinfo.

ls_loadadj returns 0 on success, otherwise -1 is returned and lserrno is set to indicate the error.

ls_loadadj can adjust all load indices with the exception of ls, it, r15m and external load indices.

#include <lsf/lsf.h>

int ls_loadadj(char *resreq, struct placeInfo *hostlist, int listsize)

Parameters:

	*resreq	resreq is a resource requirement expression (which can be NULL) that describes the resource requirements for which the load must be adjusted. These typically are the resource requirements for the previously placed task. LIM adjusts the host load indices according to the resource requirement. If NULL is specified, then LIM assumes that the task or tasks are both CPU and memory intensive (this is the default).
	*hostlist	placeinfo is a pointer to an array of placeInfo structures. A placeInfo structure contains a hostname, and an int, numtask, that represents a particular number of tasks. The host load indices (specified by resreq) of all the hosts that are specified in the array are increased by the number of tasks specified. Each task is assumed to have the same resource requirements. The requirements are those specified in resreq.
	listsize	listsize gives the number of host or cluster names in hostlist.

Data Structures:

placeInfo

Define Statements:

none

Returns:

int:0
Function was successful.

int:-1
Function failed.

Errors:

If the function fails, lserrno is set to indicate the error.

Equivalent line commands:

none

Files:

none

See also:

ls_placereq

ls_placeofhosts

ls_eligible

ls_info

ls_load