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)
Data Structures: Define Statements:
- 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. Errors:
- 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.Equivalent line commands:
- 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.
Files:
- none
- $LSB_CONFDIR/cluster_name/configdir/lsb.hosts
Date Modified: 9 Sep 2009
Platform Support: support@platform.com
Platform Information Development: doc@platform.com
Platform Computing. Accelerating Intelligence(TM).
Copyright © 1994-2009 Platform Computing Corporation. All rights reserved.