lsb_pendreason

Explains why a job is pending.

Use lsb_pendreason to determine why a job is pending. Each pending reason is associated with one or more hosts.

#include <lsf/lsbatch.h>

char *lsb_pendreason (int numReasons, int *rsTb, struct jobInfoHead *jInfoH, struct loadIndexLog *ld, int clusterId)

Parameters:

	numReasons	The number of reasons in the rsTb reason table.
	*rsTb	The reason table. Each entry in the table contains one of pending_reasons
	*jInfoH	jInfoH contains job information.
	*ld	From lsb_suspreason, 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.
	clusterId	MultiCluster cluster ID. If clusterId is greater than or equal to 0, the job is a pending remote job, and lsb_pendreason checks for host_name@cluster_name. If host name is needed, it should be found in jInfoH->remoteHosts. If the remote host name is not available, the constant string remoteHost is used.

Data Structures:

jobInfoHead
loadIndexLog

Define Statements:

pending_reasons
suspending_reasons
suspending_subreasons

Returns:

char *:reasons
The function is successful. It returns a reason why the job is pending.

NULL
The function fails. The reason code is bad.

Errors:

If no PEND reason is found, the function fails and lsberrno is set to indicate the error.

Equivalent line command:

bjobs -p

Files:

${LSF_ENVDIR:-/etc}/lsf.conf

See also:

lsb_geteventrec