LSF_QUERY_ES_FUNCTIONS

Syntax

LSF_QUERY_ES_FUNCTIONS="all"

LSF_QUERY_ES_FUNCTIONS="[acct]|[jobs]|[energy]|[gpfsio]"

Description

Specifies the functions that are permitted to use IBM® Spectrum LSF Explorer (LSF Explorer) to access and retrieve additional data. Specify a space-separated list of function names.

The acct and jobs functions integrate bacct and bhist with LSF Explorer Server. Using LSF Explorer to get data improves the performance of the supported commands by avoiding the need for parsing large log files whenever you run these commands.

This energy function integrates LSF Explorer energy accounting into LSF. LSF uses LSF Explorer to collect energy data from each host by the LSF Beats services (lsfbeat tool). The bjobs and bhosts commands can then query the data from LSF Explorer and display the job level or host level energy to users.

To use this parameter, you must first define the LSF_QUERY_ES_SERVERS parameter to enable LSF to use LSF Explorer to retrieve the data.

Valid values

acct: If the acct function is defined, the bacct command uses LSF Explorer to retrieve the accounting log records.
jobs: If the jobs function is defined, the bhist command uses LSF Explorer to retrieve the event log records.
energy: If the energy function is defined and LSF_ENABLE_BEAT_SERVICE="energy" is defined in the lsf.conf file, the bhosts and bjobs commands use LSF Explorer to retrieve energy data.
gpfsio: If the gpfsio function is defined, the bjobs and bacct commands use LSF Explorer to retrieve IBM Spectrum Scale job accounting I/O data.
Specifically, the bjobs -l command shows approximate accumulated job disk usage (I/O) data, the bjobs -o "gpfsio" command shows job disk usage (I/O) data, and the bacct -l command shows the total approximate number of read/write bytes of all storage pools, all on IBM Spectrum Scale.
all: If the all keyword is defined, all supported functions use LSF Explorer to retrieve data.

Default

Not defined. The commands do not use LSF Explorer to retrieve data.