'\" t
.\" Title: pegasus-remove
.\" Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1
.\" Date: 11/09/2018
.\" Manual: Pegasus Manual
.\" Source: Pegasus 4.4.0
.\" Language: English
.\"
.TH "PEGASUS\-REMOVE" "1" "11/09/2018" "Pegasus 4\&.4\&.0" "Pegasus Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pegasus-remove \- removes a workflow that has been planned and submitted using pegasus\-plan and pegasus\-run
.SH "SYNOPSIS"
.sp
.nf
pegasus\-remove [\fB\-d\fR \fIdagid\fR] [\fB\-v\fR] [\fIrundir\fR]
.fi
.SH "DESCRIPTION"
.sp
The pegasus\-remove command remove a submitted/running workflow that has been planned and submitted using \fBpegasus\-plan\fR and \fBpegasus\-run\fR\&. The command can be invoked either in the planned directory with no options and arguments or just the full path to the run directory\&.
.SH "OPTIONS"
.sp
By default pegasus\-remove does not require any options or arguments if invoked from within the planned workflow directory\&. If running the command outside the workflow directory then a full path to the workflow directory needs to be specified or the \fIdagid\fR of the workflow to be removed\&.
.sp
\fBpegasus\-remove\fR takes the following options:
.PP
\fB\-d\fR \fIdagid\fR, \fB\-\-dagid\fR \fIdagid\fR
.RS 4
The workflow dagid to remove
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
Raises debug level\&. Each invocation increase the level by 1\&.
.RE
.PP
\fIrundir\fR
.RS 4
Is the full qualified path to the base directory containing the planned workflow DAG and submit files\&. This is optional if pegasus\-remove command is invoked from within the run directory\&.
.RE
.SH "RETURN VALUE"
.sp
If the workflow is removed successfully pegasus\-remove returns with an exit code of 0\&. However, in case of error, a non\-zero exit code indicates problems\&. An error message clearly marks the cause\&.
.SH "FILES"
.sp
The following files are opened:
.PP
\fBbraindump\fR
.RS 4
This file is located in the rundir\&. pegasus\-remove uses this file to find out paths to several other files\&.
.RE
.SH "ENVIRONMENT VARIABLES"
.PP
\fBPATH\fR
.RS 4
The path variable is used to locate binary for
\fBcondor_rm\fR\&.
.RE
.SH "SEE ALSO"
.sp
pegasus\-plan(1), pegasus\-run(1)
.SH "AUTHORS"
.sp
Gaurang Mehta
.sp
Jens\-S\&. Vöckler
.sp
Pegasus Team \m[blue]\fBhttp://pegasus\&.isi\&.edu\fR\m[]