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       -S, --sort
43              sort jobs according to jobid, submissiontime or jobname
44
45       -R, --rsort
46              reverse sorting of jobs according to  jobid,  submissiontime  or
47              jobname
48
49       -u, --show-unavailable
50              show jobs where status information is unavailable
51
52       -p, --print-jobids
53              instead  of the status only the IDs of the selected jobs will be
54              printed
55
56       -P, --listplugins
57              list the available plugins
58
59       -t, --timeout=seconds
60              timeout in seconds (default 20)
61
62       -z, --conffile=filename
63              configuration file (default ~/.arc/client.conf)
64
65       -d, --debug=debuglevel
66              FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
67
68       -v, --version
69              print version information
70
71       -?, --help
72              print help
73

ARGUMENTS

75       job ...
76              list of jobids and/or jobnames
77

EXTENDED DESCRIPTION

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

FILES

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

ENVIRONMENT VARIABLES

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

COPYRIGHT

191       APACHE LICENSE Version 2.0
192
193

AUTHOR

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