condor_ cod

manage COD machines and jobs

Synopsis

condor_ cod [-help | -version]

condor_ cod request [-pool centralmanagerhostname[:portnumber] | -name scheddname ]| [-addr "<a.b.c.d:port>"] [[-help | -version] | [-debug | -timeout N | -classad file] ] [-requirements expr]

condor_ cod release -id ClaimID [[-help | -version] | [-debug | -timeout N | -classad file] ] [-fast]

condor_ cod activate -id ClaimID [[-help | -version] | [-debug | -timeout N | -classad file] ] [-keyword string | -jobad filename | -cluster N | -proc N | -requirements expr]

condor_ cod deactivate -id ClaimID [[-help | -version] | [-debug | -timeout N | -classad file] ] [-fast]

condor_ cod suspend -id ClaimID [[-help | -version] | [-debug | -timeout N | -classad file] ]

condor_ cod resume -id ClaimID [[-help | -version] | [-debug | -timeout N | -classad file] ]

Description

condor_ cod issues commands that manage and use COD claims on machines, given proper authorization.

Instead of specifying an argument of request, release, activate, deactivate, suspend, or resume, the user may invoke the condor_ cod tool by appending an underscore followed by one of these arguments. As an example, the following two commands are equivalent:

    condor_cod release -id "<128.105.121.21:49973>#1073352104#4"

    condor_cod_release -id "<128.105.121.21:49973>#1073352104#4"

To make these extended-name commands work, hard link the extended name to the condor_ cod executable. For example on a Unix machine:

ln condor_cod_request condor_cod

The request argument gives a claim ID, and the other commands (release, activate, deactivate, suspend, and resume) use the claim ID. The claim ID is given as the last line of output for a request, and the output appears of the form:

ID of new claim is: "<a.b.c.d:portnumber>#x#y"

An actual example of this line of output is

ID of new claim is: "<128.105.121.21:49973>#1073352104#4"

Also see section 4.3 for more a complete description of COD.

Options

-help

Display usage information

-version

Display version information

-pool centralmanagerhostname[:portnumber]

Specify a pool by giving the central manager's hostname 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>"

request

Create a new COD claim

release

Relinquish a claim and kill any running job

activate

Start a job on a given claim

deactivate

Kill the current job, but keep the claim

suspend

Suspend the job on a given claim

resume

Resume the job on a given claim

General Remarks

Examples

Exit Status

condor_ cod will exit with a status value of 0 (zero) upon success, and it will exit with the value 1 (one) upon failure.

Author

Condor Team, University of Wisconsin-Madison

Copyright

Copyright © 1990-2006 Condor Team, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved. No use of the Condor Software Program is authorized without the express consent of the Condor Team. For more information contact: Condor Team, Attention: Professor Miron Livny, 7367 Computer Sciences, 1210 W. Dayton St., Madison, WI 53706-1685, (608) 262-0856 or miron@cs.wisc.edu.

U.S. Government Rights Restrictions: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of The Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (c)(1) and (2) of Commercial Computer Software-Restricted Rights at 48 CFR 52.227-19, as applicable, Condor Team, Attention: Professor Miron Livny, 7367 Computer Sciences, 1210 W. Dayton St., Madison, WI 53706-1685, (608) 262-0856 or miron@cs.wisc.edu.

See the Condor Version 6.8.3 Manual for additional notices.