lsb_suspreason

Explains why a job was suspended.

Using the SBD, lsb_suspreason explains why system-suspended and user-suspended jobs were suspended.

#include <lsf/lsbatch.h>

char *lsb_suspreason(int reasons, int subreasons, struct loadIndexLog *ld)

Parameters:

	reasons	Reasons a job suspends.
	subreasons	If reasons is SUSP_LOAD_REASON, subreasons indicates the load indices that are out of bounds. The integer values for the load indices are found in lsf.h.If reasons is SUSP_RES_LIMIT, subreasons indicates the job's requirements for resource reservation are not satisfied. The integer values for the job's requirements for resource reservation are found in lsbatch.h. Subreasons a job suspends if reasons is SUSP_LOAD_REASON: R15S 15 second CPU run queue length R1M 1 minute CPU run queue length R15M 15 minute CPU run queue length UT 1 minute CPU utilization PG Paging rate IO Disk IO rate LS Number of log in sessions IT Idle time TMP Available temporary space SWP Available swap space MEM Available memory USR1 USR1 is used to describe unavailable or out of bounds user defined load information of an external dynamic load indice on execution hosts. USR2 USR2 is used to describe unavailable or out of bounds user defined load information of an external dynamic load indice on execution hosts.
	*ld	When reasons is SUSP_LOAD_REASON, ld is used to determine the name of any external load indices. ld uses the most recent load index log in the lsb.events file.

Data Structures:

loadIndexLog

Define Statements:

suspending_reasons
suspending_subreasons

Returns:

char *:Returns the suspending reason string.
Function was successful.

NULL
The function failed. The reason code is bad.

Errors:

No error handling

Equivalent line commands:

bjobs -s

Environment Variable:

LSB_SUSP_REASONS

Files:

$LSB_CONFDIR/cluster_name/configdir/lsb.queues
$LSB_SHAREDIR/cluster_name/logdir/lsb.events

See also:

lsb_pendreason