Platform LSF Reference Version 6.2
lsrtasks
Platform LSF Reference
246
lsrtasks
displays or updates a user’s remote task list
SYNOPSIS
lsrtasks [+ task_name[/res_req] ... | – task_name[/res_req] ...]
lsrtasks [-h |-V]
DESCRIPTION
Displays or updates a user’s remote task list in $HOME/.lsftask.
When no options are specified, displays tasks listed in the system task file
lsf.task
and the user’s task file
.lsftask.
If there is a conflict between the system task file
lsf.task and the user’s task file
.lsftask, the user’s task file overrides the system task file.
Tasks in the remote task list are eligible for remote execution. You can associate resource
requirements with each task name. Eligibility of tasks not specified in a task list for
remote execution depends on the operation mode: local or remote. In local mode, tasks
are not eligible for remote execution; in remote mode, tasks are eligible. You can specify
the operation mode when deciding the eligibility of a task (see
lseligible(1), and
ls_eligible(3)).
OPTIONS
+ task_name[/res_req] ...
If plus sign (+) is specified and the specified task names are not already in the file
.lsftask in the user’s home directory, adds the task names to the file with a + sign
preceding them.
If any of the task names are already in the
.lsftask file, the actual action depends on
the entry in the file. If the entry starts with a
+ or nothing, replaces the entry with the
specified content; if the entry starts with a minus sign (–), deletes the entry from the
.lsftask file.
Remote tasks can have a resource requirement expression associated with them,
separated by a backslash (/). See
ls_task(3).
- task_name[/res_req] ...
If – is specified and specified task names are not already in the file .lsftask in the
user’s home directory, adds the task names to the file with a – preceding the task name.
If any of the task names are already in the
.lsftask file, the actual action depends on
the entry in the file. If the entry starts with a –, no operation is done; if the entry starts
with a +, deletes the entry from the
.lsftask file.
Remote tasks can have a resource requirement expression associated with them,
separated by a backslash /. See
ls_task(3).
-h
Prints command usage to stderr and exits.