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 prompts it to send the message back (an "echo"). If successful, the message appears 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 and then echo the message again.

Use an Echo task to control jobs with subjobs

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

For example, you could have a Scheduler job with several import tasks configured to run as subjobs, followed by some document processing tasks. Because 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 subjobs, the subjob 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 subjobs fail the Echo task will fail.