glite-ce-job-resume

Section: User Commands (1)
Index

NAME

glite-ce-job-resume - Resumes one or more jobs, which have been previously suspended.

SYNOPSIS

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

DESCRIPTION

The command glite-ce-job-resume resumes jobs, which therefore can run again, previously suspended with the glite-ce-job-suspend command.

glite-ce-job-resume can resume one or more jobs: the jobs to be resumed 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 resumed only by his/her owner (i.e. the user who submitted it). Only the ``super-users'' can resume jobs submitted by other persons.
Before actually resuming the specified jobs, the command prompts the user for confirmation.

Only jobs which have been previosly suspended, and therefore are in Held status, can be resumed. For all the other job states the resume request will result in a failure. An error message is of course printed also if a 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 requested to be resumed. 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 resumed. 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-resume 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.

--donot-verify-ac-sign, -A

Allows the execution of the command even if the VO voms server certificate is not installed.

--all, -a

Resumes 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 resume request to. 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>.

--input file_name, -i file_name

Resumes 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-resume_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-resume exits with a value of 0 if the resume operation succeeds, >0 if errors occurred.

EXAMPLES

1. > glite-ce-job-resume https://grid005.pd.infn.it:8443/CREAM116j8qi1s
requests to resume the specified job, which must be previously suspended, and which therefore must be in HELD status.

2.If it is requested to resume a job which hasn't been previously suspended, an error message will be returned, as in the following example:

> glite-ce-job-resume https://grid005.pd.infn.it:8443/CREAM116j8miot
Are you sure you want to resume specified job(s) [y/n]: y

20050902 10:20:23 - FAULT: FAULT: - SOAP-ENV:Server.generalException - MethodName=[jobResume] - FaultCause=[Invalid job ID list] - Description=[The following jobs have a status not compatible with the jobResume command: https://grid005.pd.infn.it:8443/CREAM116j8miot] - ErrorCode=[1]