1ARCSTAT(1) NorduGrid Users Manual ARCSTAT(1)
2
6 arcstat - ARC Status
7
10 The arcstat command is used for obtaining the status of jobs that have
11 been submitted to grid enabled resources.
12
15 arcstat [options] [job ...]
16
19 -a, --all
20 all jobs
21 -j, --joblist=filename
23 the file storing information about active jobs (default
24 ~/.arc/jobs.xml)
25 -i, --jobids-from-file=filename
27 a file containing a list of jobIDs
28 -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 -r, --rejectmanagement=URL
34 skip jobs which are on a computing element with a given URL
35 -s, --status=statusstr
37 only select jobs whose status is statusstr
38 -l, --long
40 long format (more information)
41 -J, --json
43 output information about jobs in JSON format
44 -S, --sort
46 sort jobs according to jobid, submissiontime or jobname
47 -R, --rsort
49 reverse sorting of jobs according to jobid, submissiontime or
50 jobname
51 -u, --show-unavailable
53 show jobs where status information is unavailable
54 -p, --print-jobids
56 instead of the status only the IDs of the selected jobs will be
57 printed
58 -P, --listplugins
60 list the available plugins
61 -t, --timeout=seconds
63 timeout in seconds (default 20)
64 -z, --conffile=filename
66 configuration file (default ~/.arc/client.conf)
67 -d, --debug=debuglevel
69 FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
70 -v, --version
72 print version information
73 -?, --help
75 print help
76
78 job ...
79 list of jobids and/or jobnames
80
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 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 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 Accepted - job accepted on cluster but not being processed yet
98 Preparing - job is in phase of preparing for submission to batch system
100 Submitting - communication with batch system in ongoing
102 Hold - job's processing is suspended dueto internal reason or user
104 request
105 Queuing - job is passed to batch system but not being executed yet
107 Running - job being execcuted in batch system
109 Finishing - job in phase of post-execution procedures being run
111 Finished - job successfully completed all processing phases
113 Killed - job processing was interrupted by user request
115 Failed - job processing was interrupted due to detected failure
117 Deleted - job was removed from cluster (usually because it stayed there
119 too long)
120 Other - middleware specific job state could not be adequately mappped
122 to internal state
123 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 If the --long option is given more detailed information is shown.
129 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 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 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 Also in this case the --long option can be used to obtain more detailed
147 information.
148 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
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 ~/.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
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 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 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
194 APACHE LICENSE Version 2.0
195
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
205 arccat(1), arcclean(1), arccp(1), arcget(1), arcinfo(1), arckill(1),
206 arcls(1), arcmkdir(1), arcproxy(1), arcrenew(1), arcresub(1), arcre‐
207 sume(1), arcrm(1), arcsub(1), arcsync(1), arctest(1)
208NorduGrid ARC 6.4.1 2019-12-01 ARCSTAT(1)