5.1.4 Working with Jobs

Jobs can have child jobs. For an operation to have fully completed, the child jobs must be complete as well. However, there are certain operations in which the child jobs can take a very long time to complete or which never complete. This can happen when a child job is spawned to deal with each server. However, if the server is offline, that child job remains active until the server comes back online.

Jobs have properties indicating firstly whether the parent job has completed, and secondly whether all child jobs spawned by the parent job have also completed. The done property relates to the parent job, while the summaryDone property relates to the parent job as well as all spawned child jobs. In some cases, the parent job may appear to be complete if you check the done property, but the summaryDone property indicates that some child jobs are still running. Therefore, it is usually better practice to check the value of the summaryDone property when waiting for job completion.

To see the updates to an object after a job completes (including a modify), you must refresh the client's view of the object.