lsblib

Application Programming Interface (API) library functions for batch jobs

LSBLIB functions allow application programs to get information about the hosts, queues, users, jobs and configuration of the batch system. Application programs can also submit jobs and control hosts, queues and jobs. Finally, application programs can read batch log files and write batch error messages.

Note:

All LSBLIB APIs require that the batch header file <lsf/lsbatch.h> be included.

Many LSBLIB APIs return a pointer to an array or structure. These data structures are in static storage or on the heap. The next time the API is called, the storage is overwritten or freed.

Any program using LSBLIB APIs that change the state of the batch system (that is, except for APIs that just get information about the system) must be setuid to root if LSF_AUTH is not defined in the lsf.conf file.

On systems which have both System V and BSD programming interfaces, LSBLIB typically requires the BSD programming interface. On System V-based versions of UNIX, for example SGI IRIX, it is normally necessary to link applications using LSBLIB with the BSD compatibility library.

On AFS systems, the following needs to be added to the end of your linkage specifications when linking with LSBLIB (assuming your AFS library path is /usr/afsws):

For HP-UX and Solaris,

-lc -L/usr/afsws/lib -L/usr/afsws/lib/afs -lsys -lrx -llwp /usr/afsws/lib/afs/util.a

For other platforms,

-lc -L/usr/afsws/lib -L/usr/afsws/lib/afs -lsys -lrx -llwp

Files:

${LSF_ENVDIR:-/etc}/lsf.conf
$LSF_CONFDIR/lsf.shared
$LSF_CONFDIR/lsf.cluster.cluster_name
$LSF_CONFDIR/lsf.task
$LSF_CONFDIR/lsf.task.cluster_name
$LSB_CONFDIR/cluster_name/configdir/lsb.hosts
$$LSB_CONFDIR/cluster_name/configdir/lsb.params
$LSB_CONFDIR/cluster_name/configdir/lsb.queues
$LSB_CONFDIR/cluster_name/configdir/lsb.users

See also:

lsb_addjgrp

lsb_addreservation

lsb_calendarinfo

lsb_calendarop

lsb_chkpntjob

lsb_closejobinfo

lsb_closependingreasons

lsb_closestatus

lsb_closestream

lsb_deletejob

lsb_deljgrp

lsb_deljgrp_ext

lsb_forcekilljob

lsb_freeGuaranteedResourcePoolEntArray

lsb_freeLimitInfoEnt

lsb_freelogrec

lsb_getalloc

lsb_getallocFromHhostfile

lsb_geteventrec

lsb_geteventrecbyline

lsb_getjobdepinfo

lsb_globalFairshareConf

lsb_globalFairshareLoadInfo

lsb_guaranteedResourcePoolInfo

lsb_holdjgrp

lsb_hostcontrol

lsb_hostgrpinfo

lsb_hostinfo

lsb_hostinfo_cond

lsb_hostinfo_ex

lsb_hostpartinfo

lsb_init

lsb_jsdl2submit

lsb_killbulkjobs

lsb_launch

lsb_limitInfo

lsb_listjgrp

lsb_liveconfig

lsb_mig

lsb_modify

lsb_modjgrp

lsb_modreservation

lsb_movejob

lsb_openjobinfo

lsb_openjobinfo_a

lsb_openjobinfo_a_ext

lsb_openjobinfo_req

lsb_openpendingreasons

lsb_openstatus

lsb_openstream

lsb_parameterinfo

lsb_peekjob

lsb_pendreason

lsb_perror

lsb_postjobmsg

lsb_puteventrec

lsb_queuecontrol

lsb_queueinfo

lsb_readframejob

lsb_readjobinfo

lsb_readjobinfo_cond

lsb_readjobmsg

lsb_readpendingreasons

lsb_readrankfile

lsb_readstatus

lsb_readstatusline

lsb_readstream

lsb_readstreamline

lsb_readstreamlineMT

lsb_reconfig

lsb_reljgrp

lsb_removereservation

lsb_requeuejob

lsb_reservationinfo

lsb_resize_cancel

lsb_resize_release

lsb_runjob

lsb_serviceClassInfo

lsb_sharedresourceinfo

lsb_signaljob

lsb_streamversion

lsb_submit

lsb_submitPack

lsb_submitframe

lsb_suspreason

lsb_switchjob

lsb_sysmsg

lsb_usergrpinfo

lsb_userinfo

lsb_userinfo2

lsb_writependingreasons

lsb_writestatus

lsb_writestream