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 and the status of the clusters
12       in the grid.
13
14

SYNOPSIS

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

OPTIONS

20       -a, --all
21              all jobs
22
23       -j, --joblist=filename
24              the   file   storing  information  about  active  jobs  (default
25              ~/.arc/jobs.xml)
26
27       -i, --jobids-from-file=filename
28              a file containing a list of jobIDs
29
30       -c, --cluster=[-]name
31              explicitly select or reject a specific cluster
32
33       -s, --status=statusstr
34              only select jobs whose status is statusstr
35
36       -l, --long
37              long format (more information)
38
39       -S, --sort
40              sort jobs according to jobid, submissiontime or jobname
41
42       -R, --rsort
43              reverse sorting of jobs according to  jobid,  submissiontime  or
44              jobname
45
46       -p, --print-jobids
47              instead  of the status only the IDs of the selected jobs will be
48              printed
49
50       -P, --listplugins
51              list the available plugins
52
53       -t, --timeout=seconds
54              timeout in seconds (default 20)
55
56       -z, --conffile=filename
57              configuration file (default ~/.arc/client.conf)
58
59       -d, --debug=debuglevel
60              FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
61
62       -v, --version
63              print version information
64
65       -?, --help
66              print help
67

ARGUMENTS

69       job ...
70              list of jobids and/or jobnames
71

EXTENDED DESCRIPTION

73       The arcstat command gives the status  of  a  job  submitted  to  a  ARC
74       enabled  resource.  The job can be referred to either by the jobid that
75       was returned by arcsub(1) at submission time or by its jobname  if  the
76       job description that was submitted contained a jobname attribute.
77
78       More  than  one jobid and/or jobname can be given. If several jobs were
79       submitted with the same jobname the status of all those jobs are shown.
80       If  the  --joblist  option is used the list of jobs is read from a file
81       with the specified filename. By specifying the --all option, the status
82       of  all  active  jobs will be shown. If the --long option is given more
83       detailed information is given.
84
85       Jobs can be sorted according to the jobid, submissiontime  or  jobname,
86       either  in  normal  or  reverse  order.  By using the --sort or --rsort
87       option followed by the desired ordering ('jobid',  'submissiontime'  or
88       'jobname'),  jobs  will be sorted in normal or reverse order. Note that
89       the options --sort and --rsort cannot be used at the same time.
90
91       The --cluster option can be used to select or reject jobs  at  specific
92       clusters.  See arcsub(1) for a discussion of the format of arguments to
93       this option. The --status option can be used to select jobs in  a  spe‐
94       cific state. These options can be repeated several times.
95
96       The arcstat command locates the available clusters by querying informa‐
97       tion index servers. Which servers to query can be specified  by  giving
98       the  --index  option  to the command. See arcsub(1) for a discussion of
99       the format of arguments to this option.
100
101       Also in this case the --long option can be used to obtain more detailed
102       information.
103
104       Previously  the  arcstat  command was also used to query information of
105       clusters and/or index servers.  This functionality have been  moved  to
106       the new command arcinfo
107
108

FILES

110       ~/.arc/client.conf
111              Some  options  can be given default values by specifying them in
112              the ARC client  configuration  file.  By  using  the  --conffile
113              option  a  different  configuration  file  can  be used than the
114              default.
115
116
117       ~/.arc/jobs.xml
118              This a local list of the user's active jobs. When a job is  suc‐
119              cessfully  submitted  it  is  added  to this list and when it is
120              removed from the remote cluster it is removed  from  this  list.
121              This  list  is used as the list of all active jobs when the user
122              specifies the --all option to the  various  NorduGrid  ARC  user
123              interface  commands.  By  using the --joblist option a different
124              file can be used than the default.
125
126

ENVIRONMENT VARIABLES

128       X509_USER_PROXY
129              The location of the user's grid proxy  file.  Shouldn't  be  set
130              unless the proxy is in a non-standard location.
131
132
133       ARC_LOCATION
134              The  location  where  ARC  is installed can be specified by this
135              variable. If not specified the install location will  be  deter‐
136              mined  from  the path to the command being executed, and if this
137              fails a WARNING will be given stating the location which will be
138              used.
139
140
141       ARC_PLUGIN_PATH
142              The  location  of ARC plugins can be specified by this variable.
143              Multiple locations can be specified by separating them by  :  (;
144              in Windows). The default location is $ARC_LOCATION/lib/arc (\ in
145              Windows).
146
147

COPYRIGHT

149       APACHE LICENSE Version 2.0
150
151

AUTHOR

153       Mattias Ellert <mattias.ellert@fysast.uu.se>
154
155