ls_deleteltask

Deletes the specified task from the local task list.

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 lsltasks(). See the LSF User's Guide for detailed information on the use of task lists and resource requirements.

ls_deleteltask deletes the specified task from the local task list.
task is a char string containing a task name.

For example,
"cc/select[swp>20 || (mem>10 && pg<5)] order[swp:pg] rusage[swp=20]"
See Administering IBM Platform LSF for a description of the resource requirement string.

#include <lsf/lsf.h>
int ls_deleteltask(char *task)

Parameters:

*task

The task to be deleted from the local task list.

Data Structures:

none

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:

$LSF_CONFDIR/lsf.task
$LSF_CONFDIR/lsf.task.cluster_name
$HOME/.lsftask

See also:

ls_eligible

ls_resreq

ls_listrtask

ls_listltask

ls_insertrtask

ls_insertltask

ls_deletertask