Obtaining and Destroying Job Instances

An application programmer can not directly create a GATJob instance, she must first make oblation to the Ra of GAT. It is only through a call on an instance of the class GATResourceBroker that one can create a GATJob instance. In particular one must make a call to the function

GATResult
  GATResourceBroker_SubmitJob(GATResourceBroker broker,
    GATJobDescription_const description, GATJob *job)

The first argument is the GATResourceBroker used to create the GATJob instance. The next argument is a GATJobDescription which describes the desired GATJob . The final argument is a pointer to a GATJob. It is through this pointer that the function returns to the caller the desired GATJob instance. Finally, this function returns a GATResult, covered in Appendix , indicating its completion status.

Destruction of such a GATJob instance is simple. Only one call to the function

void GATJob_Destroy(GATJob *resource)

and all resource held by the passed GATJob instance are released.