A command posted on an agent handle is given an integer ID which is unique per handle. With the job-id argument, specify a command that must have completed before the script branch may continue. Without argument, the script branch will be suspended until all commands have completed, those which were posted on this handle before this command.
If the -capture flag was specified together with the job-id argument, then any captured output from that job will be returned from this command or printed. Note that the captured output will be discarded afterwards.
Queued commands are run sequentially, meaning that the next command will start once the previous has completed. Thus, all commands that were posted before the specified argument are guaranteed to have completed successfully.
If an error occurs, the execution is stopped and all pending commands that were posted on this handle are discarded, and the error is reported. This will also abort the script branch.
Notice: This command works only in script branches. In each branch, create a local agent handle; that handle will not interfere with other handles. Handles should be deleted before script branches finish.