bltasks

displays 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 managed by License Scheduler (submitted using taskman).

By default, displays information about all tasks.

Options

task_ID

Only displays information about the specified task.

-l

Long format. Displays detailed information for each task in a multi-line format.

-p

Only displays information about tasks with PREEMPTED status.

Cannot be used with -r or -w.

-r

Only displays information about tasks with RUN status.

Cannot be used with -p or -w.

-w

Only displays information about tasks with WAIT status.

Cannot be used with -p or -r.

-Lp “ls_project_name...”

Only displays information about tasks associated with the specified projects.

-m "host_name..."

Only displays information about tasks submitted from the specified hosts.

-t “terminal_name...”

Only displays information about tasks submitted from the specified terminals.

-u “user_name...”

Only displays information about tasks submitted by the specified users.

-h

Prints command usage to stderr and exits.

-V

Prints License Scheduler release version to stderr and exits.

Default Output

Displays the short format with the following information:

TID

Task ID that License Scheduler assigned to the task.

USER

The user who submitted the task.

STAT

The current status of the task.

  • RUN: Task is running.

  • WAIT: Task has not yet started.

  • PREEMPT: Task has been 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 License Scheduler token.

CONNECT TIME

The submission time of the task.

Output for -l Option

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

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 License Scheduler task manager is executing.

Output for -g Option

Displays every task group and information about the tasks that belong to the group. The first 4 fields - POLICY, USER, HOST, and TERMINAL - define a unique task group. A dash (-) in one of these fields means that the group includes all tasks, no matter what the value of the field is.

POLICY

License Scheduler token name. All tasks in the group request this type of license.

USER

License Scheduler user name. All tasks in the group are submitted by this user.

HOST

Host name. All tasks in the group are submitted from this host.

TERMINAL

Terminal name. All tasks in the group are submitted using this terminal.

TASK_NAME

The task name.

RUN

If 0, the group does not have a License Scheduler token at this time.

If 1 or greater, the group has a token and all tasks in the group are running.

TOTAL

Number of tasks in the group.

CONNECT_TIME

Time and date that the group was created (and requested a License Scheduler token). If all tasks in a group finish, the group releases the License Scheduler token, and the next task submitted re-creates the group.