Obtaining Information about a Job Instance

Beyond the GATJobDescription. one can also obtain further information about a particular GATJob through a call to the function

GATResult GATJob_GetInfo(GATJob_const object, GATTable_const *jobinfo)

It's initial argument is the GATJob instance to query. The following argument is a pointer to a GATTable instance. Through this pointer this function returns to the caller a GATTable instance containing this further information, the details of which we will cover below. As one can see this function returns a GATResult, see Appendix , which is used to indicate its completion status.

The GATTable instance obtained from the above function contains a set of various name/value pairs describing the job, adding a bit more detail to the info present in a GATJobDescription. The set of supported name/value pairs for such an info call are found in table

Table: The supported set of name/value pairs for an info call.

Name Type Description hostname C String Name of the host on which the job is running. scheduletime GATObject A GATTime indicating when the job was scheduled. starttime GATObject A GATTime indicating when the job was started. stoptime GATObject A GATTime indicating when the job was stopped. checkpointable GATint16 A indicating the job is checkpointable, otherwise.

In addition one should note that not all the various values in the table make sense at all points in the life cycle of a GATJob. For example, if a GATJob instance is in an initial state, then the starttime name/value pair will not be present. Other obvious, similar restrictions hold on the various name/value pairs.