arcstat(1)

1ARCSTAT(1)                  NorduGrid Users Manual                  ARCSTAT(1)
2
3
4

NAME

6       arcstat - ARC Status
7
8

DESCRIPTION

10       The  arcstat command is used for obtaining the status of jobs that have
11       been submitted to grid enabled resources.
12
13

SYNOPSIS

15       arcstat [options] [job ...]
16
17

OPTIONS

19       -a, --all
20              all jobs
21
22       -j, --joblist=filename
23              the  file  storing  information  about  active   jobs   (default
24              ~/.arc/jobs.xml)
25
26       -i, --jobids-from-file=filename
27              a file containing a list of jobIDs
28
29       -c, --cluster=name
30              select  one or more computing elements: name can be an alias for
31              a single CE, a group of CEs or a URL
32
33       -r, --rejectmanagement=URL
34              skip jobs which are on a computing element with a given URL
35
36       -s, --status=statusstr
37              only select jobs whose status is statusstr
38
39       -l, --long
40              long format (more information)
41
42       -J, --json
43              output information about jobs in JSON format
44
45       -S, --sort
46              sort jobs according to jobid, submissiontime or jobname
47
48       -R, --rsort
49              reverse sorting of jobs according to  jobid,  submissiontime  or
50              jobname
51
52       -u, --show-unavailable
53              show jobs where status information is unavailable
54
55       -p, --print-jobids
56              instead  of the status only the IDs of the selected jobs will be
57              printed
58
59       -P, --listplugins
60              list the available plugins
61
62       -t, --timeout=seconds
63              timeout in seconds (default 20)
64
65       -z, --conffile=filename
66              configuration file (default ~/.arc/client.conf)
67
68       -d, --debug=debuglevel
69              FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
70
71       -v, --version
72              print version information
73
74       -?, --help
75              print help
76

ARGUMENTS

78       job ...
79              list of jobids and/or jobnames
80

EXTENDED DESCRIPTION

82       The arcstat command gives the status  of  a  job  submitted  to  a  ARC
83       enabled  resource.  The job can be referred to either by the jobid that
84       was returned by arcsub(1) at submission time or by its jobname  if  the
85       job description that was submitted contained a jobname attribute.
86
87       More  than  one jobid and/or jobname can be given. If several jobs were
88       submitted with the same jobname the status of all those jobs are shown.
89       If  the  --joblist  option is used the list of jobs is read from a file
90       with the specified filename. By specifying the --all option, the status
91       of all active jobs will be shown.
92
93       By  default  arcstat presents job states as defined internally followed
94       by middleware specific representation of job  state  in  brackets.  The
95       following internal job states are defined:
96
97       Accepted - job accepted on cluster but not being processed yet
98
99       Preparing - job is in phase of preparing for submission to batch system
100
101       Submitting - communication with batch system in ongoing
102
103       Hold  -  job's  processing  is  suspended dueto internal reason or user
104       request
105
106       Queuing - job is passed to batch system but not being executed yet
107
108       Running - job being execcuted in batch system
109
110       Finishing - job in phase of post-execution procedures being run
111
112       Finished - job successfully completed all processing phases
113
114       Killed - job processing was interrupted by user request
115
116       Failed - job processing was interrupted due to detected failure
117
118       Deleted - job was removed from cluster (usually because it stayed there
119       too long)
120
121       Other  -  middleware specific job state could not be adequately mappped
122       to internal state
123
124       Those are  also  states  which  are  used  by  arccat(1),  arcclean(1),
125       arcget(1),  arckill(1),  arcrenew(1), arcresub(1), arcresume(1) to per‐
126       form job filtering.
127
128       If the --long option is given more detailed information is shown.
129
130       Jobs can be sorted according to the jobid, submissiontime  or  jobname,
131       either  in  normal  or  reverse  order.  By using the --sort or --rsort
132       option followed by the desired ordering ('jobid',  'submissiontime'  or
133       'jobname'),  jobs  will be sorted in normal or reverse order. Note that
134       the options --sort and --rsort cannot be used at the same time.
135
136       The --cluster option can be used to select or reject jobs  at  specific
137       clusters.  See arcsub(1) for a discussion of the format of arguments to
138       this option. The --status option can be used to select jobs in  a  spe‐
139       cific state. These options can be repeated several times.
140
141       The arcstat command locates the available clusters by querying informa‐
142       tion index servers. Which servers to query can be specified  by  giving
143       the  --index  option  to the command. See arcsub(1) for a discussion of
144       the format of arguments to this option.
145
146       Also in this case the --long option can be used to obtain more detailed
147       information.
148
149       Previously  the  arcstat  command was also used to query information of
150       clusters and/or index servers.  This functionality have been  moved  to
151       the new command arcinfo
152
153

FILES

155       ~/.arc/client.conf
156              Some  options  can be given default values by specifying them in
157              the ARC client  configuration  file.  By  using  the  --conffile
158              option  a  different  configuration  file  can  be used than the
159              default.
160
161
162       ~/.arc/jobs.xml
163              This a local list of the user's active jobs. When a job is  suc‐
164              cessfully  submitted  it  is  added  to this list and when it is
165              removed from the remote cluster it is removed  from  this  list.
166              This  list  is used as the list of all active jobs when the user
167              specifies the --all option to the  various  NorduGrid  ARC  user
168              interface  commands.  By  using the --joblist option a different
169              file can be used than the default.
170
171

ENVIRONMENT VARIABLES

173       X509_USER_PROXY
174              The location of the user's Grid proxy  file.  Shouldn't  be  set
175              unless the proxy is in a non-standard location.
176
177
178       ARC_LOCATION
179              The  location  where  ARC  is installed can be specified by this
180              variable. If not specified the install location will  be  deter‐
181              mined  from  the path to the command being executed, and if this
182              fails a WARNING will be given stating the location which will be
183              used.
184
185
186       ARC_PLUGIN_PATH
187              The  location  of ARC plugins can be specified by this variable.
188              Multiple locations can be specified by separating them by  :  (;
189              in Windows). The default location is $ARC_LOCATION/lib/arc (\ in
190              Windows).
191
192

COPYRIGHT

194       APACHE LICENSE Version 2.0
195
196

AUTHOR

198       ARC   software   is   developed   by   the   NorduGrid    Collaboration
199       (http://www.nordugrid.org), please consult the AUTHORS file distributed
200       with   ARC.   Please   report   bugs   and    feature    requests    to
201       http://bugzilla.nordugrid.org
202
203