Knowledge Center Contents Previous Next |
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.
DESCRIPTION
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.
SYNOPSIS
#include <lsf/lsf.h> int ls_loadadj(char *resreq, struct placeInfo *placeinfo, int listsize) struct placeInfo { char hostName[MAXHOSTNAMELEN]; int numtask; }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 (see ls_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).
*placeinfo
placeinfo is a pointer to an array of placeInfo structures. A placeInfo structure contains a hostname, and an integer, 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
hostname
Name of the host.
numtask
Number of tasks on the host.
RETURN VALUES
integer:0
Function was successful.
integer:-1
Function failed.
ERRORS
If the function fails, lserrno is set to indicate the error.
SEE ALSO
Related APIs
ls_placereq()
ls_placeofhosts()
ls_eligible()
ls_info() - Returns a pointer to an lsInfo structure
ls_load()
ls_task()
Equivalent line command
none
Files
none
Platform Computing Inc.
www.platform.com |
Knowledge Center Contents Previous Next |