condor_cod(1)						      General Commands Manual						     condor_cod(1)

Name
       condor_cod manage - COD machines and jobs

Synopsis
       condor_cod [-help -version]

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

       condor_codrelease-id ClaimID[[-help -version] [-debug -timeout N -classad file] ] [-fast]

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

       condor_coddeactivate-id ClaimID[[-help -version] [-debug -timeout N -classad file] ] [-fast]

       condor_codsuspend-id ClaimID[[-help -version] [-debug -timeout N -classad file] ]

       condor_codrenew-id ClaimID[[-help -version] [-debug -timeout N -classad file] ]

       condor_codresume-id ClaimID[[-help -version] [-debug -timeout N -classad file] ]

       condor_coddelegate_proxy-id ClaimID[[-help -version] [-debug -timeout N -classad file] ] [-x509proxy ProxyFile]

Description
       condor_codissues commands that manage and use COD claims on machines, given proper authorization.

       Instead of specifying an argument of request, release, activate, deactivate, suspend, renew, 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_codexecutable. For example on a Unix machine:

       ln condor_cod _request condor_cod

       The requestargument 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.3for 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 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>"

       -lease N

	  For the requestof a new claim, automatically release the claim after Nseconds.

       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

       renew

	  Renew the lease to the COD claim

       resume

	  Resume the job on a given claim

       delegate_proxy

	  Delegate an X509 proxy for the given claim

General Remarks
Examples
Exit Status
       condor_codwill 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  (C)  1990-2012  Condor  Team,  Computer  Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved.
       Licensed under the Apache License, Version 2.0.

       See the Condor Version 7.8.2 Manualor http://www.condorproject.org/licensefor additional notices. condor-admin@cs.wisc.edu

								  September 2012						     condor_cod(1)