Queue_Script Parameters

Reference:        Queue_Script

The Queue_Script parameters vary by the type of the command and the type of the parameter.  The parameter type may be either blank or an ‘@’ sign.  In this latter case, both the Minutes and Retry Limit fields are disabled and the Time Variable field is enabled.  This field allows you to specify a variable name, in standard %’ notation, which has been assigned a date/time value.  You should always use a variable here and not simply a numeric value.  Date/time values are expressed as large integers, but carry information that can only be assigned using the Assign command.

Only the Minutes field is enabled when a parent script is queuing a child script and the parameter type is left blank.  In this case, the time is the number of minutes to wait until the child has completed processing.  The default value is zero (0), and instructs the parent script to proceed immediately.

The Requeue variant of the command provides control over the time between runs (in Minutes) and the number of runs that will be performed.  Once the Retry Limit is reached, the script will stop.  This allows you to easily retry the current script without adjusting the run schedule.  It can be used in place of long waits on file presence commands, or large numbers of transfer requeue requests, both of which block other scripts from running on a client version.  When a script is being retried, other scripts can run between retries.  This is not an issue for the server version, where unlimited numbers of scripts may run simultaneously.

The Minutes parameter defaults to one (1).  This is the minimum value.  The Retry Limit parameter defaults to zero (0).  This causes the script to be retried indefinitely.  Retrying scripts extinguished if a Time_Range is specified and the limit is reached.