glite-ce-job-status can monitor one or more jobs: the jobs to be checked are identified by their job identifiers (job Ids returned by glite-ce-job-submit) provided as arguments to the command and separated by a blank space.
It has to be remarked that a job can be monitored only by his/her owner (i.e. the user who submitted it). Only the ``super-users'' can check the status of jobs submitted by other persons.
If the --all option is specified, information about 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 is returned. 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 monitor. This file must be the one generated with the --output option of the glite-ce-job-submit or glite-ce-job-list commands. If the file_name does not represent an absolute path, it will be searched in the current working directory.
When a glite-ce-job-status 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.
The --level option allows setting the detail level of the returned information. This option can be specified with three values: 0, 1 and 2. The default level of verbosity (the one considered if this option is not used and if the attribute STATUS_VERBOSITY_LEVEL hasn't been specified in the CREAM CLI conf file) is 0. Please note that specifying 0 as verbosity level means calling on the CREAM service a faster operation than when using 1 or 2 as level.
Hereafter are listed the information displayed according to the verbosity level:
Verbosity level equal 0:
o JobID: the CREAM job unique identifier
o Status: the job current status
o ExitCode: the Unix exit code - if applicable
o FailureReason: the failure reason (for failed and aborted jobs)
o Description: a description, used for example to explain why a job has been killed by CREAM
Verbosity level equal 1:
o JobID: the CREAM job unique identifier
o GridJobID: the Grid (WMS) job unique identifier, for jobs submitted to CREAM via the WMS
o Current Status: the job current status
o ExitCode: the Unix exit code - if applicable
o FailureReason: the failure reason (for failed and aborted jobs)
o Description: a description, used for example to explain why a job has been killed by CREAM
o Job status changes: the status changes (along with their timestamps) occured so far for the considered job
o Issued Commands: the commands (all but the status/list operations) and the relevant results issued on this job
With a verbosity level equal 2, some additional information fields are added:
o WorkerNode: the worker node where the job is being/was executed
o LocalUser: the user name on the CE mapped to the considered Grid user
o Deleg Proxy Id: the id of the delegated user proxy
o DelegProxyInfo: information about the user proxy used for this job
o Lease ID: the id of the delegation (if the lease mechanism has been used)
o Lease Time: the lease expiration time (if the lease mechannism has been used)
o CREAM ISB URI: the URI of the CREAM directory for the InputSandbox
o CREAM OSB URI: the URI of the CREAM directory for the OutputSandbox
o JDL: the job JDL
o Issued Commands: the same information as for verbosity level 1 plus the timestamps when the commands have been processed and completed
If the user issuing the glite-ce-job-status is a ``superuser'' of that CREAM CE, also the following information is printed specifying '2' as verbosity level:
o LRMS Abs JobId: the id of the job wrt the LRMS Abstraction Layer (i.e. the BLAH job id, since BLAH us used as middleware component to interact with the underlying resource management system)
o LRMS JobId: the id of the job in the LRMS (i.e. the PBS id /the LSF id / ...)
o Working Dir: the directory used by CREAM to store information about this job. Please note that this is not the job working directory on the worker node
It is possible to specify filters on the jobs to be considered. A first type of filter is on the job status: with the --status (-s) option it is possible to specify a list of possible job states: only the jobs being in one of the listed status will be considered.
Another possible filter that can be considered is on the submission time: it is possible to select, with the --from (-f) and/or --to (-t) option a temporal interval: only jobs submitted in this time range will be considered.
o YYYY is the year as a decimal number including the century
o MM is the month (1-12)
o DD is the day of month (1-31)
o HH, mm, ss represent respectively the hour (0-23), the minutes (0-59) and the seconds (0-59)
o YYYY is the year as a decimal number including the century
o MM is the month (1-12)
o DD is the day of month (1-31)
o HH, mm, ss represent respectively the hour (0-23), the minutes (0-59) and the seconds (0-59)
1. > glite-ce-job-status -L 1 https://cream-02.pd.infn.it:8443/CREAM955790315
displays the following lines:
**** JobID=[https://cream-02.pd.infn.it:8443/CREAM955790315]
Current Status = [REALLY-RUNNING]
Grid JobID = [N/A]
Job status changes:
-------------------
Status = [REGISTERED] - [Fri 21 Dec 2007 17:49:38] (1198255778)
Status = [PENDING] - [Fri 21 Dec 2007 17:49:38] (1198255778)
Status = [IDLE] - [Fri 21 Dec 2007 17:49:41] (1198255781)
Status = [RUNNING] - [Fri 21 Dec 2007 17:49:51] (1198255791)
Status = [REALLY-RUNNING] - [Fri 21 Dec 2007 17:50:04] (1198255804)
Issued Commands:
-------------------
*** Command Name = [JOB_REGISTER]
Command Category = [JOB_MANAGEMENT]
Command Status = [SUCCESSFULL]
*** Command Name = [JOB_START]
Command Category = [JOB_MANAGEMENT]
Command Status = [SUCCESSFULL]
2. > glite-ce-job-status --endpoint grid005.pd.infn.it:8443 --all --status DONE-OK:DONE-FAILED --from '2005-07-13 10:00:00'
Status information of all jobs belonging to the user who issued the command, submitted to the specified (with the --endpoint option) CREAM CE after the specified date and time, and being in DONE-OK or in DONE-FAILED status, will be printed.
3. The following example shows a job that has been killed by CREAM because the lease time expired:
> glite-ce-job-status https://cream-03.pd.infn.it:8443/CREAM530773588
**** JobID=[https://cream-03.pd.infn.it:8443/CREAM530773588]
Status = [CANCELLED]
ExitCode = []
Description = [Job cancelled by Lease Manager! (try 1/3)!]
![]() |
![]() |
|
![]() |
![]() |