Obtaining the JobID of a Job Instance

A practice followed on all modern operating systems is that of assigning a unique identifier to each executing process. This is useful for any number of reasons. The most obvious of which is that it simply gives a means of uniquely referring to a particular process. Think how horrible it would be if you were without a name and had to live out the balance of your days answering only to ``Hey, you over there. Yeah, you the funny looking one.'' Torture is other people.

To avoid all this mess GAT introduces a unique job ID for each GATJob instance. One obtains this job ID through a call to the function

GATResult GATJob_GetJobID(GATJob_const object, GATJobID_const *jobid)

This function's initial argument is the GATJob instance on wishes to query. The next argument is a pointer to a GATJobID. The class GATJobID is introduced solely to contain job ID's. It is through this pointer to a GATJobID that this function returns the job ID to the caller. Finally, this function returns a GATResult, covered in Appendix , which indicates its completion status.