lsrtasks, lsltasks - display or update the remote and local task lists
lsrtasks [ -h ] [ -V ] [ +|- task_name/res_req ... ] lsltasks [ -h ] [ -V ] [ +|- task_name ... ]
Display or update the user's local and remote task lists for use with the LSF system. These lists are generated by reading the system task files (see lsf.task(5) ) and the .lsftask file in the user's home directory. If there is a conflict between the system task file and user's file, the latter overrides the former.
The task file (system or user) contains two sections, one for the remote task list, the other for the local task list. Each section starts with Begin LocalTasks or Begin RemoteTasks and ends with End LocalTasks or End RemoteTasks. Each line in a section is an entry consisting of a task name and for the remote task list, a resource requirement expression separated by a slash `/'. A plus sign `+' or a minus sign `-' can optionally precede each entry. If no `+' or `-' is specified, then `+' is assumed.
Tasks in a local task list are not eligible for remote execution, either because they are trivial tasks or because they need resources on the local host. Tasks in a remote task list are eligible for remote execution. You can associate resource requirements with each task name. The remote execution eligibility of tasks that are not specified in a task list depends on the operation mode: local or remote. In local mode, they are not eligible for remote execution; in remote mode, they are eligible. You can specify the operation mode when deciding the eligibility of a task (see lseligible(1) , and ls_eligible(3) ).
If no argument is given, lsrtasks and lsltasks display the remote or local task list, respectively, in multi-column format. For remote tasks, each task name can have a resource requirement expression (see ls_task(3) ) associated with it, separated by a `/'. If a `+' or `-' followed by task names is specified, the corresponding section (LocalTasks or RemoteTasks) in the file .lsftask in the user's home directory is updated or created as follows:
If `+' is specified and the task names are not already in the file .lsftask in the user's home directory, these task names are added to the file with a preceding `+' sign. 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, then the entry is replaced by the new content specified in the command line; if the entry starts with a `-', then the entry is removed from the .lsftask file.
If `-' is specified and the task names are not already in the file .lsftask in the user's home directory, these task names are added to the file with a preceding `-'. 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 `+', the entry is removed from the .lsftask file.
% lsrtasks + foo bar/"select[cpu && mem]» - fum
or in restricted form:
% lsrtasks + foo bar/cpu:mem - fum
add the command foo to the remote task list with no resource requirements,
add bar with the resource requirement cpu:mem, and remove fum
from the remote task list.
lsfintro(1) , lseligible(1) , ls_task(3) , lsf.task(5) , ls_eligible(3)