Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

ls_resreq()

Searches a remote task list for a task name and returns the resource requirements.

DESCRIPTION

LSLIB library routine for manipulating task lists stored by LSLIB. Task lists contain information about the eligibility of tasks for remote execution and their resource requirement characteristics. LSLIB maintains two task lists: local and remote. The local list contains tasks (i.e. UNIX processes) that must be executed on the local host (for example, ps, uptime, hostname). The remote list contains tasks that are suitable for remote execution (for example, compress), together with their resource requirements.

Task lists are generated and stored in memory by reading the system task file() and the .lsftask file in the user's home directory. The task lists can be updated and displayed using the command lsrtasks(). See the LSF User's Guide for detailed information on the use of task lists and resource requirements.

ls_resreq() is a simplified version of ls_eligible() which searches the remote task list for taskname and returns the resource requirements associated with the task if found otherwise NULL is returned.

ls_resreq() returns a pointer to static data which can be overwritten by subsequent calls.

SYNOPSIS

#include <lsf/lsf.h> 
char *ls_resreq(char *taskname) 

PARAMETERS

*taskname

The name of the task being sought.

RETURN VALUES

character:Requirements

Returns the resource requirements associated with the taskname.

character:NULL

Unable to find the taskname on the remote task list.

ERRORS

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

SEE ALSO

Related APIs

ls_eligible()

ls_listrtask()

ls_listltask()

ls_insertrtask()

ls_inesrtltask()

ls_deletertask()

ls_deleteltask()

Equivalent line command

none

Files

$LSF_CONFDIR/lsf.task

$LSF_CONFDIR/lsf.task.cluster_name

$HOME/.lsftask


Platform Computing Inc.
www.platform.com
Knowledge Center         Contents    Previous  Next