lsb_openjobinfo

Returns the number of jobs in the master batch daemon.

lsb_openjobinfo accesses information about pending, running and suspended jobs in the master batch daemon. Use lsb_openjobinfo to create a connection to the master batch daemon. Next, use lsb_readjobinfo to read job records.Close the connection using lsb_closejobinfo.

lsb_openjobinfo opens a connection with mbatchd and returns the total number of records in the connection on success.

#include <lsf/lsbatch.h>

int lsb_openjobinfo(LS_LONG_INT jobId, char *jobName, char *userName, char *queueName, char *hostName, int options)

Parameters:

	jobId	Passes information about jobs with the given job ID. If jobId is 0, lsb_openjobinfo looks to another parameter to return information about jobs.If a member of a job array is to be passed, use the array form jobID[ i ] where jobID is the job array name, and i is the index value.
	*jobName	Passes information about jobs with the given job name. If jobName is NULL, lsb_openjobinfo looks to another parameter to return information about jobs.
	*userName	Passes information about jobs submitted by the named user or user group, or by all users if user is all. If user is NULL, lsb_openjobinfo assumes the user is invoking this call.
	*queueName	Passes information about jobs belonging to the named queue. If queue is NULL,jobs in all the queues of the batch system are counted.
	*hostName	Passes information about jobs on the named host, host group or cluster name. If host is NULL, jobs on all hosts of the batch system will be considered.
	options	<lsf/lsbatch.h> defines the flags shown in defs_lsb_openjobinfo constructed from bits. Use the bitwise OR to set more than one flag.

Data Structures:

: none

Define Statements:

: defs_lsb_openjobinfo_a
defs_lsb_openjobinfo

Returns:: int:value
The total number of records in the connection.
int:-1
The function failed.

Errors:

: If the function fails, lsberrno is set to indicate the error.

Equivalent line command:

: bjobs

Files:

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

See also:

lsb_openjobinfo_a

lsb_openjobinfo_a_ext