Tue Aug 16, 2022 3:45 pm
Login Register Lost Password? Contact Us

Please Note: The HPCC Systems forums are moving to Stack Overflow. We invite you to post your questions on Stack Overflow utilizing the tag hpcc-ecl (https://stackoverflow.com/search?tab=newest&q=hpcc-ecl). This legacy forum will be active and monitored during our transition to Stack Overflow but will become read only beginning September 1, 2022.

submitting ecl workunits through soap

Comments or questions specific to the features of ECL Watch

Mon Feb 27, 2012 5:46 pm Change Time Zone

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?
Posts: 1
Joined: Mon Feb 27, 2012 5:31 pm

Tue Feb 28, 2012 12:47 am Change Time Zone

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
[email protected]
Community Advisory Board Member
Community Advisory Board Member
Posts: 35
Joined: Tue Jun 14, 2011 9:38 pm

Wed Apr 10, 2019 5:02 am Change Time Zone

Can you please help with excat steps and how we will be using this soap calls.
Posts: 29
Joined: Fri Feb 23, 2018 8:30 am

Wed Apr 10, 2019 6:12 pm Change Time Zone

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.
Posts: 61
Joined: Wed Jan 30, 2013 10:18 pm

Return to ECL Watch

Who is online

Users browsing this forum: No registered users and 1 guest