Subsections


RESOURCES

Summary

This module provides routines for discovering and accessing information about Grid resources available to the GROWL system. It currently accesses remote methods which are provided and maintained on the UK e-Science Grid by the Grid Engineering Task Force http://tyne.dl.ac.uk/ETF/index.shtml as part of the InfoPortal project http://tyne.dl.ac.uk/InfoPortal/php. Other Grids and resources could be included.

attributes

Version: 1.0
Public calls: growl_mdsLast, growl_mdsCurrent, growl_xmlAll, growl_xmlDescription
Public modules: libresources.a, libgrowl.a
Other modules required: libbase.a gSOAP v2.1.4
Date: 2004
Origin: Hand-Knitted Software, R.J. Allan, CCLRC Daresbury Laboratory
Language: C
Conditions on external use: Standard, see separate chapter Workspace: internal workspace is allocated in all these routines by the gSOAP system for the long return string. This should be freed by the user when it is no longer required.
Use of globals: none
Other routines called directly: none
Input/ output: none
Restrictions:
Notes: The returned strings may contain line break characters which may be ignored.

How to use the Package

This module is used by including the libgrowl.a library or the libresources.a and libbase.a libraries. Publically callable procedures are listed here.

Specification of Resources Module

Specification of growl_xmlall

[frame=single]
      int growl_xmlAll(
                       char **result)

Argument List

char **result
On exit: long character string containing an XML description of all resources known to GROWL.

Information returned to the User

Integer, 0=success, !0=failure.

Error Returns

SOAP error message if there is a problem.

specification of growl_xmldescription

[frame=single]
      int growl_xmlDescription(
                               char *target, 
                               char **result)

Argument List

char *target
On entry: character string containing fully qualified dns name of the machine for which information is required.

char **result
On exit: long character string containing an XML description of all resources known to GROWL.

Information returned to the User

Integer, 0=success, !0=failure.

Error Returns

SOAP error message if there is a problem.

Specification of growl_mdslast

[frame=single]
      int growl_xmlLast(
                        char *target, 
                        char **result)

Argument List

char *target
On entry: character string containing fully qualified dns name of the machine for which information is required.

char **result
On exit: long character string containing an XML description of all resources known to GROWL.

Information returned to the User

Integer, 0=success, !0=failure.

Error Returns

SOAP error message if there is a problem.

Specification of growl_xmlcurrent

[frame=single]
      int growl_xmlCurrent(
                           char *target, 
                           char **result)

Argument List

char *target
On entry: character string containing fully qualified dns name of the machine for which information is required.

char **result
On exit: long character string containing an XML description of all resources known to GROWL.

Information returned to the User

Integer, 0=success, !0=failure.

Error Returns

SOAP error message if there is a problem.

Method

Algorithmic detail

All Grid resource information is obtained via calls to the InfoPortal Web services. MDS information is either live or cached. XML information is from the internal InfoPortal XML database.

Example

Example is shown of using the growl_xmlDescription method. Other methods in this package are similar.

Example text

[frame=single]
#include 'growl.h' 

   char target[]="login.hpcx.ac.uk";
   char *result;
   int res;

   res = xmlDescription(target, &result);

Example data

This is the imput parameter to the function.

Example results

Output is a long text string which describes the resource.

Rob Allan 2009-11-10