Links
Comment on page

Apps and Workflows Glossary

Learn key terms used to describe apps and workflows.
On the DNAnexus Platform, the following terms are used when discussing apps and workflows:
  • Execution: An analysis or job.
    • Root execution: The initial analysis or job that's created when a user makes an API call to run a workflow, app, or applet. Analyses and jobs created from a job via /executable-xxxx/runAPI call with detach flag set to true are also root executions.
    • Execution tree: The set of all jobs and/or analyses that are created as a result of running a root execution.
  • Analysis: An analysis is created when a workflow is run. It consists of some number of stages, each of which consists of either another analysis (if running a workflow) or a job (if running an app or applet).
    • Parent analysis: Each analysis is the parent analysis to each of the jobs that are created to run its stages.
  • Job: A job is a unit of execution that is run on a worker in the cloud. A job is created when an app or applet is run, or when a job spawns another job.
    • Origin job: The job created when an app or applet is run by either a user or an analysis. An origin job always executes the "main" entry point.
    • Master job: The job created when an app or applet is run by a user, job, or analysis. A master job always executes the "main" entry point. All origin jobs are also master jobs.
    • Parent job: A job that creates another job or analysis via an /executable-xxxx/run or /job/new API call.
    • Child job: A job created from a parent job via an /app[let]-xxxx/run or /job/new API call.
    • Subjob: A job created from a job via a /job/new API call. A subjob runs the same executable as its parent, and executes the entry point specified in the API call that created it.
    • Job tree: A set of all jobs that share the same origin job.
  • Job-based object reference: A hash containing a job ID and an output field name. This hash is given in the input or output of a job. Once the specified job has transitioned to the "done" state, it is replaced with the specified job's output field.