[Index]

cascade

A job which triggers the next job after the previous one completes. This job differs from a sequential task in that the latter follows the thread of execution, and only checks state to ensure it can continue. This job's thread of execution passes onwards after the cascade has been set up. This job will complete asynchronously once all it's children have completed.

State Operator

This job doesn't currently expose a State Operator property as sequential does. The state behaviour is equivalent to the WORST state operator, which is what is desired in most situations. A stateOperator property may be added in future versions if needed.

Property Summary

cascadeOn
haltOn
jobs
name	A name, can be any text.
stop	Read only view of the internal stop flag.

Example Summary

Example 1	A cascade of two jobs.
Example 2	Showing cascade being used with parallel.

Property Detail

cascadeOn

Configured By	ATTRIBUTE
Access	READ_WRITE

haltOn

Configured By	ATTRIBUTE
Access	READ_WRITE

jobs

Configured By	ELEMENT
Access	WRITE_ONLY

name

Configured By	ATTRIBUTE
Access	READ_WRITE
Required	No.

A name, can be any text.

stop

Access	READ_ONLY
Required	Read only.

Read only view of the internal stop flag. This flag is cleared with a reset.

Examples

Example 1

A cascade of two jobs.

<oddjob>
    <job>
        <cascade>
            <jobs>
                <echo>This runs first.</echo>
                <echo>Then this.</echo>
            </jobs>
        </cascade>
    </job>
</oddjob>

Example 2

Showing cascade being used with parallel. The cascade will wait for the parallel job to finish before running the third job.

<oddjob>
    <job>
        <cascade>
            <jobs>
                <parallel>
                    <jobs>
                        <echo>Oranges could be first or second.</echo>
                        <echo>Pears could be first or second.</echo>
                    </jobs>
                </parallel>
                <echo>Apples are guaranteed to be third.</echo>
            </jobs>
        </cascade>
    </job>
</oddjob>