Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

lsb_sharedresourceinfo()

Returns the requested shared resource information in dynamic values.

DESCRIPTION

lsb_sharedresourceinfo() returns the requested shared resource information in dynamic values. The result of this call is a chained data structure as defined in <lsf/lsbatch.h>, which contains requested information.

SYNOPSIS

#include <lsf/lsbatch.h>
LSB_SHARED_RESOURCE_INFO_T *lsb_sharedresourceinfo(
                            char **resources, 
                            int *numResources, 
                            char *hostName, int options)

typedef struct lsbSharedResourceInfo {
    char *resourceName;
    int nInstances;
    LSB_SHARED_RESOURCE_INST_T *instances;
} LSB_SHARED_RESOURCE_INFO_T;

typedef struct lsbSharedResourceInstance {
    char *totalValue;
    char *rsvValue;
    int nHosts;
    char **hostList;
} LSB_SHARED_RESOURCE_INST_T; 

PARAMETERS

**resources

resources is an NULL terminated string array storing requesting resource names. Setting resources to point to NULL returns all shared resources.

*numResources

numResources is an input/output parameter. On input it indicates how many resources are requested. Value 0 means requesting all shared resources. On return it contains qualified resource number.

*hostName

hostName is a string containing a host name. Only shared resource available on the specified host will be returned. If hostName is a NULL, shared resource available on all hosts will be returned.

options

options is reserved for future use. Currently, it should be set to 0.

RETURN VALUES

pointer:

On success, lsb_sharedresourceinfo() returns a pointer to an LSB_SHARED_RESOURCE_INFO_T structure, which contains complete shared resource information.

char:NULL

Function failed.

ERRORS

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

SEE ALSO

Related API

ls_sharedresourceinfo()

Equivalent line command

none

Files

$LSF_CONFDIR/lsf.shared

$LSF_CONFDIR/lsf.cluster.cluster_name


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