AX2560

Scheduler task: Echo

This task is primarily used for testing purposes, to check whether a Scheduler server is running and operational. The task sends a message to the Scheduler server, and asks it to send the message back (an "echo"). If successful, the message displays in the job results. No other action is performed.

Item	Description
Message to Echo	The message to send to the Scheduler server for testing. Job variables can be used in this setting.
Sleep Time	The time to pause in between message echoes, in seconds. Scheduler will echo the message once, then wait the specified sleep time, then echo the message again.

Using an Echo task to control jobs with sub-jobs

If the Task Control option Wait for all Subordinate jobs to complete before proceeding to the next task is enabled for an Echo task, then the Echo task will inherit the status of the sub-jobs when they are completed. If one of the sub-jobs fails, then the Echo task will inherit that failed status. By default, this means that the job will not process any further tasks due to the sub-job failure. This behavior can be used to stop a job from processing tasks if previous sub-jobs fail.

For example, you could have a Scheduler job with several import tasks configured to run as sub-jobs, followed by some document processing tasks. Since the document processing tasks depend on the imported data, you do not want the document processing tasks to be run if any of the import tasks fail. However, because the import tasks are running as sub-jobs, the sub-job failure does not stop the parent job from continuing to process tasks. You can place an Echo task after the import tasks and configure it to wait, and then if any sub-jobs fail the Echo task will fail.