lsb_readframejob

Returns all frame jobs information which matchs the specified parameters and fills related information into the frame job information table.

lsb_readframejob gets all frame jobs information that matches the specified parameters and fills related information into the frame job information table. lsb_readframejob is a wrapper of lsb_openjobinfo, lsb_readjobinfo, and lsb_closejobinfo. Memory allocated in frameJobInfoTbl will be freed by user.

#include <lsf/lsbatch.h>

int lsb_readframejob(LS_LONG_INT jobId, char *frameName, char *user, char *queue, char *host, int options, struct frameJobInfo **frameJobInfoTbl)

Parameters:

	jobId	Get information about the frame jobs with the given job ID. If jobID is 0, get information about frame jobs which satisfy the other specifications. If a job in a job array is to be modified, use the array form jobID[i] where jobID is the job array name, and i is the index value.
	*frameName	Get information about frame jobs with the given frame name.
	*user	Get information about frame jobs submitted by the named user or user group, or by all users if user is all. If user is NULL, the user invoking this routine is assumed.
	*queue	Get information about frame jobs belonging to the named queue. If queue is NULL,jobs in all queues of the batch system will be considered.
	*host	Get information about frame 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 following flags defs_lsb_openjobinfo_a constructed from bits. Use the bitwise OR to set more than one flag.
	**frameJobInfoTbl	The result of all frame jobs information.

Data Structures:

frameJobInfo
frameElementInfo

Define Statements:

none

Returns:

int:Length of frame job information table.
Function was successful.

int:-1
Function failed.

Errors:

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

Equivalent line commands:

none

Files:

none

See also:

lsb_openjobinfo

lsb_readjobinfo

lsb_closejobinfo