condor_rm

Withdraw job(s) from an Access Point.

Synopsis

condor_rm [-help | -version]

condor_rm [OPTIONS] [cluster… | cluster.proc… | user…]

condor_rm [-debug] [-long] [-totals] [-all] [-constraint expression] [-forcex][-pool hostname[:portnumber] | -name scheddname | -addr “<a.b.c.d:port>”]

Description

Remove job(s) currently being managed by an Access Point. Any jobs actively running or transferring files will be stopped and cleaned prior to removing the job and writing its ClassAd to the HISTORY file. For any given job, only the owner of the job or one of the queue super users (defined by the QUEUE_SUPER_USERS macro) can remove the job.

Options

-help
Display usage information.

-version
Display version information.

-long
Display result ClassAd.

-totals
Display success/failure totals.

-pool hostname[:portnumber]
Specify a pool by giving the central manager’s host name and an optional port number.

-name scheddname
Send the command to a machine identified by scheddname.

-addr “<a.b.c.d:port>”
Send the command to a machine located at “<a.b.c.d:port>”.

-debug
Causes debugging information to be sent to stderr, based on the value of the configuration variable TOOL_DEBUG.

-forcex
Force the immediate local removal of jobs in the X state. This only affects jobs already being removed.

-constraint expression
Remove all jobs which match the job ClassAd expression constraint.

-all
Remove all the jobs in the queue.

cluster
Remove all jobs in the specified cluster.

cluster.process
Remove the specific job in the cluster.

user
Remove jobs belonging to specified user.

General Remarks

If the -name option is specified, the named condor_schedd is targeted for processing. Otherwise, the local condor_schedd is targeted.

Removed jobs that were running in the grid universe may remain in the X state for a long time. This is normal, as HTCondor is attempting to communicate with the remote scheduling system to ensure the job has been properly cleaned up. The job can be forcibly removed with the -forcex if the job is stuck in the X state.

Warning

The -forcex option will cause immediate removal of the job which an orphan parts of the job that running remotely and have not been stopped or cleaned up.

Exit Status

0 - Success

1 - Failure has occurred

Examples

Remove a specific job:

$ condor_rm 123.45

Remove all jobs currently not running:

$ condor_rm -constraint 'JobStatus =!= 2'

Remove all of user Bob’s jobs:

# condor_rm bob

Availability

Linux, MacOS, Windows