Difference: GliteCeJobCancel (1 vs. 2)

Revision 22011-05-02 - MassimoSgaravatto

Line: 1 to 1
 
META TOPICPARENT name="UserGuide"
Added:
>
>

glite-ce-job-cancel

Section: User Commands (1)
Index
 

NAME

glite-ce-job-cancel - Cancels one or more jobs previously submitted to CREAM based CEs.

 

SYNOPSIS

glite-ce-job-cancel [options] <jobId1> <jobId2> ... <jobIdn>

 

DESCRIPTION

The command glite-ce-job-cancel cancels jobs previously submitted, using the glite-ce-job-submit command, to CREAM based CEs.

glite-ce-job-cancel can remove one or more jobs: the jobs to be removed are identified by their job identifiers (job Ids returned by the glite-ce-job-submit command) provided as arguments to the command and separated by a blank space.

It has to be remarked that a job can be cancelled only by his/her owner (i.e. the user who submitted it). Only the ``super-users'' can cancel jobs submitted by other persons.
Before actually cancelling the specified jobs, the command prompts the user for confirmation.

Job states for which cancellation is allowed are:

o Pending

o Idle

o Running

o Really-Running

o Held

For all the other job states the cancellation request will result in a failure. An error message is of course printed also if the specified jobId doesn't exist.

If the --all option is specified, all the jobs submitted to the interested CREAM CE (whose endpoint must be specified with the --endpoint option, which is mandatory in this case), owned by the user issuing the command, are removed. When the command is launched with the --all option, neither can a jobId be specified nor can the --input option be used.

The --input option permits to specify a file (file_name) that contains the jobIds to be removed. This file must be the one generated with the --output option of the glite-ce-job-submit or glite-ce-job-list commands. When using this option the user is interrogated for choosing among all, one or a subset of the listed job identifiers. If the file file_name does not represent an absolute path the file will be searched in the current working directory.

When a glite-ce-job-cancel request is issued, the host name and the port number to be used to contact the CREAM service(s) are retrieved from the specified jobIds (which encompass this information) unless the --endpoint option is used. As stated before, the --endpoint option is mandatory if the --all option is used.

 

OPTIONS

--help, -h
Displays command usage.

--conf file_name, -c file_name
Specifies the user specific configuration file.

--all, -a
Cancels all known jobs in the specified (with the --endpoint option, which is mandatory in this case) CREAM CE, owned by the user issuing the command. This option can't be used either if one or more jobIds have been specified or if the --input option has been specified.

--endpoint host[:port], -e host[:port]
Selects the endpoint of the CREAM CE to send the cancel request to. If the port is not specified, the port to be used is the one specified in the CREAM UI configuration file. If this option is not specified, the endpoint will be extracted from the JobID strings. The endpoint must have the format <host>:<port> or <host>.

--donot-verify-ac-sign, -A
Allows the execution of the command even if the VO voms server certificate is not installed.

--input file_name, -i file_name
Cancels jobs whose Ids are contained in the file file_name. This option can't be used if the --all option has been specified as well.

--noint, -N
If this option is specified every interactive question to the user is skipped, and default values (yes; all: consider all jobs of the given list) will be considered.

--nomsg, -n
When this option is specified, any warning or info message is suppressed.

--debug, -d
When this option is specified, debugging information is displayed on the standard output and written also into the file glite-ce-job-cancel_CREAM_<username>_<date>_<time>.log file under (by default) the /tmp/glite_cream_cli_logs directory.

--logfile file_name, -l file_name
When this option is specified, a command log file (whose pathname is file_name) is created.

--version, -v
Displays the version of the CREAM CLI software.

 

EXIT STATUS

glite-ce-job-cancel exits with a value of 0 if the cancel operation succeeds, >0 if errors occurred.

 

EXAMPLES

glite-ce-job-cancel --input joblist.txt
where joblist.txt is a file containing 2 jobIds, displays the following confirmation message:

0. https://cream-ce-01.pd.infn.it:8443/CREAM116jbs5b9

1. https://cream-ce-01.pd.infn.it:8443/CREAM116jbi4o0

a. Cancel all jobs

q. Quit

Your choice ? (multiple choices separated by ',') a

Are you sure you want to cancel specified job(s) [y/n]: y


glite-ce-job-cancel --endpoint grid005.pd.infn.it:8443 --all

cancels all jobs, on the specified CREAM CE, owned by the user issuing the command.
                                                                                  

SEE ALSO

glite-ce-job-submit, glite-ce-job-list


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXIT STATUS
EXAMPLES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 12:36:11 GMT, May 02, 2011
 -- MassimoSgaravatto - 2011-04-29 \ No newline at end of file

Revision 12011-04-29 - MassimoSgaravatto

Line: 1 to 1
Added:
>
>
META TOPICPARENT name="UserGuide"
-- MassimoSgaravatto - 2011-04-29
 
This site is powered by the TWiki collaboration platformCopyright © 2008-2019 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback