getJobDetails

Deprecated. see jobs. Returns the results of the specified job.

Parameters

jobId
Required. The identifier of the job to retrieve. If the user does not supply a valid jobId, the server returns an appropriate error message as part of the return value.

Return value

Returns the SPXML string containing the results of the requested job. See Output SPXML string for more information.

Remarks

When you send an asynchronous or scheduled evaluation to the server, the server immediately returns the results containing the jobId and status. Use this jobId to retrieve the job.

Note that the Expression Service API, the Administration Service API, and the Function Service API all contain getJobDetails functions that are identical. This design allows you to retrieve a job using only the API for that service.

An existing job can have a status of:

Status Code
interrupted -2
failed -1
waiting to start 0
running 1
done 2
done with error 3

Deleted jobs are not considered existing jobs.

Example

The following link retrieves job 111 from the server.

http://servername:8080/SplusServer/api/v8/expression/getJobDetails?jobId=111

See jobs for an example of returned SPXML from such a call.

Related reference