bltasks

Displays LSF License Scheduler interactive task information.

Synopsis

bltasks [-l] [task_ID]
bltasks [-l] [-p | -r | -w] [-Lp "ls_project_name..."] [-m "host_name..."] [-t "terminal_name..."] [-u "user_name..."]
bltasks [ | -h | -V]

Description

Displays current information about interactive tasks that were submitted by using taskman.

By default, displays information about all tasks that are managed by LSF License Scheduler.

Options

task_ID
Displays information only about the specified task.
-l
Long format. Displays detailed information for each task in a multiline format.
-p
Displays information only about tasks with PREEMPTED status.

Cannot be used with the -r or -w option.

-r
Displays information only about tasks with RUN status.

Cannot be used with the -p or -w option.

-w
Displays information only about tasks with WAIT status.

Cannot be used with the -p or -r option.

-Lp "ls_project_name..."
Displays information only about tasks that are associated with the specified projects.

If project group paths are enabled (the PROJECT_GROUP_PATH=Y parameter in the lsf.licensescheduler file) and a task has multiple effective license projects, displays only the first task that is associated with the specified effective license project.

-m "host_name..."
Displays information only about tasks that are submitted from the specified hosts.
-t "terminal_name..."
Displays information only about tasks that are submitted from the specified terminals.
-u "user_name..."
Displays information only about tasks that are submitted by the specified users.
-h
Prints command usage to stderr and exits.
-V
Prints LSF License Scheduler release version to stderr and exits.

Default Output

Displays the short format with the following information:

TID
Task ID that LSF License Scheduler assigned to the task.
USER
The user who submitted the task.
STAT
The status of the task.
RUN
Task is running.
WAIT
Task is not yet started.
PREEMPT
Task was preempted and currently has no license token.
HOST
The name of host from which the task was submitted.
PROJECT
The name of the project to which the task belongs.
FEATURES
Name of the LSF License Scheduler token.
CONNECT TIME

The submission time of the task.

EFFECTIVE_PROJECT
The actual project that the job used. If group project paths are enabled with the PROJECT_GROUP_PATH=Y parameter in the Parameters section of the lsf.licensescheduler file, LSF License Scheduler attempts to calculate a proper project according to the configuration if the license project does not exist or is not authorized for the features. Otherwise, the submission license project is the effective license project.

Output for -l Option

Displays detailed information for each task in multi-line format. If the task is in WAIT status, the bltasks command displays The application manager is waiting for a token to start and the resource requirement. Otherwise, the following current resource usage of task is displayed:

TERMINAL
The terminal the task is using.
PGID
UNIX process group ID.
CPU
The total accumulated CPU time of all processes in a task, in seconds.
MEM
Total resident memory usage of all processes in a task, in KB.
SWAP
Total virtual memory usage of all processes in a task, in KB.
Keyboard idle since
Time at which the task became idle.
RES_REQ
The resource requirement of the task.
Command line
The command the LSF License Scheduler task manager is running.