lsb_hostinfo_ex

Returns informaton about job server hosts that satisfy specified resource requirements.

lsb_hostinfo_ex returns information about job server hosts that satisfy the specified resource requirements.

#include <lsf/lsbatch.h>

struct hostInfoEnt *lsb_hostinfo_ex(char **hosts, int *numHosts, char *resReq, int options)

Parameters:

	**hosts	An array of host or cluster names.
	*numHosts	The number of host names. To get information on all hosts, set *numHosts to 0; *numHosts will be set to the actual number of hostInfoEnt structures when this call returns. If *numHosts is 1 and hosts is NULL, information on the local host is returned.
	*resReq	Resource requirements. If this option is specified, then only host information for those hosts that satisfy the resource requirements is returned. Returned hosts are sorted according to the load on the resource() given in resReq, or by default according to CPU and paging load.
	options	Options is reserved for the future use.

Data Structures:

hostInfoEnt

Define Statements:

host_status
host_load_BusyReason
host_attributes

Returns:

struct hostInfoEnt *:
An array of hostInfoEnt structures which hold the host information and sets *numHosts to the number of hostInfoEnt structures.
Function was successful.

NULL
Function failed.

Errors:

If the function fails, lsberrno is set to indicate the error. If lsberrno is LSBE_BAD_HOST, (*hosts)[*numHosts] is not a host known to the batch system. Otherwise, if *numHosts is less than its original value, *numHosts is the actual number of hosts found.

Equivalent line commands:

none

Files:

$LSB_CONFDIR/cluster_name/configdir/lsb.hosts

See also:

ls_info

ls_loadofhosts

lsb_hostinfo

lsb_queueinfo

lsb_userinfo