swif2

Create, control, modify and monitor workflows using Jefferson Lab's Scientific Workflow Indefatigable Factotum.

Usage

swif2 <command> [[-workflow] <workflow>] [options] [args]

This is the main entry point to the swif client commands. Specify <command> with options and arguments as appropriate to operate upon workflow <workflow>. All commands allow you to specify <workflow> without the -workflow flag if it is the first argument following <command>. Commands that operate on all of a user's workflows (e.g. list) do not require that you specify a workflow name.

NB: Users writing scripts to interact with swif should specify json or xml output format, since the default simple text format is intended only for quick visual inspection and is not well-specified. Parsing the simple output will likely break as features are added or modified.

Common Arguments

Flag Value Comment
-workflow workflow name Specify the workflow.
-help Display this message or, if specified before a valid command name, information pertinent to that command.
-user user name Operate as named user. Read-only access for non-privileged users.
-display json,xml,table,simple How to format the output data.

Valid Commands

Command Purpose
abandon-jobs Fail problem jobs, cancel pending ones.
add-job Add a job to an existing workflow.
add-jsub Add jobs from legacy auger file.
bless-jobs Promote problem jobs, ignoring batch system errors.
cancel End all work.
create Create a new workflow.
export Dump workflow configuration.
import Create a new workflow from configuration file.
list Display all of your workflows.
modify-jobs Change some job parameters.
notify Configure workflow notifications.
output Specify an output from within a running job.
pause Stop adding new work to batch system.
resume-jobs Resume problem jobs.
retry-jobs Resubmit problem jobs.
run Allow jobs to be released to batch system.
show-job Display information about specified job.
status Display information about the state of the workflow.
tag-job Set or remove key value pairs for a job.