usage: wfstart <pattern match expression for workflow names>... [-w <timeout s>] [-b]

This command executes one or more workflows.

Note!

If the workflow(s) is/are in a building state when running the wfstart command, "Configuration is building." will be displayed and the workflow(s) will not start unless you have used any of the -w or -b options described below.

With this command, you compare a single pattern match expression, or several, with the full workflow name, <folder>.<workflowconfigurationname>.<workflowname>, of all the workflows.

The command accepts standard wild cards, such as '*' and '?'. For further information see Textual Pattern Matches.

Example - Activate all workflows in the folder myFolder starting with the letter D.

Only workflows in Idle or Waiting state will be started. If the workflow is in another state, an error message will be shown stating why it did not start.

Option	Description

Option

Description

[-w]

Use this option to wait for workflow completion, that is wait for whichever comes first of either a timeout or received exit code declaring the status of the workflow; completed, aborted etc. For further information about exit codes, see Textual Pattern Matches.

If the workflow is in building state, "Configuration is building." will be displayed, and the workflow will not be started until finished building. A timeout may then occur if the building takes too long.

Note!

The [-w] option does only allow one workflow to be started at the time.

[-b]

Use this option (block) to wait for the return code that indicates that workflow has for example completed, aborted or another code. For further information about exit codes, see Textual Pattern Matches.

If the workflow is in building state, "Configuration is building." will be displayed, and the workflow will not be started until finished building.

Return Codes

Listed below are the different return codes for the wfstart command:

Code	Description

Code	Description
0	Will be returned if the command was successful.
50	Will be returned if the argument count is incorrect.
51	Will be returned if the argument parse fails.
70	Will be returned if the workflow is not found.*
80	Will be returned if no user is logged in.
90	Will be returned if an unexpected error occurred.
230	Will be returned if the workflow is already running.
231	Will be returned if permission is denied (no execute permission).
232	Will be returned if the workflow does not exist.*
240	Will be returned if the workflow is invalid

* The difference between return code 70 and 232 is that 70 is returned if a workflow is not found during validation of parameters, and 232 is returned if a workflow is not found when trying to start the workflow. In theory, the workflow could be deleted during the extremely short time between the validation and the start, but in practice it will happen very rarely.