blusers

displays license usage information

Synopsis

blusers [-J | -l | -P -j job_ID -u user_name -m host_name | -P -c cluster_name -j job_ID -u user_name -m host_name]
blusers [-h | -V]

Description

By default, displays summarized information about usage of licenses.

Options

-J

Displays detailed license resource request information about each job.

-l

Long format. Displays additional license usage information.

-P -j job_ID -u user_name -m host_name
-P -c cluster_name -j job_ID -u user_name -m host_name

This string of options is designed to be used in a customized preemption script. To identify a job, specify the LSF job ID, the user name, and the name of the host where the job is running.

(If the job is an interactive task submitted using taskman, do not specify -c cluster_name.)

You see the display terminal used by the job, the licenses it has checked out, and the license servers that provided the licenses. There is one line of output for each license feature from each FLEXnet license server, in the format:

port_number@host_name token_name user_name host_name display

-h

Prints command usage to stderr and exits.

-V

Prints License Scheduler release version to stderr and exits.

Default Output

FEATURE

The license name. This becomes the license token name.

SERVICE_DOMAIN

The name of the service domain that provided the license.

USER

The name of the user who submitted the jobs.

HOST

The name of the host where jobs have started.

NLICS

The number of licenses checked out from FLEXnet.

NTASKS

The number of running tasks using these licenses.

-J Output

Displays the following summary information for each job:

JOBID

The job ID assigned by LSF.

USER

The name of the user who submitted the job.

HOST

The name of the host where the job has been started.

PROJECT

The name of the license project that the job is associated with.

CLUSTER

The name of the LSF cluster that the job is associated with. Displays “-” for an interactive job.

START_TIME

The job start time.

Displays the following information for each license in use by the job:

RESOURCE

The name of the license requested by the job.

RUSAGE

The number of licenses requested by the job.

SERVICE_DOMAIN

The name of the service domain that provided the license.

The keyword UNKNOWN means the job requested a license from License Scheduler but has not checked out the license from FLEXnet.

Long Output (-l)

Displays the default output and the following additional information for each job:

OTHERS

License usage for non-managed or non-LSF workload.

DISPLAYS

Terminal display associated with the license feature.

Viewing license feature locality

When LOCAL_TO is configured for a feature in lsf.licensescheduler, blusers shows the cluster locality information for the license features. For example:
blusers
FEATURE          SERVICE_DOMAIN  USER     HOST       NLICS    NTASKS
hspice@clusterA  SD1             user1    host1      1        1
hspice@siteB     SD2             user2    host2      1        1

Examples

blusers -l
FEATURE  SERVICE_DOMAIN  USER   HOST    NLICS   NTASKS OTHERS  DISPLAYS 
feat1    LanServer       user1  hostA   1       1      0     (/dev/tty) 
blusers -J
JOBID   USER      HOST      PROJECT             CLUSTER        START_TIME
553     user1     hostA     p3                  cluster1       Oct  5 15:47:14
RESOURCE        RUSAGE        SERVICE_DOMAIN
p1_f1           1             app_1

See also

blhosts, blinfo, blstat