Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

lsb_hostinfo_cond()

Returns condensed information about job server hosts.

DESCRIPTION

lsb_hostinfo_cond() returns condensed information about job server hosts. While lsb_hostinfo() returns specific information about individual hosts, lsb_hostinfo_cond() returns the number of jobs in each state within the entire host group. The condHostInfoEnt structure contains counters that indicate how many hosts are in the ok, busy, closed, full, unreach, and unavail states and an array of hostInfoEnt structures that indicate the status of each host in the host group.

SYNOPSIS

#include <lsf/lsbatch.h> 
struct condHostInfoEnt * lsb_hostinfo_cond
                        (char **hosts, int *numHosts,
                         char *resReq, int options)

struct condHostInfoEnt {
    char *name;
    int howManyOk;
    int howManyBusy;
    int howManyClosed;
    int howManyFull;
    int howManyUnreach;
    int howManyUnavail;
    struct hostInfoEnt *hostInfo;
}; 

PARAMETERS

**hosts

An array of host names belonging to the host group.

*numHosts

The number of host names in the host group.

To get information on all hosts in the host group, set *numHosts to 0; *numHosts will be set to the actual number of hostInfoEnt structures in the host group when this call returns.

*resReq

Any resource requirements called with the function.

options

Any options called with the function.

RETURN VALUES

*condHostInfoEnt

The condHostInfoEnt structure contains condensed information about the status of job server hosts in the host group. If there is no condensed host group matching the specified host, *name is set to NULL and *hostInfo contains specific host information to be displayed instead of the condensed host group information.

ERRORS

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

SEE ALSO

Related APIs:

lsb_hostinfo() - Returns information about job server hosts


Platform Computing Inc.
www.platform.com
Knowledge Center         Contents    Previous  Next