lsrtasks

Displays or updates a remote task list.

Synopsis

lsrtasks [+ task_name[/res_req] ... | – task_name[/res_req] ...]

lsrtasks [-h | -V]

Description

Note: This command is deprecated and might be removed in a future version of LSF.

Displays or updates a user’s remote task list in the $HOME/.lsftask file.

When no options are specified, displays tasks that are listed in the system task file lsf.task and the user’s task file .lsftask.

If the system task file lsf.task conflicts with the user task file, the user 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 that are 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 for deciding the eligibility of a task.

Options

+ task_name[/res_req] ...

If plus sign (+) is specified and the specified task names are not already in the user task file (.lsftask), adds the task names to the file with a + sign that precedes 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 plus sign (+) 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 associated resource requirements, separated by a backslash (/).

- task_name[/res_req] ...

If a minus sign (–) is specified and specified task names are not already in the user task file (.lsftask), 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 associated resource requirements, separated by a backslash (/).

-h

Prints command usage to stderr and exits.

-V

Prints LSF release version to stderr and exits.

Examples

% lsrtasks + task1 task2/"select[cpu && mem]" - task3

Or in restricted form:

% lsrtasks + task1 task2/cpu:mem - task3

Adds the command task1 to the remote task list with no resource requirements, adds task2 with the resource requirement cpu:mem, and removes task3 from the remote task list.

% lsrtasks + myjob/swap>=100 && cpu

Adds myjob to the remote tasks list with its resource requirements.

Running lsrtasks with no arguments displays the resource requirements of tasks in the remote list, which is separated from the task name by a slash (/):

% lsrtasks
cc/cpu              cfd3d/type == SG1 && cpu  compressdir/cpu:mem
f77/cpu             verilog/cpu && cadence    compress/cpu
dsim/type == any    hspice/cpu && cadence      nas/swp > 200 && cpu
compress/-:cpu:mem  epi/hpux11 sparc           regression/cpu
cc/type == local    synopsys/swp >150 && cpu

Files

Reads the system task file lsf.task, and the user task file (.lsftask).

The system and user task files contain two sections, one for the remote task list, the other for the local task list. The remote tasks section starts with Begin RemoteTasks and ends with End RemoteTasks. Each line in the section is an entry that consists of a task name.

A plus sign + or a minus sign – can optionally precede each entry. If no + or – is specified, then + is assumed.