3.2.2 - Get Check

Action Option -GC (-GetCheck) :

retrieves check records from GDEXDB. With no filter, returns active check records owned by the current specialist.

dscheck -(GC|GetCheck) [Mode Options]
[-(FN|FieldNames) FieldNameString]
[-(CI|CheckIndex) CheckIndices]
[-(ON|OrderNames) OrderNameString]
[-(CM|Command) CommandNames]
[-(AV|ArgumentVector) ArgumentVectorString]
[-(SN|Specialist) SpecialistNames]
[-(DS|Dataset) DatasetIDs]
[-(AN|ActionName) ActionNames]
[-(CD|CheckDate) CommandDate]
[-(CT|CheckTime) CommandTime]
[-(WD|WorkDir) WorkingDirectory]
[-(PQ|PBSQueue) PBSBatchQueue]
[-(OF|OutputFile) OutputFileName]
[-(DB|Debug) DebugModeInfo]

Available mode options:

-(CS|CheckStatus)

include detailed status: progress percentage for running commands and error messages for failed ones.

-(FO|FormatOutput)

pad each column to a uniform width for readability.

-FN (-FieldNames) selects which fields to retrieve as a string of single-letter codes. When -FN is omitted, the default field set is “COVTUPFJDNW”.

Field codes for check records:

Code

Info Option

Description

C

-(CI|CheckIndex)

check index

O

-(CM|Command)

original command name

V

-(AV|ArgumentVector)

argument string after the command (<= 100 chars)

T

-(DS|Dataset)

dataset ID the command runs against

A

-(AN|ActionName)

action name for the command

U

-(ST|Status)

check status for the recorded command

B

-(DF|DownFlags)

storage down flags: D-DRDATA, G-GLADE, O-ObjectStore

P

-(PQ|PBSQueue)

PBS batch queue name (e.g. gdex, htc)

R

-(PI|ParentIndex)

parent check index this check waits on

F

-(FC|FileCount)

number of files to be processed

J

-(DC|DoneCount)

number of files already processed

K

-(TC|TryCount)

number of times the command has run

L

-(MC|MaxCount)

maximum number of tries allowed

Z

-(SZ|DataSize)

total bytes processed for the command

D

-(CD|CheckDate)

date the command was first recorded

Y

-(CT|CheckTime)

time the command was first recorded

H

-(HN|HostName)

host(s) the command can or cannot run on

N

-(SN|Specialist)

specialist who owns the check

W

-(WD|WorkDir)

working directory for the command

M

-(MO|Modules)

modules to load in the batch job script

I

-(EV|Environments)

environment variables for the batch job

Q

-(QS|QsubOptions)

additional qsub options

X

-(AX|ArgumentExtra)

additional argument string beyond 100 chars

E

-(ER|ErrorMessage)

error message from a failed command

Use -CI (-CheckIndex) to fetch specific records. To inspect another specialist’s records, supply -SN with the appropriate login name.