Jobs


Click here for a complete list of operations.

SubmitJob

Submits an asynchronous query to a queue longer than the shortest queue of a given context.
Returns a JobID on successful submission, exceptions otherwise.

Parameters:
long wsid : WebServicesID of the account the query will be run under.
string pw : Password of said account
string qry : Query to run
string context : Context of job
string taskname : Optional identifier of job.
int estimate : Job will be run in the queue with the time limit nearest to 'estimate'. Values are in minutes.

Output:
long : A unique identifier for the newly submitted job

Test

To test the operation using the HTTP POST protocol, click the 'Invoke' button.
Parameter Value
wsid:
pw:
qry:
context:
taskname:
estimate:

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /CasJobs/services/jobs.asmx HTTP/1.1
Host: casjobs.sdss.org
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://Services.Cas.jhu.edu/SubmitJob"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <SubmitJob xmlns="http://Services.Cas.jhu.edu">
      <wsid>long</wsid>
      <pw>string</pw>
      <qry>string</qry>
      <context>string</context>
      <taskname>string</taskname>
      <estimate>int</estimate>
    </SubmitJob>
  </soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <SubmitJobResponse xmlns="http://Services.Cas.jhu.edu">
      <SubmitJobResult>long</SubmitJobResult>
    </SubmitJobResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /CasJobs/services/jobs.asmx HTTP/1.1
Host: casjobs.sdss.org
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <SubmitJob xmlns="http://Services.Cas.jhu.edu">
      <wsid>long</wsid>
      <pw>string</pw>
      <qry>string</qry>
      <context>string</context>
      <taskname>string</taskname>
      <estimate>int</estimate>
    </SubmitJob>
  </soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <SubmitJobResponse xmlns="http://Services.Cas.jhu.edu">
      <SubmitJobResult>long</SubmitJobResult>
    </SubmitJobResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP GET

The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.

GET /CasJobs/services/jobs.asmx/SubmitJob?wsid=string&pw=string&qry=string&context=string&taskname=string&estimate=string HTTP/1.1
Host: casjobs.sdss.org

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<long xmlns="http://Services.Cas.jhu.edu">long</long>

HTTP POST

The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /CasJobs/services/jobs.asmx/SubmitJob HTTP/1.1
Host: casjobs.sdss.org
Content-Type: application/x-www-form-urlencoded
Content-Length: length

wsid=string&pw=string&qry=string&context=string&taskname=string&estimate=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<long xmlns="http://Services.Cas.jhu.edu">long</long>