Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

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