Obtaining the JobDescription of a Job Instance

After a one had used a GATJobDescription to create a GATJob instance one can obtain the GATJobDescription back from the GATJob instance. This is useful, for example, if one blind obtains a GATJob instance from a GATAdvertService. One obtains this GATJobDescription through a call to the function

GATResult GATJob_GetJobDescription(GATJob_const job, GATJobDescription_const *jd)

This function takes as its first argument a GATJob instance indicating the GATJob to query. The next argument is a pointer to a GATJobDescription. Through this pointer the function returns to the caller the apropos GATJobDescription instance. Finally, the function returns a GATResult, covered in Appendix , indicating its completion status.