GridLab
Grid Application Toolkit

A simple API for Grid Applications 		GAT
Menu


next up previous contents
Next: Creating and Destroying JobDescription Up: The Job Management Package Previous: Jobs   Contents

Creating and Destroying SoftwareDescription Instances

The class GATSoftwareDescription is in many ways similar to a GATSoftwareResourceDe scription; it is basically a container for a GATTable instance and this GATTable contains various name/value pairs which describe the executable the GATSoftwareDescription represents. The full set of supported name/value paris is given in table [*]


Table: Software Description: The minimum set of supported name/values.
Name Type Description
location GATLocation Software location.
arguments List<String> Software command line arguments.
environment GATTable Software environment, names/values are C strings.
stdin GATFile Stdin from which the executable reads.
stdout GATFile Stdout to which the executable writes.
stderr GATFile Stderr to which the executable writes.
pre-staged files List<GATFile> Files staged to the resource before invocation.
post-staged files List<GATFile> Files staged from the resource after completion.


As in the case of GATSoftwareResourceDescription, to construct an instance of the class GATSoftwareDescription one simply need a table. Explicitly one uses the function 

GATSoftwareDescription GATSoftwareDescription_Create(GATTable_const attributes)

The first, and only, argument to this function is a GATTable instance which contains name/value pairs described in table [*]. Upon success this function returns a GATSoftwareDescription instance corresponding to the passed GATTable instance. Upon failure it returns NULL.

To destroy a so created GATSoftwareDescription instance one uses the function 

void GATSoftwareDescription_Destroy(GATSoftwareDescription *resource)

Upon completion this function releases an resources held by the passed GATSoftwareDescription instance.

next up previous contents
Next: Creating and Destroying JobDescription Up: The Job Management Package Previous: Jobs   Contents
Andre Merzky 2004-05-13