submitting ecl workunits through soap

[Verticon]

we can retrieve work unit information over soap utilizing the wsdl available from ecl watch (/wsworkunits/?ver_=1.34&wsdl). is there a way to submit an ecl query through soap using a combination of the methods available, essentially simulating the ecl ide submit button and the eclplus asynchronous submission?

[anthony.fishbeck@lexisnexis.com]

Yes, in fact both the ECL IDE and eclplus make SOAP calls to WsWorkunits in order to create and run workunits.

WsWorkunits has a lot of SOAP operations and quite a few parameters on top of those, and it isn't currently documented, but the basic steps would be:

• Create a Workunit by calling WUCreate.
• Update that Workunit by calling WUUPdate:
  
  • Set Wuid to the value returned by WUCreate.
    
  • Set QueryText to your ECL text or archive (if you have multiple files or library dependencies you will have to create an archive before sending).
    
  • Set Action to 3 (Compile = 1, Check = 2, Run = 3)
    
  • Typically set Result limit to something like the IDE default of 100.
• Run workunit by calling WUSubmit
  
  • Set Wuid to the value returned by WUCreate.
    
  • Set Cluster to target cluster to run on.
    
  • Set MaxRunTime to wait (0) for async.
    
  • Set Syntax check to false. (used for only doing syntax check).
• You can poll for state change by calling WUInfo, or maybe WUQuery.
• You can wait for completion synchronously by calling WUWaitComplete.
• There are multiple operations for retrieving results after completion.

You can get indiviual wsdls for each operation: /WsWorkunits/<operation_name>?wsdl

You can also access a test form and test the operations via browser: /WsWorkunits/<operation_name>?form

[harshdesai]

Hi,
Can you please help with excat steps and how we will be using this soap calls.

[anthony.fishbeck]

Can you describe the functionality you are trying to provide? For example is this a standalone client or part of a query or service? Do you want to wait asynchronously for results? How long will each workunit take to complete?

There are several ways of running jobs via SOAP and what you use depends on the client behavior you are trying to achieve.