Queue_Script

Reference:        Script Editor Program
                        Alphabetical Command List

                        Topical Command List

Open Syntax Window

There are two variants of the Queue_Script command.  One allows you to run other scripts on any Beyond FTP server that permits such actions.  This provides a way to “chain” to other scripts.  The second variant allows you to rerun the current script at a later time.  This can be programmed to stop after a certain number of retries, or to continue indefinitely.  The actual starting time for a script can be specified in either variant by including a raw time variable preceded by the ‘@’ character in place of the minutes parameter.  These values are specified as parameters on the command form

A parent script can queue either the script source (ending in .ISF) or the compiled script (ending in .DCF).  Scheduling the script source instructs Beyond FTP to first compile the script before running it.  Scheduling the compiled script simply runs the existing compiled version.

Normally, a child script runs independently of the parent script.  You can instruct the parent to wait for the child script to run and complete by including the optional wait time clause following the script name.  This specifies the maximum amount of time the parent will wait for the child script to finish.  The parent script will continue after the child script has finished or the timeout has expired.

The child script can be run as a “one time” script by including the key words NO REPEAT after the script name, in place of the timeout value.  This instructs Beyond FTP to ignore any Repeat_Time instructions associated with the child script.  The script will run once and extinguish.  Any scheduled instances of the script will not be affected.

The Requeue variant provides great flexibility in managing the way a script processes.  However, should the script fail in a manner that it does not execute one of these commands, it will not repeat.  It usually makes sense to combine the Repeat_Time command with the Requeue variant of Queue_Script to achieve the kind of schedule you want with fail-safe operation.