dcsjlog — Return the job summary information for DCS requests (jobs).
dcsjlog [-project proj] [-active] [-cols n] [-canceled] [-done] [-end timestamp] [-fail] [-host str] [-owner str] [-qtype type] [-queued] [-qver version] [-start timestamp] jobid...
The dcsjlog command prints a job summary for one or more DCS requests. Every request submitted to the DCS Server is given a job id and the DCS Server keeps information about the job as it is processed. This information is kept for a short period of time, typically a number of days, after the job has completed.
When no options or job ids are specified, the dcsjlog command reports on all requests submitted by you on the current day since midnight (12 A.M.).
proj
Supply proj as the project number for
charging. Currently, no charging is done for DCS operations, so
this option is a placeholder for when charging might be imposed.
Display only jobs that are currently active.
n
Supply n as the number of
columns to limit each output line. The default is 132,
and the maximum is 1024.
Display only jobs that have been canceled for any reason.
Display only jobs that have completed.
timestamp
Supply timestamp as the
latest job enqueue time limit. The default
is the current time when the command executes.
See Timestamp Format
below for details on the format.
Display only jobs that have failed for any reason.
str
Supply str to limit
the search based on the submitting DCS Client
system's host name. The str
value is interpreted as a POSIX regular expression.
str
Supply str to limit
the search based on the job's owner. The
str value can either
be the UCAS account name or the scientist number.
The default is to limit the search to requests
you have submitted.
type
Supply type to limit the search
based on the DCS queue type. The default is all queue types.
Values for type can be
FT for file transfer requests,
MD for metadata requests, or
QC for queue control requests.
Display only jobs that are currently queued but have not started execution.
version
Supply version to limit
the search based on the DCS queue version.
The default is queue version 1. Any other queue
versions are typically used for testing. All
queue versions may be selected with the value
all.
timestamp
Supply timestamp as the
earliest job enqueue time limit. The default
is midnight of the current day.
See Timestamp Format
below for details on the format.
jobidThe DCS job id for the requests of interest.
-cols
are silently ignored.
A DCS Server will attempt to parse values provided for
timestamp in a variety of commonly
used formats, however it is recommended to only use a format
given in the table below.
Table 5. Some Acceptable timestamp Formats
| Value | Description |
|---|---|
| 'YYYY-MM-DD HH:MM[:SS]' | An unambiguous format. Recommended to specify a particular date and time. The seconds field may be omitted. |
| 'YYYY/MM/DD HH:MM[:SS]' | An unambiguous format. Recommended to specify a particular date and time. The seconds field may be omitted. |
| 'Month DD, YYYY HH:MM[:SS]' | Specify a particular date and time. The seconds field may be omitted. |
| -infinity |
Earlier than all other timestamp values.
Use this as the value for -start
to search as far back as possible.
|
| today | Midnight (i.e. 12 A.M.) today. |
| yesterday | Midnight (i.e. 12 A.M.) yesterday. |
Example 1. Display logs for all of your jobs that were submitted yesterday.
dcsjlog -start yesterday -end todayExample 2. Display logs for jobs submitted during a specific hour that failed.
dcsjlog -start '2005/7/8 14:00' -end '2005/7/8 15:00' -failTypical output:
Job ID: 975 Owner: BARTS Host: bluebird.ucar.edu State: Done Command: dcswait 974 Enqueued: 05/07/08 14:55:56 Started: 05/07/08 14:55:56 Ended: 05/07/08 15:02:51 Status: Cancelled by DCS admin Exit Code: 4
See Environment Variables section of the Command Behavior and Envrionment chapter for details.
See Exit Status Codes section of the Command Behavior and Environment chapter for details.