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_codtool  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"

       The HTCondor manual has 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

       Center for High Throughput Computing, University of Wisconsin-Madison

Copyright

       Copyright  (C)  1990-2013  Center  for  High  Throughput  Computing,   Computer   Sciences
       Department,  University  of  Wisconsin-Madison, Madison, WI. All Rights Reserved. Licensed
       under the Apache License, Version 2.0.

                                           January 2014                             condor_cod(1)